Files
MDHelper/docs

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 计算量很大。调试时建议:

  1. 增大粒子间距:
cfg.particles.dx = 0.05;
  1. 缩短仿真时间:
cfg.time.tEnd = 2.0e-4;
  1. 关闭重输出:
cfg.output.writeSnapshots = false;
cfg.output.writeVtk = false;
cfg.output.writeCsv = false;
cfg.output.showFigure = false;
  1. 降低输出频率:
cfg.output.plotEvery = 100;
cfg.output.vtkEvery = 100;
cfg.output.logEvery = 50;
  1. 只写 ParaView 需要的 XML VTK:
cfg.output.writeLegacyVtk = false;
  1. 使用 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;
  1. 调试代码路径时可临时关闭部分耗散/内能模型:
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 参数和爆轰产物状态方程仍需按工程问题标定或替换。

用户手册定位:接触爆炸配置、VTK 文件说明。

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 说明。

主要步骤:

  1. 根据 burnDuration 计算爆源进度。
  2. 爆源半径从 initialRadius 增长到 finalRadius。
  3. 爆源区域内的水粒子转换为气体粒子。
  4. 记录生成气体质量、释放能量、源区体积和气体体积。
  5. 按 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

实现。程序计算每条边的总应变:

实现程度:工程简化。当前塑性是边弹簧层面的残余应变更新,适合演示永久变形趋势,不是板壳厚度方向塑性或塑性铰模型。

用户手册定位:接触爆炸配置、VTK 文件说明。

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

主要顺序:

  1. 估计时间步。
  2. 应用爆源。
  3. 更新 EOS 压力。
  4. 更新壳体塑性。
  5. 构建邻域缓存。
  6. 计算流体力、壳体力、接触力和边界力。
  7. 显式积分位置和速度。
  8. 更新密度、内能和海绵层。
  9. 更新诊断量。

时间步估计位于:

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
  • 水下冲击波捕捉
  • 空化模型
  • 更真实的气泡动力学和二次脉动
  • 真实板壳单元或结构有限元模型
  • 断裂、碎片和接触后的碎片运动
  • 舱室空气压缩和淹没过程
  • 非反射边界或无限域处理
  • 网格/粒子收敛性验证和实验标定

推荐工作流

建议按以下顺序使用:

  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 分析压力、损伤、气体生成和进舱时间历程。