Files
SPHLite/docs/01_requirements_specification.md
T

92 lines
5.6 KiB
Markdown
Raw Normal View History

2026-07-02 18:47:38 +08:00
# 01 需求规格说明
文档状态:规划确认稿
## 1. 软件定位
SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。软件应能描述水下爆炸载荷、水体运动、爆轰产物气体、气泡产生与脉动、船体结构大变形和破裂,并能与 FEMLite 进行接触耦合和连续体耦合。
SPHLite 不定位为通用 SPH 框架,也不只是颗粒接触工具。其通用数值能力应服务于船舶水下接触爆炸目标,并按“水-气-爆炸-结构-耦合”的多物理平台规划。
SPHLite 的求解维度面向 3D。1D、2D 或轴对称模型可作为验证、简化算例或后处理概念使用,但不作为正式求解维度规划。
## 2. 长期目标能力
长期目标能力包括:
- 3D 实体 SPH 粒子仿真水体运动、冲击波传播和自由界面演化。
- 3D 实体 SPH 粒子仿真船体结构的大变形、塑性、损伤和破裂。
- 板壳 SPH 粒子仿真船体板壳结构的变形、屈曲、撕裂和穿孔。
- 炸药粒子的点火、爆轰传播和能量释放,采用解析点火/爆轰传播路线,而不是固定球面载荷模型。
- `Gas` 统一表示爆轰产物气体、舱内空气、空泡和混合气体。
- 爆炸气体在水中形成气泡,支持气泡膨胀、回缩、脉动和迁移统计。
- 船舱局部破坏和水气结构相互作用。
- `Solid` 与 FEMLite 3D 实体单元之间的接触耦合和连续体耦合。
- `Shell` 与 FEMLite 壳单元之间的接触耦合和连续体耦合。
FEMLite 侧术语使用“实体单元”和“壳单元”;SPHLite 侧术语使用“实体粒子”和“板壳粒子”,避免将 FEM 单元误称为粒子。
## 3. 各版本交付范围
各版本交付范围是规划边界,实际版本号可根据验证闭环调整。
| 版本线 | 交付范围 |
|---|---|
| 0.1 | CMake/CTest 工程骨架、3D 粒子状态、生命周期、错误码、C ABI 和最小 Python 调试入口 |
| 0.2 | 3D 水体 SPH 基础能力、核函数、邻域搜索、弱可压 SPH、Tait EOS 和小型压力传播测试 |
| 0.3 | `Gas`,最小 EOS 集合为 JWL 和理想气体;气体体积、中心、平均压力和等效气泡半径诊断 |
| 0.4 | `Explosive`,解析点火、爆轰到达时间、反应进度和向 `Gas` 的质量/能量注入 |
| 0.5 | `Solid` 3D 结构粒子,Johnson-Cook 材料模型和 Johnson-Cook 失效模型的最小闭环 |
| 0.6 | `Shell` 板壳粒子,板壳运动、厚度/法向、Johnson-Cook 路线下的板壳失效和撕裂初步能力 |
| 0.7 | 水-气-结构局部爆炸 smoke,覆盖气体膨胀、气泡诊断和结构响应 |
| 0.8 | SPH 与 FEMLite 的接触耦合,覆盖 SPH-FEM facet 载荷交换和运动边界 |
| 0.9 | SPH 与 FEMLite 的连续体耦合,覆盖 `Solid` 与 FEMLite 实体、`Shell` 与 FEMLite 壳的界面或重叠区耦合 |
| 1.0 | 船舱局部水下接触爆炸破坏综合 benchmark |
## 4. 关键物理路线
水体模型长期需要支持水下爆炸近场所需的可压缩 SPH 或 Riemann-SPH。早期版本允许先使用弱可压 SPH 建立粒子、邻域、时间推进、输出和验证框架。
`Gas` 的第一批 EOS 为 JWL 和理想气体。JWL 用于爆轰产物气体,理想气体用于空气或低压气体。Stiffened gas、tabular EOS 和混合气体高级模型作为后续扩展。
`Explosive` 的主路线是解析点火、爆轰传播和炸药粒子反应。球面经验载荷模型不得作为主模型,只能作为校核、边界载荷或对比工具。
结构模型的初步目标是 Johnson-Cook 材料模型和 Johnson-Cook 失效模型。基础弹性响应可作为单元测试和算法调试所需的退化路径,但交付目标应面向率相关塑性、损伤和失效。
FEM-SPH 连续体耦合是核心需求,不应简化为接触问题。连续体耦合应支持同一结构连续体中一部分使用 FEMLite 计算、另一部分使用 SPHLite 计算。具体方法,如节点投影、重叠区耦合或界面约束,放入算法和接口文档继续讨论。
## 5. 工程接口需求
- 软件应提供 C ABI,作为 C++、Python 和 FEMLite 耦合的稳定边界。
- C++ 接口可用于内部实现和高级调用。
- Python 接口先用于调试、算例生成、后处理和验收检查,不要求第一阶段提供完整绑定。
- 与 FEMLite 的耦合应通过明确的数据契约完成,不直接依赖 FEMLite 内部数据库。
- 所有可失败接口必须返回错误码,并提供可查询的错误消息。
## 6. 当前不交付范围
以下能力不应放入初始版本默认交付:
- 完整整船级水下爆炸长算例。
- 工业级高精度爆轰化学反应模型。
- 完整多材料断裂和焊缝失效库。
- 大规模并行和 GPU 后端。
- 生产级 FEM-SPH 强耦合非线性隐式算法。
- 完整商业软件输入文件兼容。
## 7. 质量要求
- 每个新增物理能力必须有小型、可重复的测试或 checker。
- 不支持的物理模型、材料模型或输入关键字必须明确报错,不得静默回退。
- 默认验证算例应小而可控,长跑和研究算例不进入默认 release gate。
- 输出文件、临时结果、大型 CSV/VTK/restart 不应提交到源码仓库。
- 文档使用 UTF-8 without BOM 编码。
## 8. 待讨论问题
- 第一版输入格式采用自定义关键字、JSON/YAML,还是类 Abaqus 风格。
- 可压缩 SPH/Riemann-SPH 的引入版本和验收算例。
- Johnson-Cook 参数、单位系统和失效删除/软化策略。
- `Shell` 的法向、转角或 director 表达方式。
- FEM-SPH 连续体耦合第一版采用节点投影、重叠区还是界面约束。