16 KiB
16 KiB
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_1restart 测试输入样例。 - 准备
STATE_0_5restart 兼容读入测试夹具。 - 创建 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_validationFortran 输入测试。 - 将
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_1restart 读回新增 Solid 状态。 - 从
STATE_0_5_1restart 读回后继续显式步。 - 从
STATE_0_5restart 兼容读入 Solid 0.5.0 状态。 - 从
STATE_0_5restart 读入时初始化 0.5.1 新状态。 - 从
STATE_0_4_1restart 读入时初始化空 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_stateFortran API。 - 新增
sph_get_solid_diagnosticsFortran API。 - 新增
sph_get_solid_reference_qualityFortran 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_1restart 读回。 - 在 Python checker 中覆盖
STATE_0_5restart 兼容读入。 - 在 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 发布前本地提交记录。