Initial MDHelper implementation
This commit is contained in:
@@ -0,0 +1,135 @@
|
||||
# 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`。
|
||||
Reference in New Issue
Block a user