Skip to content
VibeEngineering-LLCPublic

About

CAD/mesh (STL, 3MF, OBJ, STEP) to GDML converter with section sketch and report

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

52 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cad2gdml

Конвертер CAD/сеток (STL, 3MF, OBJ, STEP, Blender, GDML) в GDML для Geant4 и BecqMoni: пишет output.gdml, эскиз сечения output.png и описание output.report.txt. Лицензия MIT. Статус: тестовая сборка v0.14 (проверка пересечений тел W_OVERLAP/W_INSIDE, см. «Подготовка модели»). До этого v0.13 (вход GDML: тела box, tube, polycone, иерархия объёмов и вещества из файла; в просмотре сечение закрыто сплошным срезом; плотности NIST-веществ в окне; см. «GDML»). До этого v0.12: кнопки «Заменить…» и «Своё вещество…», STEP проверен на CAD-файле, см. «STEP». Контур GEANT4 загрузил GDML сцены atom_nano5_labr_v8 парсером Geant4: остались 8 предупреждений (вырожденные грани и «wrong orientation» у торцевых пластин, корпуса и отражателя); влияние на транспорт частиц не проверено.

Запуск

Окно: Cad2GdmlApp.exe. Добавьте файлы или папку, выберите единицы входа (для STL/OBJ обязательно), при необходимости укажите кристалл и фронт, нажмите «Конвертировать». «Заменить…» подменяет выбранный в списке файл другим (ровно один файл; повторный и тот же файл не принимаются); после замены нажмите «Конвертировать». В окне «Сцена и вещества» кнопка «Своё вещество…» создаёт вещество: имя латиницей, плотность в г/см³ и состав «элемент=массовая доля» (сумма 1 ± 0,0001); оно подставляется выбранной детали, попадает в <materials> GDML и помнится до смены списка файлов. Роль остаётся выбором из перечня. Кнопка «Сцена и вещества…» открывает трёхмерный просмотр: вращение мышью, сечение по оси, включение/выключение деталей галочкой, вещества по-русски. Выбранная деталь подсвечивается.

Командная строка:

cad2gdml <файл|папка>... --out <папка> [--name имя] [--unit mm|cm|m|inch]
         [--crystal имя] [--front +z|-z|+x|-x|+y|-y|auto] [--materials файл.json]
         [--material имя=вещество] [--density вещество=г/см3] [--role имя=роль]
         [--allow-default-material] [--keep-open | --drop-open] [--no-split] [--no-repair] [--weld мм]

Коды выхода: 0 готово; 2 вход/единицы/формат/STEP; 3 сетка; 4 роли/кадр; 5 вещество; 9 внутренняя ошибка.

Переменные окружения: CAD2GDML_VERBOSE=1 (показать служебные сообщения), CAD2GDML_TRACE=1 (метки этапов), CAD2GDML_PYTHON, CAD2GDML_STEP_SCRIPT (модуль STEP), CAD2GDML_BLENDER, CAD2GDML_BLEND_SCRIPT (вход .blend).

--front: буква — ось кристалла в системе файла, знак — передний торец; auto — ось по тензору инерции, торец по центру масс остальных деталей. В окне то же поле «Ось/фронт».

Подготовка модели

Качество GDML определяется исходником, а не конвертером. Что нужно:

  • Формат с именами деталей: OBJ (экспорт «по объектам», с материалами), 3MF, STEP или .blend. STL — только для простых деталей (например, сосуд Маринелли): один файл STL — одна деталь, без имён внутри и без материалов; на тела он не делится, а если в файле несколько отдельных тел, выводится предупреждение W_STL_MULTIBODY. Для сборок STL не подходит.
  • Одна деталь = одно замкнутое тело. Не объединяйте разные вещества в один объект; не оставляйте дыр, двойных стенок, перекрытий между деталями. Конвертер проверяет замкнутость каждой детали (открытая сетка — E_MESH_OPEN, при --keep-open предупреждение W_MESH_OPEN_KEPT; неманифольдные рёбра — предупреждение W_MESH_NONMANIFOLD, ошибка E_MESH_NONMANIFOLD при --no-split; согласованность ориентации — E_MESH_ORIENT) и пары деталей: W_OVERLAP — поверхности пронзают друг друга, W_INSIDE — деталь целиком внутри другой (в плоской структуре GDML это перекрытие объёмов, полость должна быть вырезана). Касание гранью и деталь в полости чужой не считаются ошибкой; детали с открытой сеткой в проверке пересечений не участвуют.
  • Полое тело (отражатель с полостью) — стенка должна иметь толщину: внутренняя оболочка не должна касаться внешней ни рёбрами, ни вершинами. Касание по ребру даёт неманифольдную сетку (ребро у 4 граней) и предупреждение Geant4 «wrong orientation».
  • Без микро-граней: треугольники нулевой площади и T-стыки (вершина на середине чужого ребра) создают дыры при записи в Geant4; перед экспортом объединяйте близкие вершины (Merge by Distance ~1e-4 мм) и закрывайте поверхность. Конвертер убирает такие грани сам, но не всегда.
  • Имена деталей — по веществу или назначению: Crystal_LaBr3, Housing_Al6063, Reflector_PTFE, Bezel_PC, Rubber_seal, Board_FR4, Source_water — по ним назначаются вещества и роли. Иначе положите рядом materials.json или задайте вещества в окне «Сцена и вещества» (там же — плотность; её можно изменить, по умолчанию берётся из справочника).
  • Материалы в CAD/Blender: назначьте каждому объекту материал с понятным именем (Aluminium, LaBr3, Teflon) — для OBJ и .blend он читается из usemtl, когда имя детали ничего не говорит.
  • Детализация: кристалл, отражатель, окно, корпус, защита, образец — обязательно; винты, резьбы, фаски, надписи — лишние (тысячи треугольников без влияния на отклик). Разумный размер: до ~100 тыс. треугольников на сцену.
  • Единицы и ориентация: STEP и .blend — в миллиметрах из файла; для STL/OBJ единицы задаются при конвертации. Ось кристалла и передний торец определяются автоматически; если модель повёрнута иначе — задайте --front/«Ось/фронт».

Blender

Файл .blend читается самим Blender (нужна установка, blender.exe ищется в Program Files\Blender Foundation или через CAD2GDML_BLENDER): видимые mesh-объекты экспортируются в мировых координатах, имя объекта становится именем детали, материал — usemtl. Скрытые объекты и не-mesh пропускаются.

Что делает

Сшивает сетки, делит слитые файлы на тела, заделывает дыры (крышки и корпус остаются в сцене), находит кристалл и образец, ставит ось кристалла на z, распознаёт цилиндры, трубы, ступенчатые тела вращения и параллелепипеды, остальное пишет как tessellated, назначает вещества по именам и вручную.

Вещества: если рядом с моделью лежит materials.json (или <имя>.materials.json), он подхватывается сам. Для OBJ учитывается имя материала usemtl, когда по имени детали вещество не определилось. Роли (Crystal, Source, Container, Shield, Housing, Other) можно задать в окне «Сцена и вещества» или ключом --role.

GDML (вход)

Файл .gdml читается без указания единиц (единицы и углы берутся из атрибутов lunit и aunit). Поддержаны тела box, tube, polycone (полный и неполный оборот), tessellated (грани triangular и quadrangular, type="ABSOLUTE" и "RELATIVE" как в Geant4: у RELATIVE вершины 2…4 — смещения от вершины 1; четырёхугольник делится на (1,2,3) и (1,3,4); единица — unit каждой позиции в <define>, по умолчанию мм, затем множитель lunit самой грани; lunit тела не применяется (так в Geant4), не-мм на теле даёт предупреждение W_GDML_LUNIT_IGNORED; позиция разбирается при первом обращении: выражение (2*cm), константа, неизвестная единица или повтор имени пропускают только тело, которое на неё ссылается (W_GDML_SKIPPED с причиной), остальной файл читается; вершина, которой нет в <define>, — ошибка с именем), вложенные physvol с position и rotation (правило Geant4: поворот пассивный), ссылки positionref/rotationref на <define>. Остальные виды тел пропускаются с предупреждением W_GDML_SKIPPED. Мировой объём в сцену не входит. Вещества из <materials> файла: плотность и состав по массовым долям элементов переходят в сцену как свои вещества (не G4_*); вещества G4_* пишутся ссылкой по имени, плотность для окна берётся из справочника программы. Состав по числу атомов (composite n=) переводится в массовые доли через атомные массы <atom value> элементов того же файла (PETG, C10H8O4: C 0,62502, H 0,041963, O 0,33302); элементы с одной formula и разной массой (изотопы), элемент без атомной массы и смеси из смесей не поддержаны (нецелое n и fraction рядом с composite дают замечание в отчёте) (предупреждение W_GDML_MATERIAL). Температура и энергия возбуждения в выходной GDML не переносятся. Система координат файла сохраняется: ось кристалла и передний торец берутся как +z, автоопределение для GDML не применяется (--front задаёт иное явно). Проверено на трёх сценах Гамма-1С (detector 14 деталей, marinelli 43, shield 37): код 0, число объёмов равно числу physvol плюс мировой. Объём Pb_chamber_wall совпал с расчётом по размерам из файла (6620,5 см³ при 48 сегментах окружности). Тесты на GDML (число деталей, замкнутость, объём тела вращения, пересечение) и на проверку пересечений (проникновение, касание гранью, деталь в полости, зазор 0,5 мм и проникновение 0,5 мм) есть в наборе; на трёх сценах Гамма-1С предупреждений W_OVERLAP и W_INSIDE нет. Предупреждения проверки пересечений не меняют код выхода. Полигональные тела пишутся как tessellated (поликонус тоже).

STEP

Для STEP открытые детали, которые не удалось закрыть, по умолчанию остаются в сцене (как --keep-open, в отчёте стоит предупреждение). Чтобы исключить их, используйте --drop-open или галочку «Пропускать открытые детали».

Проверка на CAD-файле ATOM-2020-SIPM2 v2 (2).step (9,5 МБ): адаптер отдаёт 42 тела, после разбивки по связности 172 детали, код выхода 0, SHA GDML одинаков на двух прогонах и в окне; предупреждения: 2 грани OpenCASCADE пропустил без триангуляции, 2 детали (7175025104, 7175025104_2) остались с открытой сеткой, у одной ориентация инвертирована. Влияние этих предупреждений на транспорт частиц не проверено.

Читается внешним процессом Python 3.12 с OpenCASCADE (cadquery-ocp-novtk 8.0.1.1.0). Модуль поставляется отдельным архивом со своим Python: распакуйте его так, чтобы каталог tools лежал рядом с cad2gdml.exe; ставить Python не нужно (можно задать свой через CAD2GDML_PYTHON, версия 3.12).

Шаблон BecqMoni и кривая Geant4 (скрипты Python, scripts/)

  • python scripts/gdml2in.py сцена.gdml выход.in [--crystal ИМЯ] [--distance-cm D] [--dump] — из GDML получается шаблон .in сцинтилляционного детектора: кристалл-брусок, слои отражателя и корпуса, точечный источник на расстоянии D см (по умолчанию 10) от переднего торца. Вещества читаются из GDML и таблицы NIST; неизвестный G4_-материал вокруг кристалла — код 3. Из сцены извлекается только кристалл и два слоя оболочки: остальные тела в шаблон не входят.
  • python scripts/g4csv2lsrm.py вход.csv выход.txt — CSV Geant4 (E_keV,eps_fep,sig_fep) переводится в TSV кривой эффективности ЛСРМ (энергия, эффективность, неопределённость %); точки с неопределённостью больше 100 % отбрасываются.

Ограничения

  • Пересечения проверяются только по поверхностям сеток (W_OVERLAP, W_INSIDE); глубина проникновения и объём перекрытия не оцениваются; детали с открытой сеткой в проверке не участвуют.
  • STL: один файл — одна деталь, на тела не делится (только простые детали, см. «Подготовка модели»).
  • Открытые сетки закрываются автоматически; если не вышло, деталь остаётся открытой и в отчёте стоит предупреждение.
  • Эскиз — сечение плоскостью y=0 (вид x–z).
  • Нативный код OpenCASCADE антивирусом проверен, анализом кода — нет.

Сборка

dotnet build src/Cad2Gdml.Cli -c Release
dotnet build src/Cad2Gdml.App -c Release
dotnet build src/Cad2Gdml.Tests -c Release -o work/bin/tests && work/bin/tests/Cad2GdmlTests.exe

Нужны .NET SDK и .NET Framework 4.8.

About

CAD/mesh (STL, 3MF, OBJ, STEP) to GDML converter with section sketch and report

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages