Конвертер 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/«Ось/фронт».
Файл .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 читается без указания единиц (единицы и углы берутся из атрибутов 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 открытые детали, которые не удалось закрыть, по умолчанию остаются в сцене (как --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).
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.