199 lines
11 KiB
Markdown
199 lines
11 KiB
Markdown
# 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 发布提交说明。
|