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

1891 lines
56 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.
# SPH_SHELL 文档
`SPH_SHELL` 是一个 MATLAB 三维 SPH 板壳-流体相互作用程序框架。当前代码面向两类用途:
- 普通板壳-流体耦合演示:水体粒子与柔性板/壳粒子接触作用。
- 船舶水下接触爆炸框架演示:爆源逐步生成气体、推动水体形成气泡、与船体板壳接触、诱发舱壁损伤破坏,并统计水/气进入舱室的过程。
注意:本程序是可运行的数值仿真框架,不是已经校核过的工程级水下爆炸毁伤预测软件。爆轰、气泡、壳体破坏和流固接触模型均为可替换的简化模型。
## 用户手册
### 1. 运行环境
建议环境:
- MATLAB R2024a 或较新版本
- Windows/Linux/macOS 均可,当前开发路径为 Windows
- 可选:ParaView,用于查看 `.vtk` 结果文件
本代码不依赖第三方 MATLAB toolbox。只需将仓库根目录加入 MATLAB 路径。
### 2. 目录结构
```text
main.m 默认入口,运行板-流体演示
README.md 用户手册
config/defaultConfig.m 默认板-流体算例配置
config/contactExplosionConfig.m 水下接触爆炸算例配置
config/validateConfig.m 配置检查与默认值补全
examples/run_plate_fluid_demo.m 板-流体演示入口
examples/run_plate_fluid_ulsph.m ULSPH 大变形板-流体演示入口
examples/run_underwater_contact_explosion_demo.m
examples/run_fast_contact_explosion_demo.m
examples/post_underwater_contact_explosion.m
sph/ 求解器模块
output*/ 运行后生成的输出目录
```
重要说明:当前代码使用普通文件夹 `config/`、`examples/`、`sph/`,不是 MATLAB package 文件夹,因此文件夹名前不需要 `+`。
### 3. 快速开始
在 MATLAB 命令窗口中进入仓库根目录,例如:
```matlab
cd('D:\CODE\SPH_SHELL')
addpath(genpath(pwd));
```
运行默认板-流体算例:
```matlab
run_plate_fluid_demo
```
该演示入口会在 `defaultConfig()` 的基础上显式设置:
```matlab
cfg.shell.model = 'reissner_mindlin';
```
若 `cfg.output.writeVtk = true`,该入口会在仿真结束后自动调用 `splitVtkFiles`,生成:
```text
output/split_parts/water.pvd
output/split_parts/explosive.pvd
output/split_parts/shell.pvd
output/split_parts/wall.pvd
```
也可以运行:
```matlab
main
```
若需要测试当前构形 ULSPH 大变形壳公式,可运行:
```matlab
run_plate_fluid_ulsph
```
该算例使用:
```matlab
cfg.shell.formulation = 'ulsph_large_deformation';
```
ULSPH 每步更新当前构形邻域和面积,计算量明显高于默认板-流体演示,建议先缩短 `cfg.time.tEnd` 调试。
默认输出目录为:
```text
output/
```
### 4. 水下接触爆炸算例
运行完整接触爆炸框架算例:
```matlab
addpath(genpath(pwd));
run_underwater_contact_explosion_demo
```
该入口调用:
```matlab
cfg = contactExplosionConfig();
state = createInitialState(cfg);
runSimulation(state, cfg);
```
默认输出目录为:
```text
output_contact_explosion/
```
该算例当前采用 Reissner-Mindlin 壳体模型:
```matlab
cfg.shell.model = 'reissner_mindlin';
```
该算例当前采用删除型模拟盒子:
```matlab
cfg.simBox.mode = 'delete';
```
#### 快速调试版本
如果只是检查代码是否能跑,建议先运行快速版本:
```matlab
run_fast_contact_explosion_demo
```
该算例使用更粗粒子、更短仿真时间,并关闭 PNG/VTK 重输出,适合调试。
#### VTK/PVD 分组后处理
完成接触爆炸计算并生成 `particles.pvd` 后,可运行:
```matlab
post_underwater_contact_explosion
```
默认读取:
```text
output_contact_explosion/particles.pvd
```
并输出:
```text
output_contact_explosion/split_parts/water.pvd
output_contact_explosion/split_parts/explosive.pvd
output_contact_explosion/split_parts/shell.pvd
output_contact_explosion/split_parts/wall.pvd
```
四个新的 PVD 分别管理水体粒子、炸药/爆炸气体粒子、板壳粒子和壁面/边界粒子。拆分后的目录中会同时写出 `.vtk` 和 `.vtp`,新的 PVD 文件会指向 `.vtp`,以便 ParaView 正确识别时间序列。板壳部分会保留壳体面片和面片损伤字段。
也可以直接调用通用拆分函数:
```matlab
splitVtkFiles('output_contact_explosion/particles.pvd', ...
'output_contact_explosion/split_parts');
```
`splitVtkFiles` 默认使用同样的四类分组;也支持自定义分组规则:
```matlab
parts = struct( ...
'name', 'shell_only', ...
'label', 'shell only', ...
'selector', @(vtk) splitVtkField(vtk, 'particle_type', zeros(size(vtk.points, 1), 1)) == 2);
splitVtkFiles('output_contact_explosion/particles.pvd', ...
'output_contact_explosion/custom_split', parts);
```
### 5. 算例物理过程
接触爆炸算例采用简化三维布置:
- 壳体板位于 `z = cfg.shell.z0`,代表船体舱壁或船底局部板壳。
- 水体位于壳板外侧,即壳板下方。
- 壳板上方为空舱区域,用 `cfg.compartment` 定义。
- 爆源位于水体中,中心为 `cfg.explosion.center`。
- 爆源半径从 `initialRadius` 逐步增长到 `finalRadius`。
- 爆源区域内水粒子被转换成气体粒子。
- 气体粒子获得压力源或内能,推动周围水体和壳体。
- 壳体粒子发生弹性变形、简化塑性累积和损伤破坏。
- 失效壳体面不再阻挡流体/气体粒子,形成数值破口。
- 程序统计水和气体进入舱室的数量、质量和体积。
### 6. 主要配置文件
#### 6.1 默认配置
默认板-流体算例配置位于:
```text
config/defaultConfig.m
```
它定义:
- 计算域 `cfg.domain`
- 粒子间距 `cfg.particles.dx`
- 时间步 `cfg.time.dt`
- 流体参数 `cfg.fluid`
- 水/气材料参数 `cfg.materials`
- 壳体参数 `cfg.shell`
- 边界条件 `cfg.boundary`
- 模拟盒子 `cfg.simBox`
- 邻域搜索缓存 `cfg.neighbor`
- 输出设置 `cfg.output`
#### 6.2 接触爆炸配置
接触爆炸算例配置位于:
```text
config/contactExplosionConfig.m
```
常用参数如下。
计算域:
```matlab
cfg.domain.xMin
cfg.domain.xMax
cfg.domain.yMin
cfg.domain.yMax
cfg.domain.zMin
cfg.domain.zMax
```
粒子分辨率:
```matlab
cfg.particles.dx
cfg.particles.hFactor
```
`dx` 越小,粒子越多,结果更细,但计算量会显著增加。三维问题中粒子数大约随 `1 / dx^3` 增长。
时间控制:
```matlab
cfg.time.dt
cfg.time.tEnd
cfg.time.cfl
cfg.time.stepMax
```
水和气体材料:
```matlab
cfg.materials.water
cfg.materials.gas
```
EOS 类型:
```text
eosType = 1 Tait 水体 EOS
eosType = 2 线性气体占位 EOS
eosType = 3 理想气体 EOS,使用 specificInternalEnergy
```
壳体参数:
```matlab
cfg.shell.model % 'spring'、'kirchhoff_love' 或 'reissner_mindlin'
cfg.shell.formulation % 'small_deformation'、'tlsph_large_deformation' 或 'ulsph_large_deformation'
cfg.shell.thickness
cfg.shell.rho
cfg.shell.youngModulus % Kirchhoff-Love/Reissner-Mindlin 使用
cfg.shell.poissonRatio % Kirchhoff-Love/Reissner-Mindlin 使用
cfg.shell.shearCorrection % Reissner-Mindlin 使用
cfg.shell.hourglassStiffnessFactor
cfg.shell.hourglassDampingFactor
cfg.shell.stiffnessAxial
cfg.shell.stiffnessBending
cfg.shell.failureStrain
cfg.shell.failurePressure
cfg.shell.yieldStrain
cfg.shell.plasticRate
cfg.shell.referenceUpdate.frequency
cfg.shell.referenceUpdate.useDeformationGradient
```
默认壳体模型为:
```matlab
cfg.shell.model = 'spring';
cfg.shell.formulation = 'small_deformation';
```
注意:这是全局默认配置;`run_plate_fluid_demo.m` 和水下接触爆炸算例 `contactExplosionConfig.m` 均已显式设置为:
```matlab
cfg.shell.model = 'reissner_mindlin';
```
可选值:
```text
spring 当前已有的质点-弹簧工程模型,默认选项
kirchhoff_love Kirchhoff-Love 薄板理论的 surface-SPH 工程实现
reissner_mindlin Reissner-Mindlin 中厚板理论的 surface-SPH 工程实现
```
`kirchhoff_love` 和 `reissner_mindlin` 可选择三种公式路径:
```text
small_deformation 小变形/工程简化 surface-SPH 公式,默认选项
tlsph_large_deformation 基于参考构形的 TLSPH 大变形壳公式
ulsph_large_deformation 基于当前构形的 ULSPH 大变形壳公式
```
注意:`ulsph_large_deformation` 与 `cfg.shell.referenceUpdate` 互斥。ULSPH 路径每步使用当前构形邻域、当前面积和当前构形散度,不需要也不允许再设置参考构形更新。
TLSPH/ULSPH 大变形壳体可启用弱 hourglass 稳定项,用于抑制壳粒子沿中面方向的非仿射飞散:
```matlab
cfg.shell.hourglassStiffnessFactor = 0.02;
cfg.shell.hourglassDampingFactor = 0.25;
```
默认值为 `0`,表示不启用。TLSPH 和 ULSPH 使用不同的 hourglass 公式:TLSPH 基于参考构形非仿射位移/速度残差,ULSPH 基于当前构形速度梯度残差。该项不替代真实本构,主要用于控制 SPH 壳体的零能或弱约束模态。
壳体参考构形更新为可选功能,默认关闭:
```matlab
cfg.shell.referenceUpdate.frequency = 0; % 0 不按频次更新;1 每步更新;N 每 N 步更新
cfg.shell.referenceUpdate.useDeformationGradient = false;
cfg.shell.referenceUpdate.maxAbsF = 2.5; % 任一 F 元素绝对值过大时触发
cfg.shell.referenceUpdate.minDiagonalF = 0.2; % 对角线任一元素过小时触发
cfg.shell.referenceUpdate.detTolerance = 0.5; % abs(det(F)-1) 过大时触发
cfg.shell.referenceUpdate.resetRotation = false; % 更新参考构形时是否同步清零转角/角速度
```
若同时启用步频和变形梯度判据,任一条件满足都会更新参考构形。当前 F 为壳体中面上的 2x2 面内变形梯度,由参考构形 surface-SPH 梯度计算。
爆源参数:
```matlab
cfg.explosion.center
cfg.explosion.initialRadius
cfg.explosion.finalRadius
cfg.explosion.burnDuration
cfg.explosion.gasMassTotal
cfg.explosion.heatReleaseTotal
cfg.explosion.pressurePeak
cfg.explosion.pressureMode
```
舱室监测区域:
```matlab
cfg.compartment.enabled
cfg.compartment.xMin
cfg.compartment.xMax
cfg.compartment.yMin
cfg.compartment.yMax
cfg.compartment.zMin
cfg.compartment.zMax
```
模拟盒子:
```matlab
cfg.simBox.mode % 'free'、'reflect' 或 'delete'
cfg.simBox.activeWalls % [xMin xMax yMin yMax zMin zMax]
cfg.simBox.restitution % reflect 模式反弹系数
```
三种盒子模式含义:
```text
free 粒子越界后不受模拟盒子影响,也不施加解析盒边界反力
reflect 粒子接近盒壁时受边界反力,越界后按 restitution 反弹,默认模式
delete 不施加盒壁反力,流体粒子越过 activeWalls 指定的盒面后被删除
```
`delete` 当前只删除流体粒子;壳体粒子保持拓扑完整,由固定边界、接触和损伤模型控制。
水下接触爆炸算例 `contactExplosionConfig.m` 已显式设置为:
```matlab
cfg.simBox.mode = 'delete';
```
### 7. 输出文件
每次运行后,程序会在 `cfg.output.directory` 下写出结果。常见文件包括:
```text
snapshot_00001.png
particles_00001.vtk
particles_00001.vtp
particles.pvd
diagnostics.csv
```
输出频率由以下参数控制:
```matlab
cfg.output.plotEvery
cfg.output.vtkEvery
cfg.output.logEvery
```
输出开关:
```matlab
cfg.output.writeSnapshots
cfg.output.writeVtk
cfg.output.writeLegacyVtk
cfg.output.writeCsv
cfg.output.showFigure
```
调试时建议关闭重输出:
```matlab
cfg.output.writeSnapshots = false;
cfg.output.writeVtk = false;
cfg.output.writeCsv = false;
cfg.output.showFigure = false;
```
若只需要 ParaView 时间序列,可以保留 `cfg.output.writeVtk = true`,并关闭 legacy `.vtk`:
```matlab
cfg.output.writeLegacyVtk = false;
```
此时程序仍会写出 XML `.vtp` 和 `particles.pvd`,但不再额外写 legacy `.vtk`。注意:当前通用拆分工具 `splitVtkFiles` 仍依赖 legacy `.vtk` 读取原始点数据;若需要按水体/炸药/板壳/壁面拆分,请保持 `cfg.output.writeLegacyVtk = true`。
### 8. VTK 文件说明
`.vtk` 和 `.vtp` 文件可用 ParaView 打开。当前输出包含粒子和壳体面片。
当 `cfg.output.writeVtk = true` 时,程序会生成 XML `.vtp`,并生成 `particles.pvd` 作为 ParaView 时间序列索引文件。由于 ParaView 的 PVD reader 需要 XML VTK 数据,`particles.pvd` 会登记 `particles_*.vtp`,而不是 legacy `.vtk`。若 `cfg.output.writeLegacyVtk = true`,程序还会同步输出 legacy `.vtk`,用于兼容旧后处理脚本和 `splitVtkFiles`。建议在 ParaView 中优先打开 `particles.pvd`,这样可以直接按时间步播放整段结果。
主要点数据字段:
```text
particle_type 1=流体,2=壳体,3=边界
is_fluid 是否为流体粒子
is_shell 是否为壳体粒子
is_boundary 是否为边界粒子
material 材料编号
eos_type EOS 类型
reference_density 参考密度
density 当前密度
pressure 压力
extra_pressure 爆炸压力源附加压力
specific_internal_energy 比内能
de_pressure_work 压力功内能变化率
de_viscous_heating 黏性耗散热变化率
density_diffusion_rate 密度扩散项
sponge_damping 海绵层阻尼
sponge_weight 海绵层权重
gas_source_fraction 气体生成进度
gas_birth_time 气体生成时间,非气体为 -1
bubble_pressure 简化气泡压力
shell_damage 壳体损伤
shell_plastic_strain 壳体塑性应变
shell_rotation_x Reissner-Mindlin 壳体转角分量
shell_rotation_y Reissner-Mindlin 壳体转角分量
shell_failed 壳体是否失效
inside_compartment 是否进入舱室监测区域
velocity 速度矢量
acceleration 加速度矢量
```
主要单元数据字段:
```text
is_shell_face 是否为壳体面片
face_damage 壳体面平均损伤
face_failed 壳体面是否失效
```
为避免 ParaView 中出现 `NaN`,不适用于某类粒子的字段会写入有限占位值,通常为 `0`。筛选时请优先使用 `is_fluid`、`is_shell`、`is_boundary` 或 `is_shell_face`。
例如:
- 查看水/气压力:先筛选 `is_fluid = 1`
- 查看壳体损伤:先筛选 `is_shell = 1`
- 查看面片损伤:使用 cell data 中的 `is_shell_face = 1`
### 9. diagnostics.csv 说明
`diagnostics.csv` 记录标量时间历程,适合用 MATLAB、Excel 或 Python 画图分析。
常见列包括:
```text
step
time
dt
water_count
gas_count
max_pressure
max_shell_damage
max_shell_plastic_strain
failed_shell_count
failed_face_count
shell_reference_updated_step
shell_reference_update_total
shell_reference_max_abs_f
shell_reference_min_diagonal_f
shell_reference_max_det_error
compartment_water_count
compartment_gas_count
compartment_water_mass
compartment_gas_mass
compartment_water_volume
compartment_gas_volume
boundary_contact_count
sim_box_deleted_fluid_step
sim_box_deleted_fluid_total
explosion_progress
explosion_pressure
generated_gas_mass
released_energy
gas_volume
bubble_pressure
mean_gas_pressure
```
在 MATLAB 中读取:
```matlab
T = readtable('output_contact_explosion/diagnostics.csv');
plot(T.time, T.max_pressure);
xlabel('time / s');
ylabel('max pressure / Pa');
```
### 10. 自定义算例
建议不要直接修改求解器文件,而是新建一个算例入口。例如:
```matlab
function run_my_case()
cfg = contactExplosionConfig();
cfg.particles.dx = 0.05;
cfg.time.tEnd = 5.0e-4;
cfg.explosion.center = [0.50, 0.30, -0.06];
cfg.explosion.pressurePeak = 1.0e7;
cfg.output.directory = 'output_my_case';
cfg = validateConfig(cfg);
state = createInitialState(cfg);
runSimulation(state, cfg);
end
```
然后运行:
```matlab
addpath(genpath(pwd));
run_my_case
```
### 11. 加速建议
三维 SPH 计算量很大。调试时建议:
1. 增大粒子间距:
```matlab
cfg.particles.dx = 0.05;
```
2. 缩短仿真时间:
```matlab
cfg.time.tEnd = 2.0e-4;
```
3. 关闭重输出:
```matlab
cfg.output.writeSnapshots = false;
cfg.output.writeVtk = false;
cfg.output.writeCsv = false;
cfg.output.showFigure = false;
```
4. 降低输出频率:
```matlab
cfg.output.plotEvery = 100;
cfg.output.vtkEvery = 100;
cfg.output.logEvery = 50;
```
5. 只写 ParaView 需要的 XML VTK:
```matlab
cfg.output.writeLegacyVtk = false;
```
6. 使用 Verlet 邻域缓存减少 `findPairs` 调用:
```matlab
cfg.neighbor.useVerlet = true;
cfg.neighbor.skinFactor = 0.25;
cfg.neighbor.rebuildEvery = 25;
```
默认配置中 `cfg.neighbor.useVerlet = false`,因为水下接触爆炸早期粒子速度很高,小 skin 可能频繁重建并增加候选粒子对,未必更快。`skinFactor` 越大,邻域重建越少,但每次参与计算的候选粒子对越多;`rebuildEvery` 是强制重建间隔,用于避免缓存长期漂移。对于较平稳的长时间流固耦合算例,可以打开该选项并测试不同 `skinFactor`。若需要逐步排查数值问题,可关闭:
```matlab
cfg.neighbor.useVerlet = false;
```
7. 调试代码路径时可临时关闭部分耗散/内能模型:
```matlab
cfg.fluid.densityDiffusionAlpha = 0.0;
cfg.fluid.viscousHeatingFactor = 0.0;
cfg.fluid.updateInternalEnergy = false;
```
当前代码已经对邻域搜索、流体力、密度更新、壳体更新和面接触进行了 MATLAB 层面的矢量化优化,并支持 Verlet 邻域缓存。若还需大幅提速,建议后续考虑:
- 将 `findPairs` 改为 MEX/C++ 实现
- 使用 `parfor` 或 GPU 加速成对粒子计算
- 使用自适应粒子分辨率或局部加密
### 12. 常见问题
#### 12.1 MATLAB 提示找不到函数
确认已在仓库根目录运行:
```matlab
addpath(genpath(pwd));
```
如果当前目录不是仓库根目录,请先 `cd` 到仓库根目录。
#### 12.2 VTK 文件中旧结果仍然有 NaN
旧文件是修复前生成的,不会自动更新。请重新运行算例生成新的 VTK 文件。新版本导出的 VTK 不再写入 `NaN`。
#### 12.3 ParaView 中某些字段看起来为 0
很多字段只对某类粒子有效。例如 `pressure` 只对流体有物理意义,`shell_damage` 只对壳体有物理意义。请用 `is_fluid`、`is_shell`、`is_boundary` 过滤后再查看。
#### 12.4 算得太慢
优先使用 `run_fast_contact_explosion_demo`,或增大 `cfg.particles.dx` 并关闭 PNG/VTK 输出。完整高分辨率接触爆炸算例会明显更慢。
#### 12.5 壳体没有明显破坏
可以检查:
```matlab
cfg.explosion.pressurePeak
cfg.shell.failurePressure
cfg.shell.failureStrain
cfg.shell.damageRate
cfg.shell.pressureDamageRate
```
也可以查看 `diagnostics.csv` 中的:
```text
max_shell_damage
failed_shell_count
failed_face_count
```
#### 12.6 水和气体没有进入舱内
检查壳体是否已经失效,以及舱室监测区域是否正确:
```matlab
cfg.compartment
```
在 VTK 中可查看 `inside_compartment` 字段。
### 13. 求解器模块说明
主要模块位于 `sph/`:
```text
createInitialState.m 创建初始粒子、壳体和边界
runSimulation.m 主时间循环
stepSimulation.m 单步推进与 Verlet 邻域缓存
findPairs.m 三维邻域搜索
fluidForces.m WCSPH 压力力和人工黏性力
updateDensity.m 密度连续方程和密度扩散
equationOfState.m 多材料 EOS
updateInternalEnergy.m 理想气体内能更新
applyExplosionSource.m 爆源气体生成和压力源
couplingForces.m 流体-壳体接触
shellForces.m 壳体模型分发和内力计算
updateShellPlasticity.m 壳体边塑性
updateShellDamage.m 壳体损伤和失效
updateShellReference.m 壳体参考构形更新
boundaryForces.m 计算域边界力
applySimulationBox.m 模拟盒子 free/reflect/delete 处理
applySpongeLayer.m 海绵层阻尼
updateDiagnostics.m 运行诊断量
writeVtkParticles.m VTK 输出
writeVtpParticles.m VTP 输出
writeDiagnosticsCsv.m CSV 输出
splitVtkFiles.m 通用 VTK/PVD 分组拆分
splitVtkField.m 自定义分组读取点标量字段
plotState.m PNG 快照绘图
```
## 理论与数值方法手册
本节说明当前程序采用的主要数值仿真技术。这里的描述对应代码中的实现,用于帮助理解程序结构、参数含义和结果解释。
相关用户手册入口:[算例物理过程](#5-算例物理过程)、[主要配置文件](#6-主要配置文件)、[输出文件](#7-输出文件)、[VTK 文件说明](#8-vtk-文件说明)、[diagnostics.csv 说明](#9-diagnosticscsv-说明)、[加速建议](#11-加速建议)、[求解器模块说明](#13-求解器模块说明)。
实现程度分为三类:
```text
框架完整 程序中已有可运行实现,数据结构和计算流程完整
工程简化 可用于定性演示或框架验证,但物理模型经过明显简化
诊断/占位 主要用于统计、可视化或后续扩展,不代表完整物理模型
```
当前各项技术实现程度概览:
| 技术 | 当前实现程度 | 说明 |
| --- | --- | --- |
| 拉格朗日粒子离散 | 框架完整 | 流体、气体、壳体、边界均有粒子数据结构 |
| 弱可压 SPH | 工程简化 | 已有压力力、密度更新和人工黏性,但不是高精度冲击波求解器 |
| cubic spline 核函数 | 框架完整 | 三维核函数和梯度均已实现 |
| 密度连续方程 | 框架完整 | 已按 SPH pair 形式矢量化实现 |
| 密度扩散 | 工程简化 | 可抑制噪声,但不是严格界面保持格式 |
| 人工黏性 | 工程简化 | 用于稳定压缩区和接触区,非完整冲击捕捉模型 |
| 多材料 EOS | 框架完整 | 粒子级 EOS 选择已实现 |
| Tait 水 EOS | 工程简化 | 可运行,参数未做工程标定 |
| 理想气体 EOS | 工程简化 | 可用于爆炸气体演示,非真实爆轰产物 EOS |
| 气体内能方程 | 工程简化 | 只更新理想气体粒子,水体内能未求解 |
| 爆炸源 | 工程简化 | 用气体生成和压力源近似爆炸过程 |
| 气泡压力 | 工程简化 | 能量-体积估算,非完整气泡动力学 |
| 流体-壳体接触 | 工程简化 | penalty 面接触已实现,非严格接触力学求解 |
| 板壳模型 | 工程简化 | 默认 spring;可选 kirchhoff_love 和 reissner_mindlin,均采用壳体粒子 surface-SPH 算子 |
| 壳体塑性 | 工程简化 | 边塑性近似,不是完整板壳塑性 |
| 损伤失效 | 工程简化 | 基于应变/压力阈值的数值破口模型 |
| 解析边界 | 框架完整 | 盒边界 penalty 反力已实现 |
| 海绵层 | 工程简化 | 阻尼边界反射,不是严格非反射边界 |
| 显式时间积分 | 框架完整 | 显式推进和 CFL 限制已实现 |
| 邻域搜索与矢量化 | 框架完整 | MATLAB 版本已优化,仍可用 MEX/GPU 继续加速 |
| 舱室进水/进气统计 | 诊断/占位 | 统计粒子进入舱室,不是舱室空气/淹没求解器 |
### 1. 拉格朗日粒子离散
程序采用拉格朗日粒子方法描述流体、爆炸气体、壳体和边界。粒子随物质运动,适合处理大变形、自由表面、破口流动和多材料相互作用。
实现程度:框架完整。粒子数据结构、初始化、时间推进和输出链路均已实现;但粒子分辨率、自适应加密和粒子重整化尚未实现。
用户手册定位:[算例物理过程](#5-算例物理过程)、[求解器模块说明](#13-求解器模块说明)、[VTK 文件说明](#8-vtk-文件说明)。
主要粒子类型包括:
```text
fluid particles 水体和爆炸气体粒子
shell particles 船体局部板壳粒子
boundary particles 边界粒子或解析边界的辅助粒子
```
流体粒子携带:
```matlab
x, v, rho, p, m, material, eosType
```
壳体粒子携带:
```matlab
x, v, m, damage, failed, fixed
theta, omega Reissner-Mindlin 模型使用的转角和角速度
```
这种统一粒子框架使水、气体和壳体可以在同一时间循环中耦合推进。
### 2. 弱可压 SPH 方法
流体求解采用弱可压 SPH,即 WCSPH。核心模块为:
实现程度:工程简化。当前 WCSPH 流程完整可运行,适合框架验证和定性分析;但尚未包含高阶一致性修正、Riemann 求解器、严格冲击捕捉或空化模型。
用户手册定位:[主要配置文件](#6-主要配置文件)、[加速建议](#11-加速建议)、[求解器模块说明](#13-求解器模块说明)。
```text
findPairs.m
kernelCubicSpline.m
kernelCubicSplineGrad.m
fluidForces.m
updateDensity.m
equationOfState.m
```
程序使用三维 cubic spline 核函数。光滑长度为:
```matlab
state.h = cfg.particles.hFactor * cfg.particles.dx
```
邻域搜索半径为:
```matlab
2.0 * state.h
```
压力力采用对称 SPH 离散:
```text
F_ij = -m_i m_j (p_i / rho_i^2 + p_j / rho_j^2) grad W_ij
```
这种形式使粒子间相互作用成对出现,有利于保持总动量守恒。
### 3. 密度连续方程与密度扩散
密度通过 SPH 连续方程更新:
实现程度:框架完整到工程简化之间。连续方程实现完整;密度扩散是稳定化近似,用于抑制噪声,不是严格的多相界面模型。
用户手册定位:[主要配置文件](#6-主要配置文件)、[VTK 文件说明](#8-vtk-文件说明)、[diagnostics.csv 说明](#9-diagnosticscsv-说明)。
```text
d rho_i / dt = sum_j m_j (v_i - v_j) · grad W_ij
```
对应代码:
```text
updateDensity.m
```
为减弱弱可压 SPH 中常见的密度噪声,程序加入可选密度扩散项:
```matlab
cfg.fluid.densityDiffusionAlpha
```
默认不跨水/气材料界面扩散:
```matlab
cfg.fluid.diffuseAcrossMaterials = false;
```
这样可以减少水气界面被数值扩散过度抹平的问题。
### 4. 人工黏性
程序采用 Monaghan 型人工黏性思想,在粒子相互接近时提供耗散。人工黏性的作用包括:
实现程度:工程简化。人工黏性可提高稳定性,但不能替代专门的水下爆炸冲击波捕捉格式。
用户手册定位:[主要配置文件](#6-主要配置文件)、[加速建议](#11-加速建议)。
- 抑制粒子穿透
- 减弱高频压力振荡
- 在压缩区提供数值耗散
- 提高强压力梯度下的稳定性
主要参数:
```matlab
cfg.materials.water.viscosityAlpha
cfg.materials.gas.viscosityAlpha
cfg.fluid.interfaceViscosityScale
```
其中 `interfaceViscosityScale` 用于缩放不同材料粒子之间的人工黏性,避免水/气界面被过度黏结。
注意:当前人工黏性不是严格高分辨率冲击捕捉格式。若用于定量水下爆炸冲击波预测,需要进一步引入更强的冲击捕捉或 Riemann-SPH 等技术。
### 5. 多材料 EOS
每个流体粒子携带独立材料编号和 EOS 类型:
实现程度:框架完整。逐粒子材料和 EOS 选择已经实现;具体 EOS 参数和爆轰产物状态方程仍需按工程问题标定或替换。
用户手册定位:[接触爆炸配置](#62-接触爆炸配置)、[VTK 文件说明](#8-vtk-文件说明)。
```matlab
state.fluid.material
state.fluid.eosType
```
当前支持:
```text
eosType = 1 Tait 水体 EOS
eosType = 2 线性气体占位 EOS
eosType = 3 理想气体 EOS
```
Tait 水体 EOS:
```text
p = rho0 c0^2 / gamma * ((rho / rho0)^gamma - 1)
```
理想气体 EOS:
```text
p = (gamma - 1) rho e
```
其中 `e` 为比内能:
```matlab
state.fluid.specificInternalEnergy
```
EOS 实现位于:
```text
equationOfState.m
```
所有 EOS 都会叠加 `extraPressure`,该字段用于爆炸压力源。
### 6. 气体内能方程
对于 `eosType = 3` 的理想气体粒子,程序可以更新比内能。当前包含:
实现程度:工程简化。气体内能更新已可运行,但只作用于理想气体粒子,未求解水体能量方程和真实爆轰产物热力学过程。
用户手册定位:[接触爆炸配置](#62-接触爆炸配置)、[diagnostics.csv 说明](#9-diagnosticscsv-说明)。
- 压力功
- 可选人工黏性耗散热
对应代码:
```text
updateInternalEnergy.m
```
压力功采用密度变化率形式:
```text
de / dt = p / rho^2 * d rho / dt
```
相关配置:
```matlab
cfg.fluid.updateInternalEnergy
cfg.fluid.viscousHeatingFactor
cfg.fluid.maxSpecificInternalEnergy
```
当前只更新理想气体粒子的内能,不更新水体内能。
### 7. 爆炸源与气泡压力近似
爆炸源由:
```text
applyExplosionSource.m
```
实现。当前爆源不是完整爆轰模型,而是一个可调的气体生成和压力源框架。
实现程度:工程简化。该模块用于生成水下接触爆炸的数值驱动过程,不能等同于真实炸药爆轰、燃烧反应或爆轰产物膨胀模型。
用户手册定位:[水下接触爆炸算例](#4-水下接触爆炸算例)、[接触爆炸配置](#62-接触爆炸配置)、[diagnostics.csv 说明](#9-diagnosticscsv-说明)。
主要步骤:
1. 根据 `burnDuration` 计算爆源进度。
2. 爆源半径从 `initialRadius` 增长到 `finalRadius`。
3. 爆源区域内的水粒子转换为气体粒子。
4. 记录生成气体质量、释放能量、源区体积和气体体积。
5. 按 `pressureMode` 施加压力源或能量-体积压力估计。
主要参数:
```matlab
cfg.explosion.center
cfg.explosion.initialRadius
cfg.explosion.finalRadius
cfg.explosion.burnDuration
cfg.explosion.gasMassTotal
cfg.explosion.heatReleaseTotal
cfg.explosion.pressurePeak
cfg.explosion.pressureMode
```
压力模式:
```text
prescribed 给定峰值压力和衰减时间
energyVolume 由释放能量和气泡/源区体积估算压力
```
简化气泡压力估计为:
```text
p_bubble = (gamma_bubble - 1) E_internal / V_bubble
```
该模型适合驱动气泡膨胀和破口进舱演示,但不是经过标定的炸药爆轰产物模型。
### 8. 流体-壳体接触
流固耦合采用 penalty 接触法:
```text
couplingForces.m
```
默认使用流体粒子到壳体四边形面片的接触。程序先找出流体粒子附近的壳体面片,再计算粒子到面片的最近点,并根据穿透深度和法向相对速度施加接触力:
实现程度:工程简化。面接触、点接触回退和失效面放行均已实现;但接触刚度依赖参数调节,不是严格的约束接触或摩擦接触模型。
用户手册定位:[算例物理过程](#5-算例物理过程)、[接触爆炸配置](#62-接触爆炸配置)、[常见问题](#12-常见问题)。
```text
F_n = k_contact * penetration - c_contact * v_normal
```
主要参数:
```matlab
cfg.coupling.stiffness
cfg.coupling.damping
cfg.coupling.searchRadiusFactor
```
若壳体面片任一节点失效,该面片不再阻挡流体/气体粒子,从而形成数值破口。
也可以使用点接触回退:
```matlab
cfg.coupling.useShellFaces = false;
```
### 9. 板壳模型
当前程序提供三种壳体模型:
```text
cfg.shell.model = 'spring'
cfg.shell.model = 'kirchhoff_love'
cfg.shell.model = 'reissner_mindlin'
```
默认值为 `spring`,即原有的质点-弹簧工程模型。三个模型共享壳体节点、壳体面片、流固接触、损伤失效和 VTK 输出流程;不同之处主要在 `shellForces.m` 中的壳体内力计算。
实现程度:`spring` 为工程简化且是当前默认稳定模型;`kirchhoff_love` 和 `reissner_mindlin` 已作为可选模型接入求解器。默认 `small_deformation` 路径采用壳体粒子 surface-SPH 梯度、散度和拉普拉斯算子,不使用有限差分算子。`tlsph_large_deformation` 路径使用参考构形 SPH 梯度、Green-Lagrange 型膜应变、曲率/转角 director 项、膜力/弯矩/剪切力结果量和参考构形散度。`ulsph_large_deformation` 路径使用当前构形邻域、当前面积权重和当前构形散度,并将大变形结果量按当前面积映射。当前仍需进一步做边界条件、应力历史转移、损伤本构和工程标定,不应直接等同于工业级有限元壳单元。
对于长时间冲击算例,TLSPH/ULSPH 壳体可能出现非仿射 hourglass 模态。程序提供可选弱稳定项,只在 `hourglassStiffnessFactor > 0` 或 `hourglassDampingFactor > 0` 时发挥作用。该项是数值稳定项,不代表额外物理材料。
TLSPH 和 ULSPH 的 hourglass control 不同:
```text
TLSPH:
X_ij = X_j - X_i
x_ij = x_j - x_i
F_i = grad_0 x_i
hg_x = x_ij - 0.5 * (F_i + F_j) X_ij
hg_v = v_ij - 0.5 * (grad_0 v_i + grad_0 v_j) X_ij
```
对应代码:
```text
shellHourglassForcesTLSPH
```
该项使用参考构形邻域、参考构形 SPH 梯度和参考边残差,适用于 `tlsph_large_deformation`。
```text
ULSPH:
x_ij = x_j - x_i
v_ij = v_j - v_i
L_i = grad_t v_i
hg_v = v_ij - 0.5 * (L_i + L_j) x_ij
```
对应代码:
```text
shellHourglassForcesULSPH
```
该项使用当前构形邻域、当前构形 SPH 梯度和速度残差,适用于 `ulsph_large_deformation`。这种处理符合 ULSPH 每步更新当前构形的思想,避免把参考构形边方向强加给当前构形 hourglass 模态。
用户手册定位:[主要配置文件](#6-主要配置文件)、[VTK 文件说明](#8-vtk-文件说明)、[求解器模块说明](#13-求解器模块说明)。
#### 9.1 spring 模型
`spring` 模型保留当前已有实现。壳体不是传统连续壳单元,而是粒子-弹簧式简化板壳。壳体由以下拓扑组成:
```text
shell.edges 轴向连接边
shell.restLength 边初始长度
shell.bendingTriplets 弯曲三节点组
shell.faces 四边形面片
```
轴向边弹簧模拟面内拉压,弯曲三元组模拟局部曲率变化。边界节点由:
```matlab
state.shell.fixed
```
固定。
主要代码:
```text
shellForces.m
createInitialState.m
```
#### 9.2 kirchhoff_love 模型
`kirchhoff_love` 模型面向薄板假设。当前代码使用壳体粒子邻域上的 surface-SPH 近似:
```text
面内位移 u, v -> SPH 梯度 -> 平面应力膜力 -> SPH 散度
横向位移 w -> SPH Laplacian 两次作用 -> Kirchhoff-Love 弯曲项
材料参数 E, nu, t -> 膜刚度和弯曲刚度
```
弯曲刚度采用:
```text
D = E * t^3 / (12 * (1 - nu^2))
```
当前实现没有显式转角自由度,也没有完整单元刚度矩阵、复杂边界条件处理和厚度方向本构积分;空间导数来自壳体粒子的 SPH 核函数邻域。
若启用:
```matlab
cfg.shell.formulation = 'tlsph_large_deformation';
```
Kirchhoff-Love 分支会使用参考构形 TLSPH 几何:当前基矢 `a_alpha`、参考基矢 `A_alpha`、当前/参考法向、Green-Lagrange 膜应变、曲率变化、膜力 `N` 和弯矩 `M`。膜力散度和弯曲项均通过参考构形 surface-SPH 算子计算。
若启用:
```matlab
cfg.shell.formulation = 'ulsph_large_deformation';
```
Kirchhoff-Love 分支会使用当前构形邻域和当前面积权重计算 `div_s`,同时保留大变形膜应变和曲率结果量。该路径用于当前构形更新试验,尚未包含完整客观应力率历史变量。
#### 9.3 reissner_mindlin 模型
`reissner_mindlin` 模型面向中厚板假设。当前代码在壳体节点上增加两个转角自由度:
```text
shell.theta(:, 1)
shell.theta(:, 2)
shell.omega(:, 1)
shell.omega(:, 2)
```
模型包含:
```text
面内膜力
转角梯度产生的弯曲力矩
横向剪切项
旋转惯量
```
剪切刚度采用:
```text
Ks = shearCorrection * G * t
G = E / (2 * (1 + nu))
```
当前实现已经把转角自由度接入显式时间积分,空间导数由壳体粒子 surface-SPH 算子计算,不使用有限差分;但它仍不是完整 Reissner-Mindlin 有限元壳单元,使用时可能需要比 `spring` 更小的时间步。
若启用:
```matlab
cfg.shell.formulation = 'tlsph_large_deformation';
```
Reissner-Mindlin 分支会构造当前 director:
```text
d = normalize(N + theta_1 A_1_unit + theta_2 A_2_unit)
```
并使用 TLSPH 形式计算膜应变、director 梯度产生的弯曲应变、横向剪切应变、膜力 `N`、弯矩 `M` 和剪切力 `Q`。平动方程使用 `Div_0(N + Q)`,转动方程使用 `Div_0(M) - Q`。
若启用:
```matlab
cfg.shell.formulation = 'ulsph_large_deformation';
```
Reissner-Mindlin 分支会使用当前构形邻域和当前面积权重计算 `div_s(N + Q)` 与 `div_s(M) - Q`,并使用当前构形 SPH 算子恢复 director 梯度。该路径目前是 ULSPH 几何与散度框架,客观率应力历史更新仍属于后续完善内容。
#### 9.4 参考构形更新
`kirchhoff_love` 和 `reissner_mindlin` 在 `small_deformation` 和 `tlsph_large_deformation` 路径中使用参考构形 surface-SPH 算子。程序可选择在仿真中更新壳体参考构形:
```text
updateShellReference.m
```
触发方式包括:
```matlab
cfg.shell.referenceUpdate.frequency = 0; % 0 不按固定步频更新
cfg.shell.referenceUpdate.frequency = 1; % 每步更新
cfg.shell.referenceUpdate.frequency = N; % 每 N 步更新
```
也可以按变形梯度 F 触发:
```matlab
cfg.shell.referenceUpdate.useDeformationGradient = true;
cfg.shell.referenceUpdate.maxAbsF
cfg.shell.referenceUpdate.minDiagonalF
cfg.shell.referenceUpdate.detTolerance
```
当前 F 为壳体中面面内 2x2 变形梯度。触发后程序会将 `state.shell.x0` 更新为当前壳体位置,并同步更新 `shell.restLength`;壳体损伤保留,边塑性残余应变会清零。若 `resetRotation = true`,Reissner-Mindlin 的转角、角速度和角加速度也会清零。
实现程度:工程简化。该功能用于降低参考构形过度畸变带来的数值问题;当前没有完整应力历史转移、客观率更新或严格 updated Lagrangian 本构积分。因此它更接近“参考构形重置/更新”功能,而不是完整 ULSPH 壳体理论。
该功能与:
```matlab
cfg.shell.formulation = 'ulsph_large_deformation';
```
互斥。ULSPH 路径每步使用当前构形,因此不会调用 `updateShellReference.m`,配置检查也会阻止同时启用 `referenceUpdate`。
#### 9.5 严格大变形 TLSPH/ULSPH 壳公式
本节给出 Kirchhoff-Love 与 Reissner-Mindlin 壳在严格大变形 TLSPH 和 ULSPH 框架下应采用的连续公式与 SPH 离散目标。当前代码尚未完整实现本节全部公式;本节用于定义后续升级方向,并区分当前工程简化模型与完整大变形壳理论。
其中 TLSPH 和 ULSPH 均已作为可选代码路径接入:
```matlab
cfg.shell.formulation = 'tlsph_large_deformation';
cfg.shell.formulation = 'ulsph_large_deformation';
```
需要注意:当前 ULSPH 路径已经使用当前构形邻域、当前面积和当前构形散度,但尚未完整实现客观应力率和应力历史变量传递。
通用中面记号:
```text
xi^alpha, alpha = 1,2 壳体中面材料坐标
zeta in [-t/2, t/2] 厚度坐标
X(xi) 参考中面位置
x(xi,t) 当前中面位置
A_alpha = partial X / partial xi^alpha
a_alpha = partial x / partial xi^alpha
A_alpha_beta = A_alpha dot A_beta
a_alpha_beta = a_alpha dot a_beta
N 参考中面法向
n 当前中面法向
B_alpha_beta 参考曲率张量
b_alpha_beta 当前曲率张量
```
TLSPH 的核心是所有核函数梯度、邻域和积分权重均在参考构形中计算:
```text
grad_0 f_i = C_i^{-1} sum_j V_j^0 (f_j - f_i) grad_0 W_ij
C_i = sum_j V_j^0 (X_j - X_i) tensor grad_0 W_ij
V_j^0 = A_j^0 参考中面面积权重
```
ULSPH 的核心是邻域、核函数梯度和积分权重在当前构形中更新:
```text
grad_t f_i = c_i^{-1} sum_j V_j^t (f_j - f_i) grad_t W_ij
c_i = sum_j V_j^t (x_j - x_i) tensor grad_t W_ij
V_j^t = A_j^t 当前中面面积权重
```
##### 9.5.1 Kirchhoff-Love 壳的 TLSPH 公式
Kirchhoff-Love 假设壳法线在变形后仍保持为中面法线,且忽略横向剪切:
```text
phi(X,zeta,t) = x(xi,t) + zeta n(xi,t)
n = (a_1 cross a_2) / |a_1 cross a_2|
```
大变形膜应变和弯曲应变可写为:
```text
E_alpha_beta = 1/2 * (a_alpha_beta - A_alpha_beta)
K_alpha_beta = b_alpha_beta - B_alpha_beta
```
厚度方向任意点的 Green-Lagrange 型壳应变为:
```text
E_alpha_beta(zeta) = E_alpha_beta + zeta K_alpha_beta
```
线弹性平面应力本构可写为:
```text
S^alpha_beta(zeta) = C^alpha_beta_gamma_delta E_gamma_delta(zeta)
```
其中各向同性平面应力刚度为:
```text
C^alpha_beta_gamma_delta =
E / (1 - nu^2) *
[
nu A^alpha_beta A^gamma_delta
+ (1 - nu)/2 * (A^alpha_gamma A^beta_delta + A^alpha_delta A^beta_gamma)
]
```
膜力和弯矩为厚度积分:
```text
N^alpha_beta = integral_{-t/2}^{t/2} S^alpha_beta(zeta) dzeta
M^alpha_beta = integral_{-t/2}^{t/2} zeta S^alpha_beta(zeta) dzeta
```
若材料线弹性且中面为零应力参考态,则常见简化为:
```text
N^alpha_beta = t C^alpha_beta_gamma_delta E_gamma_delta
M^alpha_beta = t^3/12 C^alpha_beta_gamma_delta K_gamma_delta
```
弱式平衡为:
```text
integral_A0 [N^alpha_beta delta E_alpha_beta
+ M^alpha_beta delta K_alpha_beta] dA0
= integral_A0 rho0 t b dot delta x dA0
+ integral_A0 rho0 t x_ddot dot delta x dA0
+ external_work
```
TLSPH 离散时,`E_alpha_beta`、`K_alpha_beta`、`N^alpha_beta` 和 `M^alpha_beta` 的散度均使用 `grad_0`,内部力由参考面积 `A_i^0` 积分。由于 Kirchhoff-Love 需要二阶几何量,严格实现应使用一致的曲率恢复、法向导数和边界条件处理,而不应只用简单 Laplacian 代替完整变分式。
##### 9.5.2 Reissner-Mindlin 壳的 TLSPH 公式
Reissner-Mindlin 壳引入独立 director,不要求 director 始终垂直当前中面:
```text
Phi(X,zeta,t) = x(xi,t) + zeta d(xi,t)
|d| = 1
D 参考 director,通常 D = N
d 当前 director
```
厚度点的基矢为:
```text
G_alpha(zeta) = A_alpha + zeta D_,alpha
g_alpha(zeta) = a_alpha + zeta d_,alpha
G_3 = D
g_3 = d
```
完整 Green-Lagrange 应变为:
```text
E_alpha_beta(zeta) =
1/2 * [g_alpha(zeta) dot g_beta(zeta)
- G_alpha(zeta) dot G_beta(zeta)]
E_alpha_3(zeta) =
1/2 * [g_alpha(zeta) dot d - G_alpha(zeta) dot D]
E_33 = 1/2 * [d dot d - D dot D] = 0
```
常用一阶厚度展开得到广义应变:
```text
membrane:
epsilon_alpha_beta = 1/2 * (a_alpha dot a_beta - A_alpha dot A_beta)
bending:
kappa_alpha_beta = 1/2 * (a_alpha dot d_,beta + a_beta dot d_,alpha
- A_alpha dot D_,beta - A_beta dot D_,alpha)
transverse shear:
gamma_alpha = a_alpha dot d - A_alpha dot D
```
本构与厚度积分:
```text
N^alpha_beta = integral S^alpha_beta dzeta
M^alpha_beta = integral zeta S^alpha_beta dzeta
Q^alpha = kappa_s integral S^alpha_3 dzeta
```
其中 `kappa_s` 为剪切修正系数。线弹性小厚度应变下:
```text
N^alpha_beta = t C^alpha_beta_gamma_delta epsilon_gamma_delta
M^alpha_beta = t^3/12 C^alpha_beta_gamma_delta kappa_gamma_delta
Q^alpha = kappa_s G t gamma^alpha
```
TLSPH 动量与转动平衡的强式目标可写为:
```text
rho0 t x_ddot = Div_0(N) + body + contact
rho0 I d_ddot = Div_0(M) - Q + body_moment + contact_moment + lambda d
I = t^3 / 12
```
`lambda d` 用于 enforcing `|d|=1` 的约束或通过归一化/指数映射更新 director。严格 TLSPH 实现应在参考构形中计算 `Div_0(N)`、`Div_0(M)` 和剪切项,并在每步更新 director 的单位长度和转动惯量。
##### 9.5.3 Kirchhoff-Love 壳的 ULSPH 公式
ULSPH 在当前构形中更新邻域、面积和核梯度,通常使用速率形式和客观应力率。Kirchhoff-Love 当前构形仍满足:
```text
phi(x,zeta,t) = x(xi,t) + zeta n(xi,t)
n = (a_1 cross a_2) / |a_1 cross a_2|
```
当前中面速度为 `v = x_dot`,速度梯度和面内应变率:
```text
l_alpha_beta = v_,alpha dot a_beta
d_alpha_beta = 1/2 * (l_alpha_beta + l_beta_alpha)
```
曲率速率可由当前法向和速度导数恢复:
```text
dot b_alpha_beta = dot n dot x_,alpha beta + n dot v_,alpha beta
```
或在弱式中通过 `delta b_alpha_beta` 的一致变分避免显式二阶速度导数。
当前构形的应力结果量采用客观率更新:
```text
objective_rate(N^alpha_beta) = C_N^alpha_beta_gamma_delta d_gamma_delta
objective_rate(M^alpha_beta) = C_M^alpha_beta_gamma_delta dot kappa_gamma_delta
```
典型客观率可选 Jaumann rate 或 Green-Naghdi rate。当前构形强式平衡为:
```text
rho t a = div_s(n_shell) + external
```
其中 `div_s` 使用当前面梯度 `grad_t`,`n_shell` 表示由 `N^alpha_beta` 和 `M^alpha_beta` 产生的中面内力与弯曲内力。ULSPH 离散时,所有散度、面积和邻域均使用当前构形:
```text
internal_force_i =
sum_j A_i^t A_j^t pair_divergence_t(N, M, grad_t W_ij)
```
严格 ULSPH Kirchhoff-Love 壳需要持续更新当前法向、曲率、面积权重、边界切向基,并使用客观率避免刚体转动产生虚假应变。
##### 9.5.4 Reissner-Mindlin 壳的 ULSPH 公式
Reissner-Mindlin ULSPH 使用当前中面和当前 director:
```text
Phi(x,zeta,t) = x(xi,t) + zeta d(xi,t)
|d| = 1
```
速度和 director 速率:
```text
v = x_dot
omega director 角速度
dot d = omega cross d
```
当前构形广义应变率:
```text
membrane rate:
d_alpha_beta = 1/2 * (v_,alpha dot a_beta + v_,beta dot a_alpha)
bending rate:
dot kappa_alpha_beta =
1/2 * (v_,alpha dot d_,beta + v_,beta dot d_,alpha
+ a_alpha dot dot d_,beta + a_beta dot dot d_,alpha)
shear rate:
dot gamma_alpha = v_,alpha dot d + a_alpha dot dot d
```
应力结果量采用客观率更新:
```text
objective_rate(N^alpha_beta) = C_N^alpha_beta_gamma_delta d_gamma_delta
objective_rate(M^alpha_beta) = C_M^alpha_beta_gamma_delta dot kappa_gamma_delta
objective_rate(Q^alpha) = C_Q^alpha_beta dot gamma_beta
```
当前构形平衡方程:
```text
rho t x_ddot = div_s(N) + shear_divergence(Q) + external_force
rho I omega_dot = div_s(M) - Q + external_moment
```
若使用 director 而不是转角参数,更新后需要:
```text
d <- normalize(d)
omega <- omega - (omega dot d) d
```
以保持 director 单位长度和角速度切向性。ULSPH 离散时,`div_s(N)`、`div_s(M)`、`Q` 的贡献均使用当前构形 SPH 梯度 `grad_t` 和当前面积权重 `A_i^t`。
##### 9.5.5 对当前代码升级的含义
若要把当前 `kirchhoff_love` 和 `reissner_mindlin` 的 TLSPH/ULSPH 路径继续升级为工业级完整大变形壳模型,还需要完善以下模块:
```text
1. 中面局部基矢、法向、director 和曲率的稳定 SPH 重构
2. 参考/当前构形面积权重和校正矩阵
3. 完整膜应变、弯曲应变、剪切应变或其速率形式
4. 厚度积分得到 N、M、Q
5. TLSPH: 更完整的第一/第二 Piola-Kirchhoff 应力结果量、历史变量和边界弱式
6. ULSPH: Cauchy 应力结果量、客观率更新和历史变量传递
7. director 单位长度约束、转动惯量和角动量守恒
8. 壳体边界条件、接触力矩、损伤后应力释放和历史变量转移
```
因此,当前 `referenceUpdate` 只能视为参考构形重置工具,不等同于完整 ULSPH;`tlsph_large_deformation` 和 `ulsph_large_deformation` 已经接入几何和散度框架,但仍需继续补齐上述本构、历史变量和边界弱式细节。
### 10. 壳体塑性
壳体边塑性由:
```text
updateShellPlasticity.m
```
实现。程序计算每条边的总应变:
实现程度:工程简化。当前塑性是边弹簧层面的残余应变更新,适合演示永久变形趋势,不是板壳厚度方向塑性或塑性铰模型。
用户手册定位:[接触爆炸配置](#62-接触爆炸配置)、[VTK 文件说明](#8-vtk-文件说明)。
```text
strain = (currentLength - restLength) / restLength
```
当弹性试应变超过:
```matlab
cfg.shell.yieldStrain
```
超出部分按速率松弛为塑性应变:
```matlab
cfg.shell.plasticRate
cfg.shell.maxPlasticStrain
```
塑性应变会改变该边的有效静止长度,从而影响后续弹性回复力。该模型是边弹簧塑性,不是完整板壳塑性理论。
### 11. 损伤与失效
壳体损伤由:
```text
updateShellDamage.m
```
实现。当前包含两类损伤:
实现程度:工程简化。损伤和失效机制已可触发数值破口,但不是断裂力学、裂纹扩展或碎片化模型。
用户手册定位:[常见问题:壳体没有明显破坏](#125-壳体没有明显破坏)、[VTK 文件说明](#8-vtk-文件说明)、[diagnostics.csv 说明](#9-diagnosticscsv-说明)。
- 应变损伤
- 压力损伤
应变损伤参数:
```matlab
cfg.shell.failureStrain
cfg.shell.damageRate
```
压力损伤参数:
```matlab
cfg.shell.failurePressure
cfg.shell.pressureDamageRate
```
损伤变量范围:
```text
0 <= damage <= 1
```
当壳体节点损伤达到 1 时:
```matlab
state.shell.failed = state.shell.damage >= 1.0
```
失效节点不再提供壳体内力,也不再参与流体阻挡。包含失效节点的面片会形成数值破口。
### 12. 边界条件
模拟盒子由:
```text
applySimulationBox.m
```
处理,定义粒子越过计算域六个盒面后的行为:
```matlab
cfg.simBox.mode = 'free';
cfg.simBox.mode = 'reflect';
cfg.simBox.mode = 'delete';
```
实现程度:框架完整。`free` 表示粒子不受模拟盒子影响;`reflect` 表示粒子接近盒壁时受解析边界反力,越界后按 `cfg.simBox.restitution` 反弹;`delete` 表示流体粒子越过激活盒面后从计算中删除。当前删除只作用于流体粒子,不删除壳体节点。
用户手册定位:[接触爆炸配置](#62-接触爆炸配置)、[主要配置文件](#6-主要配置文件)、[diagnostics.csv 说明](#9-diagnosticscsv-说明)。
可通过以下参数控制参与盒子处理的六个面:
```matlab
cfg.simBox.activeWalls = [xMin xMax yMin yMax zMin zMax]
```
接触爆炸算例默认顶部打开:
```matlab
cfg.simBox.activeWalls = [true, true, true, true, true, false];
```
接触爆炸算例当前使用:
```matlab
cfg.simBox.mode = 'delete';
```
解析盒边界反力由:
```text
boundaryForces.m
```
实现。默认使用解析盒边界,并只在 `cfg.simBox.mode = 'reflect'` 时启用:
实现程度:框架完整。解析盒边界和边界粒子回退均已实现;但远场无限域和特征非反射边界尚未实现。
用户手册定位:[接触爆炸配置](#62-接触爆炸配置)、[主要配置文件](#6-主要配置文件)。
```matlab
cfg.boundary.useAnalyticBox = true;
```
可通过以下参数控制六个边界面是否施加反力:
```matlab
cfg.boundary.activeWalls = [xMin xMax yMin yMax zMin zMax]
```
通常建议让 `cfg.boundary.activeWalls` 与 `cfg.simBox.activeWalls` 保持一致。
接触爆炸算例默认顶部打开:
```matlab
cfg.boundary.activeWalls = [true, true, true, true, true, false];
```
### 13. 海绵层阻尼
海绵层由:
```text
applySpongeLayer.m
```
实现,用于减小远场边界反射。它对靠近指定边界的粒子施加速度阻尼和密度扰动阻尼:
实现程度:工程简化。海绵层可降低反射,但不能完全替代严格的非反射边界条件。
用户手册定位:[主要配置文件](#6-主要配置文件)、[加速建议](#11-加速建议)。
```matlab
cfg.sponge.enabled
cfg.sponge.width
cfg.sponge.velocityDamping
cfg.sponge.densityDamping
cfg.sponge.activeWalls
```
海绵层不是严格非反射边界,但对小规模演示和调试有帮助。
### 14. 显式时间积分
程序采用显式时间推进。单步流程位于:
实现程度:框架完整。显式积分、CFL 时间步估计和按 `cfg.time.tEnd` 截断最后一步已实现;隐式结构积分和流固子循环尚未实现。
用户手册定位:[主要配置文件](#6-主要配置文件)、[加速建议](#11-加速建议)、[自定义算例](#10-自定义算例)。
```text
stepSimulation.m
```
主要顺序:
1. 估计时间步。
2. 应用爆源。
3. 更新 EOS 压力。
4. 更新壳体塑性。
5. 构建邻域缓存。
6. 计算流体力、壳体力、接触力和边界力。
7. 显式积分位置和速度。
8. 更新密度、内能和海绵层。
9. 更新诊断量。
时间步估计位于:
```text
estimateTimeStep.m
```
采用用户给定时间步、流体 CFL 估计和可选壳体稳定步长的较小值:
```text
dt = min(cfg.time.dt, dtFluidCfl, dtShell)
```
`spring` 模型默认不额外限制壳体时间步;`kirchhoff_love` 和 `reissner_mindlin` 会根据壳体材料波速估计 `dtShell`,其中 `reissner_mindlin` 还会考虑转动惯量和横向剪切刚度。由于是显式积分,声速、爆炸压力、接触刚度、壳体刚度和粒子间距都会影响稳定时间步。
除物理终止时间外,还可用最大步数限制仿真:
```matlab
cfg.time.stepMax = 100000000;
```
默认值为 `100000000`,通常不会主动截断仿真。若 `state.step` 达到 `stepMax`,即使 `state.time < cfg.time.tEnd`,主循环也会停止,并在终端输出 `Stop: stepMax`。
### 15. 邻域搜索与矢量化
SPH 的主要计算成本来自邻域搜索和成对粒子作用。程序使用三维 cell-linked list 思路:
实现程度:框架完整。MATLAB 版本已经做了缓存和矢量化优化;若追求大规模工程计算,建议进一步改为 MEX/C++、GPU 或并行实现。
用户手册定位:[加速建议](#11-加速建议)、[求解器模块说明](#13-求解器模块说明)。
```text
findPairs.m
```
当前实现特点:
- 将粒子映射到三维网格 cell。
- 使用整数 cell key 排序匹配。
- 自邻域搜索使用半邻域偏移,减少重复候选。
- 每个时间步缓存邻域结果,供流体力、密度更新、内能更新、损伤和接触复用。
- 热点模块使用矩阵运算和 `accumarray` 汇总。
这仍是 MATLAB 实现。若需要进一步大幅提速,建议将邻域搜索改为 MEX/C++,或使用 GPU/并行化。
### 16. 舱室进水/进气统计
舱室监测不是独立流体模型,而是空间统计器。程序根据:
实现程度:诊断/占位。该功能统计水/气粒子是否进入指定舱室区域,不求解舱室空气压缩、舱内液面演化或多舱连通流。
用户手册定位:[接触爆炸配置](#62-接触爆炸配置)、[常见问题:水和气体没有进入舱内](#126-水和气体没有进入舱内)、[VTK 文件说明](#8-vtk-文件说明)、[diagnostics.csv 说明](#9-diagnosticscsv-说明)。
```matlab
cfg.compartment
```
判断流体粒子是否进入舱室区域,并输出:
```text
compartment_water_count
compartment_gas_count
compartment_water_mass
compartment_gas_mass
compartment_water_volume
compartment_gas_volume
```
VTK 中可用:
```text
inside_compartment
```
查看粒子是否位于舱室监测区内。
### 17. 当前技术路线总结
当前程序组合了以下数值技术:
- 三维拉格朗日粒子离散
- 弱可压 SPH
- 三维 cubic spline 核函数
- cell-linked list 邻域搜索
- 多材料粒子和逐粒子 EOS
- Tait 水体 EOS
- 理想气体 EOS
- 人工黏性
- 密度扩散
- 简化爆源气体生成
- 能量-体积气泡压力估计
- penalty 流体-壳体接触
- 粒子-弹簧简化板壳
- 边塑性模型
- 应变/压力损伤失效模型
- 解析盒边界
- 海绵层阻尼
- 显式时间积分
- VTK/CSV 诊断输出
这些技术构成了一个可扩展的仿真框架。后续可逐步替换其中的简化模块,例如将壳体弹簧模型替换为真实壳单元,将爆源替换为标定爆轰产物 EOS,将边界替换为非反射边界。
用户手册定位:[当前模型限制](#当前模型限制)、[推荐工作流](#推荐工作流)。
## 当前模型限制
当前模型适合做程序框架开发、算法验证和定性演示。用于工程定量预测前,还需要补充和校核:
- 真实爆轰/燃烧模型
- 爆轰产物 EOS
- 水下冲击波捕捉
- 空化模型
- 更真实的气泡动力学和二次脉动
- 真实板壳单元或结构有限元模型
- 断裂、碎片和接触后的碎片运动
- 舱室空气压缩和淹没过程
- 非反射边界或无限域处理
- 网格/粒子收敛性验证和实验标定
## 推荐工作流
建议按以下顺序使用:
1. 运行 `run_plate_fluid_demo`,确认环境和基础输出正常。
2. 运行 `run_fast_contact_explosion_demo`,快速检查接触爆炸流程。
3. 修改 `contactExplosionConfig.m` 或新建自定义算例入口。
4. 先关闭 VTK/PNG,用短时间、小粒子数调试参数。
5. 参数稳定后,打开 VTK 和 CSV 输出。
6. 用 ParaView 查看粒子场、壳体损伤和进舱过程。
7. 用 `diagnostics.csv` 分析压力、损伤、气体生成和进舱时间历程。