Files
MDHelper/docs/pipeline.md
T
2026-05-25 17:12:00 +08:00

2.8 KiB
Raw Blame History

Pipeline 流程

pipeline.xml 是推荐的案例入口,用于顺序调度几何、离散、材料、求解、耦合和后处理。

最小结构

<?xml version="1.0" encoding="UTF-8"?>
<M3FramePipeline version="1.0" name="case_name" continue_on_failure="false">
  <Stages>
    <Stage kind="geometry" name="cad" path="config/cad.xml" />
    <Stage kind="meshing" mesh_type="particle" name="particle_meshing" path="config/particle_meshing.xml" />
    <Stage kind="solver" solver="sph" name="sph_solver" path="config/sph_solver.xml" />
  </Stages>
</M3FramePipeline>

该例子会按顺序执行:

cad.xml -> particle_meshing.xml -> sph_solver.xml

如果任何阶段失败,continue_on_failure="false" 会立即停止。工程计算建议保持该设置。

Stage 类型

kind 说明
geometry 调用 CAD 建模和几何导出。
meshing 调用 FEM 网格划分或 SPH 粒子划分。
material 读取材料库。
solver 运行 FEM 或 SPH 求解器。
coupling 运行 FEM-SPH 或其他耦合交换。
post / output 运行后处理和结果拆分。

路径解析

Stage path 推荐写成相对 pipeline.xml 的路径:

<Stage kind="geometry" path="config/cad.xml" />

阶段配置文件内部的输出路径推荐写完整项目相对路径:

<Export path="examples/sph/benchmarks/case/outputs/cad/model.stl" />

这样从项目根目录运行最稳定。

Meshing 阶段

普通 FEM 网格:

<Stage kind="meshing" mesh_type="volume" path="config/meshing.xml" />

SPH 粒子划分:

<Stage kind="meshing" mesh_type="particle" path="config/particle_meshing.xml" />

Solver 阶段

SPH:

<Stage kind="solver" solver="sph" path="config/sph_solver.xml" />

FEM:

<Stage kind="solver" solver="fem" path="config/fem_solver.xml" />

后处理阶段

拆分 SPH 水体/壁面粒子:

<Stage kind="post" post="sph_post" path="config/post_split_particles.xml" />

FEM 后处理:

<Stage kind="post" post="fem_post" path="config/post.xml" />

后处理配置文件应只定义后处理任务,不再重复求解器参数。

推荐案例模板

SPH 案例:

case/
  pipeline.xml
  config/
    cad.xml
    particle_meshing.xml
    sph_solver.xml
  outputs/
    cad/
    particles/
    sph/

FEM 案例:

case/
  pipeline.xml
  config/
    cad.xml
    meshing.xml
    fem_solver.xml
  outputs/
    cad/
    mesh/
    fem/

设计原则

  • Pipeline 只调度,不重复定义 FEM/SPH 内部概念。
  • 边界条件、材料、单元、粒子模型仍在对应模块的标准配置文件中定义。
  • benchmark 程序只做结果检查,不再替代 pipeline。

更完整标准见 pipeline/pipeline.md。