279 lines
16 KiB
Markdown
279 lines
16 KiB
Markdown
# SPHLite TODO
|
||
|
||
当前目标版本:0.5.1
|
||
|
||
本文档依据 `docs/v5.1_development_plan.md` 拆分。0.5.1 定位为 `Solid` 版本线的稳定化和结构算法加固版本,目标是在 0.5.0 已完成 Solid 输入、状态、本构、失效、显式推进、restart、接口和 gate 最小闭环的基础上,补强参考构型、速度梯度、应变率、最小内力、能量诊断、`STATE_0_5_1` restart、`STATE_0_5` 兼容读入和接口可观测性。
|
||
|
||
所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.5.1 不实现 `Shell`、真实水-气-结构工程爆炸响应、真实 FEM-SPH 耦合、工程级结构破坏 benchmark、复杂断裂面追踪、碎片云、焊缝失效库、大规模并行或 GPU 后端。
|
||
|
||
执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端。
|
||
|
||
## 阶段 A:版本基线、范围声明与 0.5.1 样例
|
||
|
||
- [x] 确认当前 git 状态干净或记录已有未提交内容。
|
||
- [x] 确认 `v0.5.0` 标签和远端发布提交可作为 0.5.1 开发基线。
|
||
- [x] 将核心软件版本更新为 `0.5.1`。
|
||
- [x] 将 CMake 项目版本更新为 `0.5.1`。
|
||
- [x] 更新 Fortran smoke 测试中的版本期望。
|
||
- [x] 更新 C API 测试中的版本期望。
|
||
- [x] 更新 C++ API 测试中的版本期望。
|
||
- [x] 更新 Python debug 测试中的版本期望。
|
||
- [x] 更新 CLI `--version` 和 inspect 版本期望。
|
||
- [x] 在 README 中记录 0.5.1 Solid 稳定化开发定位。
|
||
- [x] 创建 Solid 0.5.1 正常参考邻域输入样例。
|
||
- [x] 创建 Solid 0.5.1 退化参考邻域输入样例。
|
||
- [x] 创建 Solid 均匀平动速度场输入样例。
|
||
- [x] 创建 Solid 单轴拉伸速度场输入样例。
|
||
- [x] 创建 Solid 成对内力平衡输入样例。
|
||
- [x] 创建 Solid 对称均匀应力输入样例。
|
||
- [x] 创建 Solid softening 内力折减输入样例。
|
||
- [x] 创建 Solid 0.5.1 显式推进 smoke 输入样例。
|
||
- [x] 创建 `STATE_0_5_1` restart 测试输入样例。
|
||
- [x] 准备 `STATE_0_5` restart 兼容读入测试夹具。
|
||
- [x] 创建 Solid material 非法泊松比错误输入样例。
|
||
- [x] 创建 Solid material 非有限 Johnson-Cook 参数错误输入样例。
|
||
- [x] 创建 Solid 非法 softening 类型错误输入样例。
|
||
- [x] 创建 Solid section 指向非 Solid material 错误输入样例。
|
||
- [x] 创建 active Solid 粒子缺失 Solid section 错误输入样例。
|
||
|
||
## 阶段 B:Solid 输入校验、section 校验与 warning/error 路径
|
||
|
||
- [x] 复核 0.5.0 Solid material 解析路径并保持语法兼容。
|
||
- [x] 对 Solid material 缺失密度路径保持 error。
|
||
- [x] 对 Solid material 非正密度路径保持 error。
|
||
- [x] 对 Solid material 缺失弹性参数路径保持 error。
|
||
- [x] 对 Solid material 非正弹性模量路径保持 error。
|
||
- [x] 对 Solid material 非法泊松比路径新增或加固 error。
|
||
- [x] 对 Johnson-Cook flow 参数非有限路径新增或加固 error。
|
||
- [x] 对 Johnson-Cook failure 参数非完整路径保持 error。
|
||
- [x] 对 Johnson-Cook failure 参数非有限路径新增或加固 error。
|
||
- [x] 对 unsupported softening 类型新增或加固 error。
|
||
- [x] 对未被 active Solid 粒子使用的 Solid material 保持 warning。
|
||
- [x] 对 `*SOLID SECTION` 缺失 material 参数路径保持 error。
|
||
- [x] 对 `*SOLID SECTION` 指向不存在 material 路径保持 error。
|
||
- [x] 对 `*SOLID SECTION` 指向非 Solid material 路径新增或加固 error。
|
||
- [x] 对存在 active Solid 粒子但缺失 Solid section 的模型给出 error。
|
||
- [x] 确认 set 仍只表示集合,不参与 Solid 类型判断。
|
||
- [x] 确认 phase/status 默认值不改变 Water/Gas/Explosive 路径。
|
||
- [x] 新增 `solid_051_input_validation` Fortran 输入测试。
|
||
- [x] 将 `solid_051_input_validation` 接入 CTest。
|
||
- [x] 确认 0.5.0 `input_solid_material` 和 `input_solid_errors` 仍通过。
|
||
|
||
## 阶段 C:参考邻域、修正矩阵与变形梯度状态
|
||
|
||
- [x] 复核 Solid 参考坐标、参考体积和参考邻域现有状态。
|
||
- [x] 新增或补齐 Solid 每粒子参考邻居数状态。
|
||
- [x] 新增或补齐 Solid 参考邻域退化状态。
|
||
- [x] 新增或补齐 Solid 修正矩阵状态码。
|
||
- [x] 新增或补齐 Solid 修正矩阵行列式诊断。
|
||
- [x] 在 Solid reset 路径初始化参考邻域诊断状态。
|
||
- [x] 在 Solid allocate/build 路径分配参考邻域诊断状态。
|
||
- [x] 在 Solid clear/finalize 路径释放参考邻域诊断状态。
|
||
- [x] 构建 active Solid 粒子的参考邻域计数。
|
||
- [x] 在参考邻域计数中排除非 Solid 粒子污染。
|
||
- [x] 计算 active Solid 粒子的最小参考邻居数诊断。
|
||
- [x] 识别参考邻域不足的退化 Solid 粒子。
|
||
- [x] 对退化参考邻域给出受控 warning 或 error。
|
||
- [x] 构建 Solid 参考梯度矩阵或等价矩阵。
|
||
- [x] 计算 Solid 修正矩阵行列式。
|
||
- [x] 检查 Solid 修正矩阵有限性。
|
||
- [x] 检查 Solid 修正矩阵近奇异状态。
|
||
- [x] 为不可逆修正矩阵提供受控 fallback。
|
||
- [x] 将修正矩阵质量诊断写入 Solid summary。
|
||
- [x] 将变形梯度初始值设置为单位阵。
|
||
- [x] 对非 active Solid 粒子设置安全变形梯度默认值。
|
||
- [x] 新增 `solid_reference_neighbor` 测试。
|
||
- [x] 新增 `solid_correction_matrix` 测试。
|
||
- [x] 将 `solid_reference_neighbor` 接入 CTest。
|
||
- [x] 将 `solid_correction_matrix` 接入 CTest。
|
||
|
||
## 阶段 D:速度梯度、应变率和运动学驱动本构
|
||
|
||
- [x] 新增或补齐 Solid 速度梯度工作数组。
|
||
- [x] 新增或补齐 Solid 应变率状态数组。
|
||
- [x] 新增或补齐 Solid 等效应变率状态数组。
|
||
- [x] 在 Solid reset 路径初始化速度梯度和应变率状态。
|
||
- [x] 在 Solid allocate/build 路径分配速度梯度和应变率状态。
|
||
- [x] 在 Solid clear/finalize 路径释放速度梯度和应变率状态。
|
||
- [x] 实现 active Solid 粒子的速度梯度计算入口。
|
||
- [x] 确认无 active Solid 粒子时跳过速度梯度计算。
|
||
- [x] 确认非 Solid 粒子不污染 Solid 速度梯度。
|
||
- [x] 实现均匀平动下速度梯度为零的路径。
|
||
- [x] 实现单轴拉伸速度场下速度梯度计算。
|
||
- [x] 由速度梯度计算对称应变率。
|
||
- [x] 将应变率转换为 Voigt 顺序。
|
||
- [x] 由应变率和 dt 更新 Solid 应变增量。
|
||
- [x] 更新 Solid 总应变状态。
|
||
- [x] 由应变率计算等效塑性应变率的安全默认值。
|
||
- [x] 将变形梯度更新挂接到速度梯度路径。
|
||
- [x] 让弹性材料点更新接受运动学应变增量。
|
||
- [x] 让 Johnson-Cook flow 更新接受运动学应变增量。
|
||
- [x] 让 Johnson-Cook failure 更新接受运动学应变增量。
|
||
- [x] 保持等温退化测试下温度状态可恢复。
|
||
- [x] 确认 damage 单调不减。
|
||
- [x] 确认 softening 单调不增。
|
||
- [x] 确认 `PHASE_SOLID_FAILED` 不可逆。
|
||
- [x] 新增 `solid_velocity_gradient` 测试。
|
||
- [x] 新增 `solid_strain_increment` 测试。
|
||
- [x] 将 `solid_velocity_gradient` 接入 CTest。
|
||
- [x] 将 `solid_strain_increment` 接入 CTest。
|
||
|
||
## 阶段 E:最小 Solid 内力、softening 作用与动力学诊断
|
||
|
||
- [x] 复核 Solid 加速度清零和累加顺序。
|
||
- [x] 新增或补齐 Solid 内力贡献工作数组。
|
||
- [x] 新增或补齐 Solid 内力动量残差诊断状态。
|
||
- [x] 新增或补齐 Solid 最大加速度诊断状态。
|
||
- [x] 实现零应力时 Solid 内力为零。
|
||
- [x] 实现均匀平动时 Solid 内力为零。
|
||
- [x] 实现成对 Solid 粒子的对称内力贡献。
|
||
- [x] 实现对称布置下均匀应力残差受控路径。
|
||
- [x] 将 Solid 应力散度或等价力贡献累加到加速度。
|
||
- [x] 确认 Solid 内力不污染 Water-only 算例。
|
||
- [x] 确认 Solid 内力不污染 Gas-only 算例。
|
||
- [x] 确认 Solid 内力不污染 Explosive-Gas-Water 算例。
|
||
- [x] 将 softening 因子作用到应力或内力贡献。
|
||
- [x] 确认 failed Solid 粒子不被删除。
|
||
- [x] 确认 failed Solid 粒子质量不改变。
|
||
- [x] 计算 Solid 总动量诊断。
|
||
- [x] 计算 Solid 动能诊断。
|
||
- [x] 计算 Solid 内能诊断。
|
||
- [x] 计算 Solid 塑性功或等价内能增量诊断。
|
||
- [x] 计算 Solid 最大 von Mises 应力诊断。
|
||
- [x] 计算 Solid 最大应变率诊断。
|
||
- [x] 计算 Solid 最大加速度诊断。
|
||
- [x] 计算 Solid damage 范围诊断。
|
||
- [x] 计算 Solid softening 范围诊断。
|
||
- [x] 计算 Solid 内力动量残差诊断。
|
||
- [x] 将 Solid 诊断更新挂接到显式推进流程。
|
||
- [x] 新增 `solid_internal_force_pair` 测试。
|
||
- [x] 新增 `solid_uniform_stress_balance` 测试。
|
||
- [x] 新增 `solid_softening_force` 测试。
|
||
- [x] 新增 `solid_energy_diagnostics` 测试。
|
||
- [x] 将 `solid_internal_force_pair` 接入 CTest。
|
||
- [x] 将 `solid_uniform_stress_balance` 接入 CTest。
|
||
- [x] 将 `solid_softening_force` 接入 CTest。
|
||
- [x] 将 `solid_energy_diagnostics` 接入 CTest。
|
||
|
||
## 阶段 F:Solid 稳定时间步、显式推进和 0.5.0 回归隔离
|
||
|
||
- [x] 复核 0.5.0 Solid 结构波速 dt 估计。
|
||
- [x] 新增或补齐 Solid 加速度 dt 约束诊断。
|
||
- [x] 实现 `dt_solid_acc` 的有限正值保护。
|
||
- [x] 将 Solid wave dt 和 acceleration dt 合并为 Solid dt。
|
||
- [x] 将 Solid dt 继续纳入全局 dt 估计。
|
||
- [x] 确认无 active Solid 粒子时全局 dt 与 0.5.0 路径一致。
|
||
- [x] 确认 active Solid 粒子存在时 Solid dt 有限且为正。
|
||
- [x] 确认体力增大时加速度 dt 约束可收紧。
|
||
- [x] 确认内力增大时加速度 dt 约束可收紧。
|
||
- [x] 确认 restart 后 Solid dt 诊断一致。
|
||
- [x] 将 Solid 速度梯度、本构、内力和诊断挂接到 Velocity-Verlet 步。
|
||
- [x] 确认 Solid-only 小模型可连续推进多步。
|
||
- [x] 确认 Water-only smoke 仍通过。
|
||
- [x] 确认 Gas-only smoke 仍通过。
|
||
- [x] 确认 Explosive-Gas-Water smoke 仍通过。
|
||
- [x] 新增 `solid_dt_acceleration` 测试。
|
||
- [x] 更新 `solid_explicit_smoke` 覆盖 0.5.1 诊断。
|
||
- [x] 将 `solid_dt_acceleration` 接入 CTest。
|
||
- [x] 确认 0.5.0 `solid_stable_dt` 仍通过。
|
||
- [x] 确认 0.5.0 `solid_explicit_smoke` 仍通过。
|
||
|
||
## 阶段 G:CSV 输出、`STATE_0_5_1` restart 与兼容读入
|
||
|
||
- [x] 在 summary CSV 中追加 `solid_max_strain_rate` 字段。
|
||
- [x] 在 summary CSV 中追加 `solid_max_acceleration` 字段。
|
||
- [x] 在 summary CSV 中追加 `solid_internal_force_residual` 字段。
|
||
- [x] 在 summary CSV 中追加 `solid_reference_neighbor_min` 字段。
|
||
- [x] 在 summary CSV 中追加 `solid_correction_det_min` 字段。
|
||
- [x] 在 summary CSV 中追加 `solid_correction_status` 字段。
|
||
- [x] 在粒子 CSV 中追加 `solid_strain_rate_eq` 字段。
|
||
- [x] 在粒子 CSV 中追加 `solid_acceleration_norm` 字段。
|
||
- [x] 在粒子 CSV 中追加 `solid_reference_neighbor_count` 字段。
|
||
- [x] 在粒子 CSV 中追加 `solid_correction_status` 字段。
|
||
- [x] 更新 output 测试锁定 0.5.1 CSV header。
|
||
- [x] 将 restart 状态版本更新为 `STATE_0_5_1`。
|
||
- [x] 将 Solid 参考邻居数写入 0.5.1 restart。
|
||
- [x] 将 Solid 修正矩阵状态写入 0.5.1 restart。
|
||
- [x] 将 Solid 修正矩阵行列式诊断写入 0.5.1 restart。
|
||
- [x] 将 Solid 变形梯度写入 0.5.1 restart。
|
||
- [x] 将 Solid 应变率状态写入 0.5.1 restart。
|
||
- [x] 将 Solid 0.5.1 新增诊断写入 restart。
|
||
- [x] 从 `STATE_0_5_1` restart 读回新增 Solid 状态。
|
||
- [x] 从 `STATE_0_5_1` restart 读回后继续显式步。
|
||
- [x] 从 `STATE_0_5` restart 兼容读入 Solid 0.5.0 状态。
|
||
- [x] 从 `STATE_0_5` restart 读入时初始化 0.5.1 新状态。
|
||
- [x] 从 `STATE_0_4_1` restart 读入时初始化空 Solid 0.5.1 状态。
|
||
- [x] 确认 restart 后不重复初始化 Solid 应力。
|
||
- [x] 确认 restart 后不重复初始化 Solid 塑性应变。
|
||
- [x] 确认 restart 后不重复初始化 Solid damage。
|
||
- [x] 确认 restart 后不重复初始化 Solid softening。
|
||
- [x] 确认 restart 后不重复初始化 Solid 变形梯度。
|
||
- [x] 新增 `solid_restart_051` 测试。
|
||
- [x] 新增 `solid_restart_050_compat` 测试。
|
||
- [x] 将 `solid_restart_051` 接入 CTest。
|
||
- [x] 将 `solid_restart_050_compat` 接入 CTest。
|
||
|
||
## 阶段 H:Fortran API、C ABI、C++、Python 与 CLI
|
||
|
||
- [x] 新增 `sph_get_solid_state` Fortran API。
|
||
- [x] 新增 `sph_get_solid_diagnostics` Fortran API。
|
||
- [x] 新增 `sph_get_solid_reference_quality` Fortran API。
|
||
- [x] 为 Solid 0.5.1 Fortran API 补齐未初始化错误路径。
|
||
- [x] 为 Solid 0.5.1 Fortran API 补齐小容量错误路径。
|
||
- [x] 在 C 头文件中声明 `sphlite_get_solid_particle_state`。
|
||
- [x] 在 C ABI 中实现 Solid 粒子级状态查询。
|
||
- [x] 在 C ABI 中校验空指针错误路径。
|
||
- [x] 在 C ABI 中校验非正容量错误路径。
|
||
- [x] 在 C ABI 中校验小容量错误路径。
|
||
- [x] 在 C ABI 中锁定 stress 展开顺序。
|
||
- [x] 在 C ABI 中锁定 strain 展开顺序。
|
||
- [x] 在 C ABI 中锁定 strain-rate 展开顺序。
|
||
- [x] 在 C API 测试中覆盖 Solid 粒子级状态查询。
|
||
- [x] 在 C API 测试中覆盖 Solid 0.5.1 错误路径。
|
||
- [x] 在 C++ wrapper 中新增 Solid particle state 薄包装。
|
||
- [x] 在 C++ API 测试中覆盖 Solid particle state 薄包装。
|
||
- [x] 在 Python ctypes 中新增 Solid particle state 薄包装。
|
||
- [x] 在 Python inspect 中追加 Solid 0.5.1 诊断字段。
|
||
- [x] 在 Python run/checker 中覆盖 Solid 0.5.1 小模型。
|
||
- [x] 在 Python checker 中覆盖 `STATE_0_5_1` restart 读回。
|
||
- [x] 在 Python checker 中覆盖 `STATE_0_5` restart 兼容读入。
|
||
- [x] 在 CLI inspect 中追加 `solid_max_strain_rate` 字段。
|
||
- [x] 在 CLI inspect 中追加 `solid_max_acceleration` 字段。
|
||
- [x] 在 CLI inspect 中追加 `solid_internal_force_residual` 字段。
|
||
- [x] 在 CLI inspect 中追加 `solid_correction_status` 字段。
|
||
- [x] 在 CLI inspect 中追加 `solid_reference_neighbor_min` 字段。
|
||
- [x] 在 CLI run 中追加 Solid 0.5.1 诊断字段。
|
||
- [x] 在 CLI checker 中覆盖 Solid 0.5.1 输入、run 和 restart。
|
||
- [x] 确认新增 API 不改变 0.5.0 已有接口语义。
|
||
- [x] 新增 `solid_state_api` 测试并接入 CTest。
|
||
- [x] 新增 `solid_python_051` 测试并接入 CTest。
|
||
- [x] 新增 `solid_cli_051` 测试并接入 CTest。
|
||
|
||
## 阶段 I:源码尺寸、回归门禁、文档同步与发布准备
|
||
|
||
- [ ] 新增 `solid_051_source_size` 检查项并接入 CTest。
|
||
- [ ] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。
|
||
- [ ] 拆分过大的 Solid reference 源文件或过长过程。
|
||
- [ ] 拆分过大的 Solid kinematics 源文件或过长过程。
|
||
- [ ] 拆分过大的 Solid force 源文件或过长过程。
|
||
- [ ] 拆分过大的 Solid restart 源文件或过长过程。
|
||
- [ ] 保持 0.5.0 完整 gate 全部通过。
|
||
- [ ] 单独运行 0.5.0 Solid 专项 gate。
|
||
- [ ] 单独运行 0.5.1 Solid 专项 gate。
|
||
- [ ] 运行 `source_size` 检查并确认无新增无理由例外。
|
||
- [ ] 运行 `git diff --check` 并清理空白问题。
|
||
- [ ] 更新 README 的 0.5.1 当前状态和不交付范围。
|
||
- [ ] 更新 06 号文档的 0.5.1 release gate。
|
||
- [ ] 更新 09 号文档的 0.5.1 验收记录占位。
|
||
- [ ] 更新 11 号文档的 0.5.1 benchmark/gate 矩阵。
|
||
- [ ] 确认文档不宣称已实现 `Shell`。
|
||
- [ ] 确认文档不宣称已实现真实水-气-结构工程爆炸响应。
|
||
- [ ] 确认文档不宣称已实现真实 FEM-SPH 耦合。
|
||
- [ ] 确认文档不宣称已实现工程级结构破坏 benchmark。
|
||
- [ ] 确认未新增几何、网格或粒子生成能力。
|
||
- [ ] 确认未新增 FEMLite 直接依赖。
|
||
- [ ] 确认未修改 SPHLite 文件夹之外的内容。
|
||
- [ ] 确认默认 gate、0.5.0 Solid gate、0.5.1 Solid gate、source size 和 `git diff --check` 全部通过。
|
||
- [ ] 汇总 0.5.1 已完成能力、未交付范围和已知限制。
|
||
- [ ] 准备 0.5.1 发布前本地提交记录。
|