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

2.8 KiB
Raw Blame History

常见问题

XML 文件打不开

检查:

  • 路径是否相对 pipeline.xml 所在目录。
  • 文件名是否大小写一致。
  • 是否从项目根目录运行。

PVD 中帧数太少

检查:

  • max_steps 是否过小。
  • end_time 是否太短。
  • output_interval 是否过大。
  • 自动时间步是否提前达到终止时间。

示例:希望每 200 步输出一次,最多 5000 步:

<Control max_steps="5000" output_interval="200" />

SPH 流体像泥巴

常见原因:

  • artificial_viscosity 太大。
  • 物理黏度过大。
  • 时间步太大导致数值耗散。

建议先降低:

artificial_viscosity="0.001"
artificial_viscosity_beta="0"

SPH 粒子穿透壁面

检查:

  • 边界粒子是否至少 2 层。
  • 边界粒子间距是否和流体粒子接近。
  • boundary_id 是否和边界条件一致。
  • 壁面模型是否适合当前算例。

强冲击建议使用 adami_ghost 或 semi_analytical。

如果仍穿墙:

  • 减小时间步或 CFL。
  • 增大边界粒子层数。
  • 增大声速 speed_of_sound。
  • 增加弱排斥力,但不要过大。

液滴膨胀

若使用:

pressure_eos="rho_c0_squared"

动量方程必须使用表压 p-rho0*c0^2。当前代码已对该 EOS 做背景压扣除。

自由液滴不建议启用强 particle shifting。

推荐先用:

particle_regularization="none"
enable_xsph="true"
density_filter="delta_sph"
delta_sph_coefficient="0.005"

液滴分团簇聚集

检查:

  • 表面张力是否过大。
  • particle shifting 方向和强度是否合理。
  • 密度滤波是否过强。
  • 粒子分辨率是否太粗。

可尝试:

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 无新帧 输出间隔过大或程序提前失败。