# 案例导航 案例位于 `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//benchmarks// ``` 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\\benchmarks\\pipeline.xml ``` 4. 创建可选 benchmark: ```text benchmark_.cpp ``` benchmark 只做: - 读取 PVD/VTU/CSV。 - 计算误差。 - 写报告。 - 返回成功或失败码。 ## README 建议模板 ```markdown # Case Name ## 目的 说明验证什么物理模型或数值算法。 ## 运行 ```powershell .\cmake-build-cuda13\Release\M3Frame.exe examples\...\pipeline.xml ``` ## 输出 - `outputs/.../*.pvd` - `outputs/.../*_report.csv` ## 判据 说明误差阈值或定性观察点。 ```