Files
CCLite/SPHLite/docs/01_requirements_specification.md
T
2026-07-05 22:48:27 +08:00

5.6 KiB

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 连续体耦合第一版采用节点投影、重叠区还是界面约束。