Files
SPHLite/README.md
T
2026-07-03 16:54:45 +08:00

85 lines
5.9 KiB
Markdown
Raw 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.5.1。该版本定位为 `Solid` 3D 实体结构粒子稳定化和结构算法加固版本,在 0.5.0 已建立 Solid 最小闭环的基础上,补强参考构型、速度梯度、应变率、最小内力、能量诊断、restart 兼容和接口可观测性。不交付 `Shell` 的生产路径,也不交付真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行或工程级结构破坏 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、VTK、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.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 转化最小闭环。
- `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 和粒子级状态接口。
- 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_size` 1/1,`git diff --check` 通过。