Files
SPHLite/todo.md
T
2026-07-03 17:29:47 +08:00

16 KiB
Raw Blame History

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 样例

  • 确认当前 git 状态干净或记录已有未提交内容。
  • 确认 v0.5.0 标签和远端发布提交可作为 0.5.1 开发基线。
  • 将核心软件版本更新为 0.5.1。
  • 将 CMake 项目版本更新为 0.5.1。
  • 更新 Fortran smoke 测试中的版本期望。
  • 更新 C API 测试中的版本期望。
  • 更新 C++ API 测试中的版本期望。
  • 更新 Python debug 测试中的版本期望。
  • 更新 CLI --version 和 inspect 版本期望。
  • 在 README 中记录 0.5.1 Solid 稳定化开发定位。
  • 创建 Solid 0.5.1 正常参考邻域输入样例。
  • 创建 Solid 0.5.1 退化参考邻域输入样例。
  • 创建 Solid 均匀平动速度场输入样例。
  • 创建 Solid 单轴拉伸速度场输入样例。
  • 创建 Solid 成对内力平衡输入样例。
  • 创建 Solid 对称均匀应力输入样例。
  • 创建 Solid softening 内力折减输入样例。
  • 创建 Solid 0.5.1 显式推进 smoke 输入样例。
  • 创建 STATE_0_5_1 restart 测试输入样例。
  • 准备 STATE_0_5 restart 兼容读入测试夹具。
  • 创建 Solid material 非法泊松比错误输入样例。
  • 创建 Solid material 非有限 Johnson-Cook 参数错误输入样例。
  • 创建 Solid 非法 softening 类型错误输入样例。
  • 创建 Solid section 指向非 Solid material 错误输入样例。
  • 创建 active Solid 粒子缺失 Solid section 错误输入样例。

阶段 B:Solid 输入校验、section 校验与 warning/error 路径

  • 复核 0.5.0 Solid material 解析路径并保持语法兼容。
  • 对 Solid material 缺失密度路径保持 error。
  • 对 Solid material 非正密度路径保持 error。
  • 对 Solid material 缺失弹性参数路径保持 error。
  • 对 Solid material 非正弹性模量路径保持 error。
  • 对 Solid material 非法泊松比路径新增或加固 error。
  • 对 Johnson-Cook flow 参数非有限路径新增或加固 error。
  • 对 Johnson-Cook failure 参数非完整路径保持 error。
  • 对 Johnson-Cook failure 参数非有限路径新增或加固 error。
  • 对 unsupported softening 类型新增或加固 error。
  • 对未被 active Solid 粒子使用的 Solid material 保持 warning。
  • 对 *SOLID SECTION 缺失 material 参数路径保持 error。
  • 对 *SOLID SECTION 指向不存在 material 路径保持 error。
  • 对 *SOLID SECTION 指向非 Solid material 路径新增或加固 error。
  • 对存在 active Solid 粒子但缺失 Solid section 的模型给出 error。
  • 确认 set 仍只表示集合,不参与 Solid 类型判断。
  • 确认 phase/status 默认值不改变 Water/Gas/Explosive 路径。
  • 新增 solid_051_input_validation Fortran 输入测试。
  • 将 solid_051_input_validation 接入 CTest。
  • 确认 0.5.0 input_solid_material 和 input_solid_errors 仍通过。

阶段 C:参考邻域、修正矩阵与变形梯度状态

  • 复核 Solid 参考坐标、参考体积和参考邻域现有状态。
  • 新增或补齐 Solid 每粒子参考邻居数状态。
  • 新增或补齐 Solid 参考邻域退化状态。
  • 新增或补齐 Solid 修正矩阵状态码。
  • 新增或补齐 Solid 修正矩阵行列式诊断。
  • 在 Solid reset 路径初始化参考邻域诊断状态。
  • 在 Solid allocate/build 路径分配参考邻域诊断状态。
  • 在 Solid clear/finalize 路径释放参考邻域诊断状态。
  • 构建 active Solid 粒子的参考邻域计数。
  • 在参考邻域计数中排除非 Solid 粒子污染。
  • 计算 active Solid 粒子的最小参考邻居数诊断。
  • 识别参考邻域不足的退化 Solid 粒子。
  • 对退化参考邻域给出受控 warning 或 error。
  • 构建 Solid 参考梯度矩阵或等价矩阵。
  • 计算 Solid 修正矩阵行列式。
  • 检查 Solid 修正矩阵有限性。
  • 检查 Solid 修正矩阵近奇异状态。
  • 为不可逆修正矩阵提供受控 fallback。
  • 将修正矩阵质量诊断写入 Solid summary。
  • 将变形梯度初始值设置为单位阵。
  • 对非 active Solid 粒子设置安全变形梯度默认值。
  • 新增 solid_reference_neighbor 测试。
  • 新增 solid_correction_matrix 测试。
  • 将 solid_reference_neighbor 接入 CTest。
  • 将 solid_correction_matrix 接入 CTest。

阶段 D:速度梯度、应变率和运动学驱动本构

  • 新增或补齐 Solid 速度梯度工作数组。
  • 新增或补齐 Solid 应变率状态数组。
  • 新增或补齐 Solid 等效应变率状态数组。
  • 在 Solid reset 路径初始化速度梯度和应变率状态。
  • 在 Solid allocate/build 路径分配速度梯度和应变率状态。
  • 在 Solid clear/finalize 路径释放速度梯度和应变率状态。
  • 实现 active Solid 粒子的速度梯度计算入口。
  • 确认无 active Solid 粒子时跳过速度梯度计算。
  • 确认非 Solid 粒子不污染 Solid 速度梯度。
  • 实现均匀平动下速度梯度为零的路径。
  • 实现单轴拉伸速度场下速度梯度计算。
  • 由速度梯度计算对称应变率。
  • 将应变率转换为 Voigt 顺序。
  • 由应变率和 dt 更新 Solid 应变增量。
  • 更新 Solid 总应变状态。
  • 由应变率计算等效塑性应变率的安全默认值。
  • 将变形梯度更新挂接到速度梯度路径。
  • 让弹性材料点更新接受运动学应变增量。
  • 让 Johnson-Cook flow 更新接受运动学应变增量。
  • 让 Johnson-Cook failure 更新接受运动学应变增量。
  • 保持等温退化测试下温度状态可恢复。
  • 确认 damage 单调不减。
  • 确认 softening 单调不增。
  • 确认 PHASE_SOLID_FAILED 不可逆。
  • 新增 solid_velocity_gradient 测试。
  • 新增 solid_strain_increment 测试。
  • 将 solid_velocity_gradient 接入 CTest。
  • 将 solid_strain_increment 接入 CTest。

阶段 E:最小 Solid 内力、softening 作用与动力学诊断

  • 复核 Solid 加速度清零和累加顺序。
  • 新增或补齐 Solid 内力贡献工作数组。
  • 新增或补齐 Solid 内力动量残差诊断状态。
  • 新增或补齐 Solid 最大加速度诊断状态。
  • 实现零应力时 Solid 内力为零。
  • 实现均匀平动时 Solid 内力为零。
  • 实现成对 Solid 粒子的对称内力贡献。
  • 实现对称布置下均匀应力残差受控路径。
  • 将 Solid 应力散度或等价力贡献累加到加速度。
  • 确认 Solid 内力不污染 Water-only 算例。
  • 确认 Solid 内力不污染 Gas-only 算例。
  • 确认 Solid 内力不污染 Explosive-Gas-Water 算例。
  • 将 softening 因子作用到应力或内力贡献。
  • 确认 failed Solid 粒子不被删除。
  • 确认 failed Solid 粒子质量不改变。
  • 计算 Solid 总动量诊断。
  • 计算 Solid 动能诊断。
  • 计算 Solid 内能诊断。
  • 计算 Solid 塑性功或等价内能增量诊断。
  • 计算 Solid 最大 von Mises 应力诊断。
  • 计算 Solid 最大应变率诊断。
  • 计算 Solid 最大加速度诊断。
  • 计算 Solid damage 范围诊断。
  • 计算 Solid softening 范围诊断。
  • 计算 Solid 内力动量残差诊断。
  • 将 Solid 诊断更新挂接到显式推进流程。
  • 新增 solid_internal_force_pair 测试。
  • 新增 solid_uniform_stress_balance 测试。
  • 新增 solid_softening_force 测试。
  • 新增 solid_energy_diagnostics 测试。
  • 将 solid_internal_force_pair 接入 CTest。
  • 将 solid_uniform_stress_balance 接入 CTest。
  • 将 solid_softening_force 接入 CTest。
  • 将 solid_energy_diagnostics 接入 CTest。

阶段 F:Solid 稳定时间步、显式推进和 0.5.0 回归隔离

  • 复核 0.5.0 Solid 结构波速 dt 估计。
  • 新增或补齐 Solid 加速度 dt 约束诊断。
  • 实现 dt_solid_acc 的有限正值保护。
  • 将 Solid wave dt 和 acceleration dt 合并为 Solid dt。
  • 将 Solid dt 继续纳入全局 dt 估计。
  • 确认无 active Solid 粒子时全局 dt 与 0.5.0 路径一致。
  • 确认 active Solid 粒子存在时 Solid dt 有限且为正。
  • 确认体力增大时加速度 dt 约束可收紧。
  • 确认内力增大时加速度 dt 约束可收紧。
  • 确认 restart 后 Solid dt 诊断一致。
  • 将 Solid 速度梯度、本构、内力和诊断挂接到 Velocity-Verlet 步。
  • 确认 Solid-only 小模型可连续推进多步。
  • 确认 Water-only smoke 仍通过。
  • 确认 Gas-only smoke 仍通过。
  • 确认 Explosive-Gas-Water smoke 仍通过。
  • 新增 solid_dt_acceleration 测试。
  • 更新 solid_explicit_smoke 覆盖 0.5.1 诊断。
  • 将 solid_dt_acceleration 接入 CTest。
  • 确认 0.5.0 solid_stable_dt 仍通过。
  • 确认 0.5.0 solid_explicit_smoke 仍通过。

阶段 G:CSV 输出、STATE_0_5_1 restart 与兼容读入

  • 在 summary CSV 中追加 solid_max_strain_rate 字段。
  • 在 summary CSV 中追加 solid_max_acceleration 字段。
  • 在 summary CSV 中追加 solid_internal_force_residual 字段。
  • 在 summary CSV 中追加 solid_reference_neighbor_min 字段。
  • 在 summary CSV 中追加 solid_correction_det_min 字段。
  • 在 summary CSV 中追加 solid_correction_status 字段。
  • 在粒子 CSV 中追加 solid_strain_rate_eq 字段。
  • 在粒子 CSV 中追加 solid_acceleration_norm 字段。
  • 在粒子 CSV 中追加 solid_reference_neighbor_count 字段。
  • 在粒子 CSV 中追加 solid_correction_status 字段。
  • 更新 output 测试锁定 0.5.1 CSV header。
  • 将 restart 状态版本更新为 STATE_0_5_1。
  • 将 Solid 参考邻居数写入 0.5.1 restart。
  • 将 Solid 修正矩阵状态写入 0.5.1 restart。
  • 将 Solid 修正矩阵行列式诊断写入 0.5.1 restart。
  • 将 Solid 变形梯度写入 0.5.1 restart。
  • 将 Solid 应变率状态写入 0.5.1 restart。
  • 将 Solid 0.5.1 新增诊断写入 restart。
  • 从 STATE_0_5_1 restart 读回新增 Solid 状态。
  • 从 STATE_0_5_1 restart 读回后继续显式步。
  • 从 STATE_0_5 restart 兼容读入 Solid 0.5.0 状态。
  • 从 STATE_0_5 restart 读入时初始化 0.5.1 新状态。
  • 从 STATE_0_4_1 restart 读入时初始化空 Solid 0.5.1 状态。
  • 确认 restart 后不重复初始化 Solid 应力。
  • 确认 restart 后不重复初始化 Solid 塑性应变。
  • 确认 restart 后不重复初始化 Solid damage。
  • 确认 restart 后不重复初始化 Solid softening。
  • 确认 restart 后不重复初始化 Solid 变形梯度。
  • 新增 solid_restart_051 测试。
  • 新增 solid_restart_050_compat 测试。
  • 将 solid_restart_051 接入 CTest。
  • 将 solid_restart_050_compat 接入 CTest。

阶段 H:Fortran API、C ABI、C++、Python 与 CLI

  • 新增 sph_get_solid_state Fortran API。
  • 新增 sph_get_solid_diagnostics Fortran API。
  • 新增 sph_get_solid_reference_quality Fortran API。
  • 为 Solid 0.5.1 Fortran API 补齐未初始化错误路径。
  • 为 Solid 0.5.1 Fortran API 补齐小容量错误路径。
  • 在 C 头文件中声明 sphlite_get_solid_particle_state。
  • 在 C ABI 中实现 Solid 粒子级状态查询。
  • 在 C ABI 中校验空指针错误路径。
  • 在 C ABI 中校验非正容量错误路径。
  • 在 C ABI 中校验小容量错误路径。
  • 在 C ABI 中锁定 stress 展开顺序。
  • 在 C ABI 中锁定 strain 展开顺序。
  • 在 C ABI 中锁定 strain-rate 展开顺序。
  • 在 C API 测试中覆盖 Solid 粒子级状态查询。
  • 在 C API 测试中覆盖 Solid 0.5.1 错误路径。
  • 在 C++ wrapper 中新增 Solid particle state 薄包装。
  • 在 C++ API 测试中覆盖 Solid particle state 薄包装。
  • 在 Python ctypes 中新增 Solid particle state 薄包装。
  • 在 Python inspect 中追加 Solid 0.5.1 诊断字段。
  • 在 Python run/checker 中覆盖 Solid 0.5.1 小模型。
  • 在 Python checker 中覆盖 STATE_0_5_1 restart 读回。
  • 在 Python checker 中覆盖 STATE_0_5 restart 兼容读入。
  • 在 CLI inspect 中追加 solid_max_strain_rate 字段。
  • 在 CLI inspect 中追加 solid_max_acceleration 字段。
  • 在 CLI inspect 中追加 solid_internal_force_residual 字段。
  • 在 CLI inspect 中追加 solid_correction_status 字段。
  • 在 CLI inspect 中追加 solid_reference_neighbor_min 字段。
  • 在 CLI run 中追加 Solid 0.5.1 诊断字段。
  • 在 CLI checker 中覆盖 Solid 0.5.1 输入、run 和 restart。
  • 确认新增 API 不改变 0.5.0 已有接口语义。
  • 新增 solid_state_api 测试并接入 CTest。
  • 新增 solid_python_051 测试并接入 CTest。
  • 新增 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 发布前本地提交记录。