1694 lines
74 KiB
Markdown
1694 lines
74 KiB
Markdown
# SPH 手册
|
||
|
||
本文档分为两部分:
|
||
|
||
1. **求解器用户手册**:说明如何组织案例、编写 `pipeline.xml`、`particle_meshing.xml`、`sph_solver.xml`,以及如何设置材料、边界、输出和常用稳定化参数。
|
||
2. **理论手册**:说明 M3Frame 当前 SPH 模块背后的主要离散思想、核函数、密度和压力更新、边界处理、表面张力、多相流、固体 SPH 和稳定性机制。
|
||
|
||
SPH 模块的主要公共入口如下:
|
||
|
||
- `sph/sph_solver_config.h`:SPH 配置数据模型和读取入口。
|
||
- `sph/sph_solver_pipeline.h`:`SPHSimulationPipeline::build/execute/execute_config(...)`。
|
||
- `sph/sph_solver_keywords.h`:标准配置关键词常量。
|
||
- `sph/sph_discretization.h`:粒子状态、时间推进和整体离散流程。
|
||
- `sph/fluid_wcsph.h`:WCSPH 流体动量方程、压力项、黏性、表面张力和壁面相互作用。
|
||
- `sph/fluid_isph.h`:ISPH/PPE 压力投影相关功能。
|
||
- `sph/boundary_condition.h`、`sph/boundary_region.h`:边界条件、边界区域和壁面模型。
|
||
- `sph/sph_post.h`:SPH 后处理,例如流体粒子和壁面粒子拆分输出。
|
||
|
||
---
|
||
|
||
# 第一部分:求解器用户手册
|
||
|
||
## 1. 案例目录结构
|
||
|
||
推荐新案例使用下面的目录结构:
|
||
|
||
```text
|
||
case/
|
||
pipeline.xml
|
||
config/
|
||
cad.xml
|
||
particle_meshing.xml
|
||
materials.xml
|
||
sph_solver.xml
|
||
post_split_particles.xml
|
||
outputs/
|
||
```
|
||
|
||
历史 benchmark 中仍可能使用 `data/` 目录,例如:
|
||
|
||
```text
|
||
examples/sph/benchmarks/hydrostatic_tank/
|
||
pipeline.xml
|
||
data/
|
||
cad.xml
|
||
particle_meshing.xml
|
||
sph_solver.xml
|
||
outputs/
|
||
```
|
||
|
||
`data/` 和 `config/` 功能上等价;新文档和新案例建议优先使用 `config/`。
|
||
|
||
## 2. 通过 pipeline 运行 SPH 案例
|
||
|
||
典型 `pipeline.xml`:
|
||
|
||
```xml
|
||
<M3FramePipeline version="1.0" name="sph_case">
|
||
<Stages>
|
||
<Stage kind="geometry" path="config/cad.xml" />
|
||
<Stage kind="meshing" mesh_type="particle" path="config/particle_meshing.xml" />
|
||
<Stage kind="solver" solver="sph" path="config/sph_solver.xml" />
|
||
<Stage kind="post" post="sph_post" path="config/post_split_particles.xml" />
|
||
</Stages>
|
||
</M3FramePipeline>
|
||
```
|
||
|
||
运行:
|
||
|
||
```powershell
|
||
.\M3Frame.exe path\to\case\pipeline.xml
|
||
```
|
||
|
||
调试时也可以直接运行 SPH 求解器配置:
|
||
|
||
```powershell
|
||
.\M3Frame.exe path\to\case\config\sph_solver.xml
|
||
```
|
||
|
||
## 3. 最小 SPH 求解器配置
|
||
|
||
```xml
|
||
<SPHSimulation>
|
||
<Input particles="config/particles.vtu" />
|
||
|
||
<Domain
|
||
min_x="0" min_y="0" min_z="0"
|
||
max_x="1" max_y="1" max_z="1" />
|
||
|
||
<Solver
|
||
method="wcsph"
|
||
kernel="cubic_spline"
|
||
smoothing_length="0.012"
|
||
cutoff_radius="0.0264"
|
||
time_step="1.0e-5"
|
||
steps="1000"
|
||
output_interval="100"
|
||
integration="euler" />
|
||
|
||
<MaterialMap>
|
||
<Material particle_material="7" library_key="water.newtonian" />
|
||
</MaterialMap>
|
||
|
||
<InitialCondition
|
||
body_force_x="0"
|
||
body_force_y="-9.81"
|
||
body_force_z="0" />
|
||
|
||
<Boundary
|
||
id="2"
|
||
type="simple_dynamic_wall"
|
||
pressure_floor="0.0"
|
||
impenetrability="on"
|
||
impenetrability_tolerance="0.002"
|
||
impenetrability_velocity_damping="0.8" />
|
||
|
||
<Output
|
||
directory="outputs/sph"
|
||
basename="case"
|
||
format="vtu"
|
||
pvd="on" />
|
||
</SPHSimulation>
|
||
```
|
||
|
||
## 4. XML 命名规则
|
||
|
||
关键词使用小写加下划线,例如:
|
||
|
||
- `surface_tension_model`
|
||
- `density_sum_frequency`
|
||
- `gradient_correction`
|
||
- `impenetrability_velocity_damping`
|
||
|
||
布尔值建议使用:
|
||
|
||
- `on`
|
||
- `off`
|
||
|
||
部分历史配置也兼容 `true/false`,但新案例建议统一使用 `on/off`。
|
||
|
||
## 5. Solver 与 Boundary 的职责划分
|
||
|
||
`<Solver>` 只放求解器、时间积分、核函数、黏性、状态方程、周期边界、输出频率等全局求解参数。
|
||
|
||
`<Boundary>` 只放边界类型、壁面模型、壁面速度、压力地板、排斥力、不可穿透修正、半解析边界积分和 ISPH 壁面 PPE 条件。
|
||
|
||
边界相关关键词不允许继续写在 `<Solver>` 下。旧关键词也不再兼容。
|
||
|
||
| 旧关键词 | 新关键词 | 所属节点 |
|
||
| --- | --- | --- |
|
||
| `boundary_pressure_floor` | `pressure_floor` | `Boundary` |
|
||
| `coupled_boundary_repulsion` | `repulsion_coefficient` | `Boundary` |
|
||
| `coupled_boundary_repulsion_distance` | `repulsion_distance` | `Boundary` |
|
||
| `wall_impenetrability` | `impenetrability` | `Boundary` |
|
||
| `wall_impenetrability_tolerance` | `impenetrability_tolerance` | `Boundary` |
|
||
| `wall_impenetrability_velocity_damping` | `impenetrability_velocity_damping` | `Boundary` |
|
||
|
||
## 6. 粒子划分与材料编号
|
||
|
||
粒子通常由 `particle_meshing.xml` 生成。粒子文件中的 `material` 字段表示粒子材料编号。
|
||
|
||
例如 `particle_meshing.xml` 中:
|
||
|
||
```xml
|
||
<ParticleRegion name="water" material="7" spacing="0.01" />
|
||
```
|
||
|
||
表示生成的水粒子带有 `material=7`。
|
||
|
||
`sph_solver.xml` 中:
|
||
|
||
```xml
|
||
<MaterialMap>
|
||
<Material particle_material="7" library_key="water.newtonian" />
|
||
</MaterialMap>
|
||
```
|
||
|
||
这里的 `particle_material="7"` 指的是从粒子文件读入的材料编号。它与内置材料库中的 XML `Material id="7"` 不是同一个语义层级。
|
||
|
||
建议理解为:
|
||
|
||
- `particle_meshing.xml` 的 `material="7"`:写入粒子的材料标签。
|
||
- `sph_solver.xml` 的 `particle_material="7"`:选择粒子标签为 7 的那一组粒子。
|
||
- `library_key="water.newtonian"`:真正从材料库读取的材料模型。
|
||
|
||
## 7. 粒子 offset
|
||
|
||
粒子划分支持 `offset`,用于避免流体粒子与壁面粒子重叠。
|
||
|
||
```xml
|
||
<ParticleRegion
|
||
name="fluid"
|
||
spacing="0.01"
|
||
offset="0.5 0.5 0.5" />
|
||
```
|
||
|
||
`offset="0.5 0.5 0.5"` 表示沿 x、y、z 方向分别偏移 `0.5 * spacing`。
|
||
|
||
通道流、静水箱、溃坝等含有多层壁面粒子的案例,建议显式检查流体区域和壁面区域的 offset,避免最外层流体粒子与最内层壁面粒子坐标重合。
|
||
|
||
## 8. Solver 常用关键词
|
||
|
||
### 基本时间控制
|
||
|
||
| 关键词 | 含义 |
|
||
| --- | --- |
|
||
| `method` | 求解方法,例如 `wcsph`、`isph`、`solid_sph`。 |
|
||
| `time_step` | 固定时间步长。 |
|
||
| `steps` | 总步数。 |
|
||
| `output_interval` | 输出间隔。 |
|
||
| `integration` | 时间积分方法,例如 `euler`、`velocity_verlet`、`predictor_corrector`。 |
|
||
|
||
### 核函数和邻域
|
||
|
||
| 关键词 | 含义 |
|
||
| --- | --- |
|
||
| `kernel` | 核函数类型,例如 `cubic_spline`。 |
|
||
| `smoothing_length` | 光滑长度。 |
|
||
| `cutoff_radius` | 截断半径。 |
|
||
| `neighbor_search` | 邻域搜索方式。周期边界通常不需要手动设为 `periodic`,代码会根据 `periodic_x/y/z` 和 `Domain` 选择周期 ghost 邻域。 |
|
||
|
||
### 体力
|
||
|
||
体力可在 `<InitialCondition>` 中设置:
|
||
|
||
```xml
|
||
<InitialCondition
|
||
body_force_x="0"
|
||
body_force_y="-9.81"
|
||
body_force_z="0" />
|
||
```
|
||
|
||
Poiseuille 通道流中可令体力沿流向:
|
||
|
||
```xml
|
||
<InitialCondition
|
||
body_force_x="9.81"
|
||
body_force_y="0"
|
||
body_force_z="0" />
|
||
```
|
||
|
||
## 9. 密度更新
|
||
|
||
SPH 流体密度始终通过连续性方程更新。`enable_density_sum` 不是密度更新开关,而是额外的密度求和重初始化开关。
|
||
|
||
| 关键词 | 默认值 | 含义 |
|
||
| --- | --- | --- |
|
||
| `enable_density_sum` | `off` | 是否额外启用密度求和修正;连续性方程仍然每步更新密度,该选项只用于周期性重初始化和降低长期密度漂移。 |
|
||
| `density_sum_frequency` | `10` | 启用密度求和后,每隔多少步执行一次。 |
|
||
|
||
示例:
|
||
|
||
```xml
|
||
<Solver
|
||
enable_density_sum="on"
|
||
density_sum_frequency="10" />
|
||
```
|
||
|
||
静水箱和长时间自由面计算中,密度漂移会逐渐放大,建议启用密度求和重初始化,但不宜每步执行得过强。
|
||
|
||
## 10. 压力与状态方程
|
||
|
||
常用状态方程包括:
|
||
|
||
| 名称 | 适用场景 |
|
||
| --- | --- |
|
||
| `linear` | 简单弱可压缩问题。 |
|
||
| `tait` | 水体自由面和溃坝类 WCSPH。 |
|
||
| `ideal_gas` | 气体或教学算例。 |
|
||
| `mie_gruneisen` | 冲击、高压或固体动力学。 |
|
||
| `tillotson` | 高速冲击或极端状态。 |
|
||
|
||
弱可压 SPH 通常用人工声速 `c0` 控制密度压缩率。`c0` 太低会导致压力响应迟缓和密度波动;太高会导致时间步要求更严格。
|
||
|
||
## 11. Riemann-SPH
|
||
|
||
Riemann-SPH 用于改善强间断、界面和高速流动中的压力振荡。常见设置:
|
||
|
||
```xml
|
||
<Solver riemann_solver="riemann_rusanov" />
|
||
```
|
||
|
||
多相流可启用相间 Riemann 处理:
|
||
|
||
```xml
|
||
<Solver
|
||
multiphase_interphase_riemann="on"
|
||
multiphase_riemann_dissipation="0.1" />
|
||
```
|
||
|
||
## 12. 黏性模型
|
||
|
||
### 人工黏性
|
||
|
||
```xml
|
||
<Solver
|
||
artificial_viscosity="0.01"
|
||
artificial_viscosity_beta="0.0" />
|
||
```
|
||
|
||
人工黏性主要用于数值稳定。若数值看起来像泥浆,通常是 `artificial_viscosity` 或物理黏性过大。
|
||
|
||
### 物理黏性
|
||
|
||
支持 Morris/Laminar 黏性、Lo-Shao 黏性离散、可变黏度和多材料黏性平均。
|
||
|
||
示例:
|
||
|
||
```xml
|
||
<Solver
|
||
physical_viscosity="morris"
|
||
dynamic_viscosity="0.001" />
|
||
```
|
||
|
||
### 非牛顿流体
|
||
|
||
工业常见非牛顿模型包括:
|
||
|
||
- Bingham
|
||
- Herschel-Bulkley
|
||
- Carreau
|
||
- 剪切变稀
|
||
- 剪切增稠
|
||
- 屈服应力流体
|
||
|
||
非牛顿模型会根据局部剪切率更新等效黏度,并可通过最小/最大黏度限制避免数值奇异。
|
||
|
||
## 13. 表面张力
|
||
|
||
常用模型:
|
||
|
||
| 模型 | 配置值 | 说明 |
|
||
| --- | --- | --- |
|
||
| CSF | `surface_tension_model="csf"` | 基于颜色梯度、曲率和连续表面力。 |
|
||
| 成对 cohesion | `surface_tension_model="pairwise_cohesion"` | 成对守恒内聚力,适合液滴类案例。 |
|
||
| cohesion + adhesion | `surface_tension_model="pairwise_cohesion_adhesion"` | 在 cohesion 基础上加入壁面附着。 |
|
||
|
||
参数含义:
|
||
|
||
| 关键词 | 含义 |
|
||
| --- | --- |
|
||
| `surface_tension` | 物理表面张力系数,通常单位为 N/m。 |
|
||
| `surface_tension_cohesion` | pairwise cohesion 模型的数值内聚强度系数。 |
|
||
| `surface_tension_adhesion` | 壁面附着强度。 |
|
||
| `surface_tension_pair_equilibrium` | 成对力平衡距离参数。 |
|
||
| `surface_tension_acceleration_limit` | 表面张力加速度限幅。 |
|
||
|
||
`surface_tension` 与 `surface_tension_cohesion` 不是同一个量。前者是物理系数,后者是 pairwise 模型中的数值缩放系数。选择 `pairwise_cohesion` 时,`surface_tension` 仍提供物理强度基准,`surface_tension_cohesion` 控制成对力离散强度。
|
||
|
||
液滴振荡案例建议:
|
||
|
||
```xml
|
||
<Solver
|
||
surface_tension_model="pairwise_cohesion"
|
||
surface_tension="0.072"
|
||
surface_tension_cohesion="1.0"
|
||
xsph_epsilon="0.05" />
|
||
```
|
||
|
||
## 14. 周期边界
|
||
|
||
周期边界适用于通道流、Couette flow、Taylor-Green vortex 等。
|
||
|
||
```xml
|
||
<Domain
|
||
min_x="0" min_y="0" min_z="0"
|
||
max_x="1" max_y="0.1" max_z="0.1" />
|
||
|
||
<Solver
|
||
periodic_x="on"
|
||
periodic_z="on" />
|
||
```
|
||
|
||
使用周期边界时必须给出有效 `Domain`。周期方向上的邻域搜索会构造 ghost view,避免粒子在周期边界附近丢失邻居。
|
||
|
||
## 15. Boundary 配置
|
||
|
||
### 基本壁面
|
||
|
||
```xml
|
||
<Boundary
|
||
id="2"
|
||
type="simple_dynamic_wall"
|
||
velocity_x="0"
|
||
velocity_y="0"
|
||
velocity_z="0"
|
||
pressure_floor="0.0"
|
||
impenetrability="on"
|
||
impenetrability_tolerance="0.002"
|
||
impenetrability_velocity_damping="0.8" />
|
||
```
|
||
|
||
常用边界类型:
|
||
|
||
| 类型 | 说明 |
|
||
| --- | --- |
|
||
| `wall_no_slip` | 传统无滑移壁面。 |
|
||
| `wall_free_slip` | 自由滑移壁面。 |
|
||
| `simple_dynamic_wall` | 边界粒子参与密度、压力和温度更新,但位置保持边界约束。 |
|
||
| `adami_ghost` | Adami ghost 边界外推。 |
|
||
| `coupled_dynamics_solid_wall` | 耦合动力学固体壁面。 |
|
||
| `inlet_velocity` | 速度入口。 |
|
||
| `outlet_pressure` | 压力出口。 |
|
||
| `inlet_buffer` | 入口缓冲区。 |
|
||
| `outlet_buffer` | 出口缓冲区。 |
|
||
| `periodic` | 周期边界区域。 |
|
||
|
||
### 壁面模型
|
||
|
||
推荐使用更清晰的层级:边界类型由 `type` 表示,壁面外推或积分模型由 `wall_model` 表示。
|
||
|
||
```xml
|
||
<Boundary
|
||
id="2"
|
||
type="wall_no_slip"
|
||
wall_model="adami_ghost" />
|
||
```
|
||
|
||
`Solver` 中不再重复定义 `wall_treatment` 或 `wall_model`。
|
||
|
||
### 边界稳定化参数
|
||
|
||
| 关键词 | 含义 |
|
||
| --- | --- |
|
||
| `pressure_floor` | 边界压力下限,避免壁面外推出现过大负压。 |
|
||
| `repulsion_coefficient` | 近壁弱排斥力系数,`0.0` 表示关闭。 |
|
||
| `repulsion_distance` | 排斥力作用距离。 |
|
||
| `impenetrability` | 是否启用几何不可穿透修正。 |
|
||
| `impenetrability_tolerance` | 允许穿透容差。 |
|
||
| `impenetrability_velocity_damping` | 穿透修正后的法向速度阻尼。 |
|
||
|
||
`repulsion_*` 和 `impenetrability_*` 不冲突,但物理作用阶段不同:
|
||
|
||
- `repulsion_*`:动量方程受力阶段的预防性近壁排斥。
|
||
- `impenetrability_*`:时间积分后的位置/速度几何纠正。
|
||
|
||
静水箱优先建议使用 `simple_dynamic_wall + impenetrability`,排斥力设为 0 或很小。
|
||
|
||
## 16. Adami ghost 边界
|
||
|
||
Adami ghost 壁面会根据邻近流体粒子外推壁面虚粒子的密度、压力和速度。适合 Couette flow、Poiseuille flow、静水箱等需要较稳定壁面压力的场景。
|
||
|
||
典型设置:
|
||
|
||
```xml
|
||
<Boundary
|
||
id="2"
|
||
type="wall_no_slip"
|
||
wall_model="adami_ghost"
|
||
velocity_x="0"
|
||
velocity_y="0"
|
||
velocity_z="0"
|
||
pressure_floor="0.0" />
|
||
```
|
||
|
||
移动壁面:
|
||
|
||
```xml
|
||
<Boundary
|
||
id="3"
|
||
type="wall_no_slip"
|
||
wall_model="adami_ghost"
|
||
velocity_x="0.1"
|
||
velocity_y="0"
|
||
velocity_z="0" />
|
||
```
|
||
|
||
## 17. 半解析壁面积分
|
||
|
||
半解析壁面积分用于更高保真的三角面片或曲面边界:
|
||
|
||
```xml
|
||
<Boundary
|
||
id="2"
|
||
type="wall_no_slip"
|
||
wall_model="semi_analytical"
|
||
boundary_geometry_integral="on"
|
||
boundary_missing_kernel_correction="on"
|
||
boundary_corner_stabilization="on"
|
||
boundary_integral_area_scale="1.0"
|
||
boundary_integral_min_partition="0.05" />
|
||
```
|
||
|
||
相关能力包括:
|
||
|
||
- 三角面片边界积分。
|
||
- 曲面边界积分近似。
|
||
- 边界缺失核修正。
|
||
- 角点和棱边稳定处理。
|
||
- 移动刚体边界一致动量交换。
|
||
|
||
## 18. ISPH 与 PPE 设置
|
||
|
||
ISPH 压力泊松方程相关配置包括:
|
||
|
||
```xml
|
||
<Solver
|
||
method="isph"
|
||
isph_pressure_solver="bicgstab"
|
||
isph_pressure_tolerance="1.0e-6"
|
||
isph_pressure_max_iterations="200" />
|
||
```
|
||
|
||
固壁 Neumann 和弱式边界积分应放在 `<Boundary>` 中:
|
||
|
||
```xml
|
||
<Boundary
|
||
id="2"
|
||
type="wall_no_slip"
|
||
isph_wall_neumann="on"
|
||
isph_wall_weak_boundary_integral="on"
|
||
isph_wall_boundary_integral_scale="1.0" />
|
||
```
|
||
|
||
PPE 可结合压力参考点、奇异性诊断、Jacobi/Gauss-Seidel/CG/BiCGSTAB 和预条件器使用。
|
||
|
||
## 19. 开放边界与 buffer zone
|
||
|
||
开放边界粒子管理包括:
|
||
|
||
| 关键词 | 含义 |
|
||
| --- | --- |
|
||
| `open_boundary_particle_management` | 是否启用开放边界粒子管理。 |
|
||
| `open_boundary_spacing` | buffer 粒子间距。 |
|
||
| `open_boundary_injection_density` | 入口补粒子密度。 |
|
||
| `open_boundary_injection_material` | 入口补粒子材料编号。 |
|
||
| `open_boundary_delete_outlet_particles` | 是否删除出口粒子。 |
|
||
| `open_boundary_recycle_particles` | 是否循环复用粒子。 |
|
||
| `open_boundary_reset_buffer_particles` | 是否重置 buffer 区粒子。 |
|
||
| `open_boundary_non_reflecting_outlet` | 是否启用非反射出口。 |
|
||
| `open_boundary_nscbc_relaxation` | NSCBC 松弛强度。 |
|
||
| `open_boundary_nscbc_probe_distance` | NSCBC 探针距离。 |
|
||
|
||
## 20. 多相流设置
|
||
|
||
多相流支持:
|
||
|
||
- phase/color 标记。
|
||
- 大密度比稳定化。
|
||
- 界面张力模型。
|
||
- drag force。
|
||
- mixture model。
|
||
- 气液、液固、颗粒流耦合框架。
|
||
- conservative volume fraction 演化。
|
||
- 压力振荡抑制。
|
||
- 相间 Riemann solver。
|
||
|
||
典型关键词:
|
||
|
||
```xml
|
||
<Solver
|
||
multiphase_interphase_riemann="on"
|
||
multiphase_riemann_dissipation="0.1" />
|
||
```
|
||
|
||
## 21. 湍流模型
|
||
|
||
支持:
|
||
|
||
- SPS turbulence。
|
||
- Smagorinsky LES。
|
||
- 湍流黏性输出控制。
|
||
|
||
```xml
|
||
<Solver
|
||
turbulence_model="smagorinsky"
|
||
smagorinsky_constant="0.12"
|
||
output_turbulent_viscosity="on" />
|
||
```
|
||
|
||
## 22. 固体 SPH 与断裂
|
||
|
||
固体 SPH 支持:
|
||
|
||
- 大变形运动学。
|
||
- 变形梯度 `F`。
|
||
- 应变率。
|
||
- 旋转率。
|
||
- Jaumann/Green-Naghdi 客观应力率历史量。
|
||
- 初始邻接拓扑 bond list。
|
||
- bond damage。
|
||
- 拉伸/剪切断裂准则。
|
||
- 裂纹面法向。
|
||
- 碎片识别。
|
||
|
||
示例关键词:
|
||
|
||
```xml
|
||
<Solver
|
||
method="solid_sph"
|
||
solid_identify_fragments="on" />
|
||
```
|
||
|
||
## 23. 自适应与多分辨率
|
||
|
||
支持:
|
||
|
||
- particle split/merge。
|
||
- 自适应 smoothing length。
|
||
- 多分辨率过渡区核修正。
|
||
- 质量守恒重采样。
|
||
- 物理量保守投影。
|
||
|
||
示例:
|
||
|
||
```xml
|
||
<Solver
|
||
enable_multiresolution_correction="on"
|
||
multiresolution_h_ratio_threshold="1.3"
|
||
multiresolution_kernel_correction="on"
|
||
multiresolution_mass_redistribution="on"
|
||
multiresolution_conservative_projection="on"
|
||
multiresolution_projection_strength="0.5"
|
||
multiresolution_resampling_iterations="2" />
|
||
```
|
||
|
||
## 24. 梯度修正与粒子正则化
|
||
|
||
常用选项:
|
||
|
||
```xml
|
||
<Solver
|
||
gradient_correction="linear"
|
||
xsph_epsilon="0.05" />
|
||
```
|
||
|
||
梯度修正用于恢复一阶一致性。对于壁面附近的粒子,边界粒子也应参与修正矩阵构造,否则壁面附近压力和速度梯度会失真。
|
||
|
||
## 25. GPU 与并行
|
||
|
||
SPH 包含 CUDA resident 求解路径的框架。相关关键词:
|
||
|
||
```xml
|
||
<Solver enable_cuda_solver_path="on" />
|
||
```
|
||
|
||
当前 CPU 路径仍是最完整、最稳妥的功能路径。CUDA 路径适合大粒子数和显式流体计算,使用前应通过 benchmark 对比 CPU/GPU 的粒子位置、密度、压力和总能量误差。
|
||
|
||
## 26. 输出与后处理
|
||
|
||
常规输出:
|
||
|
||
```xml
|
||
<Output
|
||
directory="outputs/sph"
|
||
basename="case"
|
||
format="vtu"
|
||
pvd="on" />
|
||
```
|
||
|
||
将流体和壁面分离输出:
|
||
|
||
```xml
|
||
<SPHPost>
|
||
<SplitParticles
|
||
input="outputs/sph/case.pvd"
|
||
output_directory="outputs/split"
|
||
by="role" />
|
||
</SPHPost>
|
||
```
|
||
|
||
后处理 pipeline:
|
||
|
||
```xml
|
||
<M3FramePipeline version="1.0" name="sph_post">
|
||
<Stages>
|
||
<Stage kind="post" post="sph_post" path="data/post_split_particles.xml" />
|
||
</Stages>
|
||
</M3FramePipeline>
|
||
```
|
||
|
||
## 27. 监控与 log
|
||
|
||
长时间 SPH 计算建议输出:
|
||
|
||
- step。
|
||
- physical time。
|
||
- 粒子数。
|
||
- 最大速度。
|
||
- 最大加速度。
|
||
- 密度最小值/最大值。
|
||
- 压力最小值/最大值。
|
||
- 边界穿透量。
|
||
- 总质量。
|
||
- 动能、势能、表面能。
|
||
|
||
监控信息应同时打印到命令行窗口并写入 log 文件,方便判断粒子飞散、压力爆炸或边界失稳发生在哪一步。
|
||
|
||
## 28. 常见案例设置
|
||
|
||
### 静水箱
|
||
|
||
推荐:
|
||
|
||
- 使用 `simple_dynamic_wall` 或完整 `adami_ghost`。
|
||
- 边界粒子至少 2 到 3 层。
|
||
- 流体粒子和壁面粒子不能重叠。
|
||
- 启用 `impenetrability`。
|
||
- `repulsion_coefficient` 设为 0 或很小。
|
||
- 启用 `gradient_correction`。
|
||
- 适度启用 `enable_density_sum`。
|
||
- 时间步要保守。
|
||
|
||
### 溃坝
|
||
|
||
推荐:
|
||
|
||
- 使用 Tait EOS。
|
||
- 使用标准 Monaghan 人工黏性,但 alpha 不宜过大。
|
||
- 边界使用多层动态壁面粒子。
|
||
- 输出水体和壁面分离文件,便于可视化。
|
||
|
||
### Poiseuille flow
|
||
|
||
推荐:
|
||
|
||
- 流向使用周期边界。
|
||
- 展向可使用周期边界。
|
||
- 体力沿流向。
|
||
- 上下壁面使用 `adami_ghost` 或 `simple_dynamic_wall`。
|
||
- 主要依赖物理黏性,人工黏性很小。
|
||
- benchmark 从结果文件读入速度剖面并与解析解比较。
|
||
|
||
### Couette flow
|
||
|
||
推荐:
|
||
|
||
- x/z 方向周期。
|
||
- 上壁面给定切向速度。
|
||
- 下壁面固定。
|
||
- 上下壁面使用 2 层或更多边界粒子。
|
||
- 避免流体粒子与壁面粒子重叠。
|
||
|
||
### 液滴振荡
|
||
|
||
推荐:
|
||
|
||
- 无重力。
|
||
- 使用 `pairwise_cohesion`。
|
||
- 时间步要小。
|
||
- 使用 XSPH 抑制高频噪声。
|
||
- 监控液滴主轴长度和总质量。
|
||
|
||
## 29. 常见问题排查
|
||
|
||
### 粒子从盒子飞出
|
||
|
||
检查:
|
||
|
||
- 边界粒子是否足够厚。
|
||
- 流体粒子是否与边界粒子重叠。
|
||
- 是否开启 `impenetrability`。
|
||
- 时间步是否过大。
|
||
- 压力是否出现大负值。
|
||
- 声速是否过低。
|
||
|
||
### 静水箱出现爆炸式膨胀
|
||
|
||
常见原因:
|
||
|
||
- 边界压力外推不稳定。
|
||
- 密度漂移累积。
|
||
- 负压造成张力不稳定。
|
||
- 粒子分布无序导致梯度误差放大。
|
||
- 排斥力或不可穿透修正过强,向流体注入能量。
|
||
|
||
建议:
|
||
|
||
- 关闭强排斥力。
|
||
- 保留不可穿透修正但增加速度阻尼。
|
||
- 启用密度求和重初始化。
|
||
- 降低时间步。
|
||
- 检查壁面粒子和水体粒子是否重叠。
|
||
|
||
### 液滴分团簇聚集
|
||
|
||
常见原因:
|
||
|
||
- 表面张力成对力过强。
|
||
- 负压张力不稳定。
|
||
- 密度求和或压力 EOS 不一致。
|
||
- 时间步太大。
|
||
|
||
建议:
|
||
|
||
- 降低 `surface_tension_cohesion`。
|
||
- 使用加速度限幅。
|
||
- 适度增大物理黏性或 XSPH。
|
||
- 使用更稳定的压力模型。
|
||
|
||
### 通道流粒子向内部聚集
|
||
|
||
常见原因:
|
||
|
||
- 壁面外推速度方向不正确。
|
||
- 边界粒子和流体粒子重叠。
|
||
- 周期 ghost 邻域同步不完整。
|
||
- 近壁压力地板或排斥力过强。
|
||
|
||
## 30. SPH XML 关键词总表
|
||
|
||
本节按 `sph/sph_solver_keywords.h` 和 `sph/sph_solver_config.h` 中已有读取逻辑整理。若本节与旧案例不一致,以源码当前关键词为准。新案例根节点建议使用:
|
||
|
||
```xml
|
||
<M3FrameSPHSimulation version="1.0" name="case_name">
|
||
...
|
||
</M3FrameSPHSimulation>
|
||
```
|
||
|
||
### 默认值、范围和布尔写法约定
|
||
|
||
`sph_solver_config.h` 会把 XML 读入 `SPHSimulationDocument`,再写入 `SPHOptions`。如果 XML 中缺少某个关键词,就使用代码默认值。下面的“推荐范围”是工程调参建议,不是强制限制。
|
||
|
||
布尔值建议写为 `on/off`。配置读取层也能识别常见布尔写法,但新案例统一使用 `on/off` 更清晰。
|
||
|
||
| 类型 | 推荐写法 | 说明 |
|
||
| --- | --- | --- |
|
||
| 布尔 | `on`、`off` | 用于开关项,例如 `enable_density_sum="on"`。 |
|
||
| 整数 | `0`、`10`、`1000` | 用于步数、频率、材料编号和粒子编号;不应写成带单位字符串。 |
|
||
| 实数 | `0.001`、`1.0e-5` | 用于时间步、黏度、长度和数值系数;建议统一使用 SI 单位。 |
|
||
| 向量 | 分量关键词 | SPH 配置多用 `vx/vy/vz`、`body_force_x/y/z`。 |
|
||
| 枚举 | 小写字符串 | 支持部分同义写法,例如 `velocity_verlet`/`verlet`。 |
|
||
|
||
常用全局默认值:
|
||
|
||
| 关键词 | 默认值 | 推荐范围/建议 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `physics` | `fluid` | `fluid`、`solid` 等 | 决定使用流体、固体或边界物理路径。它会影响力学模型、历史变量和后处理字段。 |
|
||
| `formulation` | `wcsph` | 流体常用 `wcsph`,不可压测试可用 `isph` | 决定主要求解方程。`wcsph` 用 EOS 给压力,`isph` 解 PPE,TL/UL 用于固体大变形。 |
|
||
| `integration` | `explicit_euler` | 稳态调试用 `explicit_euler`,长时显式动力学可试 `velocity_verlet` | 决定位置和速度推进格式。Verlet 通常比 Euler 更适合长时间动力学。 |
|
||
| `kernel` | `wendland` | 自由面流动推荐 Wendland 类核;历史案例可能用 `cubic_spline` | 核函数影响邻居权重、梯度精度和抗粒子配对能力。 |
|
||
| `neighbor_search` | `variable_cell` | 大多数案例保持默认 | 邻域搜索策略。周期边界由 `periodic_x/y/z + Domain` 自动触发周期 ghost 搜索。 |
|
||
| `skin` | `0.0` | `0` 到数个粒子间距 | 邻域搜索缓冲距离。较大时减少重建频率,但候选邻居和计算量会上升。 |
|
||
| `reference_density` | `1000.0` | 水通常 `1000` | 参考密度,参与 EOS、静水压力、归一化和密度漂移判断。 |
|
||
| `speed_of_sound` | `20.0` | 通常取最大流速的 10 倍以上 | 弱可压人工声速,越大时间步越小。 |
|
||
| `pressure_eos` | `material` | 水体常用材料中的 Tait EOS | 压力来自材料或内置简化 EOS。 |
|
||
| `auto_time_step` | `on` | 显式 SPH 推荐开启 | 根据声速、加速度和黏性限制自动收缩时间步,避免固定 dt 在局部高速时失稳。 |
|
||
| `cfl` | `0.25` | `0.1` 到 `0.4` | 声速 CFL 系数。越小越稳,计算成本越高。 |
|
||
| `min_dt` | `1.0e-12` | 按问题尺度设置 | 自动时间步下限。若下限过大,失稳时无法继续缩小 dt。 |
|
||
| `max_dt` | `1.0e30` | 建议设置为期望最大步长 | 自动时间步上限。初始静止问题建议设置有限值,避免首步过大。 |
|
||
|
||
### 物理模型默认值速查
|
||
|
||
| 关键词 | 默认值 | 推荐范围/建议 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `artificial_viscosity` | `0.01` | 水体自由面常用 `0.001` 到 `0.05`;冲击问题可更大 | Monaghan alpha。过大像泥浆。 |
|
||
| `artificial_viscosity_beta` | `0.0` | 低速自由面通常 `0`;强冲击可取 `2*alpha` | Monaghan beta。 |
|
||
| `physical_viscosity` | `none` | Poiseuille/Couette 推荐 `morris` 或 `lo_shao` | 选择 Navier-Stokes 物理黏性离散。解析通道流应主要依赖该项而非人工黏性。 |
|
||
| `dynamic_viscosity` | `0.0` | 水约 `0.001 Pa·s` | 设为正值时会自动启用 Morris 黏性路径。 |
|
||
| `kinematic_viscosity` | `0.0` | 水约 `1.0e-6 m^2/s` | 运动黏度 `nu`。与动态黏度的关系为 `mu=rho*nu`。 |
|
||
| `viscosity_ratio_limit` | `100.0` | 多材料常用 `10` 到 `1000` | 限制黏度比导致的界面刚性,避免高低黏材料交界处产生异常大力。 |
|
||
| `surface_tension` | `0.0` | 水-空气约 `0.072 N/m` | 设为 0 表示关闭表面张力。 |
|
||
| `surface_tension_model` | `csf` | 液滴可用 `pairwise_cohesion` | 表面张力离散方式。CSF 依赖曲率估计,pairwise cohesion 更强调成对守恒。 |
|
||
| `surface_tension_threshold` | `1.0e-8` | 根据颜色梯度尺度调节 | CSF 界面阈值,用于过滤过小颜色梯度,避免把内部噪声误判为自由面。 |
|
||
| `surface_tension_smoothing_iterations` | `0` | `0` 到 `3` | 只对 CSF 平滑有意义;可降低曲率噪声,但会让界面更钝。 |
|
||
| `surface_tension_acceleration_limit` | `0.0` | `0` 表示不限幅;不稳定时设置正值 | 限制局部曲率噪声或粒子聚集导致的巨大表面张力加速度。 |
|
||
| `surface_tension_cohesion` | `1.0` | `0.1` 到 `2.0` 起试 | pairwise cohesion 数值强度。 |
|
||
| `surface_tension_adhesion` | `0.0` | 需要润湿/壁面附着时设正值 | 壁面 adhesion 系数,用于近似液体对固壁的附着或润湿趋势。 |
|
||
| `surface_tension_pair_equilibrium` | `1.0` | 内部会夹到合理区间 | pairwise 平衡距离系数。 |
|
||
|
||
### 稳定化与粒子正则化默认值速查
|
||
|
||
| 关键词 | 默认值 | 推荐范围/建议 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `enable_density_sum` | `off` | 静水和长时间自由面可开 | 额外密度求和修正;连续性方程始终更新密度。 |
|
||
| `density_sum_frequency` | `10` | `5` 到 `50` 起试 | `enable_density_sum="off"` 时被忽略。 |
|
||
| `density_filter` | `none` | 静水可试 `shepard` 或 `delta_sph` | 密度滤波模型,用于降低密度/压力噪声,但会引入额外扩散。 |
|
||
| `shepard_filter_frequency` | `0.0` | 正值启用对应频率 | Shepard 滤波频率或间隔控制,用于重归一化密度并减轻长期漂移。 |
|
||
| `delta_sph_coefficient` | `0.0` | `0.01` 到 `0.1` 起试 | Delta-SPH 密度扩散。 |
|
||
| `particle_regularization` | `none` | 自由面可谨慎试 `particle_shifting` | 粒子正则化类型,用于改善粒子分布无序;过强会扰动真实自由面运动。 |
|
||
| `particle_shift_coefficient` | `0.0` | `0.01` 到 `0.1` 起试 | shifting 强度,控制粒子向更均匀分布移动的幅度;过大会引入非物理输运。 |
|
||
| `particle_shift_max_fraction` | `0.2` | `0.05` 到 `0.2` | 单步最大 shift 距离占 spacing/h 的比例。 |
|
||
| `gradient_correction` | `none` | 静水、边界和固体问题建议 `linear` | 一阶一致性修正,可显著改善壁面附近压力梯度和固体应力梯度。 |
|
||
| `free_surface_detection` | `none` | 自由面/表面张力可用 `number_density` 或 `color_gradient` | 自由面识别方法,影响表面张力、开放边界和自由面后处理标记。 |
|
||
| `free_surface_threshold` | `0.75` | `0.6` 到 `0.9` 起试 | 自由面识别阈值,决定内部粒子和自由面粒子的分界敏感度。 |
|
||
| `enable_xsph` | `off` | 长时自由面可开 | XSPH 开关,用邻域速度平滑粒子输运速度,减少粒子穿插。 |
|
||
| `xsph_epsilon` | `0.5` | 常用 `0.02` 到 `0.2`,默认偏强 | XSPH 强度;越大速度场越平滑,但涡结构和剪切梯度会被扩散。 |
|
||
| `velocity_damping` | `0.0` | 静力松弛可设小正值 | 全局速度阻尼,用于快速衰减初始扰动;真实瞬态对比中应谨慎使用。 |
|
||
|
||
### Boundary 默认值速查
|
||
|
||
`Boundary` 中许多默认值为 `-1`,表示“不覆盖全局默认值”。如果显式写入,则该边界会把对应值应用到选中的边界粒子或求解器选项。
|
||
|
||
| 关键词 | 默认值 | 推荐范围/建议 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `type` | `wall_no_slip` | 按物理边界选择 | 边界类型,决定该边界是固壁、入口、出口、周期、耦合接口还是自由面标记。 |
|
||
| `boundary_id` | `-1` | 应与粒子文件边界 id 对应 | 负值表示不按 id 匹配;推荐对实体边界粒子使用明确 id。 |
|
||
| `wall_model` | 空 | `adami_ghost`、`simple_dynamic_wall`、`semi_analytical` | 壁面模型覆盖,用于指定同一固壁类型下的不同壁面外推或积分方式。 |
|
||
| `pressure` | `0.0` | 压力出口或指定壁面压力时使用 | 边界压力值,主要用于压力出口和参考压力边界,不建议代替固壁压力外推。 |
|
||
| `density` | `0.0` | 指定密度边界时使用 | 写入后 `prescribe_density=true`。 |
|
||
| `buffer_width` | `0.0` | 入口/出口 buffer 通常为数倍 spacing | buffer 宽度,决定开放边界粒子补充、删除和状态松弛的空间范围。 |
|
||
| `relaxation_time` | `0.0` | 开放边界松弛用 | 松弛时间,控制 buffer 区向目标速度、密度或压力恢复的快慢。 |
|
||
| `pressure_floor` | 不覆盖;全局默认 `0.02` | 静水可用 `0` 到 `0.02` | 边界压力地板系数,用于避免壁面外推负压过大;过大会抬高近壁压力。 |
|
||
| `repulsion_coefficient` | 不覆盖;全局默认 `0.01` | 静水建议 `0`,强穿透才小量开启 | 近壁排斥力强度,是受力阶段的防穿透手段;过强会把粒子弹离壁面。 |
|
||
| `repulsion_distance` | 不覆盖;全局默认 `0.5` | `0.3` 到 `0.8` 倍 spacing/h 起试 | 排斥力作用距离,决定粒子多近时开始被推离壁面。 |
|
||
| `impenetrability` | 不覆盖;全局默认 `off` | 静水箱/容器建议 `on` | 几何不可穿透修正,是积分后的边界保护;不替代真实压力边界。 |
|
||
| `impenetrability_tolerance` | 不覆盖;全局默认 `0.0` | 通常取 `0.1` 到 `0.5` 倍 spacing | 穿透容差,越小越严格,但可能导致频繁硬修正。 |
|
||
| `impenetrability_velocity_damping` | 不覆盖;全局默认 `0.0` | `0.5` 到 `0.95` 起试 | 法向速度阻尼,用于减少修正后的反弹和能量注入。 |
|
||
| `boundary_geometry_integral` | 不覆盖;全局默认 `on` | 半解析壁面使用 | 边界几何积分开关,用真实边界面积和法向补足粒子支持域缺失。 |
|
||
| `boundary_missing_kernel_correction` | 不覆盖;全局默认 `on` | 半解析壁面建议开 | 缺失核修正,用于改善近壁密度、压力梯度和黏性项精度。 |
|
||
| `boundary_corner_stabilization` | 不覆盖;全局默认 `on` | 角点/棱边建议开 | 角点稳定处理,防止多个壁面交汇处出现法向混乱或粒子从角点逃逸。 |
|
||
| `boundary_moving_rigid_momentum_exchange` | 不覆盖;全局默认 `on` | 移动刚体壁面建议开 | 动量交换开关,使移动壁面和流体之间的力学交换更一致。 |
|
||
| `boundary_corner_normal_threshold` | 不覆盖;全局默认 `0.65` | `0.5` 到 `0.9` | 角点法向判据,用于判断局部法向变化是否足以触发角点稳定逻辑。 |
|
||
| `boundary_integral_area_scale` | 不覆盖;全局默认 `1.0` | 通常 `1.0` | 边界积分面积缩放,用于校准半解析积分贡献。 |
|
||
| `boundary_integral_min_partition` | 不覆盖;全局默认 `0.05` | `0.01` 到 `0.1` | 最小边界积分分区/权重下限,避免局部边界贡献过小。 |
|
||
|
||
### 顶层节点
|
||
|
||
| 节点 | 作用 |
|
||
| --- | --- |
|
||
| `Domain` | 计算域、周期边界包围盒。 |
|
||
| `Particles` | 输入粒子 VTU 文件。可出现多个。 |
|
||
| `Materials` | 材料映射容器。 |
|
||
| `MaterialLibrary` | 外部材料库路径。 |
|
||
| `Material` | 粒子材料编号到材料库 key 的映射。 |
|
||
| `InitialCondition` | 初始速度、密度、压力、质量、材料和角色覆盖。 |
|
||
| `BoundaryConditions` | 边界容器。 |
|
||
| `Boundary` | 单个边界区域或边界类型。 |
|
||
| `Solver` | SPH 求解器、物理模型和数值算法控制。 |
|
||
| `Control` | 起止时间、时间步、最大步数和输出间隔。 |
|
||
| `Output` | VTU/PVD 输出控制。 |
|
||
| `Monitor` | 运行监控和 log 输出控制。 |
|
||
|
||
### 通用属性
|
||
|
||
| 关键词 | 说明 |
|
||
| --- | --- |
|
||
| `name` | 名称。 |
|
||
| `path` | 文件路径。 |
|
||
| `type` | 类型。 |
|
||
| `id` | 编号。 |
|
||
| `key` | 材料库或配置 key。 |
|
||
| `enabled` | 是否启用。 |
|
||
|
||
### Domain
|
||
|
||
| 关键词 | 说明 |
|
||
| --- | --- |
|
||
| `min_x`、`min_y`、`min_z` | 计算域最小坐标。 |
|
||
| `max_x`、`max_y`、`max_z` | 计算域最大坐标。 |
|
||
|
||
周期边界 `periodic_x/y/z` 依赖有效 `Domain`。
|
||
|
||
### Particles
|
||
|
||
| 关键词 | 说明 |
|
||
| --- | --- |
|
||
| `path` | 输入粒子 VTU 文件路径。 |
|
||
|
||
示例:
|
||
|
||
```xml
|
||
<Particles path="data/particles.vtu" />
|
||
```
|
||
|
||
### MaterialLibrary 与 Material
|
||
|
||
| 节点 | 关键词 | 说明 |
|
||
| --- | --- | --- |
|
||
| `MaterialLibrary` | `path` | 材料库 XML/配置文件路径。相对路径会按配置文件所在目录解析。 |
|
||
| `Material` | `id` | 粒子文件中的材料编号,用于把 VTU 中的 `material` 标签映射到具体材料模型。 |
|
||
| `Material` | `key` | 材料库 key,例如 `water.newtonian`。建议优先使用 key,而不是依赖内置材料 id 的顺序。 |
|
||
| `Material` | `dynamic_viscosity` | 覆盖材料动态黏度,适合在同一材料库 key 下快速测试不同黏度。 |
|
||
| `Material` | `kinematic_viscosity` | 覆盖材料运动黏度,适合 Poiseuille/Couette 等直接给定 `nu` 的 benchmark。 |
|
||
|
||
示例:
|
||
|
||
```xml
|
||
<Materials>
|
||
<MaterialLibrary path="material/builtin_materials.xml" />
|
||
<Material id="7" key="water.newtonian" />
|
||
</Materials>
|
||
```
|
||
|
||
### InitialCondition
|
||
|
||
| 关键词 | 说明 |
|
||
| --- | --- |
|
||
| `vx`、`vy`、`vz` | 初始速度。 |
|
||
| `density` | 初始密度覆盖。 |
|
||
| `pressure` | 初始压力覆盖。 |
|
||
| `h` | 初始光滑长度覆盖。 |
|
||
| `mass` | 初始质量覆盖。 |
|
||
| `material` | 初始材料编号覆盖。 |
|
||
| `role` | 初始粒子角色,例如 `fluid`、`boundary`。 |
|
||
| `body_force_x`、`body_force_y`、`body_force_z` | 体力加速度,也可在 `Solver` 中读取。 |
|
||
|
||
### Solver:基础求解控制
|
||
|
||
| 关键词 | 可选值或类型 | 说明 |
|
||
| --- | --- | --- |
|
||
| `physics` | `fluid`、`solid`、`porous_solid`、`debris`、`boundary` | 决定粒子按流体、固体或边界物理路径处理。普通水体、气体和自由面流动用 `fluid`;弹性杆冲击、断裂等用 `solid`;该选项会影响后续力学模型和历史变量更新。 |
|
||
| `formulation` | `wcsph`、`isph`、`total_lagrangian_solid`/`tl_solid`、`updated_lagrangian_solid`/`ul_solid` | 决定主要离散格式。`wcsph` 用状态方程给压力,适合显式自由面;`isph` 通过 PPE 约束不可压;TL/UL 固体格式用于大变形固体 SPH。 |
|
||
| `integration` | `explicit_euler`、`velocity_verlet`/`verlet`、`predictor_corrector` | 控制粒子位置和速度推进。Euler 最简单;Velocity-Verlet 对长时间动力学更稳;Predictor-Corrector 会增加一次预测/修正流程。 |
|
||
| `kernel` | 字符串 | 核函数名称,由核函数模块解释。核函数会影响邻域平滑、梯度精度和抗粒子配对能力;自由面和长时间计算建议使用抗配对性较好的核。 |
|
||
| `neighbor_search` | 字符串 | 邻域搜索类型,默认 `variable_cell`。通常无需手动改;若启用周期边界,应使用 `periodic_x/y/z + Domain`,不要把它简单理解为普通搜索类型开关。 |
|
||
| `skin` | 实数 | 邻域搜索缓冲距离。较大 skin 可减少重建邻域频率,但会增加候选邻居数量;显式大位移问题可适当增大。 |
|
||
| `reference_density` | 实数 | 参考密度 `rho0`,用于 EOS、静水压力和归一化。水一般为 `1000`;多材料时应与材料库密度保持一致。 |
|
||
| `speed_of_sound` | 实数 | 人工声速 `c0`。越大密度波动越小,但显式稳定时间步越小;WCSPH 通常要求 `c0` 至少为特征流速的 10 倍左右。 |
|
||
| `pressure_eos` | `material`、`linear_reference`、`rho_c0_squared` | 选择压力计算路径。`material` 使用材料库 EOS;`linear_reference` 使用 `rho-rho0` 型线性压力;`rho_c0_squared` 使用 `p=rho*c0^2`,通常只适合特定测试。 |
|
||
| `pressure_flux` | `symmetric`、`riemann_rusanov`/`rusanov`/`godunov` | 压力相互作用形式。`symmetric` 是传统成对守恒格式;Riemann/Rusanov 可增强间断和多相界面稳定性,但会引入额外耗散。 |
|
||
| `fluid_pressure_floor` | 实数 | 流体压力下限。用于限制过大负压和张力不稳定;设置过高会改变真实压力场,静水或液滴案例需谨慎。 |
|
||
|
||
### Solver:黏性与非牛顿流体
|
||
|
||
| 关键词 | 可选值或类型 | 说明 |
|
||
| --- | --- | --- |
|
||
| `artificial_viscosity` | 实数 | Monaghan 人工黏性 alpha,用于抑制粒子穿插和高频速度噪声。自由面水体通常保持很小;过大会让水体表现得像高黏泥浆。 |
|
||
| `artificial_viscosity_beta` | 实数 | Monaghan 人工黏性 beta,主要用于强压缩或冲击问题。低速不可压流和静水问题通常设为 0。 |
|
||
| `physical_viscosity` | `none`、`morris`/`laminar`、`lo_shao` | 选择物理黏性离散。Poiseuille、Couette 等黏性 benchmark 应使用物理黏性;`lo_shao` 对边界附近黏性扩散更稳。 |
|
||
| `dynamic_viscosity` | 实数 | 动态黏度 `mu`,单位通常为 Pa·s。若设为正值而 `physical_viscosity=none`,代码会自动走 Morris 物理黏性路径。 |
|
||
| `kinematic_viscosity` | 实数 | 运动黏度 `nu=mu/rho`。与 `dynamic_viscosity` 二选一或保持一致,避免同时给出互相矛盾的黏度尺度。 |
|
||
| `viscosity_ratio_limit` | 实数 | 多材料黏度平均时的黏度比限制,避免高黏/低黏界面产生过大剪切力和时间步刚性。 |
|
||
| `rheology_model` | `newtonian`、`power_law`、`bingham`、`herschel_bulkley`、`carreau` | 非牛顿流变模型。泥浆、浆料、屈服应力流体可用 Bingham/Herschel-Bulkley;聚合物流体可用 Carreau。 |
|
||
| `rheology_min_dynamic_viscosity` | 实数 | 非牛顿等效黏度下限,防止剪切变稀时黏度过低导致时间推进不稳定。 |
|
||
| `rheology_max_dynamic_viscosity` | 实数 | 非牛顿等效黏度上限,防止剪切率接近零或屈服区导致等效黏度趋于无穷。 |
|
||
| `rheology_consistency_index` | 实数 | 幂律/Herschel-Bulkley 的稠度系数 `K`,直接决定给定剪切率下的黏度幅值。 |
|
||
| `rheology_flow_behavior_index` | 实数 | 幂律指数 `n`。`n<1` 表示剪切变稀,`n>1` 表示剪切增稠,`n=1` 退化为牛顿型。 |
|
||
| `rheology_yield_stress` | 实数 | 屈服应力。Bingham/Herschel-Bulkley 中用于描述未屈服区;过大时会显著降低流动性。 |
|
||
| `rheology_regularization` | 实数 | 屈服应力模型正则化参数,用有限大黏度近似理想屈服行为;数值越大越接近理想屈服,但越刚。 |
|
||
| `carreau_zero_shear_viscosity` | 实数 | Carreau 模型低剪切极限黏度,控制流体在近静止区域的高黏平台。 |
|
||
| `carreau_infinite_shear_viscosity` | 实数 | Carreau 模型高剪切极限黏度,控制高速剪切区域的低黏平台。 |
|
||
| `carreau_time_constant` | 实数 | Carreau 转换时间尺度,决定从低剪切平台过渡到高剪切平台的剪切率位置。 |
|
||
| `carreau_exponent` | 实数 | Carreau 指数,控制黏度曲线过渡陡峭程度。 |
|
||
|
||
### Solver:湍流
|
||
|
||
| 关键词 | 可选值或类型 | 说明 |
|
||
| --- | --- | --- |
|
||
| `turbulence_model` | `none`、`sps`、`smagorinsky`/`les` | 选择亚粒子尺度湍流模型。小尺度层流 benchmark 应保持 `none`;高雷诺数自由面流可尝试 LES/SPS。 |
|
||
| `smagorinsky_constant` | 实数 | Smagorinsky 常数,控制湍流黏性强度。越大耗散越强,涡结构越容易被抹平。 |
|
||
| `sps_coefficient` | 实数 | SPS 模型系数,用于亚粒子应力耗散。需要结合分辨率和实验/解析结果校准。 |
|
||
|
||
### Solver:表面张力
|
||
|
||
| 关键词 | 可选值或类型 | 说明 |
|
||
| --- | --- | --- |
|
||
| `surface_tension` | 实数 | 物理表面张力系数 `sigma`。设置为 0 时表面张力关闭;液滴案例需与粒子尺度和时间步一起校准。 |
|
||
| `surface_tension_model` | `csf`、`pairwise_cohesion`、`pairwise_cohesion_adhesion` | 选择表面张力离散。CSF 依赖曲率估计,pairwise cohesion 更成对守恒,液滴保持形状时通常更稳。 |
|
||
| `surface_tension_threshold` | 实数 | CSF 中用于判断有效界面法向的阈值。过低会把噪声当界面,过高会漏掉真实自由面。 |
|
||
| `surface_tension_smoothing_iterations` | 整数 | CSF 法向/曲率平滑次数。可降低 parasitic current,但过多会扩散界面并改变曲率。 |
|
||
| `surface_tension_acceleration_limit` | 实数 | 表面张力加速度限幅。用于防止小粒距或局部聚集时出现瞬时巨大加速度;0 表示不限幅。 |
|
||
| `surface_tension_cohesion` | 实数 | pairwise cohesion 的数值强度系数,与 `surface_tension` 共同决定成对内聚力幅值;过大会产生团簇聚集。 |
|
||
| `surface_tension_adhesion` | 实数 | 壁面附着强度,只在 cohesion-adhesion 模型中有意义;用于润湿、接触角趋势等近似。 |
|
||
| `surface_tension_pair_equilibrium` | 实数 | pairwise 模型的平衡距离系数,影响粒子间吸引/排斥切换位置;偏离过大会改变液滴平衡间距。 |
|
||
|
||
### Solver:多相流
|
||
|
||
| 关键词 | 可选值或类型 | 说明 |
|
||
| --- | --- | --- |
|
||
| `multiphase_model` | `none`、`color`/`color_function`、`mixture` | 选择多相描述方式。`color` 适合界面标记和表面张力,`mixture` 适合相间拖曳和混合物近似。 |
|
||
| `interface_tension` | 实数 | 相间界面张力,常用于不同流体材料之间。与自由面 `surface_tension` 不完全等价,应按相对界面单独标定。 |
|
||
| `drag_coefficient` | 实数 | 相间拖曳系数,用于气液、颗粒-流体或混合物模型的速度松弛。过大时会使两相速度被强制锁定。 |
|
||
| `multiphase_density_ratio_limit` | 实数 | 限制相间密度比在数值离散中的极端影响,避免大密度比界面压力项过刚。 |
|
||
| `multiphase_density_relaxation` | 实数 | 相间密度松弛强度,用于抑制界面密度噪声;过大会抹平真实密度跳跃。 |
|
||
| `multiphase_velocity_relaxation` | 实数 | 相间速度松弛强度,用于抑制界面速度振荡;过大会削弱真实滑移。 |
|
||
| `multiphase_phase_from_material` | 布尔 | 开启后根据粒子材料编号自动生成 phase/color 标记,适合由 `particle_meshing.xml` 分材料生成的多相案例。 |
|
||
| `multiphase_interface_reinitialization` | 布尔 | 是否对界面标记进行重新初始化,使界面厚度和颜色场保持稳定;界面被数值扩散时可开启。 |
|
||
| `multiphase_reinitialization_strength` | 实数 | 重新初始化强度。过小作用不明显,过大可能移动界面或损失小尺度结构。 |
|
||
| `multiphase_pressure_oscillation_suppression` | 布尔 | 是否启用大密度比界面压力振荡抑制,用于减轻轻重流体界面压力跳动。 |
|
||
| `multiphase_pressure_suppression_strength` | 实数 | 压力振荡抑制强度。需要从小值开始调,避免过度耗散界面压力。 |
|
||
| `multiphase_interphase_riemann` | 布尔 | 启用相间 Riemann solver,用于改善界面压力和法向速度耦合,适合 Rayleigh-Taylor 等大密度比问题。 |
|
||
| `multiphase_riemann_dissipation` | 实数 | 相间 Riemann 耗散强度。越大界面越稳但越耗散,可能抑制物理不稳定增长。 |
|
||
| `multiphase_conservative_volume_fraction` | 布尔 | 启用保守体积分数演化,用于减少相体积/质量漂移。 |
|
||
| `multiphase_volume_fraction_relaxation` | 实数 | 体积分数松弛强度,用于稳定体积分数场;过大可能导致界面变厚。 |
|
||
|
||
### Solver:密度、粒子正则化和自适应
|
||
|
||
| 关键词 | 可选值或类型 | 说明 |
|
||
| --- | --- | --- |
|
||
| `enable_density_sum` | 布尔 | 额外启用密度求和重初始化。注意连续性方程始终更新密度;该项只是周期性纠偏。 |
|
||
| `density_sum_frequency` | 整数 | 密度求和执行频率。值越小纠偏越频繁,但可能干扰瞬态压力波;需大于 0。 |
|
||
| `density_filter` | `none`、`shepard`、`delta_sph` | 密度滤波方式。Shepard 更像重归一化,Delta-SPH 更像密度扩散;都用于降低密度噪声。 |
|
||
| `shepard_filter_frequency` | 实数 | Shepard 滤波频率或间隔控制。适合静水保持,但过强会削弱真实密度变化。 |
|
||
| `delta_sph_coefficient` | 实数 | Delta-SPH 密度扩散系数。可抑制压力噪声,过大会让自由面和界面变钝。 |
|
||
| `particle_regularization` | `none`、`particle_shifting`/`pst`、`transport_velocity`/`tvf` | 粒子位置正则化方法。用于改善粒子分布无序,但需要避免破坏自由面和质量守恒。 |
|
||
| `particle_shift_coefficient` | 实数 | 粒子 shifting 强度。建议从小值开始,过大时粒子会出现非物理横向漂移。 |
|
||
| `particle_shift_max_fraction` | 实数 | 单步最大 shifting 距离比例,用于限制正则化位移,防止一次修正过大。 |
|
||
| `adaptive_resolution` | `none`、`smoothing_length`/`h`、`split_merge` | 自适应分辨率方式。`h` 只调光滑长度,`split_merge` 会改变粒子数和质量分布。 |
|
||
| `adaptive_min_h` | 实数 | 自适应光滑长度下限,防止 h 过小导致邻居不足和时间步过小。 |
|
||
| `adaptive_max_h` | 实数 | 自适应光滑长度上限,防止 h 过大导致过度平滑和计算量增加。 |
|
||
| `adaptive_split_density_ratio` | 实数 | split 判据,通常表示局部密度/分辨率超过阈值时细化。设置过低会快速增加粒子数。 |
|
||
| `adaptive_merge_density_ratio` | 实数 | merge 判据,通常表示局部分辨率过高或密度偏低时合并。设置过高会损失局部细节。 |
|
||
| `enable_multiresolution_correction` | 布尔 | 多分辨率过渡区修正总开关。不同 h 或粒子质量共存时建议开启。 |
|
||
| `multiresolution_h_ratio_threshold` | 实数 | 判断是否处于变分辨率交界区的 h 比值阈值。越接近 1,识别越敏感。 |
|
||
| `multiresolution_kernel_correction` | 布尔 | 对交界区核权重和梯度进行修正,减小粗细粒子相互作用偏差。 |
|
||
| `multiresolution_mass_redistribution` | 布尔 | 在 split/merge 或分辨率过渡后重新分配质量,减少总质量误差和局部密度跳变。 |
|
||
| `multiresolution_conservative_projection` | 布尔 | 对速度、密度等物理量做守恒投影,尽量保持质量、动量或标量总量。 |
|
||
| `multiresolution_projection_strength` | 实数 | 保守投影强度。过小修正不足,过大可能引入局部振荡。 |
|
||
| `multiresolution_resampling_iterations` | 整数 | 重采样/投影迭代次数。次数越多越平滑,但计算成本增加。 |
|
||
| `gradient_correction` | `none`、`linear`/`renormalization` | 一阶一致性核梯度修正。边界、静水、固体和应力计算建议开启;粒子严重无序时矩阵可能病态。 |
|
||
| `free_surface_detection` | `none`、`number_density`、`color_gradient` | 自由面识别方法。表面张力、开放边界和输出分析可依赖该标记。 |
|
||
| `free_surface_threshold` | 实数 | 自由面识别阈值。阈值太低会误判内部粒子,太高会漏检真实自由面。 |
|
||
| `enable_xsph` | 布尔 | 启用 XSPH 速度平滑输运,减少粒子穿插和高频噪声。 |
|
||
| `xsph_epsilon` | 实数 | XSPH 平滑系数。小值用于稳定粒子排列,大值会显著扩散速度场。 |
|
||
| `velocity_damping` | 实数 | 全局速度阻尼。适合静力松弛或快速稳定初始场,不应长期用于真实动力学对比。 |
|
||
|
||
### Solver:时间步、ISPH、开放边界、周期和 CUDA
|
||
|
||
| 关键词 | 可选值或类型 | 说明 |
|
||
| --- | --- | --- |
|
||
| `auto_time_step` | 布尔 | 启用后根据声速、加速度和黏性条件更新建议时间步。显式流体推荐开启,调试解析解时可关闭固定步长。 |
|
||
| `cfl` | 实数 | 声速 CFL 系数,控制 `h/(c0+vmax)` 类时间步。值越小越稳但计算更慢。 |
|
||
| `min_dt` | 实数 | 自动时间步下限。若设置过大,自动时间步无法充分缩小;若过小,计算可能在失稳前变得极慢。 |
|
||
| `max_dt` | 实数 | 自动时间步上限。建议设为物理上可接受的最大显式步长,避免初始静止时步长突然过大。 |
|
||
| `isph_free_surface_dirichlet` | 布尔 | ISPH 自由面压力 Dirichlet 条件。自由面不可压计算通常需要给压力参考,否则 PPE 可能漂移。 |
|
||
| `isph_pressure_reference` | 布尔 | 是否启用 PPE 压力参考。泊松方程只有压力差有意义,通常需要参考点或平均压力约束消除奇异性。 |
|
||
| `isph_pressure_reference_particle` | 整数 | 指定压力参考粒子编号。若为负值,代码可使用内部策略选择参考。 |
|
||
| `isph_pressure_reference_value` | 实数 | 压力参考值,常设为 0。用于给 PPE 解固定压力基准。 |
|
||
| `isph_diagnose_singularity` | 布尔 | 开启 PPE 矩阵奇异性诊断,帮助发现全 Neumann 边界、孤立粒子或对角项异常。 |
|
||
| `isph_singularity_diagonal_tolerance` | 实数 | 奇异性诊断的对角容差。过大可能误报,过小可能漏掉病态行。 |
|
||
| `isph_pressure_solver` | `conjugate_gradient`、`jacobi`、`gauss_seidel`、`bicgstab` | PPE 线性求解器。CG 适合对称正定近似,BiCGSTAB 对非对称或病态矩阵更宽容。 |
|
||
| `isph_pressure_preconditioner` | `none`、`jacobi`/`diagonal`、`amg`/`multigrid` | PPE 预条件器。Jacobi 成本低,AMG/多重网格适合大规模 PPE,但需要更严格的矩阵质量。 |
|
||
| `open_boundary_particle_management` | 布尔 | 启用入口补粒子、出口删除和 buffer 重置等开放边界粒子管理。未开启时相关 open boundary 参数不会生效。 |
|
||
| `open_boundary_spacing` | 实数 | buffer 区生成粒子的目标间距,应与内部流体粒子 spacing 接近,避免入口密度跳变。 |
|
||
| `open_boundary_injection_density` | 实数 | 入口补粒子的初始密度。应与入口材料参考密度一致,否则入口会产生压力波。 |
|
||
| `open_boundary_injection_material` | 整数 | 入口补粒子的材料编号。应能在 `Material` 映射中找到对应材料。 |
|
||
| `open_boundary_delete_outlet_particles` | 布尔 | 出口粒子离开计算域后删除,避免粒子在域外继续参与邻域搜索。 |
|
||
| `open_boundary_recycle_particles` | 布尔 | 将出口粒子回收到入口或 buffer,减少频繁分配和粒子数波动。 |
|
||
| `open_boundary_reset_buffer_particles` | 布尔 | 对 buffer 区粒子速度、密度等状态做重置或松弛,保证入口剖面稳定。 |
|
||
| `open_boundary_non_reflecting_outlet` | 布尔 | 启用非反射出口,减少压力波在出口反射回计算域。 |
|
||
| `open_boundary_nscbc_relaxation` | 实数 | NSCBC 松弛系数。值越大出口越强制,反射可能减少但也可能改写内部解。 |
|
||
| `open_boundary_nscbc_probe_distance` | 实数 | NSCBC 探针距离,用于从内部采样外推出口状态;通常取若干粒子间距。 |
|
||
| `periodic_x`、`periodic_y`、`periodic_z` | 布尔 | 指定周期方向。必须配合有效 `Domain`,代码会构造周期 ghost 邻居。 |
|
||
| `enable_cuda_solver_path` | 布尔 | 启用 CUDA 求解路径。适合大规模显式计算;正式使用前应与 CPU 结果做一致性验证。 |
|
||
|
||
### Solver:静水平衡和固体 SPH
|
||
|
||
| 关键词 | 可选值或类型 | 说明 |
|
||
| --- | --- | --- |
|
||
| `body_force_x`、`body_force_y`、`body_force_z` | 实数 | 体力加速度,例如重力或 Poiseuille 驱动力。方向和单位应与几何尺度一致。 |
|
||
| `hydrostatic_equilibrium_projection` | 布尔 | 静水平衡投影,用于快速构造接近平衡的静水压力场;真实瞬态模拟或验证求解器稳定性时可关闭。 |
|
||
| `hydrostatic_free_surface_y` | 实数 | 静水自由面高度,用于按深度计算静水压力。坐标方向需与重力方向一致。 |
|
||
| `hydrostatic_velocity_damping` | 实数 | 静水投影/松弛中的速度阻尼。值越大越快衰减速度,但可能掩盖真实不稳定。 |
|
||
| `hydrostatic_zero_acceleration` | 布尔 | 静水投影时是否置零加速度。用于保持初始平衡,但不应作为真实动力学的长期替代。 |
|
||
| `tensile_instability_control` | 实数 | 张力不稳定控制系数,用于抑制负压下粒子成团。过强会改变真实拉伸状态。 |
|
||
| `solid_damage_threshold` | 实数 | 固体粒子损伤阈值,达到后可触发退化或断裂逻辑。 |
|
||
| `solid_fracture_stress` | 实数 | 基于应力的断裂阈值。适合简单脆性断裂测试,需与材料强度单位一致。 |
|
||
| `solid_kinematics_dt` | 实数 | 固体运动学历史量更新所用时间步。通常与全局 `dt` 一致或由求解器内部同步。 |
|
||
| `solid_objective_rate` | `jaumann`、`green_naghdi`/`gn`、`truesdell` | 大变形固体的客观应力率。Jaumann 简单常用,Green-Naghdi 对大转动更稳健。 |
|
||
| `solid_fracture_deactivate` | 布尔 | bond 或粒子断裂后是否停用相互作用。开启可形成裂纹面,关闭则只记录损伤。 |
|
||
| `solid_use_bond_fracture` | 布尔 | 启用基于初始邻接拓扑的 bond 断裂,而不是只按粒子 damage 判断。 |
|
||
| `solid_bond_tensile_strain` | 实数 | bond 拉伸断裂应变阈值,用于法向拉伸破坏。 |
|
||
| `solid_bond_shear_strain` | 实数 | bond 剪切断裂应变阈值,用于切向滑移或剪切破坏。 |
|
||
| `solid_bond_damage_rate` | 实数 | bond damage 演化速率。值越大,超过阈值后损伤累积越快。 |
|
||
| `solid_bond_break_damage` | 实数 | bond 完全断裂的 damage 阈值。达到该值后 bond 可被删除或失活。 |
|
||
| `solid_identify_fragments` | 布尔 | 断裂后识别连通碎片 id,便于输出和后处理统计碎片数量。 |
|
||
|
||
### Boundary
|
||
|
||
| 关键词 | 可选值或类型 | 说明 |
|
||
| --- | --- | --- |
|
||
| `name` | 字符串 | 边界名称,仅用于日志、调试和可读性,不要求唯一但建议唯一。 |
|
||
| `boundary_id` 或 `boundary` | 整数 | 匹配粒子文件中的边界 id。对于由粒子划分生成的壁面,推荐用该 id 打通几何、粒子和边界条件。 |
|
||
| `type` | 见下表 | 边界物理类型,决定边界如何约束粒子、入口出口或耦合界面。 |
|
||
| `wall_model` | `pressure_floor`、`adami_ghost`、`semi_analytical`、`simple_dynamic_wall`、`coupled_dynamics_solid_wall` 等 | 壁面外推或壁面力学模型。它可以覆盖基础 `type` 的壁面处理方式,例如把普通固壁设为 Adami ghost。 |
|
||
| `min_x`、`min_y`、`min_z`、`max_x`、`max_y`、`max_z` | 实数 | 边界盒,用于按空间范围选择粒子或定义 inlet/outlet buffer 区。盒子过大可能误选流体粒子。 |
|
||
| `vx`、`vy`、`vz` | 实数 | 边界速度。移动壁、Couette 上壁和入口速度边界会使用这些分量。 |
|
||
| `nx`、`ny`、`nz` 或 `normal_x/y/z` | 实数 | 边界法向。压力出口、对称面、壁面 Neumann 和半解析边界积分会用到。 |
|
||
| `pressure` | 实数 | 指定边界压力,常用于压力出口或参考压力边界。不可随意用于固壁替代真实壁面压力外推。 |
|
||
| `density` | 实数 | 指定边界密度。写入后该边界会被视为 prescribed density,适合入口或特殊边界粒子。 |
|
||
| `buffer_width` | 实数 | inlet/outlet buffer 宽度。一般取数倍粒子间距,以保证粒子补充或删除有足够缓冲区。 |
|
||
| `relaxation_time` | 实数 | buffer 区状态松弛时间。过小会强制入口状态,过大则入口/出口调节不明显。 |
|
||
| `pressure_floor` | 实数 | 边界压力地板,用于避免壁面外推产生过大负压。静水箱中设得过高会抬高近壁压力。 |
|
||
| `repulsion_coefficient` | 实数 | 近壁排斥力系数,是动量方程中的预防性力。静水箱通常设为 0;穿透严重时可小量开启。 |
|
||
| `repulsion_distance` | 实数 | 近壁排斥力作用距离。距离太小来不及防穿透,太大则会影响正常近壁流动。 |
|
||
| `boundary_geometry_integral` | 布尔 | 启用半解析边界积分,用三角面片/曲面几何补偿缺失支持域。复杂 CAD 边界建议开启。 |
|
||
| `boundary_missing_kernel_correction` | 布尔 | 对壁面截断造成的缺失核积分做修正,可改善近壁密度、压力和梯度精度。 |
|
||
| `boundary_corner_stabilization` | 布尔 | 针对角点和棱边处法向不连续的稳定化处理,防止粒子从角点缝隙穿出。 |
|
||
| `boundary_moving_rigid_momentum_exchange` | 布尔 | 移动刚体边界与流体进行一致动量交换,适合移动壁、刚体边界和耦合问题。 |
|
||
| `boundary_corner_normal_threshold` | 实数 | 判断角点/棱边法向突变的阈值。值越小越容易触发角点稳定处理。 |
|
||
| `boundary_integral_area_scale` | 实数 | 边界积分面积缩放,用于校准半解析积分强度;通常保持 1。 |
|
||
| `boundary_integral_min_partition` | 实数 | 半解析积分的最小 partition 或权重下限,避免局部边界贡献过小导致支持域塌陷。 |
|
||
| `isph_wall_neumann` | 布尔 | ISPH/PPE 中的固壁 Neumann 条件,控制压力泊松方程壁面法向梯度。 |
|
||
| `isph_wall_weak_boundary_integral` | 布尔 | 用弱式边界积分装配 ISPH 壁面项,比简单粒子约束更接近连续 Neumann 条件。 |
|
||
| `isph_wall_boundary_integral_scale` | 实数 | ISPH 壁面积分项缩放因子,用于校准壁面 PPE 贡献强度。 |
|
||
| `impenetrability` | 布尔 | 时间积分后的几何不可穿透修正。它不是物理壁面力,而是防止粒子越界的最后保护。 |
|
||
| `impenetrability_tolerance` | 实数 | 允许穿透容差。应与粒子间距相关;太小可能频繁硬修正,太大则可见穿透。 |
|
||
| `impenetrability_velocity_damping` | 实数 | 穿透修正后的法向速度阻尼。较大阻尼可减少反弹,过大则会吸收真实动能。 |
|
||
| `tolerance` | 实数 | 边界盒或距离判断容差。用于粒子选择,过大会扩大边界影响范围。 |
|
||
|
||
`type` 支持:
|
||
|
||
| 类型值 | 说明 |
|
||
| --- | --- |
|
||
| `wall`、`solid_wall`、`wall_no_slip` | 固壁/无滑移壁面,通常配合多层边界粒子、Adami ghost 或半解析壁面积分使用。 |
|
||
| `free_slip_wall` | 自由滑移壁面,只约束法向穿透,允许切向滑移,适合对称或理想滑移边界。 |
|
||
| `moving_wall` | 移动壁面,使用 `vx/vy/vz` 指定壁面速度,可用于 Couette flow 或移动固壁。 |
|
||
| `inlet_velocity` | 速度入口,给定入口速度和必要状态量,用于开放通道或入流测试。 |
|
||
| `outlet_pressure` | 压力出口,指定出口压力或参考压力,通常需要配合非反射/缓冲区避免反射。 |
|
||
| `inlet_buffer`、`buffer_inlet` | 入口 buffer,通过补粒子和状态松弛维持入流剖面。 |
|
||
| `outlet_buffer`、`buffer_outlet` | 出口 buffer,用于删除、回收或重置离开计算域的粒子。 |
|
||
| `periodic` | 周期边界区域。实际邻域周期性主要由 `periodic_x/y/z` 与 `Domain` 控制。 |
|
||
| `free_surface` | 自由面边界标记,用于后处理或 ISPH 自由面压力条件。 |
|
||
| `symmetry_plane` | 对称面,通常约束法向速度和法向通量。 |
|
||
| `solid_contact` | 固体接触边界,用于固体 SPH 或耦合接触问题。 |
|
||
| `fem_interface` | FEM-SPH 接口,用于流固耦合或区域数据交换。 |
|
||
| `coupled_dynamics_solid_wall` | 耦合动力学固壁,会插值壁面虚粒子状态并参与流体受力计算。 |
|
||
| `simple_dynamic_wall` | 简单动态壁面,边界粒子参与密度/压力等状态更新,但位置保持边界约束不变。 |
|
||
|
||
### Control
|
||
|
||
| 关键词 | 默认值 | 推荐范围/建议 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `start_time` | `0.0` | 通常保持 0 | 起始物理时间,只影响输出时间戳和时间推进初值,不会自动初始化速度或压力。 |
|
||
| `end_time` | `1.0e-3` | 应与 `dt * max_steps` 协调 | 终止物理时间。计算会受 `end_time` 和 `max_steps` 双重限制,哪个先到就停止。 |
|
||
| `dt` | `1.0e-4` | 显式 SPH 应满足 CFL;静水/表面张力问题要更小 | 基础时间步。若 `auto_time_step=on`,它也是初始/参考步长之一。 |
|
||
| `max_steps` | `1000` | 根据计算时长设置 | 最大步数,用于防止自动时间步过小导致运行无限延长。 |
|
||
| `output_interval` | `1` | 大案例常用 `50`、`100`、`200` | 每隔多少步写一次结果。值越小结果越细,但 IO 开销和磁盘占用越大。 |
|
||
|
||
### Output
|
||
|
||
| 关键词 | 默认值 | 可选值/建议 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `directory` | `sph_outputs` | 路径 | 主输出目录。VTU、PVD 和可选拆分结果默认都相对该目录组织。 |
|
||
| `prefix` | `sph` | 字符串 | 主输出文件前缀,例如 `sph_0.vtu`、`sph_100.vtu`。 |
|
||
| `pvd` | `sph.pvd` | 文件名 | 主 PVD 文件名,用于 ParaView 按时间序列读取所有 VTU 帧。 |
|
||
| `format` | `ascii` | `ascii`、`appended_binary`/`binary` | VTU 数据格式。调试用 ASCII,大数据用 binary。 |
|
||
| `compression` | `none` | `none`、`zlib` | VTU 压缩方式。大规模输出可用 `zlib` 节省磁盘空间,但写文件耗时会增加。 |
|
||
| `output_turbulent_viscosity` | `on` | 布尔 | 是否把湍流黏性场写入 VTU。未启用湍流模型时该字段通常为零或无实际意义。 |
|
||
| `split_particles` | `off` | 布尔 | 是否在求解输出阶段直接将流体和边界粒子分别写出,便于可视化时隐藏壁面或单独检查穿透。 |
|
||
| `fluid_directory` | 空;开启拆分时默认为 `directory/water` | 路径 | 流体粒子输出目录。若不指定,开启拆分后自动放到主输出目录下的 `water`。 |
|
||
| `boundary_directory` | 空;开启拆分时默认为 `directory/walls` | 路径 | 边界粒子输出目录。若不指定,开启拆分后自动放到主输出目录下的 `walls`。 |
|
||
| `fluid_prefix` | `fluid` | 字符串 | 流体粒子输出前缀,用于区分主结果和拆分结果。 |
|
||
| `boundary_prefix` | `boundary` | 字符串 | 边界粒子输出前缀,建议与边界类型或案例名称保持一致。 |
|
||
| `fluid_pvd` | `fluid.pvd` | 文件名 | 流体粒子 PVD,仅记录拆分后的流体序列。 |
|
||
| `boundary_pvd` | `boundary.pvd` | 文件名 | 边界粒子 PVD,仅记录拆分后的边界序列。 |
|
||
|
||
### Monitor
|
||
|
||
| 关键词 | 默认值 | 推荐范围/建议 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `enabled` | `off` | 长时间案例建议 `on` | 是否启用运行监控。监控不会改变求解结果,但有助于定位飞散、压力爆炸和边界穿透发生的时间步。 |
|
||
| `console` | `on` | 调试时建议 `on` | 是否同步打印到命令行。关闭后可只写 log,适合批量后台运行。 |
|
||
| `log` 或 `path` | 空 | 建议写到 `outputs/*.log` | log 文件路径。若为空且启用监控,可能只输出到控制台或使用默认路径。 |
|
||
| `interval` | `0` | `0` 表示使用求解器默认/输出节奏;大案例可设 `10`、`50` | 每隔多少步输出一次监控信息。比 VTU 输出更频繁时可更早发现失稳。 |
|
||
| `velocity` | `on` | 布尔 | 是否监控速度范围。最大速度突然增大通常是粒子飞散或边界失稳的前兆。 |
|
||
| `acceleration` | `on` | 布尔 | 是否监控加速度范围。最大加速度突增常由压力尖峰、表面张力过强或排斥力过硬引起。 |
|
||
| `density` | `on` | 布尔 | 是否监控密度范围。WCSPH 中密度偏离参考值过多说明声速、时间步或密度修正需要调整。 |
|
||
| `pressure` | `on` | 布尔 | 是否监控压力范围。大负压可能导致张力不稳定,大正压尖峰可能导致爆炸式膨胀。 |
|
||
| `bounds` | `on` | 布尔 | 是否监控粒子坐标范围。坐标超出 `Domain` 或容器范围可快速发现穿透和飞散。 |
|
||
| `time_step` | `on` | 布尔 | 是否输出时间步信息。自动时间步计算中可观察 dt 是否被声速、黏性或加速度条件压低。 |
|
||
|
||
---
|
||
|
||
# 第二部分:理论手册
|
||
|
||
## 1. SPH 基本思想
|
||
|
||
SPH 是一种无网格拉格朗日粒子方法。连续场函数 `f(x)` 通过核函数近似:
|
||
|
||
```text
|
||
f(x) = integral f(x') W(x - x', h) dx'
|
||
```
|
||
|
||
粒子离散后:
|
||
|
||
```text
|
||
f_i ≈ sum_j m_j / rho_j * f_j * W_ij
|
||
```
|
||
|
||
其中:
|
||
|
||
- `m_j` 是粒子质量。
|
||
- `rho_j` 是粒子密度。
|
||
- `W_ij = W(x_i - x_j, h)` 是核函数。
|
||
- `h` 是光滑长度。
|
||
|
||
梯度近似:
|
||
|
||
```text
|
||
grad f_i ≈ sum_j m_j / rho_j * f_j * grad W_ij
|
||
```
|
||
|
||
工程实现中常使用反对称形式或一阶一致性修正,以改善动量守恒和梯度精度。
|
||
|
||
## 2. 核函数和支持域
|
||
|
||
核函数需要满足:
|
||
|
||
- 紧支撑。
|
||
- 非负。
|
||
- 归一化。
|
||
- 足够光滑。
|
||
- 随距离单调衰减。
|
||
|
||
常用截断半径为 `2h` 或 `2.2 * spacing` 附近。邻域粒子过少会导致梯度误差大;邻域粒子过多会增加数值扩散和计算量。
|
||
|
||
## 3. WCSPH 控制方程
|
||
|
||
弱可压 SPH 求解:
|
||
|
||
```text
|
||
d rho / dt = -rho div(v)
|
||
dv / dt = -1/rho grad(p) + viscous + body + surface_tension + boundary
|
||
dx / dt = v
|
||
```
|
||
|
||
密度通过连续性方程更新,压力通过状态方程给出。
|
||
|
||
## 4. 密度连续性方程
|
||
|
||
常见 SPH 密度更新:
|
||
|
||
```text
|
||
d rho_i / dt = sum_j m_j (v_i - v_j) · grad W_ij
|
||
```
|
||
|
||
M3Frame 中 SPH 流体始终使用连续性方程推进密度。密度求和是额外的重初始化:
|
||
|
||
```text
|
||
rho_i = sum_j m_j W_ij
|
||
```
|
||
|
||
密度求和可以减小漂移,但频繁或过强会破坏瞬态连续性,因此作为可选稳定化使用。
|
||
|
||
## 5. 压力项离散
|
||
|
||
常用对称压力梯度:
|
||
|
||
```text
|
||
dv_i/dt = -sum_j m_j (p_i/rho_i^2 + p_j/rho_j^2) grad W_ij
|
||
```
|
||
|
||
这种形式保证成对动量守恒。壁面粒子和多相粒子需要特殊处理,否则容易产生压力穿透、压力振荡或界面噪声。
|
||
|
||
## 6. Tait 状态方程
|
||
|
||
水体常用 Tait EOS:
|
||
|
||
```text
|
||
p = B [(rho/rho0)^gamma - 1]
|
||
B = rho0 c0^2 / gamma
|
||
```
|
||
|
||
其中:
|
||
|
||
- `rho0` 是参考密度。
|
||
- `c0` 是人工声速。
|
||
- `gamma` 对水常取 7。
|
||
|
||
人工声速决定密度压缩率和显式稳定时间步。典型弱可压要求密度波动小于 1%。
|
||
|
||
## 7. Riemann-SPH 理论
|
||
|
||
Riemann-SPH 用局部一维 Riemann 解替代或修正传统压力项。Rusanov 通量可理解为在界面压力中加入速度跳跃耗散:
|
||
|
||
```text
|
||
p* = average(p_L, p_R) - 0.5 rho_bar c_bar (u_R - u_L)
|
||
```
|
||
|
||
优点:
|
||
|
||
- 改善压力振荡。
|
||
- 提高界面和冲击稳定性。
|
||
- 对多相大密度比问题更稳。
|
||
|
||
代价:
|
||
|
||
- 引入额外数值耗散。
|
||
- 参数不合适时会抹平真实波动。
|
||
|
||
## 8. 人工黏性
|
||
|
||
Monaghan 人工黏性用于处理粒子靠近时的非物理穿透和冲击:
|
||
|
||
```text
|
||
Pi_ij = (-alpha c_bar mu_ij + beta mu_ij^2) / rho_bar
|
||
```
|
||
|
||
人工黏性只在粒子相互接近时生效。自由面流动中 alpha 过大时,水体会显得像泥浆。
|
||
|
||
## 9. 物理黏性
|
||
|
||
物理黏性对应 Navier-Stokes 方程中的黏性扩散项。SPH 中常用 Morris 黏性形式:
|
||
|
||
```text
|
||
a_i^nu = sum_j m_j * 2 nu_ij (v_i - v_j) / rho_j * (r_ij · grad W_ij) / (|r_ij|^2 + eta^2)
|
||
```
|
||
|
||
Lo-Shao 黏性离散在边界和自由面附近有更好的稳定性。多材料黏性平均需要使用调和平均或受限平均,避免高黏/低黏界面出现过大剪切力。
|
||
|
||
## 10. 非牛顿流体
|
||
|
||
非牛顿流体的黏度依赖剪切率:
|
||
|
||
```text
|
||
mu_eff = mu(gamma_dot)
|
||
```
|
||
|
||
典型模型:
|
||
|
||
- Bingham:存在屈服应力。
|
||
- Herschel-Bulkley:幂律 + 屈服应力。
|
||
- Carreau:从零剪切黏度过渡到无限剪切黏度。
|
||
- 剪切变稀:剪切率越大,黏度越小。
|
||
- 剪切增稠:剪切率越大,黏度越大。
|
||
|
||
数值上必须给黏度上下限,避免剪切率接近零时黏度奇异。
|
||
|
||
## 11. 表面张力理论
|
||
|
||
### CSF 模型
|
||
|
||
CSF 将界面张力写成体力:
|
||
|
||
```text
|
||
f_sigma = sigma kappa n delta_s
|
||
```
|
||
|
||
SPH 中通过颜色场梯度估计法向:
|
||
|
||
```text
|
||
n = grad C
|
||
kappa = -div(n / |n|)
|
||
```
|
||
|
||
CSF 对粒子无序和曲率估计很敏感,容易出现 parasitic current。
|
||
|
||
### Pairwise cohesion 模型
|
||
|
||
成对 cohesion 模型用粒子间成对吸引/排斥力模拟表面张力。优点是成对守恒、实现直接,适合液滴振荡。缺点是系数需要校准,过强会造成团簇聚集。
|
||
|
||
M3Frame 中 pairwise cohesion 的强度由物理 `surface_tension` 和数值 `surface_tension_cohesion` 共同决定。
|
||
|
||
## 12. XSPH 修正
|
||
|
||
XSPH 用邻域平均速度修正粒子输运速度:
|
||
|
||
```text
|
||
dx_i/dt = v_i + epsilon sum_j m_j/rho_j (v_j - v_i) W_ij
|
||
```
|
||
|
||
它可以降低粒子相对穿插和高频噪声,但过大时会造成数值扩散,抹平真实涡结构。
|
||
|
||
## 13. 梯度修正
|
||
|
||
标准 SPH 梯度在边界附近不满足一阶一致性。梯度修正通过矩阵:
|
||
|
||
```text
|
||
L_i = [sum_j V_j (x_j - x_i) ⊗ grad W_ij]^{-1}
|
||
```
|
||
|
||
修正核梯度:
|
||
|
||
```text
|
||
grad W_ij^corr = L_i grad W_ij
|
||
```
|
||
|
||
边界粒子也需要参与修正矩阵构造,否则壁面附近会出现压力梯度和黏性梯度偏差。
|
||
|
||
## 14. 粒子无序和正则化
|
||
|
||
SPH 粒子无序会导致:
|
||
|
||
- 密度噪声。
|
||
- 压力振荡。
|
||
- 自由面毛刺。
|
||
- 壁面附近空腔。
|
||
- 表面张力团簇化。
|
||
|
||
常用正则化:
|
||
|
||
- XSPH。
|
||
- particle shifting。
|
||
- 密度求和重初始化。
|
||
- 核梯度修正。
|
||
- 多分辨率保守投影。
|
||
|
||
## 15. 壁面边界理论
|
||
|
||
SPH 壁面边界困难的核心原因是流体粒子的支持域在壁面处被截断。直接缺失邻域会导致:
|
||
|
||
- 密度不足。
|
||
- 压力偏低。
|
||
- 黏性力方向错误。
|
||
- 粒子穿透。
|
||
|
||
### 多层边界粒子
|
||
|
||
用 2 到 3 层边界粒子补足支持域,是工程中最常见的方法。优点是简单稳健;缺点是几何角点、曲面和边界重叠需要仔细处理。
|
||
|
||
### Adami ghost
|
||
|
||
Adami ghost 通过流体邻域外推边界虚粒子压力、密度和速度,使壁面对流体粒子表现得像物理边界。
|
||
|
||
### Simple dynamic wall
|
||
|
||
`simple_dynamic_wall` 将边界粒子作为正常粒子参与密度和压力更新,但冻结位置。它适合静水箱等需要壁面稳定填充支持域的场景。
|
||
|
||
### 半解析壁面积分
|
||
|
||
半解析方法直接对三角面片或曲面边界积分,理论上更贴近连续边界条件,适合复杂 CAD 几何和高保真工业计算。
|
||
|
||
## 16. 周期边界理论
|
||
|
||
周期边界要求:
|
||
|
||
- 粒子跨周期边界后位置映射正确。
|
||
- 邻域搜索能看到周期镜像粒子。
|
||
- 物理量和材料属性同步。
|
||
- 输出时可选择真实粒子而非 ghost view。
|
||
|
||
如果周期邻域缺失,粒子靠近周期边界时支持域突然减少,可能导致压力脉冲和粒子飞散。
|
||
|
||
## 17. 开放边界理论
|
||
|
||
开放边界需要同时处理:
|
||
|
||
- 入口补粒子。
|
||
- 出口删除粒子。
|
||
- buffer 区重置。
|
||
- 非反射波动条件。
|
||
- 质量守恒。
|
||
|
||
NSCBC 出口基于特征线思想,将进入计算域的波幅控制到较小,避免压力波反射回流场。
|
||
|
||
## 18. 多相流理论
|
||
|
||
多相 SPH 的难点:
|
||
|
||
- 大密度比导致压力项刚性。
|
||
- 界面处压力振荡。
|
||
- 体积分数扩散。
|
||
- 表面张力和黏性跳跃。
|
||
|
||
常用稳定化:
|
||
|
||
- color/phase 标记。
|
||
- conservative volume fraction。
|
||
- interface reinitialization。
|
||
- pressure oscillation suppression。
|
||
- interphase Riemann solver。
|
||
- drag/mixture model。
|
||
|
||
## 19. 湍流模型理论
|
||
|
||
SPH 的 LES 通常通过亚粒子应力或湍流黏性建模:
|
||
|
||
```text
|
||
nu_t = (C_s Delta)^2 |S|
|
||
```
|
||
|
||
其中:
|
||
|
||
- `C_s` 是 Smagorinsky 常数。
|
||
- `Delta` 是粒子尺度。
|
||
- `S` 是应变率张量。
|
||
|
||
湍流黏性可输出到 VTU,用于检查局部耗散区域。
|
||
|
||
## 20. 固体 SPH 理论
|
||
|
||
固体 SPH 需要更新:
|
||
|
||
- 变形梯度 `F`。
|
||
- 应变率 `D`。
|
||
- 自旋张量 `W`。
|
||
- Cauchy 应力。
|
||
- 客观应力率。
|
||
- 材料历史变量。
|
||
|
||
大变形固体常用:
|
||
|
||
- Total Lagrangian SPH。
|
||
- Updated Lagrangian SPH。
|
||
- Jaumann 应力率。
|
||
- Green-Naghdi 应力率。
|
||
- 有限塑性返回映射。
|
||
|
||
断裂可通过初始 bond network 记录粒子间拓扑。当 bond 满足拉伸或剪切断裂准则后,降低或删除相互作用,形成裂纹面和碎片。
|
||
|
||
## 21. ISPH 理论
|
||
|
||
ISPH 通过压力泊松方程保证不可压约束:
|
||
|
||
```text
|
||
div(v^{n+1}) = 0
|
||
```
|
||
|
||
预测速度:
|
||
|
||
```text
|
||
v* = v^n + dt * non_pressure_forces
|
||
```
|
||
|
||
压力泊松方程:
|
||
|
||
```text
|
||
∇²p = rho / dt * div(v*)
|
||
```
|
||
|
||
修正速度:
|
||
|
||
```text
|
||
v^{n+1} = v* - dt / rho * grad(p)
|
||
```
|
||
|
||
PPE 的难点在于:
|
||
|
||
- 自由面压力条件。
|
||
- 固壁 Neumann 条件。
|
||
- 压力参考点。
|
||
- 奇异性诊断。
|
||
- 预条件器。
|
||
|
||
## 22. 时间积分理论
|
||
|
||
### Euler 显式
|
||
|
||
简单、便宜,但耗散和稳定性受时间步限制明显。
|
||
|
||
```text
|
||
v^{n+1} = v^n + dt a^n
|
||
x^{n+1} = x^n + dt v^n
|
||
```
|
||
|
||
### Velocity Verlet
|
||
|
||
比 Euler 更适合保守系统和长时间显式动力学:
|
||
|
||
```text
|
||
x^{n+1} = x^n + dt v^n + 0.5 dt^2 a^n
|
||
v^{n+1} = v^n + 0.5 dt (a^n + a^{n+1})
|
||
```
|
||
|
||
### Predictor-Corrector
|
||
|
||
先预测位置和速度,再根据新加速度修正,可改善显式稳定性。
|
||
|
||
## 23. 稳定时间步
|
||
|
||
显式 SPH 时间步通常受三个条件限制:
|
||
|
||
```text
|
||
dt_cfl ~ h / (c0 + vmax)
|
||
dt_force ~ sqrt(h / |a|max)
|
||
dt_viscous ~ h^2 / nu
|
||
```
|
||
|
||
最终取:
|
||
|
||
```text
|
||
dt = C * min(dt_cfl, dt_force, dt_viscous)
|
||
```
|
||
|
||
静水箱、液滴和强表面张力问题通常需要比普通溃坝更小的时间步。
|
||
|
||
## 24. 静水压力为什么困难
|
||
|
||
静水箱看似简单,但对 SPH 很苛刻:
|
||
|
||
- 正确解是速度为零,压力线性分布。
|
||
- 任何微小压力噪声都会驱动粒子运动。
|
||
- 壁面支持域缺失会破坏压力梯度。
|
||
- 负压会触发张力不稳定。
|
||
- 密度漂移会缓慢积累。
|
||
- 几何不可穿透修正若太硬,会向系统注入能量。
|
||
|
||
因此稳定静水箱通常需要:
|
||
|
||
- 高质量初始粒子排布。
|
||
- 多层且不重叠的壁面粒子。
|
||
- 稳定壁面压力外推。
|
||
- 密度漂移控制。
|
||
- 小时间步。
|
||
- 一阶一致性修正。
|
||
|
||
## 25. Benchmark 和误差评估
|
||
|
||
推荐使用以下 benchmark 检查不同功能:
|
||
|
||
| 案例 | 检查内容 |
|
||
| --- | --- |
|
||
| Hydrostatic tank | 静水压力、壁面稳定性、密度漂移。 |
|
||
| Dam break | 自由面大变形、壁面冲击、压力峰值。 |
|
||
| Poiseuille flow | 黏性、周期边界、解析速度剖面。 |
|
||
| Couette flow | 移动壁面、无滑移边界、黏性扩散。 |
|
||
| Oscillating droplet | 表面张力、质量守恒、主轴振荡周期。 |
|
||
| Taylor-Green vortex | 涡衰减、黏性耗散、周期边界。 |
|
||
| Rayleigh-Taylor | 多相界面、大密度比稳定性。 |
|
||
| Elastic bar impact | 固体 SPH、大变形、接触边界。 |
|
||
| Kalthoff-Winkler | 动态断裂、bond damage、碎片识别。 |
|
||
|
||
误差评估建议输出:
|
||
|
||
- L2 误差。
|
||
- L∞ 误差。
|
||
- 总质量误差。
|
||
- 动量误差。
|
||
- 能量变化。
|
||
- 压力峰值误差。
|
||
- 解析剖面对比 CSV。
|