Files
SPHLite/docs/v6.1_development_plan.md
T
2026-07-03 20:22:58 +08:00

22 KiB
Raw Blame History

SPHLite v6.1 开发计划

文档状态:0.6.1 开发计划草案

目标软件版本:SPHLite 0.6.1

1. 文档定位

本文档用于规划 SPHLite 0.6.1 版本的开发范围。0.6.1 继续沿 0.6 Shell 板壳粒子版本线推进,在 0.6.0 已完成 Shell material/section 输入、厚度积分规则、粒子级状态数组和厚度积分点状态数组的基础上,建立 Shell director、转动状态、参考面积/惯量、局部坐标系和 Mindlin-Reissner 小变形运动学的可验证基线。

0.6.1 不作为完整 Shell 结构动力学闭环版本,不交付 Shell 材料点更新、Shell 内力、Shell 内力矩、显式推进生产路径、Shell restart、公开 C ABI 或工程级船舶水下爆炸响应。0.6.1 的重点是让 0.6.0 已建立的 Shell 状态从“可分配、可初始化”推进到“可描述 director、局部转动和板壳应变局部量”,为后续 Shell 材料点、失效、内力和显式推进版本提供稳定运动学基础。

2. 依据文件

本计划依据以下 01-06 号文档制定:

  • docs/01_requirements_specification.md
  • docs/02_software_architecture_design.md
  • docs/03_detailed_design.md
  • docs/04_mathematical_model_and_algorithms.md
  • docs/05_interface_control_document.md
  • docs/06_test_and_verification_plan.md

同时,0.6.1 以已发布的 0.6.0 Shell 输入与状态基线版本为开发基线。

3. 版本定位

3.1 与 0.6.0 的关系

0.6.0 已完成以下 Shell 基线能力:

  • TYPE=SHELL material 识别。
  • *SHELL SECTION 输入解析。
  • Shell section 的厚度、3 点/5 点厚度积分和剪切修正校验。
  • Shell material 密度、弹性、Johnson-Cook flow/failure 和 softening 输入校验。
  • Shell 粒子级状态数组,包括 thickness、director、omega、膜应变、弯曲应变、剪切应变、damage、softening、内能和失效状态。
  • Shell 厚度积分点状态数组,包括积分点坐标、权重、应力、应变、塑性应变、温度、damage 和 softening。
  • input_shell_section、input_shell_errors、shell_state_build 和 shell_section_integration 专项 gate。

0.6.1 不重写 0.6.0 输入和状态基线。0.6.1 应保持 0.6.0 完整 gate 稳定,并在已有 Shell 状态数组之上补全 director 初始化、几何质量诊断、转动状态和小变形运动学。

3.2 与 0.6.2 的关系

0.6.2 建议作为 Shell 材料点和失效基线版本。0.6.1 不实现 Shell Johnson-Cook 材料点更新、积分点 damage 累积、softening 演化或 PHASE_SHELL_FAILED 生产路径。0.6.1 只应提供 0.6.2 所需的应变增量、厚度积分点应变状态和局部壳分量顺序。

3.3 与 0.7.0 的关系

0.7.0 建议作为水-气-结构局部爆炸 smoke 的起点。0.6.1 不实现 Water/Gas/Explosive 对 Shell 的真实爆炸载荷闭环,也不实现舱段破坏工程算例。0.6.1 的 Shell 运动学诊断可为后续载荷施加提供可观测状态,但不能宣传为水下爆炸结构响应能力。

3.4 与耦合版本的关系

真实 FEM-SPH 接触耦合和连续体耦合仍属于后续 0.8/0.9。0.6.1 只维护 SPHLite 内部 Shell director、局部坐标和应变状态,不直接依赖 FEMLite,不修改 FEMLite,也不引入外部 CouplingModule 作为依赖。

3.5 0.6.1 核心目标

0.6.1 的核心目标是建立 Shell 运动学基线:

0.6.0 Shell input and state baseline
  -> Shell director initialization and validation
  -> reference area and rotational inertia placeholders
  -> local tangent frame construction
  -> angular velocity and director update entry
  -> Mindlin-Reissner small-strain membrane, bending and shear measures
  -> through-thickness integration-point strain increment mapping
  -> Shell kinematics diagnostics and focused CTest gate

4. 开发原则

4.1 保持求解器定位

SPHLite 仍是求解器,不负责几何建模、网格或粒子生成。0.6.1 可从输入中的节点、单元、section 和 orientation 子集推断 Shell director、参考面积和局部基,但不得新增几何生成或自动粒子生成功能。

4.2 复用 Abaqus 子集优先

0.6.1 如需显式给定 Shell director 或局部方向,应优先复用 Abaqus 可表达的关键词子集,例如 *ORIENTATION 或 section 上的 orientation 引用。只有 Abaqus 子集无法表达测试所需调试信息时,才允许使用 *SPHLITE ... 扩展关键词,并且必须标注为 SPHLite 调试扩展,不替代 Abaqus 风格输入主线。

4.3 保持 Fortran 95 和集中型数据管理

核心实现继续使用 Fortran 95。Shell 新增状态应纳入现有集中数据库或 Shell 模块状态管理,不采用面向对象粒子类设计。新增过程应控制文件和过程大小,必要时将 Shell 几何、运动学和诊断拆分到独立 Fortran 模块。

4.4 保持显式动力学主流程

时间推进继续只支持 Velocity-Verlet 显式动力学。0.6.1 可建立 director 更新入口和转动状态工作数组,但不交付完整 Shell 显式推进生产路径,不引入隐式求解、静力求解或非线性静力求解接口。

4.5 小型可测优先

Shell director、局部坐标系和 Mindlin-Reissner 局部量必须先通过小型、可重复测试验收。0.6.1 不追求复杂壳单元刚度、真实断裂、穿孔、接触或工程舱段破坏,只要求运动学状态方向、量级、有限性和非 Shell 安全默认值可测。

4.6 Shell 与 Solid 分离

Solid 和 Shell 分别处理实体结构粒子和板壳结构粒子。0.6.1 可以参考 Solid 的质量诊断、有限性检查和 source size 拆分经验,但不得将 Shell 粒子伪装为 Solid 粒子,也不得改变 0.5.1 Solid gate 的结果。

5. 0.6.1 交付目标

0.6.1 建议交付以下内容:

  1. 将软件版本更新为 0.6.1。
  2. 保持 0.6.0 完整 gate 全部通过。
  3. 明确 Shell director 初始化优先级。
  4. 支持从受控输入信息给定 Shell 初始 director 或局部 orientation。
  5. 支持从受控 Shell 参考面几何推断初始 director。
  6. 对无法推断 director 的 active Shell 粒子报 error。
  7. 检查 Shell director 有限性、非零长度和归一化质量。
  8. 新增 Shell director 退化数量、最大归一化偏差或等价质量诊断。
  9. 初始化 active Shell 粒子的参考面积或等效面积。
  10. 初始化 active Shell 粒子的转动惯量或等价面积/厚度惯量状态。
  11. 初始化 Shell angular velocity、angular acceleration 或等价力矩工作数组。
  12. 对非 Shell 粒子设置安全的 director、转动、面积和惯量默认值。
  13. 实现 Shell director 基于角速度的基础更新入口。
  14. 实现 director 更新后的归一化保护和有限性检查。
  15. 建立 Shell 局部切向基向量和局部分量顺序。
  16. 建立 Shell 局部基有限性、正交性和退化诊断。
  17. 实现刚体平动下膜应变为零的受控路径。
  18. 实现单轴拉伸和简单剪切下的膜应变计算。
  19. 实现受控曲率场下的弯曲应变计算。
  20. 实现受控横向剪切下的剪切应变计算。
  21. 将膜应变映射到局部 11,22,12 顺序。
  22. 将弯曲应变映射到局部 11,22,12 顺序。
  23. 将横向剪切应变映射到局部 13,23 顺序。
  24. 建立 Shell strain increment 工作数组。
  25. 将中面膜应变、弯曲应变和厚度坐标组合为厚度积分点应变增量。
  26. 确认未使用积分点不参与应变计算。
  27. 确认 failed Shell 粒子按受控策略跳过或保持状态。
  28. 确认 Shell 运动学路径不污染 Water/Gas/Explosive/Solid 粒子。
  29. 新增 Shell 0.6.1 专项 CTest gate。
  30. 更新 README、06、09 和 11 号文档中的 0.6.1 测试、验收和不交付范围。
  31. 不新增 FEMLite 直接依赖,不修改 SPHLite 文件夹之外的内容。

6. 非交付范围

0.6.1 不交付以下内容:

  1. 不交付完整 Shell 结构动力学闭环。
  2. 不交付 Shell Johnson-Cook 材料点更新。
  3. 不交付 Shell damage 累积、渐进 softening 演化或真实撕裂路径。
  4. 不交付 Shell 内力、内力矩或稳定时间步生产路径。
  5. 不将 Shell 接入完整 Velocity-Verlet 显式推进。
  6. 不交付 Shell output CSV 字段的生产级格式扩展,除非只作为测试诊断。
  7. 不交付 Shell restart 或 STATE_0_6_1 正式读写。
  8. 不交付 Shell C ABI、C++ wrapper、Python ctypes 或 CLI 公开诊断字段。
  9. 不交付真实水-气-结构工程爆炸响应。
  10. 不交付真实 FEM-SPH 接触耦合或连续体耦合。
  11. 不交付板壳穿孔、裂纹扩展、碎片云、焊缝失效库或壳-实体连接算法。
  12. 不新增几何、网格或粒子生成能力。
  13. 不实现大规模并行、GPU 后端或性能优化版本。

7. 输入、director 和局部方向

7.1 Director 初始化优先级

0.6.1 建议采用以下 Shell director 初始化优先级:

  1. 显式 orientation 或 director 输入。
  2. Shell section 引用的 orientation。
  3. 受控 Shell 参考面几何推断出的面法向。
  4. 无法安全推断时对 active Shell 粒子报 error。

不建议为 active Shell 粒子使用全局固定默认 director 作为生产路径。全局默认值可用于非 Shell 粒子的安全默认状态,或用于没有 active Shell 粒子的空模型路径。

7.2 Abaqus 子集约束

若实现 orientation 输入,0.6.1 应先支持受控、明确的小子集:

  • orientation 名称解析。
  • section 对 orientation 的引用。
  • 可归一化的方向向量或局部切向基。
  • 非有限向量、零向量和平行退化向量 error。
  • 未被 active Shell 使用的 orientation 可 warning。

0.6.1 不追求完整 Abaqus orientation 兼容,不支持复杂坐标系、随场变量变化的 orientation 或用户子程序。

7.3 几何推断边界

Shell 是 2D 几何,通过 section 识别厚度和板壳属性。0.6.1 可从输入中的受控三角形或四边形 Shell 面片推断:

  • 粒子所属参考面。
  • 参考面法向。
  • 局部切向方向。
  • 粒子参考面积或等效面积。

该推断只服务于求解器状态构建和小型测试,不是几何生成器。输入仍必须显式给出节点和元素,SPHLite 不生成新的几何或粒子。

8. Shell 几何状态设计

8.1 Director 状态

0.6.1 沿用 0.6.0 已建立的:

real(rk), allocatable :: shell_director(:,:)
real(rk), allocatable :: shell_omega(:,:)

建议补充或确认以下状态:

real(rk), allocatable :: shell_alpha(:,:)
real(rk), allocatable :: shell_reference_area(:)
real(rk), allocatable :: shell_rotational_inertia(:)
integer, allocatable :: shell_director_status(:)

其中:

  • shell_alpha(3,npart) 表示角加速度或等价转动工作量。
  • shell_reference_area(npart) 表示参考中面面积或等效面积。
  • shell_rotational_inertia(npart) 第一版可使用质量、厚度和面积推导的等效标量惯量。
  • shell_director_status(npart) 记录正常、由输入给定、由几何推断或退化状态。

8.2 局部坐标状态

0.6.1 建议建立局部基向量工作数组或持久数组:

real(rk), allocatable :: shell_local_e1(:,:)
real(rk), allocatable :: shell_local_e2(:,:)
real(rk), allocatable :: shell_local_e3(:,:)
integer, allocatable :: shell_local_frame_status(:)

约定:

  • e3 与 director 一致。
  • e1 和 e2 位于 Shell 中面切向平面。
  • e1, e2, e3 应构成右手正交基。
  • 局部基只用于 Shell 运动学、诊断和后续材料点分量映射,不改变数据库中的全局坐标。

8.3 参考面积和惯量

0.6.1 的参考面积和转动惯量先作为小型测试和后续内力版本的基础状态:

  • 对 active Shell 粒子必须为非负有限值。
  • 对参与运动学或转动测试的 active Shell 粒子应为正值。
  • 非 active Shell 粒子可为 0。
  • 质量为非正、厚度为非正或面积退化时应报 error 或设置退化诊断,不得静默进入运动学计算。

9. Shell 转动运动学

9.1 角速度状态

0.6.1 将 shell_omega 作为 Shell 局部转动状态的第一入口。默认值为 0。测试中可通过受控初始化或内部辅助过程设置角速度,不要求在 0.6.1 暴露 C ABI 或 CLI 设置接口。

9.2 Director 更新

0.6.1 可采用小转动更新入口:

director_new = normalize(director_old + dt * omega cross director_old)

该路径只作为受控小转动和有限性测试的运动学基础,不宣称为完整有限转动壳理论。后续版本可升级为更稳健的旋转张量或四元数路线,但不得影响 0.6.1 小型 gate 的方向和量级约定。

9.3 转动诊断

0.6.1 建议记录:

  • active Shell 粒子数。
  • 最大角速度。
  • 最大 director 长度偏差。
  • director 退化数量。
  • 局部基退化数量。
  • 参考面积退化数量。
  • 转动惯量退化数量。

这些诊断第一版可先保留在 Fortran 模块查询或测试辅助路径中,不要求进入公开 C ABI。

10. Mindlin-Reissner 小变形运动学

10.1 分量顺序

0.6.1 应锁定 Shell 局部分量顺序:

  • 膜应变:11,22,12。
  • 弯曲应变:11,22,12。
  • 横向剪切应变:13,23。
  • 厚度积分点应变可采用 11,22,12,13,23 顺序。

该顺序必须与 0.6.0 已建立的状态数组、后续材料点更新和测试期望保持一致。

10.2 膜应变

0.6.1 的膜应变目标是小变形、可测路径:

  • 刚体平动下膜应变为 0。
  • 单轴拉伸下对应方向膜应变为正且量级正确。
  • 简单剪切下 12 分量方向和量级可控。
  • 非 Shell 粒子不参与膜应变计算。

0.6.1 不要求处理大转动大应变壳理论。

10.3 弯曲应变

0.6.1 的弯曲应变目标是受控曲率场:

  • director 空间变化可产生弯曲应变。
  • 均匀 director 场弯曲应变为 0 或数值容差内为 0。
  • 受控线性曲率输入得到方向和量级可检查的 11,22,12 分量。

0.6.1 不要求完整壳单元曲率矩阵或工程级弯曲刚度。

10.4 横向剪切应变

0.6.1 的横向剪切目标是受控 Mindlin-Reissner 小变形量:

  • 中面法向位移梯度和 director/转角状态共同决定剪切应变诊断。
  • 纯刚体平动不产生剪切应变。
  • 受控横向剪切输入得到方向和量级可检查的 13,23 分量。

0.6.1 不要求剪切锁定控制、减缩积分或工程级壳单元修正。

10.5 厚度积分点应变增量

0.6.1 应将中面运动学量映射到厚度积分点:

ip_strain = membrane_strain + zeta * bending_strain + shear_strain

其中 zeta 使用 0.6.0 section 积分规则中的厚度方向坐标或等价归一化坐标。未使用积分点必须保持安全默认值,不参与计算、诊断或后续材料点更新。

11. 数据和模块拆分建议

0.6.1 实现时建议控制 src/shell/sph_shell.f90 膨胀。若新增过程较多,可考虑拆分:

  • sph_shell_geometry:director、局部基、参考面积和几何质量诊断。
  • sph_shell_kinematics:转动更新、膜应变、弯曲应变、剪切应变和积分点应变增量。
  • sph_shell_diagnostics:Shell 0.6.1 诊断汇总。

是否拆分以 source size gate 和实际代码复杂度为准。拆分不得改变现有 Fortran API 语义,不得引入循环依赖。

12. 测试计划

12.1 0.6.1 新增测试

建议新增或补强以下测试:

  • shell_director_input:显式 orientation/director 输入、归一化和错误路径。
  • shell_reference_geometry:由受控三角形或四边形参考面推断 director、面积和局部基。
  • shell_director_update:角速度驱动 director 更新、归一化保护和有限性检查。
  • shell_rotation_kinematics:角速度、角加速度或等价转动工作数组默认值和最大角速度诊断。
  • shell_local_frame:局部基正交性、右手性、退化向量 error 和非 Shell 默认值。
  • shell_membrane_strain:刚体平动、单轴拉伸和简单剪切膜应变。
  • shell_bending_strain:均匀 director 场和受控曲率场弯曲应变。
  • shell_shear_strain:刚体平动和受控横向剪切应变。
  • shell_ip_strain_increment:3 点/5 点厚度积分点应变增量映射和未使用积分点跳过。
  • shell_061_source_size:Shell 0.6.1 source size 和 stale exception 检查。

12.2 回归测试

0.6.1 必须继续通过 0.6.0 完整 gate,包括:

  • 0.6.0 Shell 输入与状态基线 gate。
  • 0.5.1 Solid 稳定化 gate。
  • 既有 Water/Gas/Explosive/Solid/接口/restart/output/source-size gate。

12.3 建议 0.6.1 Release Gate

建议 0.6.1 默认 gate 为:

cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_shell_section|input_shell_errors|shell_state_build|shell_section_integration)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(shell_director_input|shell_reference_geometry|shell_director_update|shell_rotation_kinematics|shell_local_frame|shell_membrane_strain|shell_bending_strain|shell_shear_strain|shell_ip_strain_increment|shell_061_source_size)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure
git diff --check

实际测试名称可在实现阶段微调,但 0.6.1 release gate 必须覆盖 director、局部基、转动、三类应变、积分点应变增量和 source size。

13. 开发阶段建议

阶段 A:版本基线和 0.6.1 范围收敛

  1. 更新软件版本为 0.6.1。
  2. 保持 0.6.0 gate 稳定。
  3. 更新 README 中 0.6.1 的开发定位。
  4. 准备 Shell director、局部基、应变和积分点应变增量测试输入样例。
  5. 明确 0.6.1 不交付材料点、内力、restart 和公开接口。

阶段 B:Director 输入、几何推断和质量诊断

  1. 实现 director 初始化优先级。
  2. 支持受控 orientation/director 输入。
  3. 支持由受控 Shell 参考面推断 director。
  4. 初始化参考面积和等效转动惯量。
  5. 实现 director、面积和惯量退化 error/warning 路径。
  6. 新增 director 和参考几何测试。

阶段 C:局部坐标系和转动状态

  1. 建立 Shell 局部基向量。
  2. 实现局部基正交性、右手性和有限性检查。
  3. 初始化角速度、角加速度或等价工作数组。
  4. 实现 director 小转动更新入口。
  5. 增加最大角速度、director 偏差和局部基退化诊断。
  6. 新增局部基和转动测试。

阶段 D:Mindlin-Reissner 小变形应变

  1. 实现膜应变计算。
  2. 实现弯曲应变计算。
  3. 实现横向剪切应变计算。
  4. 锁定局部分量顺序。
  5. 确认刚体平动应变为零。
  6. 新增膜、弯曲和剪切应变测试。

阶段 E:厚度积分点应变增量和诊断

  1. 建立 Shell strain increment 工作数组。
  2. 将膜、弯曲和剪切应变映射到积分点应变增量。
  3. 确认 3 点和 5 点积分规则均可用。
  4. 确认未使用积分点跳过。
  5. 汇总 Shell 0.6.1 运动学诊断。
  6. 新增积分点应变增量测试。

阶段 F:门禁、文档和发布记录

  1. 新增 0.6.1 专项 CTest gate。
  2. 新增或更新 source size gate。
  3. 运行完整 CTest。
  4. 更新 README、06、09 和 11 号文档。
  5. 确认 git diff --check 通过。
  6. 准备 0.6.1 发布记录。

14. 验收标准

0.6.1 应满足以下验收标准:

  1. 软件版本为 0.6.1。
  2. 0.6.0 完整 gate 继续通过。
  3. active Shell 粒子可以从输入或受控参考几何获得有限、归一化的 director。
  4. 无法推断 director 的 active Shell 粒子报 error。
  5. Shell 局部基有限、正交、右手性可检查。
  6. active Shell 粒子的参考面积和等效惯量初始化受控。
  7. director 可通过角速度执行小转动更新并保持归一化。
  8. 刚体平动下膜应变、弯曲应变和剪切应变在容差内为零。
  9. 单轴拉伸、简单剪切、受控曲率和横向剪切测试的方向和量级可检查。
  10. 3 点和 5 点厚度积分点应变增量映射正确。
  11. 未使用积分点不参与应变计算。
  12. 非 Shell 粒子不被 Shell 运动学路径污染。
  13. failed Shell 粒子处理策略明确且测试覆盖。
  14. 0.6.1 专项 gate、完整 CTest、source size 和 git diff --check 通过。
  15. 文档明确 0.6.1 不交付 Shell 材料点、内力、显式推进、restart、公开接口、真实水-气-结构爆炸响应或真实 FEM-SPH 耦合。

15. 风险和控制

风险 表现 控制策略
Shell 范围再次膨胀 0.6.1 试图同时实现材料、内力、restart 和接口 限定为 director、转动和运动学基线
orientation 子集过宽 追求完整 Abaqus orientation 兼容 只支持受控子集,其他 warning 或 error
几何推断被误解为网格生成 从参考面推断 director 被宣传为几何功能 文档明确 SPHLite 不生成几何或粒子
大转动理论过早进入 小转动更新被扩展为复杂有限转动壳 0.6.1 只验收小转动方向和有限性
壳状态污染 Solid 共享数据库中 phase 过滤不严 新增混合 Shell/Solid 测试
文件膨胀 sph_shell.f90 继续增长 必要时拆分 geometry/kinematics/diagnostics 模块
测试只检查存在性 应变测试没有方向和量级约束 每个应变测试必须有数值期望或容差

16. 后续版本建议

0.6.1 完成后,建议后续版本按以下路线推进:

  1. 0.6.2:Shell 弹性材料点、Johnson-Cook flow/failure、damage、softening 和 PHASE_SHELL_FAILED 状态基线。
  2. 0.6.3:Shell 内力、内力矩、稳定时间步、Shell-only 显式 smoke、summary/output 和小型动力学闭环。
  3. 0.6.4 或 0.7.0 前置:Shell restart、C ABI、C++ wrapper、Python ctypes、CLI 字段和 Water/Gas/Explosive 对 Shell 的受控载荷入口。
  4. 0.7.0:水-气-结构局部爆炸 smoke,覆盖小型 Water/Gas/Explosive/Solid/Shell 链路。

17. 0.6.1 发布后进入 0.6.2 的条件

满足以下条件后,可以启动 0.6.2:

  1. Shell director、局部基、转动和 Mindlin-Reissner 小变形运动学 gate 稳定。
  2. Shell 厚度积分点应变增量状态可被后续材料点更新复用。
  3. 0.6.0 输入/状态 gate 和 0.6.1 运动学 gate 均纳入默认回归。
  4. 文档明确 0.6.1 仍不是完整 Shell 动力学版本。
  5. source size 受控,Shell 几何和运动学过程不形成新的大文件风险。