GeoWeld Prep 是面向 CAE 的焊缝识别与几何创建桌面程序。本项目只关注 T 型、对接型和搭接型焊缝的候选识别、审核、平滑焊缝面创建和共享拓扑导出;STEP 导入、预览、缓存和导出仅作为焊缝功能的基础设施。
- STEP AP203/AP214/AP242 通过 Open CASCADE XDE 导入;
- HyperMesh STEP 无损导入:组合嵌套装配实例位姿,显式读取全部形状表示和非流形拓扑,并回收未挂接到 XDE 产品标签的面、独立边和基准点;
- 预览三角化按小特征尺寸自适应;失败面会单独重试并保留边界曲线,不再静默消失。每次导入在项目
cache/import_diagnostics.json写入 STEP 实体、转换根、完整拓扑和回收数量; - 装配树、零件名称和颜色读取;
- 稳定 Part UID 与 SHA-256 几何指纹,不依赖 OCCT 临时拓扑 ID;
- 体积、面积、质心、包围盒、面数、边数和 Shape 有效性统计;
- 每个零件的 BREP 缓存;
- VTK 三维 CAD 预览、旋转/缩放/平移、拾取、隐藏、显示、孤立和透明;
- 工程化工作台界面:可停靠的 Model Browser、Properties 与 Engineering Data 面板,五阶段流程状态条、模型/候选筛选、上下文菜单以及状态感知工具栏;
- 常用快捷键:
Ctrl+F搜索模型、H隐藏、I孤立、Shift+H全部显示、F适应窗口、Ctrl+R识别并建面、Ctrl+E导出; - 前/后/左/右/顶/底/轴测视图、Fit All 和截图;
- 项目目录、SQLite 状态、Action Log、阶段快照和断点重载;
- 后台任务执行 STEP 导入、三角化和导出;大型焊缝探测与建面使用独立进程并行占用多核,GUI 主线程不执行大规模几何计算;
- 将源面与焊缝压印、分割并缝合为共享边拓扑,导出为单一完整 STEP;
- OCCT STEP 重读、配置、UID、SQLite 和完整 V0 集成测试。
- HyperMesh 2019 基础 STEP 导入验收脚本与验证记录;该验收不等同于焊缝功能完成。
- 基于扩展 AABB 粗筛和 OCP 精确距离的零件邻接分析;
- 轴对齐板类几何的 T 型、对接型和搭接型焊缝候选识别;
- 候选路径、间隙、有效长度、重叠面积、置信度和警告证据;
- 候选接受、拒绝、路径/宽度修改、两零件手工新增和 Action Log;
- T 型窄条面、对接桥接面和搭接桥接面的独立 Surface 创建;
- 焊缝面有效性、面积、短边和最小宽度检查;
- 包含源面和焊缝面的单一完整 STEP;全 Shell 输入导出为
GEOWELD_CONNECTED_TOPOLOGY,并保留面级来源名称与颜色; - 焊缝边界会先锁定两侧特征点和特征线,再压印到母面;T 型和多孔交汇以非流形共享边写入 STEP,仅在严格共享失败且几何完全重合时使用等价边保底;
- 三态可视化切换:正常显示、
SEAM全渲染且原模型半透明框线、SEAM全渲染且原模型纯框线; - HyperMesh 风格预览操作:左键选择、滚轮缩放、中键按住并绕鼠标命中位置旋转、右键按住平移;
- 候选及焊缝面 SQLite 持久化、项目重开恢复和 STEP 回读验证。
- 单击 Detect Welds 自动完成探测、全部接受、建面和焊缝高亮,不再要求逐步点击接受与创建;
- 可在预览中左键拾取焊缝并同步选择 Model Browser 的
SEAM子组件,支持工具栏、右键菜单或Delete键删除; - 焊缝组件使用
SEAM_<类型>_<连接组件A>__<连接组件B>_<UID>命名,直接保存连接关系;
程序只使用仓库内的 runtime/python/python.exe,不依赖系统 Python 或全局包。当前工作副本已经安装好便携环境。
首次重建环境:
powershell -ExecutionPolicy Bypass -File .\scripts\setup_portable.ps1 -Dev该脚本下载 Python 3.11.9 Embedded,并把 PySide6、OCP、VTK、NumPy、Pydantic、PyYAML 和测试依赖安装到 runtime/python。依赖版本在 requirements/base.txt 和 requirements/dev.txt 中锁定。
启动:
run_geoweld.cmd
焊缝并行度由 src/geoweld_prep/config/defaults.yaml 中的
weld.parallel_workers 和 weld.parallel_cpu_fraction 控制。默认工作进程数为 0,
会按可用逻辑核心数的约 2/3 自动设置(例如 24 核使用 16 核);设为 1 可强制串行,
设为其他正整数可固定工作进程上限。CPU 比例默认是 0.6667,可在 (0, 1] 范围内
调整。程序还会受实际任务数约束,并让小任务保持串行,避免进程启动和 BREP 重载开销
抵消收益。
测试:
run_tests.cmd
首次制作供 Windows x64 离线电脑使用的运行环境压缩包(体积较大):
package_runtime.cmd
每次发布制作代码更新包(不包含 runtime,体积较小):
package_code.cmd
两个成品均写入 dist。runtime 使用 .tar.gz 格式,并在包内提供逐文件
SHA256SUMS.txt;其中不含任何 ZIP(Python 标准库也会展开到 runtime/python/Lib)。
离线电脑首次部署时,可用 tar -xzf <runtime包名>.tar.gz 解压 runtime,再把 code 包
解压到 runtime 成品目录中的同一位置;以后只需解压新的 code 包并覆盖旧文件。依赖版本
发生变化时才需要重新制作和部署 runtime。若需要覆盖已有同版本成品,在命令后追加
-Force。
- 点击 New Project,选择项目父目录并输入项目名;
- 点击 Import STEP,导入
.step或.stp; - 在左侧装配树选择零件,在三维视图审核并查看右侧属性; 三维视图中左键用于选择,滚轮用于缩放,中键拖动用于绕按下位置旋转,右键拖动用于平移;
- 点击 Detect Welds;程序自动探测、接受并创建全部焊缝,然后进入原模型半透明、焊缝完整高亮的显示模式;
- 在预览中左键点击焊缝,Model Browser 会自动选中
SEAM下对应组件;使用 Delete Weld、右键 Delete weld 或Delete键移除; - 如需人工修订,仍可使用候选表中的接受、拒绝、路径修改和手工新增功能,再点击 Build Weld Surfaces 重建;
- 使用工具栏 Seam View 切换普通、焊缝聚焦和 Topology diagnostics;拓扑视图以绿色显示严格共享特征边、黄色显示等价边、洋红显示错配边,并同时显示自由边和非流形边;
- 审核底部 Issues 中的导入和焊缝质量警告;
- 点击 Export Complete STEP,将源模型与焊缝共享拓扑一起输出为
model_complete.step; - 从项目的
exports目录取得输出,并按 焊缝验收清单在 HyperMesh 中验证。
基础几何通道的验证证据见 基础几何通道验证记录。
每个用户项目均独立保存:
project_name/
├─ source/source_model.step
├─ cache/parts/*.brep
├─ cache/tessellation/
├─ cache/weld_surfaces/*.brep
├─ database/project.sqlite
├─ exports/model_complete.step
├─ logs/
├─ snapshots/
└─ project.json
源 STEP 始终保留;Working Shape、Preview Mesh 和 Export Shape 分离管理。导入或导出失败不会删除源模型,也不会把失败状态标记为成功。
examples/v0_sample.step 是可直接导入的两零件 V0 样例。可使用项目便携解释器重新生成:
.\runtime\python\python.exe .\scripts\generate_v0_sample.pyexamples/geoweld_standard_test.step 是现有基础几何回归装配,包含 15 类测试场景、23 个有名称零件,其中三类连接场景用于焊缝目标;小件、保留实体和其他几何仅作为输入/负例,不属于产品功能目标。配套的
examples/geoweld_standard_test.manifest.json 给出场景到零件名的映射。重新生成:
.\runtime\python\python.exe .\scripts\generate_standard_test_step.py也可以指定输出位置;默认会在同目录生成 .manifest.json:
.\runtime\python\python.exe .\scripts\generate_standard_test_step.py D:\temp\geoweld_test.stepexamples/geoweld_midsurface_test.step 用于模拟“外部中面抽取完成后再导入”的几何。它沿用相同的 15 类场景和 23 个零件,但所有部件均为零厚度开放 Shell 或闭合表面壳,STEP 中不包含 Solid;配套 Manifest 为
examples/geoweld_midsurface_test.manifest.json。重新生成:
.\runtime\python\python.exe .\scripts\generate_midsurface_test_step.pyexamples/geoweld_weld_scenarios.step 是专门用于焊缝识别的全 Shell 中面装配,包含简单 T 型、折弯轮廓 T 型、三角板三边 T 型、不规则多孔搭接、不等长近边搭接、圆孔穿管和圆筒鳍片七类场景。所有关键中面、边和孔隙距离记录在同名 Manifest 中。重新生成:
.\runtime\python\python.exe .\scripts\generate_weld_scenario_step.py当前只实现和验证以下闭环:导入 STEP → 分析几何邻接 → 识别 T/对接/搭接焊缝候选 → 用户审核 → 创建平滑焊缝面 → 压印并输出源面与焊缝共享拓扑的完整 STEP。
明确不考虑:小零件清理、钣金分类、中面识别/抽取、有限元网格、材料/属性、求解、HyperMesh Tcl 自动化和 Connector 后处理。
当前 W1/W2 首版优先覆盖轴对齐或接近轴对齐的板类实体/壳体。旋转板、曲面板、复杂曲线路径、多段路径和双侧搭接焊将在后续迭代扩展。自动化证据和复现命令见 W1/W2 验证记录。
命令行复现完整闭环:
.\runtime\python\python.exe .\scripts\run_weld_workflow.py --accept-all