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