Files
SPHLite/todo.md
T
2026-07-04 10:59:25 +08:00

258 lines
14 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.8.1
本文档根据 `docs/v8.1_development_plan.md` 生成。0.8.1 定位为 SPHLite 侧中立接触耦合接口稳定化版本,目标是在 0.8.0 已发布的 coupling region、粒子/Facet Proxy 导出、外部载荷/运动边界导入、显式步响应、diagnostics、restart 和接口层基础上,加固 facet pressure/traction/resultant 载荷导入、受控分配、接触状态诊断、输出、restart、接口和 mock coupling gate。
所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.8.1 不交付真实 FEMLite 联合运行,不交付外部 CouplingModule、CoupleLite、CoupledLite 或 CouplingLite,不交付连续体耦合,不宣称工程级水下接触爆炸破坏 benchmark。核心代码继续遵守 Fortran95 约束,C/C++/Python 接口采用追加式扩展。执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端,除非用户另行要求。
## 阶段 A:0.8.1 基线、范围收敛和版本更新
- [x] 确认当前 git 工作区状态并记录已有未提交内容。
- [x] 确认 `v0.8.0` 标签和远端发布提交可作为 0.8.1 开发基线。
- [x] 复核 `docs/v8.1_development_plan.md` 的版本定位和非交付范围。
- [x] 确认 0.8.1 只交付 SPHLite 侧接触耦合接口稳定化能力。
- [x] 确认 0.8.1 不实现真实 FEMLite 联合运行。
- [x] 确认 0.8.1 不实现外部 CouplingModule。
- [x] 确认 0.8.1 不实现连续体耦合。
- [x] 确认 0.8.1 不新增几何、网格或粒子生成能力。
- [x] 复核 0.8.0 coupling region 输入解析能力。
- [x] 复核 0.8.0 facet proxy 导出能力。
- [x] 复核 0.8.0 facet load 导入能力。
- [x] 复核 0.8.0 coupling diagnostics 能力。
- [x] 复核 0.8.0 restart 和接口边界。
- [x] 将 CMake 项目版本更新为 `0.8.1`。
- [x] 将核心 Fortran 版本号更新为 `0.8.1`。
- [x] 更新 Fortran smoke 测试中的版本期望。
- [x] 更新 C API 测试中的版本期望。
- [x] 更新 C++ wrapper 测试中的版本期望。
- [x] 更新 Python debug 测试中的版本期望。
- [x] 更新 CLI `--version` 或 inspect 版本期望。
- [x] 更新 README 当前开发版本为 `0.8.1`。
- [x] 在 README 中说明 0.8.1 的接触载荷分配和诊断范围。
- [x] 在 README 中说明 0.8.1 的不交付边界。
- [x] 准备 0.8.1 coupling 专项 gate 的初始测试名称清单。
- [x] 运行版本相关 smoke 或快速 gate。
- [x] 运行 `git diff --check`。
- [x] 准备阶段 A 本地提交说明。
## 阶段 B:输入控制、载荷模式和接触状态契约
- [x] 定义 `LOAD_MODE=PARTICLE_FORCE` 输入语义。
- [x] 定义 `LOAD_MODE=FACET_FORCE` 输入语义。
- [x] 定义 `LOAD_MODE=PRESSURE` 输入语义。
- [x] 定义 `LOAD_MODE=TRACTION` 输入语义。
- [x] 定义 `DISTRIBUTION=UNIFORM` 输入语义。
- [x] 定义 `DISTRIBUTION=AREA` 输入语义。
- [x] 定义 `DISTRIBUTION=MASS` 输入语义。
- [x] 定义 `CONTACT_STATE=IMPORT` 输入语义。
- [x] 支持读取 coupling region 的 `LOAD_MODE` 字段。
- [x] 支持读取 coupling region 的 `DISTRIBUTION` 字段。
- [x] 支持读取 coupling region 的 `CONTACT_STATE` 字段。
- [x] 为未显式给出的 `LOAD_MODE` 设置 0.8.0 兼容默认值。
- [x] 为未显式给出的 `DISTRIBUTION` 设置兼容默认值。
- [x] 对非法 `LOAD_MODE` 报 error。
- [x] 对非法 `DISTRIBUTION` 报 error。
- [x] 对非法 `CONTACT_STATE` 报 error。
- [x] 对 pressure/traction 载荷但无 facet proxy 的 active region 报 error。
- [x] 对 disabled region 保留新增输入记录但不参与导入。
- [x] 在数据库中保存 load mode。
- [x] 在数据库中保存 distribution mode。
- [x] 在数据库中保存 contact state mode。
- [x] 建立 contact flag 运行时缓存。
- [x] 建立 contact normal 运行时缓存。
- [x] 建立 gap 运行时缓存。
- [x] 建立 penetration 运行时缓存。
- [x] 建立 contact pressure 运行时缓存。
- [x] 在初始化阶段分配 contact state 缓存。
- [x] 在 finalize 阶段释放 contact state 缓存。
- [x] 在模型重建阶段清空 contact state 缓存。
- [x] 新增 `input_coupling_load_mode_081` 测试。
- [x] 新增 `input_coupling_load_errors_081` 测试。
- [x] 新增 `coupling_contact_state_081` 基础测试。
- [x] 将阶段 B 新测试接入 CTest。
- [x] 运行阶段 B 输入和接触状态专项测试。
- [x] 运行 `git diff --check`。
- [x] 准备阶段 B 本地提交说明。
## 阶段 C:Facet Pressure、Traction、Resultant 和分配策略
- [x] 设计 facet pressure 导入缓存。
- [x] 设计 facet traction 导入缓存。
- [x] 设计 facet resultant 导入缓存。
- [x] 设计 facet 分配后粒子力缓存复用路径。
- [x] 定义 pressure 正负号约定。
- [x] 实现 pressure 到 facet 合力的转换。
- [x] 实现 traction 到 facet 合力的转换。
- [x] 实现 resultant force 的直接接收路径。
- [x] 实现 `UNIFORM` 分配策略。
- [x] 实现 `AREA` 或受控 facet 权重分配策略。
- [x] 实现 `MASS` 分配策略。
- [x] 对权重和非正时报 error。
- [x] 对 facet 面积非正时报 error。
- [x] 对 facet 法向非有限时报 error。
- [x] 对 facet 法向长度过小时报 error。
- [x] 对 pressure 非有限时报 error。
- [x] 对 traction 非有限时报 error。
- [x] 对 resultant 非有限时报 error。
- [x] 对非法 facet id 报 error。
- [x] 对重复 facet id 记录诊断或报 error。
- [x] 对同一 epoch 重复导入按固定策略处理。
- [x] 对新 epoch 导入清理上一 epoch 临时载荷。
- [x] 计算 facet 输入总力。
- [x] 计算 facet 分配后总力。
- [x] 计算 facet 总力误差。
- [x] 计算 facet 输入参考力矩。
- [x] 计算 facet 分配后参考力矩。
- [x] 计算 facet 力矩误差。
- [x] 记录最大 pressure。
- [x] 记录最大 traction。
- [x] 新增 `coupling_facet_pressure_081` 测试。
- [x] 新增 `coupling_facet_traction_081` 测试。
- [x] 新增 `coupling_facet_resultant_081` 测试。
- [x] 新增 `coupling_distribution_uniform_081` 测试。
- [x] 新增 `coupling_distribution_area_081` 测试。
- [x] 新增 `coupling_distribution_mass_081` 测试。
- [x] 新增 `coupling_load_balance_081` 测试。
- [x] 将阶段 C 新测试接入 CTest。
- [x] 运行阶段 C facet 载荷分配专项测试。
- [x] 运行 `git diff --check`。
- [x] 准备阶段 C 本地提交说明。
## 阶段 D:显式步接入、接触诊断和回归隔离
- [ ] 将 pressure 分配后的粒子力接入 coupling 外力缓存。
- [ ] 将 traction 分配后的粒子力接入 coupling 外力缓存。
- [ ] 将 resultant 分配后的粒子力接入 coupling 外力缓存。
- [ ] 固定 particle force、facet force、pressure、traction 和 motion boundary 的施加顺序。
- [ ] 固定 coupling 外载荷与 blast 外载荷的叠加顺序。
- [ ] 确认 coupling 外载荷缓存独立于 blast 外载荷缓存。
- [ ] 记录 active contact 数量。
- [ ] 记录 skipped contact 数量。
- [ ] 记录最大 penetration。
- [ ] 记录 stale epoch 计数。
- [ ] 记录重复导入计数。
- [ ] 记录 nonfinite contact import 计数。
- [ ] 记录负面积或零面积 facet 计数。
- [ ] 记录非法权重计数。
- [ ] 将 contact diagnostics 合入 coupling diagnostics 查询。
- [ ] 确认无 active contact 时安全跳过。
- [ ] 确认 disabled coupling region 不影响显式步。
- [ ] 确认空 pressure/traction 导入不产生虚假加速度。
- [ ] 确认 Water-only 回归不被 0.8.1 coupling 路径污染。
- [ ] 确认 Gas-only 回归不被 0.8.1 coupling 路径污染。
- [ ] 确认 Explosive 回归不被 0.8.1 coupling 路径污染。
- [ ] 确认 Solid-only 回归不被 0.8.1 coupling 路径污染。
- [ ] 确认 Shell-only 回归不被 0.8.1 coupling 路径污染。
- [ ] 新增 `coupling_contact_diagnostics_081` 测试。
- [ ] 新增 `coupling_solver_order_081` 测试。
- [ ] 新增 `coupling_stale_epoch_081` 测试。
- [ ] 新增 `coupling_solid_surface_pressure_081` 测试。
- [ ] 新增 `coupling_shell_pressure_081` 测试。
- [ ] 新增 `coupling_mixed_pressure_motion_081` 测试。
- [ ] 将阶段 D 新测试接入 CTest。
- [ ] 运行阶段 D 显式步和诊断专项测试。
- [ ] 运行 `git diff --check`。
- [ ] 准备阶段 D 本地提交说明。
## 阶段 E:Output、Restart、Fortran API 和外部接口层
- [ ] 定义 summary CSV 的 0.8.1 contact 字段清单。
- [ ] 追加 `coupling_active_contacts` summary CSV 字段。
- [ ] 追加 `coupling_skipped_contacts` summary CSV 字段。
- [ ] 追加 `coupling_max_pressure` summary CSV 字段。
- [ ] 追加 `coupling_max_traction` summary CSV 字段。
- [ ] 追加 `coupling_max_penetration` summary CSV 字段。
- [ ] 追加 `coupling_force_balance_error` summary CSV 字段。
- [ ] 追加 `coupling_moment_balance_error` summary CSV 字段。
- [ ] 定义粒子 CSV 的 0.8.1 contact 调试字段清单。
- [ ] 追加粒子 CSV 的 `coupling_contact_flag` 字段。
- [ ] 追加粒子 CSV 的 `coupling_gap` 字段。
- [ ] 追加粒子 CSV 的 `coupling_penetration` 字段。
- [ ] 明确 0.8.1 restart 状态版本名称。
- [ ] 实现 `STATE_0_8_1` 或等价 0.8.1 restart 写入。
- [ ] 在 restart 中保存 load mode 和 distribution mode。
- [ ] 在 restart 中保存 contact state 缓存。
- [ ] 在 restart 中保存 facet 分配诊断。
- [ ] 在 restart 中保存新增 contact diagnostics。
- [ ] 实现 `STATE_0_8_1` 或等价 0.8.1 restart 读回。
- [ ] 实现 0.8.0 restart 兼容读入后的空 0.8.1 状态初始化。
- [ ] 实现 restart 读回后继续显式步的 0.8.1 coupling 状态恢复。
- [ ] 新增 `sph_coupling_apply_facet_pressures` Fortran API。
- [ ] 新增 `sph_coupling_apply_facet_tractions` Fortran API。
- [ ] 新增 `sph_coupling_apply_facet_resultants` Fortran API。
- [ ] 新增 `sph_coupling_apply_contact_state` Fortran API。
- [ ] 新增 `sph_coupling_get_load_balance` Fortran API。
- [ ] 新增 `sph_coupling_get_contact_diagnostics` Fortran API。
- [ ] 在 C 头文件中声明 facet pressure 导入接口。
- [ ] 在 C 头文件中声明 facet traction 导入接口。
- [ ] 在 C 头文件中声明 contact state 导入接口。
- [ ] 在 C 头文件中声明 contact diagnostics 查询接口。
- [ ] 实现 C ABI 新接口的空指针错误路径。
- [ ] 实现 C ABI 新接口的小容量错误路径。
- [ ] 实现 C ABI 新接口的非法 region 错误路径。
- [ ] 实现 C ABI 新接口的非有限输入错误路径。
- [ ] 在 C++ wrapper 中追加 pressure、traction 和 diagnostics 薄包装。
- [ ] 在 Python ctypes 中追加 pressure、traction 和 diagnostics 调试入口。
- [ ] 在 CLI inspect 中追加 load mode、distribution 和 contact diagnostics 字段。
- [ ] 新增 `coupling_output_081` 测试。
- [ ] 新增 `coupling_restart_081` 测试。
- [ ] 新增 `coupling_restart_080_compat` 测试。
- [ ] 新增 `coupling_fortran_api_081` 测试。
- [ ] 新增 `coupling_c_api_081` 测试。
- [ ] 新增 `coupling_cpp_api_081` 测试。
- [ ] 新增 `coupling_python_081` 测试。
- [ ] 新增 `coupling_cli_081` 测试。
- [ ] 将阶段 E 新测试接入 CTest。
- [ ] 运行阶段 E output、restart 和接口专项测试。
- [ ] 运行 `git diff --check`。
- [ ] 准备阶段 E 本地提交说明。
## 阶段 F:Mock Coupling Smoke、门禁、文档和发布准备
- [ ] 设计 Solid surface pressure mock coupling smoke 样例。
- [ ] 设计 Shell pressure mock coupling smoke 样例。
- [ ] 设计 traction mock coupling smoke 样例。
- [ ] 设计 pressure-motion 混合 mock coupling smoke 样例。
- [ ] 设计 stale epoch mock coupling smoke 样例。
- [ ] 新增 Solid surface pressure 输入文件。
- [ ] 新增 Shell pressure 输入文件。
- [ ] 新增 traction 输入文件。
- [ ] 新增 pressure-motion 混合输入文件。
- [ ] 新增 stale epoch 输入文件。
- [ ] 验证 smoke 中所有粒子状态保持有限。
- [ ] 验证 smoke 中 pressure 方向受控。
- [ ] 验证 smoke 中 traction 方向受控。
- [ ] 验证 smoke 中 motion boundary 方向受控。
- [ ] 验证 smoke 中 Solid 响应方向受控。
- [ ] 验证 smoke 中 Shell 平动响应方向受控。
- [ ] 验证 smoke 中总力误差和力矩误差有限。
- [ ] 验证 smoke 中 contact diagnostics 有限。
- [ ] 验证 stale epoch 诊断按预期变化。
- [ ] 新增 `coupling_smoke_081` 测试。
- [ ] 新增 `coupling_source_size_081` 测试。
- [ ] 将阶段 F 新测试接入 CTest。
- [ ] 运行 0.8.1 coupling 专项 gate。
- [ ] 运行 0.8.0 coupling 回归 gate。
- [ ] 运行 Water 回归 gate。
- [ ] 运行 Gas 回归 gate。
- [ ] 运行 Explosive 回归 gate。
- [ ] 运行 Solid 回归 gate。
- [ ] 运行 Shell 回归 gate。
- [ ] 运行 0.7.0 blast 回归 gate。
- [ ] 运行 0.7.1 blast 专项 gate。
- [ ] 运行完整 CTest。
- [ ] 运行 source size 相关 gate。
- [ ] 运行 `git diff --check`。
- [ ] 检查代码、构建脚本、测试和工具目录未新增 FEMLite 直接依赖。
- [ ] 检查输出目录、CSV、VTK、restart 和临时结果未被提交。
- [ ] 更新 README 的 0.8.1 当前状态和不交付范围。
- [ ] 更新 `docs/06_test_and_verification_plan.md` 的 0.8.1 release gate。
- [ ] 更新 `docs/09_release_history.md` 的 0.8.1 本地验收记录。
- [ ] 更新 `docs/11_benchmark_matrix.md` 的 0.8.1 gate 矩阵。
- [ ] 确认文档不宣称真实 FEMLite 联合运行。
- [ ] 确认文档不宣称连续体耦合。
- [ ] 确认文档不宣称工程级船舶水下接触爆炸破坏 benchmark。
- [ ] 准备 0.8.1 发布提交说明。
- [ ] 准备阶段 F 本地提交说明。