Initial MDHelper implementation
This commit is contained in:
@@ -0,0 +1,112 @@
|
||||
# 案例导航
|
||||
|
||||
案例位于 `examples/`。
|
||||
|
||||
## SPH
|
||||
|
||||
```text
|
||||
examples/sph/benchmarks/
|
||||
```
|
||||
|
||||
推荐阅读顺序:
|
||||
|
||||
1. `hydrostatic_tank`:静水保持,检查边界和压力。
|
||||
2. `dam_break_pressure`:三维溃坝,检查自由面和壁面。
|
||||
3. `couette_flow`:周期边界和剪切流。
|
||||
4. `poiseuille_flow`:通道流和解析速度剖面。
|
||||
5. `oscillating_droplet`:表面张力液滴。
|
||||
6. `elastic_bar_impact`:固体 SPH 冲击。
|
||||
|
||||
## FEM
|
||||
|
||||
```text
|
||||
examples/fem/
|
||||
```
|
||||
|
||||
推荐分组:
|
||||
|
||||
- patch test。
|
||||
- 梁、壳、实体基础测试。
|
||||
- 材料测试。
|
||||
- 接触测试。
|
||||
- 多孔介质测试。
|
||||
- 求解器测试。
|
||||
- 后处理测试。
|
||||
|
||||
## Geometry
|
||||
|
||||
```text
|
||||
examples/geometry/
|
||||
```
|
||||
|
||||
用于检查 CAD 建模、几何导出、网格划分和粒子划分。
|
||||
|
||||
## Benchmark 规则
|
||||
|
||||
新 benchmark 应尽量遵循:
|
||||
|
||||
- `pipeline.xml` 负责建模、离散和求解。
|
||||
- `benchmark_*.cpp` 只读取结果并对比解析解。
|
||||
- 报告写入 `outputs/*.csv`。
|
||||
- README 说明运行命令和评价指标。
|
||||
|
||||
## 新建案例步骤
|
||||
|
||||
1. 创建目录:
|
||||
|
||||
```text
|
||||
examples/<physics>/benchmarks/<case_name>/
|
||||
```
|
||||
|
||||
2. 创建配置:
|
||||
|
||||
```text
|
||||
pipeline.xml
|
||||
config/cad.xml
|
||||
config/meshing.xml 或 config/particle_meshing.xml
|
||||
config/sph_solver.xml 或 config/fem_solver.xml
|
||||
```
|
||||
|
||||
3. 运行:
|
||||
|
||||
```powershell
|
||||
.\cmake-build-cuda13\Release\M3Frame.exe examples\<physics>\benchmarks\<case_name>\pipeline.xml
|
||||
```
|
||||
|
||||
4. 创建可选 benchmark:
|
||||
|
||||
```text
|
||||
benchmark_<case_name>.cpp
|
||||
```
|
||||
|
||||
benchmark 只做:
|
||||
|
||||
- 读取 PVD/VTU/CSV。
|
||||
- 计算误差。
|
||||
- 写报告。
|
||||
- 返回成功或失败码。
|
||||
|
||||
## README 建议模板
|
||||
|
||||
```markdown
|
||||
# Case Name
|
||||
|
||||
## 目的
|
||||
|
||||
说明验证什么物理模型或数值算法。
|
||||
|
||||
## 运行
|
||||
|
||||
```powershell
|
||||
.\cmake-build-cuda13\Release\M3Frame.exe examples\...\pipeline.xml
|
||||
```
|
||||
|
||||
## 输出
|
||||
|
||||
- `outputs/.../*.pvd`
|
||||
- `outputs/.../*_report.csv`
|
||||
|
||||
## 判据
|
||||
|
||||
说明误差阈值或定性观察点。
|
||||
```
|
||||
Reference in New Issue
Block a user