Files
SPHLite/README.md
T
2026-07-03 21:57:10 +08:00

8.0 KiB
Raw Blame History

SPHLite

SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。

当前开发版本:0.6.1。该版本定位为 Shell director、转动状态、参考面积/惯量、局部坐标系和 Mindlin-Reissner 小变形运动学基线版本,在 0.6.0 已发布的 Shell 输入与状态基线之上推进。不交付 Shell 材料点更新、Shell 内力、Shell 内力矩、完整显式推进生产路径、Shell restart、公开 C ABI/C++/Python/CLI 诊断字段、真实水-气-结构工程爆炸响应或真实 FEM-SPH 联合运行。

代码仓库地址:

目标能力

  • 3D 流体 SPH 粒子仿真水体运动、冲击波传播和自由界面演化。
  • Gas 表示气体相,包括爆轰产物、舱内空气、空泡和混合气体。
  • Explosive 描述炸药点火、爆轰传播、反应进度和向气体相的质量/能量注入。
  • 3D 实体结构 SPH 粒子仿真船体大变形、塑性、损伤和破裂。
  • 板壳 SPH 粒子仿真船体板壳结构变形、屈曲、撕裂和穿孔。
  • 船舱局部破坏、气体膨胀、气泡产生与脉动等水下爆炸现象。
  • SPH 3D 实体结构与 FEMLite 3D 实体单元的接触和连续体耦合。
  • SPH 板壳粒子与 FEMLite 板壳单元的接触和连续体耦合。

模块设想

模块 职责
Core 精度、错误码、生命周期、日志、全局控制
Particle 粒子状态、邻域搜索、核函数和基础数据结构
Water 水体、冲击波和流固界面载荷
Gas 气体 EOS、气体团簇、气泡/气腔统计和界面演化
Explosive 点火、爆轰传播、反应进度和能量释放
Solid 3D 结构粒子、应力更新、损伤和断裂
Shell 板壳粒子、厚度、转角/法向、膜弯剪响应和撕裂
CouplingInterface 中立耦合数据导出、外部载荷导入和耦合诊断占位
Output CSV、VTK、restart 和诊断输出
Interface C ABI、C++ 接口和 Python 调试入口

构建原则

SPHLite 的编译和测试要求应与 FEMLite 保持一致风格:

  • CMake 作为主构建系统。
  • CTest 作为测试入口。
  • Fortran 95 用于核心求解器实现。
  • C ABI 作为长期稳定的跨语言边界。
  • C++ 作为 C ABI 之上的薄包装接口。
  • Python 用于调试脚本、轻量后处理和验收检查。
  • 只在本仓库目录内维护 SPHLite 文件;FEMLite 仅作为参考和外部耦合对象。

文档

当前状态

0.6.1 当前以 0.6.0 Shell 输入与状态基线发布版本为起点,进入 Shell director、局部坐标和小变形运动学开发。0.5.0 以来已完成内容主要包括:

  • CMake/CTest 工程骨架和 Fortran 95 核心库。
  • C ABI、C++ 头文件薄包装和 Python ctypes 调试入口。
  • Abaqus .inp 明确子集解析,以及 *SPHLITE EOS、*SPHLITE VISCOSITY、*SPHLITE PARTICLE CONTROL、*SPHLITE BODY FORCE。
  • 3D Water 粒子的 Wendland/Cubic 核函数、uniform cell 邻域搜索、Tait EOS、Monaghan 人工黏性、连续性方程和 Velocity-Verlet 显式推进。
  • Water summary、稳定时间步诊断、CSV output、restart 和双 pressure wave smoke 小算例。
  • Gas material、三类 Gas EOS、Gas 状态初始化、单相显式推进、气体 summary、bubble metrics、Gas CSV/restart、Gas 源项缓存和公开诊断接口。
  • Explosive 的解析点火、爆轰到达时间、programmed burn 反应进度、释放量统计、Gas 源项注入和 phase 转化最小闭环。
  • Explosive summary、CSV 输出字段、STATE_0_4 restart、0.3.1 restart 兼容读入、Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 字段。
  • 0.4.1 在 0.4.0 基础上加固多点点火、多炸药材料、冻结反应质量、release balance、SOURCE/PHASE 诊断、Water/Gas/Explosive 混合 smoke、STATE_0_4_1 restart 和 STATE_0_4 兼容读入。
  • 0.4.1 追加 release balance 的 Fortran API、C ABI、C++ wrapper、Python ctypes、CLI 和专项 CTest gate。
  • 0.5.0 新增 Solid 3D 实体结构粒子的 material/section 输入、密度/弹性参数、Johnson-Cook flow/failure 参数、softening 控制和 Solid 输入错误路径。
  • 0.5.0 新增 Solid 状态数组、弹性与 Johnson-Cook 材料点、damage 累积、线性渐进软化、结构波速稳定时间步、Solid-only 显式 smoke、CSV 输出和 STATE_0_5 restart。
  • 0.5.0 追加 Solid summary、failure counts、Fortran API、C ABI、C++ wrapper、Python ctypes、CLI 字段和 Solid 专项 CTest gate。
  • 0.5.1 补强 Solid 参考邻域质量、修正矩阵、变形梯度、速度梯度、应变率、最小内力、softening 力学作用、能量诊断、稳定时间步加速度约束和 STATE_0_5_1 restart。
  • 0.5.1 追加 Solid 粒子级状态、诊断和参考质量的 Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 可观测字段。
  • 0.5.1 兼容读入 STATE_0_5 Solid restart,并在读入时初始化 0.5.1 新增状态。
  • 0.5.1 为 source size 门禁拆分 Solid C ABI、Python Solid 调试包装和 Solid API 查询模块;src/solid/sph_solid.f90 作为 Solid 输入/material 表 owner 登记说明性例外。
  • CouplingInterface 的中立数据导出、外部粒子力导入和诊断占位保持可用;真实 FEM-SPH 联合运行仍由外部 CouplingModule 后续实现。
  • 0.6.0 新增 Shell material/section 输入、厚度/3 点和 5 点积分、剪切修正、Shell material 错误路径、未绑定 Shell material warning 和 active Shell 缺失 Shell section error。
  • 0.6.0 新增 Shell 粒子级状态数组、厚度积分点状态数组、active Shell 默认初始化、非 Shell 安全默认值和 3/5 点厚度积分规则。
  • Shell 在 0.6.0 只交付输入与状态基线,不交付 director/转动更新、Mindlin-Reissner 应变路径、Shell 材料点更新、内力、显式推进、restart、公开 API 或生产计算路径。
  • 0.6.1 新增 Shell 显式 director、*ORIENTATION、section orientation、三角形/四边形参考面推断、参考面积、等效转动惯量和 director 质量诊断。
  • 0.6.1 新增 Shell 局部 e1/e2/e3 坐标系、角速度/角加速度状态、*SPHLITE SHELL ROTATION 输入和 director 小转动更新入口。
  • 0.6.1 新增 Mindlin-Reissner 小变形膜应变、弯曲应变、横向剪切应变、厚度积分点应变增量映射和运动学诊断查询入口。
  • Shell 在 0.6.1 仍不交付材料点更新、内力、显式推进、restart、公开接口或生产计算路径。
  • 0.5.0 本地 gate 已通过:完整 CTest 83/83,0.4.1 Explosive 回归 gate 14/14,0.5.0 Solid 专项 gate 17/17,source_size 1/1,git diff --check 通过。
  • 0.5.1 本地 gate 已通过:完整 CTest 99/99,0.5.0 Solid 回归 gate 17/17,0.5.1 Solid 专项 gate 16/16,source_size/solid_source_size/solid_051_source_size 3/3,git diff --check 通过。
  • 0.6.0 本地 gate 已通过:完整 CTest 103/103,Shell 输入/状态基线专项 gate 4/4,source_size 1/1,git diff --check 通过。
  • 0.6.1 本地 gate 已通过:完整 CTest 113/113,Shell 运动学专项 gate 13/13,source_size/shell_061_source_size 2/2,git diff --check 通过。