114 lines
12 KiB
Markdown
114 lines
12 KiB
Markdown
# SPHLite
|
||
|
||
SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。
|
||
|
||
当前发布版本:0.8.2。该版本定位为 CCLite worker 集成预研版,在 0.8.1 中立接触耦合接口稳定化基线之上新增 worker CLI 骨架、IPC adapter mock、命令映射、v2 数据契约、worker 诊断格式和 CCLite mock 命令闭环 gate。本地发布 gate 已通过;不交付真实 Windows shared memory/named event IPC、真实 CCLite 进程联调、真实 FEM-SPH 接触搜索、生产级 FSI 或工程级水下接触爆炸破坏 benchmark。
|
||
|
||
代码仓库地址:
|
||
|
||
- http://123.57.213.67:3062/shen/SPHLite.git
|
||
|
||
## 目标能力
|
||
|
||
- 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、summary CSV、VTU、PVD、restart 和诊断输出 |
|
||
| `Interface` | C ABI、C++ 接口和 Python 调试入口 |
|
||
|
||
## 构建原则
|
||
|
||
SPHLite 的编译和测试要求应与 FEMLite 保持一致风格:
|
||
|
||
- CMake 作为主构建系统。
|
||
- CTest 作为测试入口。
|
||
- Fortran 95 用于核心求解器实现。
|
||
- C ABI 作为长期稳定的跨语言边界。
|
||
- C++ 作为 C ABI 之上的薄包装接口。
|
||
- Python 用于调试脚本、轻量后处理和验收检查。
|
||
- 只在本仓库目录内维护 SPHLite 文件;FEMLite 仅作为参考和外部耦合对象。
|
||
|
||
## 文档
|
||
|
||
- [文档索引](docs/README.md)
|
||
- [01 需求规格说明](docs/01_requirements_specification.md)
|
||
- [02 软件架构设计](docs/02_software_architecture_design.md)
|
||
- [03 详细设计](docs/03_detailed_design.md)
|
||
- [04 数学模型与算法](docs/04_mathematical_model_and_algorithms.md)
|
||
- [05 接口控制文档](docs/05_interface_control_document.md)
|
||
- [06 测试与验证计划](docs/06_test_and_verification_plan.md)
|
||
- [07 用户手册](docs/07_user_manual.md)
|
||
- [08 开发者手册](docs/08_developer_manual.md)
|
||
- [09 版本历史与验收记录](docs/09_release_history.md)
|
||
- [10 后续开发路线图](docs/10_development_roadmap.md)
|
||
- [11 Benchmark 与验收矩阵](docs/11_benchmark_matrix.md)
|
||
|
||
## 当前状态
|
||
|
||
0.8.2 当前以 0.8.1 中立接触耦合接口稳定化版本为起点,完成 CCLite worker 集成预研和 mock 通信闭环。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` 通过。
|
||
- 0.7.0 新增小型 Water/Gas/Explosive/Solid/Shell 局部爆炸 smoke、结构外载荷缓存、载荷诊断和默认回归 gate;该版本只用于链路验收,不作为工程精度 benchmark。
|
||
- 0.7.0 局部爆炸诊断先提供 Fortran API 和 CSV 调试输出,不新增公开 C ABI/C++/Python 稳定接口,也不写入正式 `STATE_0_7` restart。
|
||
- 0.7.0 本地 gate 已通过:完整 CTest 127/127,局部爆炸专项 gate 14/14,source size 相关 gate 7/7,`git diff --check` 通过。
|
||
- 0.7.1 新增多 blast region 输入加固、启用/禁用控制、重复 region 错误检查、Solid/Shell 载荷叠加诊断、多 region 输出/restart 边界测试和 `blast_smoke_071`。
|
||
- 0.7.1 本地 gate 已通过:完整 CTest 139/139,0.7.0 blast 回归 gate 14/14,0.7.1 blast 专项 gate 12/12,Water/Gas/Explosive/Solid/Shell 分类 gate 6/6、16/16、27/27、31/31、13/13,source size 相关 gate 7/7,`git diff --check` 通过。
|
||
- 0.7.1 仍限定在 SPHLite 内部局部爆炸链路稳定化,不进入 0.8 的 FEM-SPH 接触耦合或连续体耦合;不交付真实工程级水下接触爆炸响应、完整舱段破坏 benchmark、Shell 完整动力学闭环或公开 Blast C ABI/C++/Python 稳定接口。
|
||
- 0.8.0 将 `CouplingInterface` 从占位推进为可由外部耦合模块逐步驱动的 SPHLite 侧接触耦合接口,计划覆盖 coupling region 输入、粒子/Facet Proxy 导出、外部力/面载荷/运动边界导入、显式步施加、诊断、restart、C ABI/C++/Python/CLI 和 mock coupling gate。
|
||
- 0.8.0 仍不直接依赖 FEMLite,不实现外部 CouplingModule,不交付连续体耦合,不宣称工程级船舶水下接触爆炸破坏 benchmark。
|
||
- 0.8.0 本地发布 gate 已通过:完整 CTest 163/163,0.8.0 coupling 专项 gate 24/24,Water/Gas/Explosive/Solid/Shell 分类 gate 6/6、19/19、28/28、33/33、14/14,0.7.0 blast 回归 gate 19/19,0.7.1 blast 专项 gate 7/7,source size 相关 gate 8/8,`git diff --check` 通过。
|
||
- 0.8.0 交付的是 SPHLite 侧中立接触耦合接口和 mock coupling smoke;不宣称真实 FEMLite 联合运行、外部 CouplingModule、连续体一体化耦合、生产级接触算法或工程级船舶水下接触爆炸破坏 benchmark。
|
||
- 0.8.1 在 0.8.0 数据契约上追加 pressure、traction、facet resultant、载荷分配、接触状态、载荷守恒诊断、输出/restart 字段、Fortran/C/C++/Python/CLI 接口加固和 0.8.1 mock coupling gate。
|
||
- 0.8.1 本地发布 gate 已通过:完整 CTest 189/189,0.8.1 coupling 专项 gate 26/26,0.8.0 coupling 回归 gate 24/24,Water/Gas/Explosive/Solid/Shell 分类 gate 6/6、19/19、29/29、33/33、14/14,0.7.0 blast 回归 gate 15/15,0.7.1 blast 专项 gate 11/11,source size 相关 gate 9/9,`git diff --check` 通过。
|
||
- 0.8.1 检查确认代码、构建脚本、测试和工具目录未新增 FEMLite 直接依赖,输出目录、CSV、VTK、restart 和临时结果未进入待提交清单。
|
||
- 0.8.1 仍不直接依赖 FEMLite,不实现外部 CouplingModule,不交付连续体耦合,不宣称工程级船舶水下接触爆炸破坏 benchmark。
|
||
- 0.8.2 新增 CCLite worker 入口骨架、IPC adapter mock、命令映射表、v2 数据契约草案、worker 诊断格式和 CCLite mock 命令闭环测试。
|
||
- 0.8.2 本地发布 gate 已通过:完整 CTest 196/196,worker/coupling 专项 gate 56/56,source size 相关 gate 9/9,`git diff --check` 通过。
|
||
- 0.8.2 仍不交付真实 Windows shared memory/named event IPC,不交付真实 CCLite 进程联调,不交付真实 SPH-FEM 接触/FSI。
|