Files
SPHLite/todo.md
T

11 KiB
Raw Blame History

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 发布提交说明。