SPH_SHELL 文档
SPH_SHELL 是一个 MATLAB 三维 SPH 板壳-流体相互作用程序框架。当前代码面向两类用途:
- 普通板壳-流体耦合演示:水体粒子与柔性板/壳粒子接触作用。
- 船舶水下接触爆炸框架演示:爆源逐步生成气体、推动水体形成气泡、与船体板壳接触、诱发舱壁损伤破坏,并统计水/气进入舱室的过程。
注意:本程序是可运行的数值仿真框架,不是已经校核过的工程级水下爆炸毁伤预测软件。爆轰、气泡、壳体破坏和流固接触模型均为可替换的简化模型。
用户手册
1. 运行环境
建议环境:
- MATLAB R2024a 或较新版本
- Windows/Linux/macOS 均可,当前开发路径为 Windows
- 可选:ParaView,用于查看
.vtk结果文件
本代码不依赖第三方 MATLAB toolbox。只需将仓库根目录加入 MATLAB 路径。
2. 目录结构
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 命令窗口中进入仓库根目录,例如:
cd('D:\CODE\SPH_SHELL')
addpath(genpath(pwd));
运行默认板-流体算例:
run_plate_fluid_demo
该演示入口会在 defaultConfig() 的基础上显式设置:
cfg.shell.model = 'reissner_mindlin';
若 cfg.output.writeVtk = true,该入口会在仿真结束后自动调用 splitVtkFiles,生成:
output/split_parts/water.pvd
output/split_parts/explosive.pvd
output/split_parts/shell.pvd
output/split_parts/wall.pvd
也可以运行:
main
若需要测试当前构形 ULSPH 大变形壳公式,可运行:
run_plate_fluid_ulsph
该算例使用:
cfg.shell.formulation = 'ulsph_large_deformation';
ULSPH 每步更新当前构形邻域和面积,计算量明显高于默认板-流体演示,建议先缩短 cfg.time.tEnd 调试。
默认输出目录为:
output/
4. 水下接触爆炸算例
运行完整接触爆炸框架算例:
addpath(genpath(pwd));
run_underwater_contact_explosion_demo
该入口调用:
cfg = contactExplosionConfig();
state = createInitialState(cfg);
runSimulation(state, cfg);
默认输出目录为:
output_contact_explosion/
该算例当前采用 Reissner-Mindlin 壳体模型:
cfg.shell.model = 'reissner_mindlin';
该算例当前采用删除型模拟盒子:
cfg.simBox.mode = 'delete';
快速调试版本
如果只是检查代码是否能跑,建议先运行快速版本:
run_fast_contact_explosion_demo
该算例使用更粗粒子、更短仿真时间,并关闭 PNG/VTK 重输出,适合调试。
VTK/PVD 分组后处理
完成接触爆炸计算并生成 particles.pvd 后,可运行:
post_underwater_contact_explosion
默认读取:
output_contact_explosion/particles.pvd
并输出:
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 正确识别时间序列。板壳部分会保留壳体面片和面片损伤字段。
也可以直接调用通用拆分函数:
splitVtkFiles('output_contact_explosion/particles.pvd', ...
'output_contact_explosion/split_parts');
splitVtkFiles 默认使用同样的四类分组;也支持自定义分组规则:
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 默认配置
默认板-流体算例配置位于:
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 接触爆炸配置
接触爆炸算例配置位于:
config/contactExplosionConfig.m
常用参数如下。
计算域:
cfg.domain.xMin
cfg.domain.xMax
cfg.domain.yMin
cfg.domain.yMax
cfg.domain.zMin
cfg.domain.zMax
粒子分辨率:
cfg.particles.dx
cfg.particles.hFactor
dx 越小,粒子越多,结果更细,但计算量会显著增加。三维问题中粒子数大约随 1 / dx^3 增长。
时间控制:
cfg.time.dt
cfg.time.tEnd
cfg.time.cfl
cfg.time.stepMax
水和气体材料:
cfg.materials.water
cfg.materials.gas
EOS 类型:
eosType = 1 Tait 水体 EOS
eosType = 2 线性气体占位 EOS
eosType = 3 理想气体 EOS,使用 specificInternalEnergy
壳体参数:
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
默认壳体模型为:
cfg.shell.model = 'spring';
cfg.shell.formulation = 'small_deformation';
注意:这是全局默认配置;run_plate_fluid_demo.m 和水下接触爆炸算例 contactExplosionConfig.m 均已显式设置为:
cfg.shell.model = 'reissner_mindlin';
可选值:
spring 当前已有的质点-弹簧工程模型,默认选项
kirchhoff_love Kirchhoff-Love 薄板理论的 surface-SPH 工程实现
reissner_mindlin Reissner-Mindlin 中厚板理论的 surface-SPH 工程实现
kirchhoff_love 和 reissner_mindlin 可选择三种公式路径:
small_deformation 小变形/工程简化 surface-SPH 公式,默认选项
tlsph_large_deformation 基于参考构形的 TLSPH 大变形壳公式
ulsph_large_deformation 基于当前构形的 ULSPH 大变形壳公式
注意:ulsph_large_deformation 与 cfg.shell.referenceUpdate 互斥。ULSPH 路径每步使用当前构形邻域、当前面积和当前构形散度,不需要也不允许再设置参考构形更新。
TLSPH/ULSPH 大变形壳体可启用弱 hourglass 稳定项,用于抑制壳粒子沿中面方向的非仿射飞散:
cfg.shell.hourglassStiffnessFactor = 0.02;
cfg.shell.hourglassDampingFactor = 0.25;
默认值为 0,表示不启用。TLSPH 和 ULSPH 使用不同的 hourglass 公式:TLSPH 基于参考构形非仿射位移/速度残差,ULSPH 基于当前构形速度梯度残差。该项不替代真实本构,主要用于控制 SPH 壳体的零能或弱约束模态。
壳体参考构形更新为可选功能,默认关闭:
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 梯度计算。
爆源参数:
cfg.explosion.center
cfg.explosion.initialRadius
cfg.explosion.finalRadius
cfg.explosion.burnDuration
cfg.explosion.gasMassTotal
cfg.explosion.heatReleaseTotal
cfg.explosion.pressurePeak
cfg.explosion.pressureMode
舱室监测区域:
cfg.compartment.enabled
cfg.compartment.xMin
cfg.compartment.xMax
cfg.compartment.yMin
cfg.compartment.yMax
cfg.compartment.zMin
cfg.compartment.zMax
模拟盒子:
cfg.simBox.mode % 'free'、'reflect' 或 'delete'
cfg.simBox.activeWalls % [xMin xMax yMin yMax zMin zMax]
cfg.simBox.restitution % reflect 模式反弹系数
三种盒子模式含义:
free 粒子越界后不受模拟盒子影响,也不施加解析盒边界反力
reflect 粒子接近盒壁时受边界反力,越界后按 restitution 反弹,默认模式
delete 不施加盒壁反力,流体粒子越过 activeWalls 指定的盒面后被删除
delete 当前只删除流体粒子;壳体粒子保持拓扑完整,由固定边界、接触和损伤模型控制。
水下接触爆炸算例 contactExplosionConfig.m 已显式设置为:
cfg.simBox.mode = 'delete';
7. 输出文件
每次运行后,程序会在 cfg.output.directory 下写出结果。常见文件包括:
snapshot_00001.png
particles_00001.vtk
particles_00001.vtp
particles.pvd
diagnostics.csv
输出频率由以下参数控制:
cfg.output.plotEvery
cfg.output.vtkEvery
cfg.output.logEvery
输出开关:
cfg.output.writeSnapshots
cfg.output.writeVtk
cfg.output.writeLegacyVtk
cfg.output.writeCsv
cfg.output.showFigure
调试时建议关闭重输出:
cfg.output.writeSnapshots = false;
cfg.output.writeVtk = false;
cfg.output.writeCsv = false;
cfg.output.showFigure = false;
若只需要 ParaView 时间序列,可以保留 cfg.output.writeVtk = true,并关闭 legacy .vtk:
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,这样可以直接按时间步播放整段结果。
主要点数据字段:
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 加速度矢量
主要单元数据字段:
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 画图分析。
常见列包括:
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 中读取:
T = readtable('output_contact_explosion/diagnostics.csv');
plot(T.time, T.max_pressure);
xlabel('time / s');
ylabel('max pressure / Pa');
10. 自定义算例
建议不要直接修改求解器文件,而是新建一个算例入口。例如:
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
然后运行:
addpath(genpath(pwd));
run_my_case
11. 加速建议
三维 SPH 计算量很大。调试时建议:
- 增大粒子间距:
cfg.particles.dx = 0.05;
- 缩短仿真时间:
cfg.time.tEnd = 2.0e-4;
- 关闭重输出:
cfg.output.writeSnapshots = false;
cfg.output.writeVtk = false;
cfg.output.writeCsv = false;
cfg.output.showFigure = false;
- 降低输出频率:
cfg.output.plotEvery = 100;
cfg.output.vtkEvery = 100;
cfg.output.logEvery = 50;
- 只写 ParaView 需要的 XML VTK:
cfg.output.writeLegacyVtk = false;
- 使用 Verlet 邻域缓存减少
findPairs调用:
cfg.neighbor.useVerlet = true;
cfg.neighbor.skinFactor = 0.25;
cfg.neighbor.rebuildEvery = 25;
默认配置中 cfg.neighbor.useVerlet = false,因为水下接触爆炸早期粒子速度很高,小 skin 可能频繁重建并增加候选粒子对,未必更快。skinFactor 越大,邻域重建越少,但每次参与计算的候选粒子对越多;rebuildEvery 是强制重建间隔,用于避免缓存长期漂移。对于较平稳的长时间流固耦合算例,可以打开该选项并测试不同 skinFactor。若需要逐步排查数值问题,可关闭:
cfg.neighbor.useVerlet = false;
- 调试代码路径时可临时关闭部分耗散/内能模型:
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 提示找不到函数
确认已在仓库根目录运行:
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 壳体没有明显破坏
可以检查:
cfg.explosion.pressurePeak
cfg.shell.failurePressure
cfg.shell.failureStrain
cfg.shell.damageRate
cfg.shell.pressureDamageRate
也可以查看 diagnostics.csv 中的:
max_shell_damage
failed_shell_count
failed_face_count
12.6 水和气体没有进入舱内
检查壳体是否已经失效,以及舱室监测区域是否正确:
cfg.compartment
在 VTK 中可查看 inside_compartment 字段。
13. 求解器模块说明
主要模块位于 sph/:
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 快照绘图
理论与数值方法手册
本节说明当前程序采用的主要数值仿真技术。这里的描述对应代码中的实现,用于帮助理解程序结构、参数含义和结果解释。
相关用户手册入口:算例物理过程、主要配置文件、输出文件、VTK 文件说明、diagnostics.csv 说明、加速建议、求解器模块说明。
实现程度分为三类:
框架完整 程序中已有可运行实现,数据结构和计算流程完整
工程简化 可用于定性演示或框架验证,但物理模型经过明显简化
诊断/占位 主要用于统计、可视化或后续扩展,不代表完整物理模型
当前各项技术实现程度概览:
| 技术 | 当前实现程度 | 说明 |
|---|---|---|
| 拉格朗日粒子离散 | 框架完整 | 流体、气体、壳体、边界均有粒子数据结构 |
| 弱可压 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. 拉格朗日粒子离散
程序采用拉格朗日粒子方法描述流体、爆炸气体、壳体和边界。粒子随物质运动,适合处理大变形、自由表面、破口流动和多材料相互作用。
实现程度:框架完整。粒子数据结构、初始化、时间推进和输出链路均已实现;但粒子分辨率、自适应加密和粒子重整化尚未实现。
用户手册定位:算例物理过程、求解器模块说明、VTK 文件说明。
主要粒子类型包括:
fluid particles 水体和爆炸气体粒子
shell particles 船体局部板壳粒子
boundary particles 边界粒子或解析边界的辅助粒子
流体粒子携带:
x, v, rho, p, m, material, eosType
壳体粒子携带:
x, v, m, damage, failed, fixed
theta, omega Reissner-Mindlin 模型使用的转角和角速度
这种统一粒子框架使水、气体和壳体可以在同一时间循环中耦合推进。
2. 弱可压 SPH 方法
流体求解采用弱可压 SPH,即 WCSPH。核心模块为:
实现程度:工程简化。当前 WCSPH 流程完整可运行,适合框架验证和定性分析;但尚未包含高阶一致性修正、Riemann 求解器、严格冲击捕捉或空化模型。
findPairs.m
kernelCubicSpline.m
kernelCubicSplineGrad.m
fluidForces.m
updateDensity.m
equationOfState.m
程序使用三维 cubic spline 核函数。光滑长度为:
state.h = cfg.particles.hFactor * cfg.particles.dx
邻域搜索半径为:
2.0 * state.h
压力力采用对称 SPH 离散:
F_ij = -m_i m_j (p_i / rho_i^2 + p_j / rho_j^2) grad W_ij
这种形式使粒子间相互作用成对出现,有利于保持总动量守恒。
3. 密度连续方程与密度扩散
密度通过 SPH 连续方程更新:
实现程度:框架完整到工程简化之间。连续方程实现完整;密度扩散是稳定化近似,用于抑制噪声,不是严格的多相界面模型。
用户手册定位:主要配置文件、VTK 文件说明、diagnostics.csv 说明。
d rho_i / dt = sum_j m_j (v_i - v_j) · grad W_ij
对应代码:
updateDensity.m
为减弱弱可压 SPH 中常见的密度噪声,程序加入可选密度扩散项:
cfg.fluid.densityDiffusionAlpha
默认不跨水/气材料界面扩散:
cfg.fluid.diffuseAcrossMaterials = false;
这样可以减少水气界面被数值扩散过度抹平的问题。
4. 人工黏性
程序采用 Monaghan 型人工黏性思想,在粒子相互接近时提供耗散。人工黏性的作用包括:
实现程度:工程简化。人工黏性可提高稳定性,但不能替代专门的水下爆炸冲击波捕捉格式。
- 抑制粒子穿透
- 减弱高频压力振荡
- 在压缩区提供数值耗散
- 提高强压力梯度下的稳定性
主要参数:
cfg.materials.water.viscosityAlpha
cfg.materials.gas.viscosityAlpha
cfg.fluid.interfaceViscosityScale
其中 interfaceViscosityScale 用于缩放不同材料粒子之间的人工黏性,避免水/气界面被过度黏结。
注意:当前人工黏性不是严格高分辨率冲击捕捉格式。若用于定量水下爆炸冲击波预测,需要进一步引入更强的冲击捕捉或 Riemann-SPH 等技术。
5. 多材料 EOS
每个流体粒子携带独立材料编号和 EOS 类型:
实现程度:框架完整。逐粒子材料和 EOS 选择已经实现;具体 EOS 参数和爆轰产物状态方程仍需按工程问题标定或替换。
state.fluid.material
state.fluid.eosType
当前支持:
eosType = 1 Tait 水体 EOS
eosType = 2 线性气体占位 EOS
eosType = 3 理想气体 EOS
Tait 水体 EOS:
p = rho0 c0^2 / gamma * ((rho / rho0)^gamma - 1)
理想气体 EOS:
p = (gamma - 1) rho e
其中 e 为比内能:
state.fluid.specificInternalEnergy
EOS 实现位于:
equationOfState.m
所有 EOS 都会叠加 extraPressure,该字段用于爆炸压力源。
6. 气体内能方程
对于 eosType = 3 的理想气体粒子,程序可以更新比内能。当前包含:
实现程度:工程简化。气体内能更新已可运行,但只作用于理想气体粒子,未求解水体能量方程和真实爆轰产物热力学过程。
用户手册定位:接触爆炸配置、diagnostics.csv 说明。
- 压力功
- 可选人工黏性耗散热
对应代码:
updateInternalEnergy.m
压力功采用密度变化率形式:
de / dt = p / rho^2 * d rho / dt
相关配置:
cfg.fluid.updateInternalEnergy
cfg.fluid.viscousHeatingFactor
cfg.fluid.maxSpecificInternalEnergy
当前只更新理想气体粒子的内能,不更新水体内能。
7. 爆炸源与气泡压力近似
爆炸源由:
applyExplosionSource.m
实现。当前爆源不是完整爆轰模型,而是一个可调的气体生成和压力源框架。
实现程度:工程简化。该模块用于生成水下接触爆炸的数值驱动过程,不能等同于真实炸药爆轰、燃烧反应或爆轰产物膨胀模型。
用户手册定位:水下接触爆炸算例、接触爆炸配置、diagnostics.csv 说明。
主要步骤:
- 根据
burnDuration计算爆源进度。 - 爆源半径从
initialRadius增长到finalRadius。 - 爆源区域内的水粒子转换为气体粒子。
- 记录生成气体质量、释放能量、源区体积和气体体积。
- 按
pressureMode施加压力源或能量-体积压力估计。
主要参数:
cfg.explosion.center
cfg.explosion.initialRadius
cfg.explosion.finalRadius
cfg.explosion.burnDuration
cfg.explosion.gasMassTotal
cfg.explosion.heatReleaseTotal
cfg.explosion.pressurePeak
cfg.explosion.pressureMode
压力模式:
prescribed 给定峰值压力和衰减时间
energyVolume 由释放能量和气泡/源区体积估算压力
简化气泡压力估计为:
p_bubble = (gamma_bubble - 1) E_internal / V_bubble
该模型适合驱动气泡膨胀和破口进舱演示,但不是经过标定的炸药爆轰产物模型。
8. 流体-壳体接触
流固耦合采用 penalty 接触法:
couplingForces.m
默认使用流体粒子到壳体四边形面片的接触。程序先找出流体粒子附近的壳体面片,再计算粒子到面片的最近点,并根据穿透深度和法向相对速度施加接触力:
实现程度:工程简化。面接触、点接触回退和失效面放行均已实现;但接触刚度依赖参数调节,不是严格的约束接触或摩擦接触模型。
F_n = k_contact * penetration - c_contact * v_normal
主要参数:
cfg.coupling.stiffness
cfg.coupling.damping
cfg.coupling.searchRadiusFactor
若壳体面片任一节点失效,该面片不再阻挡流体/气体粒子,从而形成数值破口。
也可以使用点接触回退:
cfg.coupling.useShellFaces = false;
9. 板壳模型
当前程序提供三种壳体模型:
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 不同:
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
对应代码:
shellHourglassForcesTLSPH
该项使用参考构形邻域、参考构形 SPH 梯度和参考边残差,适用于 tlsph_large_deformation。
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
对应代码:
shellHourglassForcesULSPH
该项使用当前构形邻域、当前构形 SPH 梯度和速度残差,适用于 ulsph_large_deformation。这种处理符合 ULSPH 每步更新当前构形的思想,避免把参考构形边方向强加给当前构形 hourglass 模态。
用户手册定位:主要配置文件、VTK 文件说明、求解器模块说明。
9.1 spring 模型
spring 模型保留当前已有实现。壳体不是传统连续壳单元,而是粒子-弹簧式简化板壳。壳体由以下拓扑组成:
shell.edges 轴向连接边
shell.restLength 边初始长度
shell.bendingTriplets 弯曲三节点组
shell.faces 四边形面片
轴向边弹簧模拟面内拉压,弯曲三元组模拟局部曲率变化。边界节点由:
state.shell.fixed
固定。
主要代码:
shellForces.m
createInitialState.m
9.2 kirchhoff_love 模型
kirchhoff_love 模型面向薄板假设。当前代码使用壳体粒子邻域上的 surface-SPH 近似:
面内位移 u, v -> SPH 梯度 -> 平面应力膜力 -> SPH 散度
横向位移 w -> SPH Laplacian 两次作用 -> Kirchhoff-Love 弯曲项
材料参数 E, nu, t -> 膜刚度和弯曲刚度
弯曲刚度采用:
D = E * t^3 / (12 * (1 - nu^2))
当前实现没有显式转角自由度,也没有完整单元刚度矩阵、复杂边界条件处理和厚度方向本构积分;空间导数来自壳体粒子的 SPH 核函数邻域。
若启用:
cfg.shell.formulation = 'tlsph_large_deformation';
Kirchhoff-Love 分支会使用参考构形 TLSPH 几何:当前基矢 a_alpha、参考基矢 A_alpha、当前/参考法向、Green-Lagrange 膜应变、曲率变化、膜力 N 和弯矩 M。膜力散度和弯曲项均通过参考构形 surface-SPH 算子计算。
若启用:
cfg.shell.formulation = 'ulsph_large_deformation';
Kirchhoff-Love 分支会使用当前构形邻域和当前面积权重计算 div_s,同时保留大变形膜应变和曲率结果量。该路径用于当前构形更新试验,尚未包含完整客观应力率历史变量。
9.3 reissner_mindlin 模型
reissner_mindlin 模型面向中厚板假设。当前代码在壳体节点上增加两个转角自由度:
shell.theta(:, 1)
shell.theta(:, 2)
shell.omega(:, 1)
shell.omega(:, 2)
模型包含:
面内膜力
转角梯度产生的弯曲力矩
横向剪切项
旋转惯量
剪切刚度采用:
Ks = shearCorrection * G * t
G = E / (2 * (1 + nu))
当前实现已经把转角自由度接入显式时间积分,空间导数由壳体粒子 surface-SPH 算子计算,不使用有限差分;但它仍不是完整 Reissner-Mindlin 有限元壳单元,使用时可能需要比 spring 更小的时间步。
若启用:
cfg.shell.formulation = 'tlsph_large_deformation';
Reissner-Mindlin 分支会构造当前 director:
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。
若启用:
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 算子。程序可选择在仿真中更新壳体参考构形:
updateShellReference.m
触发方式包括:
cfg.shell.referenceUpdate.frequency = 0; % 0 不按固定步频更新
cfg.shell.referenceUpdate.frequency = 1; % 每步更新
cfg.shell.referenceUpdate.frequency = N; % 每 N 步更新
也可以按变形梯度 F 触发:
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 壳体理论。
该功能与:
cfg.shell.formulation = 'ulsph_large_deformation';
互斥。ULSPH 路径每步使用当前构形,因此不会调用 updateShellReference.m,配置检查也会阻止同时启用 referenceUpdate。
9.5 严格大变形 TLSPH/ULSPH 壳公式
本节给出 Kirchhoff-Love 与 Reissner-Mindlin 壳在严格大变形 TLSPH 和 ULSPH 框架下应采用的连续公式与 SPH 离散目标。当前代码尚未完整实现本节全部公式;本节用于定义后续升级方向,并区分当前工程简化模型与完整大变形壳理论。
其中 TLSPH 和 ULSPH 均已作为可选代码路径接入:
cfg.shell.formulation = 'tlsph_large_deformation';
cfg.shell.formulation = 'ulsph_large_deformation';
需要注意:当前 ULSPH 路径已经使用当前构形邻域、当前面积和当前构形散度,但尚未完整实现客观应力率和应力历史变量传递。
通用中面记号:
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 的核心是所有核函数梯度、邻域和积分权重均在参考构形中计算:
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 的核心是邻域、核函数梯度和积分权重在当前构形中更新:
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 假设壳法线在变形后仍保持为中面法线,且忽略横向剪切:
phi(X,zeta,t) = x(xi,t) + zeta n(xi,t)
n = (a_1 cross a_2) / |a_1 cross a_2|
大变形膜应变和弯曲应变可写为:
E_alpha_beta = 1/2 * (a_alpha_beta - A_alpha_beta)
K_alpha_beta = b_alpha_beta - B_alpha_beta
厚度方向任意点的 Green-Lagrange 型壳应变为:
E_alpha_beta(zeta) = E_alpha_beta + zeta K_alpha_beta
线弹性平面应力本构可写为:
S^alpha_beta(zeta) = C^alpha_beta_gamma_delta E_gamma_delta(zeta)
其中各向同性平面应力刚度为:
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)
]
膜力和弯矩为厚度积分:
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
若材料线弹性且中面为零应力参考态,则常见简化为:
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
弱式平衡为:
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 始终垂直当前中面:
Phi(X,zeta,t) = x(xi,t) + zeta d(xi,t)
|d| = 1
D 参考 director,通常 D = N
d 当前 director
厚度点的基矢为:
G_alpha(zeta) = A_alpha + zeta D_,alpha
g_alpha(zeta) = a_alpha + zeta d_,alpha
G_3 = D
g_3 = d
完整 Green-Lagrange 应变为:
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
常用一阶厚度展开得到广义应变:
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
本构与厚度积分:
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 为剪切修正系数。线弹性小厚度应变下:
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 动量与转动平衡的强式目标可写为:
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 当前构形仍满足:
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,速度梯度和面内应变率:
l_alpha_beta = v_,alpha dot a_beta
d_alpha_beta = 1/2 * (l_alpha_beta + l_beta_alpha)
曲率速率可由当前法向和速度导数恢复:
dot b_alpha_beta = dot n dot x_,alpha beta + n dot v_,alpha beta
或在弱式中通过 delta b_alpha_beta 的一致变分避免显式二阶速度导数。
当前构形的应力结果量采用客观率更新:
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。当前构形强式平衡为:
rho t a = div_s(n_shell) + external
其中 div_s 使用当前面梯度 grad_t,n_shell 表示由 N^alpha_beta 和 M^alpha_beta 产生的中面内力与弯曲内力。ULSPH 离散时,所有散度、面积和邻域均使用当前构形:
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:
Phi(x,zeta,t) = x(xi,t) + zeta d(xi,t)
|d| = 1
速度和 director 速率:
v = x_dot
omega director 角速度
dot d = omega cross d
当前构形广义应变率:
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
应力结果量采用客观率更新:
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
当前构形平衡方程:
rho t x_ddot = div_s(N) + shear_divergence(Q) + external_force
rho I omega_dot = div_s(M) - Q + external_moment
若使用 director 而不是转角参数,更新后需要:
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 路径继续升级为工业级完整大变形壳模型,还需要完善以下模块:
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. 壳体塑性
壳体边塑性由:
updateShellPlasticity.m
实现。程序计算每条边的总应变:
实现程度:工程简化。当前塑性是边弹簧层面的残余应变更新,适合演示永久变形趋势,不是板壳厚度方向塑性或塑性铰模型。
strain = (currentLength - restLength) / restLength
当弹性试应变超过:
cfg.shell.yieldStrain
超出部分按速率松弛为塑性应变:
cfg.shell.plasticRate
cfg.shell.maxPlasticStrain
塑性应变会改变该边的有效静止长度,从而影响后续弹性回复力。该模型是边弹簧塑性,不是完整板壳塑性理论。
11. 损伤与失效
壳体损伤由:
updateShellDamage.m
实现。当前包含两类损伤:
实现程度:工程简化。损伤和失效机制已可触发数值破口,但不是断裂力学、裂纹扩展或碎片化模型。
用户手册定位:常见问题:壳体没有明显破坏、VTK 文件说明、diagnostics.csv 说明。
- 应变损伤
- 压力损伤
应变损伤参数:
cfg.shell.failureStrain
cfg.shell.damageRate
压力损伤参数:
cfg.shell.failurePressure
cfg.shell.pressureDamageRate
损伤变量范围:
0 <= damage <= 1
当壳体节点损伤达到 1 时:
state.shell.failed = state.shell.damage >= 1.0
失效节点不再提供壳体内力,也不再参与流体阻挡。包含失效节点的面片会形成数值破口。
12. 边界条件
模拟盒子由:
applySimulationBox.m
处理,定义粒子越过计算域六个盒面后的行为:
cfg.simBox.mode = 'free';
cfg.simBox.mode = 'reflect';
cfg.simBox.mode = 'delete';
实现程度:框架完整。free 表示粒子不受模拟盒子影响;reflect 表示粒子接近盒壁时受解析边界反力,越界后按 cfg.simBox.restitution 反弹;delete 表示流体粒子越过激活盒面后从计算中删除。当前删除只作用于流体粒子,不删除壳体节点。
用户手册定位:接触爆炸配置、主要配置文件、diagnostics.csv 说明。
可通过以下参数控制参与盒子处理的六个面:
cfg.simBox.activeWalls = [xMin xMax yMin yMax zMin zMax]
接触爆炸算例默认顶部打开:
cfg.simBox.activeWalls = [true, true, true, true, true, false];
接触爆炸算例当前使用:
cfg.simBox.mode = 'delete';
解析盒边界反力由:
boundaryForces.m
实现。默认使用解析盒边界,并只在 cfg.simBox.mode = 'reflect' 时启用:
实现程度:框架完整。解析盒边界和边界粒子回退均已实现;但远场无限域和特征非反射边界尚未实现。
cfg.boundary.useAnalyticBox = true;
可通过以下参数控制六个边界面是否施加反力:
cfg.boundary.activeWalls = [xMin xMax yMin yMax zMin zMax]
通常建议让 cfg.boundary.activeWalls 与 cfg.simBox.activeWalls 保持一致。
接触爆炸算例默认顶部打开:
cfg.boundary.activeWalls = [true, true, true, true, true, false];
13. 海绵层阻尼
海绵层由:
applySpongeLayer.m
实现,用于减小远场边界反射。它对靠近指定边界的粒子施加速度阻尼和密度扰动阻尼:
实现程度:工程简化。海绵层可降低反射,但不能完全替代严格的非反射边界条件。
cfg.sponge.enabled
cfg.sponge.width
cfg.sponge.velocityDamping
cfg.sponge.densityDamping
cfg.sponge.activeWalls
海绵层不是严格非反射边界,但对小规模演示和调试有帮助。
14. 显式时间积分
程序采用显式时间推进。单步流程位于:
实现程度:框架完整。显式积分、CFL 时间步估计和按 cfg.time.tEnd 截断最后一步已实现;隐式结构积分和流固子循环尚未实现。
stepSimulation.m
主要顺序:
- 估计时间步。
- 应用爆源。
- 更新 EOS 压力。
- 更新壳体塑性。
- 构建邻域缓存。
- 计算流体力、壳体力、接触力和边界力。
- 显式积分位置和速度。
- 更新密度、内能和海绵层。
- 更新诊断量。
时间步估计位于:
estimateTimeStep.m
采用用户给定时间步、流体 CFL 估计和可选壳体稳定步长的较小值:
dt = min(cfg.time.dt, dtFluidCfl, dtShell)
spring 模型默认不额外限制壳体时间步;kirchhoff_love 和 reissner_mindlin 会根据壳体材料波速估计 dtShell,其中 reissner_mindlin 还会考虑转动惯量和横向剪切刚度。由于是显式积分,声速、爆炸压力、接触刚度、壳体刚度和粒子间距都会影响稳定时间步。
除物理终止时间外,还可用最大步数限制仿真:
cfg.time.stepMax = 100000000;
默认值为 100000000,通常不会主动截断仿真。若 state.step 达到 stepMax,即使 state.time < cfg.time.tEnd,主循环也会停止,并在终端输出 Stop: stepMax。
15. 邻域搜索与矢量化
SPH 的主要计算成本来自邻域搜索和成对粒子作用。程序使用三维 cell-linked list 思路:
实现程度:框架完整。MATLAB 版本已经做了缓存和矢量化优化;若追求大规模工程计算,建议进一步改为 MEX/C++、GPU 或并行实现。
findPairs.m
当前实现特点:
- 将粒子映射到三维网格 cell。
- 使用整数 cell key 排序匹配。
- 自邻域搜索使用半邻域偏移,减少重复候选。
- 每个时间步缓存邻域结果,供流体力、密度更新、内能更新、损伤和接触复用。
- 热点模块使用矩阵运算和
accumarray汇总。
这仍是 MATLAB 实现。若需要进一步大幅提速,建议将邻域搜索改为 MEX/C++,或使用 GPU/并行化。
16. 舱室进水/进气统计
舱室监测不是独立流体模型,而是空间统计器。程序根据:
实现程度:诊断/占位。该功能统计水/气粒子是否进入指定舱室区域,不求解舱室空气压缩、舱内液面演化或多舱连通流。
用户手册定位:接触爆炸配置、常见问题:水和气体没有进入舱内、VTK 文件说明、diagnostics.csv 说明。
cfg.compartment
判断流体粒子是否进入舱室区域,并输出:
compartment_water_count
compartment_gas_count
compartment_water_mass
compartment_gas_mass
compartment_water_volume
compartment_gas_volume
VTK 中可用:
inside_compartment
查看粒子是否位于舱室监测区内。
17. 当前技术路线总结
当前程序组合了以下数值技术:
- 三维拉格朗日粒子离散
- 弱可压 SPH
- 三维 cubic spline 核函数
- cell-linked list 邻域搜索
- 多材料粒子和逐粒子 EOS
- Tait 水体 EOS
- 理想气体 EOS
- 人工黏性
- 密度扩散
- 简化爆源气体生成
- 能量-体积气泡压力估计
- penalty 流体-壳体接触
- 粒子-弹簧简化板壳
- 边塑性模型
- 应变/压力损伤失效模型
- 解析盒边界
- 海绵层阻尼
- 显式时间积分
- VTK/CSV 诊断输出
这些技术构成了一个可扩展的仿真框架。后续可逐步替换其中的简化模块,例如将壳体弹簧模型替换为真实壳单元,将爆源替换为标定爆轰产物 EOS,将边界替换为非反射边界。
当前模型限制
当前模型适合做程序框架开发、算法验证和定性演示。用于工程定量预测前,还需要补充和校核:
- 真实爆轰/燃烧模型
- 爆轰产物 EOS
- 水下冲击波捕捉
- 空化模型
- 更真实的气泡动力学和二次脉动
- 真实板壳单元或结构有限元模型
- 断裂、碎片和接触后的碎片运动
- 舱室空气压缩和淹没过程
- 非反射边界或无限域处理
- 网格/粒子收敛性验证和实验标定
推荐工作流
建议按以下顺序使用:
- 运行
run_plate_fluid_demo,确认环境和基础输出正常。 - 运行
run_fast_contact_explosion_demo,快速检查接触爆炸流程。 - 修改
contactExplosionConfig.m或新建自定义算例入口。 - 先关闭 VTK/PNG,用短时间、小粒子数调试参数。
- 参数稳定后,打开 VTK 和 CSV 输出。
- 用 ParaView 查看粒子场、壳体损伤和进舱过程。
- 用
diagnostics.csv分析压力、损伤、气体生成和进舱时间历程。