2.3 KiB
2.3 KiB
快速开始
本章说明如何从源码编译 M3Frame,并运行一个 XML 驱动案例。
1. 编译主程序
在项目根目录执行:
cmake -S . -B cmake-build-cuda13 -DCMAKE_BUILD_TYPE=Release
cmake --build cmake-build-cuda13 --config Release --target M3Frame
成功后主程序通常位于:
cmake-build-cuda13/Release/M3Frame.exe
2. 运行一个 SPH 案例
以三维溃坝压力案例为例:
.\cmake-build-cuda13\Release\M3Frame.exe examples\sph\benchmarks\dam_break_pressure\pipeline.xml
典型输出包括:
[pipeline] GeometryStage ...
[pipeline] ParticleMeshingStage ...
[pipeline] SolverStage(sph) ...
[sph-monitor] step=...
结果一般写入案例目录下的 outputs/。
3. 运行一个后处理 benchmark
部分案例提供 benchmark_*.cpp,用于读取求解结果并和解析解对比。此类程序不应再生成几何或直接推进求解器。
示例:
cmake --build cmake-build-examples-migrated --config Debug --target benchmark_sph_oscillating_droplet
.\cmake-build-examples-migrated\Debug\benchmark_sph_oscillating_droplet.exe
4. 检查结果
常用文件:
.pvd:ParaView 时间序列入口。.vtu:单个时间步的网格或粒子结果。.csv:误差、监测量、反力、能量等时间历程。.log:命令行监测信息和求解诊断。
建议用 ParaView 打开 .pvd 文件查看随时间变化的结果。
5. 最小案例目录
新建案例时,建议从以下最小结构开始:
my_case/
pipeline.xml
config/
cad.xml
particle_meshing.xml 或 meshing.xml
sph_solver.xml 或 fem_solver.xml
outputs/
README.md
先让 pipeline.xml 只执行几何和离散,确认 outputs/ 中的 .stl/.obj/.vtu 正确;再加入求解器阶段。这样可以快速区分问题来自建模、离散还是求解。
6. 推荐调试顺序
- 打开 CAD 导出的
.stl或.obj,确认几何位置和尺寸。 - 打开粒子或网格
.vtu,确认材料 id、边界 id、粒子角色。 - 缩短计算步数,例如
max_steps="10",确认日志能正常输出。 - 打开
.pvd,检查第一帧和最后一帧是否可读。 - 再逐步增大时间、粒子数或网格数。