11 KiB
11 KiB
SPHLite TODO
当前目标版本:0.6.1
本文档依据 docs/v6.1_development_plan.md 拆分。0.6.1 定位为 Shell director、转动状态、参考面积/惯量、局部坐标系和 Mindlin-Reissner 小变形运动学基线版本,在 0.6.0 Shell 输入与状态基线之上推进。
所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.6.1 不交付 Shell 材料点更新、Shell 内力、Shell 内力矩、完整显式推进生产路径、Shell restart、公开 C ABI/C++/Python/CLI 诊断字段、真实水-气-结构工程爆炸响应或真实 FEM-SPH 耦合。
执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端。
阶段 A:版本基线、范围声明与 0.6.1 样例
- 确认当前 git 状态并记录已有未提交内容。
- 确认
v0.6.0标签和远端发布提交可作为 0.6.1 开发基线。 - 将核心软件版本更新为
0.6.1。 - 将 CMake 项目版本更新为
0.6.1。 - 更新 Fortran smoke 测试中的版本期望。
- 更新 C API 测试中的版本期望。
- 更新 C++ API 测试中的版本期望。
- 更新 Python debug 测试中的版本期望。
- 更新 CLI
--version和 inspect 版本期望。 - 在 README 中记录 0.6.1 Shell 运动学基线开发定位。
- 明确 README 中 0.6.1 不交付材料点、内力、restart 和公开接口。
- 创建 Shell 显式 director 输入样例。
- 创建 Shell section 引用 orientation 输入样例。
- 创建 Shell director 零向量错误输入样例。
- 创建 Shell director 非有限值错误输入样例。
- 创建 Shell orientation 平行退化错误输入样例。
- 创建 Shell 三角形参考面 director 推断样例。
- 创建 Shell 四边形参考面 director 推断样例。
- 创建 Shell 参考面积退化错误输入样例。
- 创建 Shell 局部基退化错误输入样例。
- 创建 Shell 角速度更新测试样例。
- 创建 Shell 刚体平动应变测试样例。
- 创建 Shell 单轴拉伸膜应变测试样例。
- 创建 Shell 简单剪切膜应变测试样例。
- 创建 Shell 受控曲率弯曲应变测试样例。
- 创建 Shell 横向剪切应变测试样例。
- 创建 Shell 3 点积分点应变增量样例。
- 创建 Shell 5 点积分点应变增量样例。
- 创建 Shell/Solid 混合运动学隔离样例。
- 运行 0.6.0 Shell 输入与状态基线专项 gate 并记录基线结果。
阶段 B:Director 输入、几何推断和质量诊断
- 设计 Shell director 初始化优先级常量或内部约定。
- 复核现有 Shell section 数据结构是否可挂接 orientation 信息。
- 支持受控
*ORIENTATION名称解析。 - 支持 section 引用 orientation 名称。
- 支持 orientation 方向向量读取。
- 支持 orientation 局部切向向量读取。
- 对 orientation 非有限向量路径报 error。
- 对 orientation 零向量路径报 error。
- 对 orientation 平行退化向量路径报 error。
- 对未被 active Shell 使用的 orientation 保持 warning。
- 将显式 orientation 映射到 active Shell director。
- 将 section orientation 映射到 active Shell director。
- 支持由三角形参考面推断 Shell director。
- 支持由四边形参考面推断 Shell director。
- 对无法安全推断 director 的 active Shell 粒子报 error。
- 检查 Shell director 有限性。
- 检查 Shell director 非零长度。
- 对 Shell director 执行归一化。
- 记录 Shell director 初始化来源状态。
- 记录 Shell director 最大长度偏差诊断。
- 记录 Shell director 退化数量诊断。
- 初始化 active Shell 粒子参考面积。
- 初始化 active Shell 粒子等效转动惯量。
- 对参考面积退化路径报 error 或记录退化诊断。
- 对转动惯量退化路径报 error 或记录退化诊断。
- 对非 Shell 粒子设置安全 director 默认值。
- 对非 Shell 粒子设置安全参考面积默认值。
- 对非 Shell 粒子设置安全转动惯量默认值。
- 新增
shell_director_input测试。 - 新增
shell_reference_geometry测试。 - 将
shell_director_input接入 CTest。 - 将
shell_reference_geometry接入 CTest。
阶段 C:局部坐标系、转动状态和 director 更新
- 设计 Shell 局部基向量数组布局。
- 新增或补齐
shell_local_e1状态或工作数组。 - 新增或补齐
shell_local_e2状态或工作数组。 - 新增或补齐
shell_local_e3状态或工作数组。 - 新增 Shell local frame status 状态数组。
- 在 Shell allocate/build 路径分配局部基状态。
- 在 Shell reset 路径初始化局部基状态。
- 在 Shell clear/finalize 路径释放局部基状态。
- 由 director 构造 Shell 局部
e3。 - 由 orientation 或参考面构造 Shell 局部
e1。 - 由
e3 cross e1构造 Shell 局部e2。 - 对 Shell 局部基执行有限性检查。
- 对 Shell 局部基执行正交性检查。
- 对 Shell 局部基执行右手性检查。
- 记录局部基退化数量诊断。
- 新增或补齐 Shell angular acceleration 工作数组。
- 在 Shell reset 路径初始化 angular velocity 默认值。
- 在 Shell reset 路径初始化 angular acceleration 默认值。
- 对非 Shell 粒子设置安全转动状态默认值。
- 新增 Shell 内部测试辅助过程以设置角速度。
- 实现 Shell director 小转动更新入口。
- 在 director 更新后执行归一化保护。
- 在 director 更新后刷新局部基。
- 对 Shell 转动状态执行有限性检查。
- 计算 Shell 最大角速度诊断。
- 确认无 active Shell 粒子时跳过局部基和转动更新。
- 确认局部基和转动状态不污染 Solid 粒子。
- 新增
shell_director_update测试。 - 新增
shell_rotation_kinematics测试。 - 新增
shell_local_frame测试。 - 将
shell_director_update接入 CTest。 - 将
shell_rotation_kinematics接入 CTest。 - 将
shell_local_frame接入 CTest。
阶段 D:Mindlin-Reissner 小变形膜、弯曲和剪切应变
- 设计 Shell 运动学过程的输入输出约定。
- 锁定 Shell 膜应变局部分量顺序
11,22,12。 - 锁定 Shell 弯曲应变局部分量顺序
11,22,12。 - 锁定 Shell 剪切应变局部分量顺序
13,23。 - 新增 Shell strain increment 工作数组布局。
- 在 Shell allocate/build 路径分配 strain increment 工作数组。
- 在 Shell reset 路径初始化 strain increment 工作数组。
- 在 Shell clear/finalize 路径释放 strain increment 工作数组。
- 实现 Shell 刚体平动下膜应变为零的路径。
- 实现 Shell 单轴拉伸膜应变计算。
- 实现 Shell 简单剪切膜应变计算。
- 将膜应变写入
shell_membrane_strain。 - 实现均匀 director 场下弯曲应变为零的路径。
- 实现受控曲率场弯曲应变计算。
- 将弯曲应变写入
shell_bending_strain。 - 实现刚体平动下横向剪切应变为零的路径。
- 实现受控横向剪切应变计算。
- 将横向剪切应变写入
shell_shear_strain。 - 对 Shell 应变计算执行有限性检查。
- 确认非 Shell 粒子不参与应变计算。
- 确认 failed Shell 粒子按受控策略跳过或保持状态。
- 确认未建立局部基时应变计算报 error。
- 记录 Shell 最大膜应变诊断。
- 记录 Shell 最大弯曲应变诊断。
- 记录 Shell 最大剪切应变诊断。
- 新增
shell_membrane_strain测试。 - 新增
shell_bending_strain测试。 - 新增
shell_shear_strain测试。 - 将
shell_membrane_strain接入 CTest。 - 将
shell_bending_strain接入 CTest。 - 将
shell_shear_strain接入 CTest。
阶段 E:厚度积分点应变增量、诊断和隔离检查
- 设计 Shell 厚度积分点应变增量分量顺序。
- 确认厚度积分点应变增量使用
11,22,12,13,23顺序。 - 将膜应变贡献映射到 active 积分点应变增量。
- 将厚度坐标乘弯曲应变贡献映射到 active 积分点应变增量。
- 将横向剪切应变贡献映射到 active 积分点应变增量。
- 确认 3 点厚度积分规则参与应变增量映射。
- 确认 5 点厚度积分规则参与应变增量映射。
- 确认未使用积分点保持安全默认值。
- 确认未使用积分点不参与诊断统计。
- 将积分点应变增量写入 Shell integration point strain 状态。
- 对积分点应变增量执行有限性检查。
- 记录 Shell 最大积分点应变增量诊断。
- 记录 Shell active 积分点数量诊断。
- 汇总 Shell 0.6.1 运动学诊断查询入口。
- 确认 Shell 运动学诊断无 active Shell 粒子时返回安全默认值。
- 确认 Shell/Solid 混合模型中 Solid 状态不被修改。
- 确认 Water/Gas/Explosive 粒子不被 Shell 运动学路径修改。
- 确认 0.6.0 Shell state build 测试仍通过。
- 确认 0.6.0 Shell section integration 测试仍通过。
- 新增
shell_ip_strain_increment测试。 - 将
shell_ip_strain_increment接入 CTest。
阶段 F:门禁、source size、文档和发布准备
- 复核
src/shell/sph_shell.f90文件规模。 - 判断是否需要拆分 Shell geometry 模块。
- 判断是否需要拆分 Shell kinematics 模块。
- 判断是否需要拆分 Shell diagnostics 模块。
- 如需拆分,新增 Shell 模块并保持 Fortran API 语义不变。
- 如需拆分,更新 CMake 中 Shell 源文件列表。
- 新增
shell_061_source_size检查。 - 将
shell_061_source_size接入 CTest。 - 更新
tests/source_size_exceptions.txt中必要的 Shell 说明性例外。 - 运行完整 CTest。
- 运行 0.6.0 Shell 输入与状态基线专项 gate。
- 运行 0.6.1 Shell 运动学专项 gate。
- 运行 source size 相关 gate。
- 运行
git diff --check。 - 更新 README 中 0.6.1 当前状态和不交付范围。
- 更新
docs/06_test_and_verification_plan.md的 0.6.1 release gate。 - 更新
docs/09_release_history.md的 0.6.1 本地验收记录。 - 更新
docs/11_benchmark_matrix.md的 0.6.1 gate 矩阵。 - 确认 0.6.1 文档不宣称完整 Shell 动力学闭环。
- 确认 0.6.1 文档不宣称真实水-气-结构工程爆炸响应。
- 确认 0.6.1 文档不宣称真实 FEM-SPH 联合运行。
- 确认输出目录、CSV、VTK、restart 和临时结果未提交。
- 确认代码、构建脚本、测试和工具目录未新增 FEMLite 直接依赖。
- 准备 0.6.1 发布提交说明。