Files
SPHLite/todo.md
T
2026-07-03 21:57:10 +08:00

199 lines
11 KiB
Markdown
Raw Blame History

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