Files
MDHelper/docs/troubleshooting.md
T
2026-05-25 17:12:00 +08:00

137 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 常见问题
## 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 无新帧 | 输出间隔过大或程序提前失败。 |