22 KiB
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.mddocs/02_software_architecture_design.mddocs/03_detailed_design.mddocs/04_mathematical_model_and_algorithms.mddocs/05_interface_control_document.mddocs/06_test_and_verification_plan.md
同时,0.6.1 以已发布的 0.6.0 Shell 输入与状态基线版本为开发基线。
3. 版本定位
3.1 与 0.6.0 的关系
0.6.0 已完成以下 Shell 基线能力:
TYPE=SHELLmaterial 识别。*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 建议交付以下内容:
- 将软件版本更新为
0.6.1。 - 保持 0.6.0 完整 gate 全部通过。
- 明确 Shell director 初始化优先级。
- 支持从受控输入信息给定 Shell 初始 director 或局部 orientation。
- 支持从受控 Shell 参考面几何推断初始 director。
- 对无法推断 director 的 active Shell 粒子报 error。
- 检查 Shell director 有限性、非零长度和归一化质量。
- 新增 Shell director 退化数量、最大归一化偏差或等价质量诊断。
- 初始化 active Shell 粒子的参考面积或等效面积。
- 初始化 active Shell 粒子的转动惯量或等价面积/厚度惯量状态。
- 初始化 Shell angular velocity、angular acceleration 或等价力矩工作数组。
- 对非 Shell 粒子设置安全的 director、转动、面积和惯量默认值。
- 实现 Shell director 基于角速度的基础更新入口。
- 实现 director 更新后的归一化保护和有限性检查。
- 建立 Shell 局部切向基向量和局部分量顺序。
- 建立 Shell 局部基有限性、正交性和退化诊断。
- 实现刚体平动下膜应变为零的受控路径。
- 实现单轴拉伸和简单剪切下的膜应变计算。
- 实现受控曲率场下的弯曲应变计算。
- 实现受控横向剪切下的剪切应变计算。
- 将膜应变映射到局部
11,22,12顺序。 - 将弯曲应变映射到局部
11,22,12顺序。 - 将横向剪切应变映射到局部
13,23顺序。 - 建立 Shell strain increment 工作数组。
- 将中面膜应变、弯曲应变和厚度坐标组合为厚度积分点应变增量。
- 确认未使用积分点不参与应变计算。
- 确认 failed Shell 粒子按受控策略跳过或保持状态。
- 确认 Shell 运动学路径不污染 Water/Gas/Explosive/Solid 粒子。
- 新增 Shell 0.6.1 专项 CTest gate。
- 更新 README、06、09 和 11 号文档中的 0.6.1 测试、验收和不交付范围。
- 不新增 FEMLite 直接依赖,不修改 SPHLite 文件夹之外的内容。
6. 非交付范围
0.6.1 不交付以下内容:
- 不交付完整 Shell 结构动力学闭环。
- 不交付 Shell Johnson-Cook 材料点更新。
- 不交付 Shell damage 累积、渐进 softening 演化或真实撕裂路径。
- 不交付 Shell 内力、内力矩或稳定时间步生产路径。
- 不将 Shell 接入完整 Velocity-Verlet 显式推进。
- 不交付 Shell output CSV 字段的生产级格式扩展,除非只作为测试诊断。
- 不交付 Shell restart 或
STATE_0_6_1正式读写。 - 不交付 Shell C ABI、C++ wrapper、Python ctypes 或 CLI 公开诊断字段。
- 不交付真实水-气-结构工程爆炸响应。
- 不交付真实 FEM-SPH 接触耦合或连续体耦合。
- 不交付板壳穿孔、裂纹扩展、碎片云、焊缝失效库或壳-实体连接算法。
- 不新增几何、网格或粒子生成能力。
- 不实现大规模并行、GPU 后端或性能优化版本。
7. 输入、director 和局部方向
7.1 Director 初始化优先级
0.6.1 建议采用以下 Shell director 初始化优先级:
- 显式 orientation 或 director 输入。
- Shell section 引用的 orientation。
- 受控 Shell 参考面几何推断出的面法向。
- 无法安全推断时对 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 范围收敛
- 更新软件版本为
0.6.1。 - 保持 0.6.0 gate 稳定。
- 更新 README 中 0.6.1 的开发定位。
- 准备 Shell director、局部基、应变和积分点应变增量测试输入样例。
- 明确 0.6.1 不交付材料点、内力、restart 和公开接口。
阶段 B:Director 输入、几何推断和质量诊断
- 实现 director 初始化优先级。
- 支持受控 orientation/director 输入。
- 支持由受控 Shell 参考面推断 director。
- 初始化参考面积和等效转动惯量。
- 实现 director、面积和惯量退化 error/warning 路径。
- 新增 director 和参考几何测试。
阶段 C:局部坐标系和转动状态
- 建立 Shell 局部基向量。
- 实现局部基正交性、右手性和有限性检查。
- 初始化角速度、角加速度或等价工作数组。
- 实现 director 小转动更新入口。
- 增加最大角速度、director 偏差和局部基退化诊断。
- 新增局部基和转动测试。
阶段 D:Mindlin-Reissner 小变形应变
- 实现膜应变计算。
- 实现弯曲应变计算。
- 实现横向剪切应变计算。
- 锁定局部分量顺序。
- 确认刚体平动应变为零。
- 新增膜、弯曲和剪切应变测试。
阶段 E:厚度积分点应变增量和诊断
- 建立 Shell strain increment 工作数组。
- 将膜、弯曲和剪切应变映射到积分点应变增量。
- 确认 3 点和 5 点积分规则均可用。
- 确认未使用积分点跳过。
- 汇总 Shell 0.6.1 运动学诊断。
- 新增积分点应变增量测试。
阶段 F:门禁、文档和发布记录
- 新增 0.6.1 专项 CTest gate。
- 新增或更新 source size gate。
- 运行完整 CTest。
- 更新 README、06、09 和 11 号文档。
- 确认
git diff --check通过。 - 准备 0.6.1 发布记录。
14. 验收标准
0.6.1 应满足以下验收标准:
- 软件版本为
0.6.1。 - 0.6.0 完整 gate 继续通过。
- active Shell 粒子可以从输入或受控参考几何获得有限、归一化的 director。
- 无法推断 director 的 active Shell 粒子报 error。
- Shell 局部基有限、正交、右手性可检查。
- active Shell 粒子的参考面积和等效惯量初始化受控。
- director 可通过角速度执行小转动更新并保持归一化。
- 刚体平动下膜应变、弯曲应变和剪切应变在容差内为零。
- 单轴拉伸、简单剪切、受控曲率和横向剪切测试的方向和量级可检查。
- 3 点和 5 点厚度积分点应变增量映射正确。
- 未使用积分点不参与应变计算。
- 非 Shell 粒子不被 Shell 运动学路径污染。
- failed Shell 粒子处理策略明确且测试覆盖。
- 0.6.1 专项 gate、完整 CTest、source size 和
git diff --check通过。 - 文档明确 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 完成后,建议后续版本按以下路线推进:
- 0.6.2:Shell 弹性材料点、Johnson-Cook flow/failure、damage、softening 和
PHASE_SHELL_FAILED状态基线。 - 0.6.3:Shell 内力、内力矩、稳定时间步、Shell-only 显式 smoke、summary/output 和小型动力学闭环。
- 0.6.4 或 0.7.0 前置:Shell restart、C ABI、C++ wrapper、Python ctypes、CLI 字段和 Water/Gas/Explosive 对 Shell 的受控载荷入口。
- 0.7.0:水-气-结构局部爆炸 smoke,覆盖小型 Water/Gas/Explosive/Solid/Shell 链路。
17. 0.6.1 发布后进入 0.6.2 的条件
满足以下条件后,可以启动 0.6.2:
- Shell director、局部基、转动和 Mindlin-Reissner 小变形运动学 gate 稳定。
- Shell 厚度积分点应变增量状态可被后续材料点更新复用。
- 0.6.0 输入/状态 gate 和 0.6.1 运动学 gate 均纳入默认回归。
- 文档明确 0.6.1 仍不是完整 Shell 动力学版本。
- source size 受控,Shell 几何和运动学过程不形成新的大文件风险。