Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

GeoWeld Prep

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。

使用流程

  1. 点击 New Project,选择项目父目录并输入项目名;
  2. 点击 Import STEP,导入 .step 或 .stp;
  3. 在左侧装配树选择零件,在三维视图审核并查看右侧属性; 三维视图中左键用于选择,滚轮用于缩放,中键拖动用于绕按下位置旋转,右键拖动用于平移;
  4. 点击 Detect Welds;程序自动探测、接受并创建全部焊缝,然后进入原模型半透明、焊缝完整高亮的显示模式;
  5. 在预览中左键点击焊缝,Model Browser 会自动选中 SEAM 下对应组件;使用 Delete Weld、右键 Delete weld 或 Delete 键移除;
  6. 如需人工修订,仍可使用候选表中的接受、拒绝、路径修改和手工新增功能,再点击 Build Weld Surfaces 重建;
  7. 使用工具栏 Seam View 切换普通、焊缝聚焦和 Topology diagnostics;拓扑视图以绿色显示严格共享特征边、黄色显示等价边、洋红显示错配边,并同时显示自由边和非流形边;
  8. 审核底部 Issues 中的导入和焊缝质量警告;
  9. 点击 Export Complete STEP,将源模型与焊缝共享拓扑一起输出为 model_complete.step;
  10. 从项目的 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.py

examples/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.step

examples/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.py

examples/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

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages