Files
2026-07-05 21:41:34 +08:00

115 lines
12 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# SPHLite
SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。
当前发布版本:0.8.3。该版本定位为 CCLite worker 集成加固版,在 0.8.2 worker mock 契约基础上新增能力查询、Windows shared memory/named event IPC 适配器自测、AOR v1 粒子/力数据块、contact state 导入、`*SPHLITE CCLITE` 输入开关和 worker 诊断文件 gate。本地发布 gate 已通过;仍不交付真实外部 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 作为测试入口。
- 算法核心 `sphlite_core` 维持 Fortran 95,包括求解器、粒子/单元语义、材料和物理模块;worker、CLI、IPC 等外围集成层及其测试/工具性 Fortran 代码可放宽到 Fortran 2018。
- 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.3 当前以 0.8.2 CCLite worker mock 契约版本为起点,完成 SPHLite 侧 Windows IPC self-test、worker 数据块和诊断链路加固。0.5.0 以来已完成内容主要包括:
- CMake/CTest 工程骨架、Fortran 95 算法核心库,以及可使用 Fortran 2018 的 worker/CLI/IPC 外围集成目标。
- 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.3 新增 `--cclite-capabilities`、Windows shared memory/named event IPC attach/loop 自测、AOR v1 粒子/力数据块、contact state 导入、`*SPHLITE CCLITE` 输入开关、worker log/particle report/force report 和 CCLite mock 命令闭环加固测试。
- 0.8.3 本地发布 gate 已通过:完整 CTest 200/200,worker/coupling 专项 gate 55/55,source size 相关 gate 9/9,`git diff --check` 通过;无限水域爆炸示例脚本生成 VTU/PVD,`tools/publish_to_cclite.bat -TargetRoot ..\CCLite\SPHLite` 实际发布通过。
- 0.8.3 仍不交付真实外部 CCLite 进程联调,不交付真实 SPH-FEM 接触/FSI,不交付生产级 CCLite 载荷求解。