Initial MDHelper implementation

This commit is contained in:
shenw
2026-05-25 17:12:00 +08:00
commit 50b15b02c7
45 changed files with 11654 additions and 0 deletions
+136
View File
@@ -0,0 +1,136 @@
# 常见问题
## XML 文件打不开
检查:
- 路径是否相对 `pipeline.xml` 所在目录。
- 文件名是否大小写一致。
- 是否从项目根目录运行。
## PVD 中帧数太少
检查:
- `max_steps` 是否过小。
- `end_time` 是否太短。
- `output_interval` 是否过大。
- 自动时间步是否提前达到终止时间。
示例:希望每 200 步输出一次,最多 5000 步:
```xml
<Control max_steps="5000" output_interval="200" />
```
## SPH 流体像泥巴
常见原因:
- `artificial_viscosity` 太大。
- 物理黏度过大。
- 时间步太大导致数值耗散。
建议先降低:
```xml
artificial_viscosity="0.001"
artificial_viscosity_beta="0"
```
## SPH 粒子穿透壁面
检查:
- 边界粒子是否至少 2 层。
- 边界粒子间距是否和流体粒子接近。
- `boundary_id` 是否和边界条件一致。
- 壁面模型是否适合当前算例。
强冲击建议使用 `adami_ghost` 或 `semi_analytical`。
如果仍穿墙:
- 减小时间步或 CFL。
- 增大边界粒子层数。
- 增大声速 `speed_of_sound`。
- 增加弱排斥力,但不要过大。
## 液滴膨胀
若使用:
```xml
pressure_eos="rho_c0_squared"
```
动量方程必须使用表压 `p-rho0*c0^2`。当前代码已对该 EOS 做背景压扣除。
自由液滴不建议启用强 particle shifting。
推荐先用:
```xml
particle_regularization="none"
enable_xsph="true"
density_filter="delta_sph"
delta_sph_coefficient="0.005"
```
## 液滴分团簇聚集
检查:
- 表面张力是否过大。
- particle shifting 方向和强度是否合理。
- 密度滤波是否过强。
- 粒子分辨率是否太粗。
可尝试:
```xml
enable_xsph="true"
xsph_epsilon="0.05"
density_filter="delta_sph"
delta_sph_coefficient="0.005"
particle_regularization="none"
```
## FEM 接触穿透
检查:
- 接触刚度是否过小。
- 时间步是否过大。
- 接触面法向是否正确。
- 主从面是否匹配。
- 是否需要接触阻尼或 augmented Lagrangian。
## ParaView 无法读取 VTU
检查:
- PointData/CellData 数组长度是否匹配。
- PVD 中相对路径是否正确。
- VTU 是否写完整。
- appended binary 是否和压缩选项兼容。
## CUDA 编译失败
检查:
- CUDA Toolkit 与 MSVC 版本兼容性。
- GPU 架构设置。
- 是否启用了 CUDA 不支持的 C++ 代码路径。
## 数值发散快速判断
观察 monitor:
| 现象 | 可能原因 |
|---|---|
| `vmax` 突然变成极大值 | 时间步过大、压力过强、接触刚度过大。 |
| `rho=[min,max]` 范围迅速扩大 | 密度计算不稳定或粒子分布失真。 |
| `fluid_bounds` 快速扩大 | 爆炸、自由面压力不平衡或 particle shifting 过强。 |
| `fluid_bounds` 快速缩小 | 粒子聚集、表面张力过强或压力吸引。 |
| PVD 无新帧 | 输出间隔过大或程序提前失败。 |