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

136 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Pipeline 流程
`pipeline.xml` 是推荐的案例入口,用于顺序调度几何、离散、材料、求解、耦合和后处理。
## 最小结构
```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>
```
该例子会按顺序执行:
```text
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` 的路径:
```xml
<Stage kind="geometry" path="config/cad.xml" />
```
阶段配置文件内部的输出路径推荐写完整项目相对路径:
```xml
<Export path="examples/sph/benchmarks/case/outputs/cad/model.stl" />
```
这样从项目根目录运行最稳定。
## Meshing 阶段
普通 FEM 网格:
```xml
<Stage kind="meshing" mesh_type="volume" path="config/meshing.xml" />
```
SPH 粒子划分:
```xml
<Stage kind="meshing" mesh_type="particle" path="config/particle_meshing.xml" />
```
## Solver 阶段
SPH:
```xml
<Stage kind="solver" solver="sph" path="config/sph_solver.xml" />
```
FEM:
```xml
<Stage kind="solver" solver="fem" path="config/fem_solver.xml" />
```
## 后处理阶段
拆分 SPH 水体/壁面粒子:
```xml
<Stage kind="post" post="sph_post" path="config/post_split_particles.xml" />
```
FEM 后处理:
```xml
<Stage kind="post" post="fem_post" path="config/post.xml" />
```
后处理配置文件应只定义后处理任务,不再重复求解器参数。
## 推荐案例模板
SPH 案例:
```text
case/
pipeline.xml
config/
cad.xml
particle_meshing.xml
sph_solver.xml
outputs/
cad/
particles/
sph/
```
FEM 案例:
```text
case/
pipeline.xml
config/
cad.xml
meshing.xml
fem_solver.xml
outputs/
cad/
mesh/
fem/
```
## 设计原则
- Pipeline 只调度,不重复定义 FEM/SPH 内部概念。
- 边界条件、材料、单元、粒子模型仍在对应模块的标准配置文件中定义。
- benchmark 程序只做结果检查,不再替代 pipeline。
更完整标准见 `pipeline/pipeline.md`。