348f244693e3edd38307c0c12f2ef9f5b8eff14a
SPHLite
SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。
当前开发版本:0.5.1。该版本定位为 Solid 3D 实体结构粒子稳定化和结构算法加固版本,在 0.5.0 已建立 Solid 最小闭环的基础上,补强参考构型、速度梯度、应变率、最小内力、能量诊断、restart 兼容和接口可观测性。不交付 Shell 的生产路径,也不交付真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行或工程级结构破坏 benchmark。
代码仓库地址:
目标能力
- 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 仅作为参考和外部耦合对象。
文档
- 文档索引
- 01 需求规格说明
- 02 软件架构设计
- 03 详细设计
- 04 数学模型与算法
- 05 接口控制文档
- 06 测试与验证计划
- 07 用户手册
- 08 开发者手册
- 09 版本历史与验收记录
- 10 后续开发路线图
- 11 Benchmark 与验收矩阵
当前状态
0.5.1 当前在 0.5.0 Solid 起步闭环基线之上开展 Solid 稳定化和结构算法加固。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 转化最小闭环。Explosivesummary、CSV 输出字段、STATE_0_4restart、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_1restart 和STATE_0_4兼容读入。 - 0.4.1 追加 release balance 的 Fortran API、C ABI、C++ wrapper、Python ctypes、CLI 和专项 CTest gate。
- 0.5.0 新增
Solid3D 实体结构粒子的 material/section 输入、密度/弹性参数、Johnson-Cook flow/failure 参数、softening 控制和 Solid 输入错误路径。 - 0.5.0 新增 Solid 状态数组、弹性与 Johnson-Cook 材料点、damage 累积、线性渐进软化、结构波速稳定时间步、Solid-only 显式 smoke、CSV 输出和
STATE_0_5restart。 - 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_1restart 和粒子级状态接口。 - CouplingInterface 的中立数据导出、外部粒子力导入和诊断占位保持可用;真实 FEM-SPH 联合运行仍由外部 CouplingModule 后续实现。
Shell仍为后续阶段,不在 0.5.1 交付生产计算路径。- 0.5.0 本地 gate 已通过:完整 CTest 83/83,0.4.1 Explosive 回归 gate 14/14,0.5.0 Solid 专项 gate 17/17,
source_size1/1,git diff --check通过。
Description
Languages
Fortran
75.7%
C
12.7%
CMake
4.9%
Python
4.6%
C++
1.6%
Other
0.5%