76 lines
3.7 KiB
Markdown
76 lines
3.7 KiB
Markdown
# SPHLite
|
|
|
|
SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。
|
|
|
|
当前目标版本:0.1.1。该版本定位为框架加固和接口闭合版,在 0.1.0 工程骨架基础上完善输入元数据、粒子状态查询、C ABI/C++/Python/CLI、output、restart 和 CouplingInterface 占位测试,不交付生产级水下爆炸、气泡脉动、结构破裂或 FEM-SPH 联合计算能力。
|
|
|
|
代码仓库地址:
|
|
|
|
- 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.1.1 当前实现重点包括:
|
|
|
|
- CMake/CTest 工程骨架。
|
|
- Fortran 95 核心库、C ABI、C++ 头文件薄包装和 Python `ctypes` 调试入口。
|
|
- Abaqus `.inp` 明确子集的元数据占位解析。
|
|
- 粒子状态查询和常量一致性检查。
|
|
- Velocity-Verlet 显式推进骨架加固。
|
|
- CSV output 和 restart 占位闭环。
|
|
- Water、Gas、Explosive、Solid、Shell 和 CouplingInterface 的占位模块。
|
|
- 0.1.1 release gate 与 source size 门禁。
|