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

14 KiB
Raw Blame History

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 基线、范围收敛和版本更新

  • 确认当前 git 工作区状态并记录已有未提交内容。
  • 确认 v0.8.0 标签和远端发布提交可作为 0.8.1 开发基线。
  • 复核 docs/v8.1_development_plan.md 的版本定位和非交付范围。
  • 确认 0.8.1 只交付 SPHLite 侧接触耦合接口稳定化能力。
  • 确认 0.8.1 不实现真实 FEMLite 联合运行。
  • 确认 0.8.1 不实现外部 CouplingModule。
  • 确认 0.8.1 不实现连续体耦合。
  • 确认 0.8.1 不新增几何、网格或粒子生成能力。
  • 复核 0.8.0 coupling region 输入解析能力。
  • 复核 0.8.0 facet proxy 导出能力。
  • 复核 0.8.0 facet load 导入能力。
  • 复核 0.8.0 coupling diagnostics 能力。
  • 复核 0.8.0 restart 和接口边界。
  • 将 CMake 项目版本更新为 0.8.1。
  • 将核心 Fortran 版本号更新为 0.8.1。
  • 更新 Fortran smoke 测试中的版本期望。
  • 更新 C API 测试中的版本期望。
  • 更新 C++ wrapper 测试中的版本期望。
  • 更新 Python debug 测试中的版本期望。
  • 更新 CLI --version 或 inspect 版本期望。
  • 更新 README 当前开发版本为 0.8.1。
  • 在 README 中说明 0.8.1 的接触载荷分配和诊断范围。
  • 在 README 中说明 0.8.1 的不交付边界。
  • 准备 0.8.1 coupling 专项 gate 的初始测试名称清单。
  • 运行版本相关 smoke 或快速 gate。
  • 运行 git diff --check。
  • 准备阶段 A 本地提交说明。

阶段 B:输入控制、载荷模式和接触状态契约

  • 定义 LOAD_MODE=PARTICLE_FORCE 输入语义。
  • 定义 LOAD_MODE=FACET_FORCE 输入语义。
  • 定义 LOAD_MODE=PRESSURE 输入语义。
  • 定义 LOAD_MODE=TRACTION 输入语义。
  • 定义 DISTRIBUTION=UNIFORM 输入语义。
  • 定义 DISTRIBUTION=AREA 输入语义。
  • 定义 DISTRIBUTION=MASS 输入语义。
  • 定义 CONTACT_STATE=IMPORT 输入语义。
  • 支持读取 coupling region 的 LOAD_MODE 字段。
  • 支持读取 coupling region 的 DISTRIBUTION 字段。
  • 支持读取 coupling region 的 CONTACT_STATE 字段。
  • 为未显式给出的 LOAD_MODE 设置 0.8.0 兼容默认值。
  • 为未显式给出的 DISTRIBUTION 设置兼容默认值。
  • 对非法 LOAD_MODE 报 error。
  • 对非法 DISTRIBUTION 报 error。
  • 对非法 CONTACT_STATE 报 error。
  • 对 pressure/traction 载荷但无 facet proxy 的 active region 报 error。
  • 对 disabled region 保留新增输入记录但不参与导入。
  • 在数据库中保存 load mode。
  • 在数据库中保存 distribution mode。
  • 在数据库中保存 contact state mode。
  • 建立 contact flag 运行时缓存。
  • 建立 contact normal 运行时缓存。
  • 建立 gap 运行时缓存。
  • 建立 penetration 运行时缓存。
  • 建立 contact pressure 运行时缓存。
  • 在初始化阶段分配 contact state 缓存。
  • 在 finalize 阶段释放 contact state 缓存。
  • 在模型重建阶段清空 contact state 缓存。
  • 新增 input_coupling_load_mode_081 测试。
  • 新增 input_coupling_load_errors_081 测试。
  • 新增 coupling_contact_state_081 基础测试。
  • 将阶段 B 新测试接入 CTest。
  • 运行阶段 B 输入和接触状态专项测试。
  • 运行 git diff --check。
  • 准备阶段 B 本地提交说明。

阶段 C:Facet Pressure、Traction、Resultant 和分配策略

  • 设计 facet pressure 导入缓存。
  • 设计 facet traction 导入缓存。
  • 设计 facet resultant 导入缓存。
  • 设计 facet 分配后粒子力缓存复用路径。
  • 定义 pressure 正负号约定。
  • 实现 pressure 到 facet 合力的转换。
  • 实现 traction 到 facet 合力的转换。
  • 实现 resultant force 的直接接收路径。
  • 实现 UNIFORM 分配策略。
  • 实现 AREA 或受控 facet 权重分配策略。
  • 实现 MASS 分配策略。
  • 对权重和非正时报 error。
  • 对 facet 面积非正时报 error。
  • 对 facet 法向非有限时报 error。
  • 对 facet 法向长度过小时报 error。
  • 对 pressure 非有限时报 error。
  • 对 traction 非有限时报 error。
  • 对 resultant 非有限时报 error。
  • 对非法 facet id 报 error。
  • 对重复 facet id 记录诊断或报 error。
  • 对同一 epoch 重复导入按固定策略处理。
  • 对新 epoch 导入清理上一 epoch 临时载荷。
  • 计算 facet 输入总力。
  • 计算 facet 分配后总力。
  • 计算 facet 总力误差。
  • 计算 facet 输入参考力矩。
  • 计算 facet 分配后参考力矩。
  • 计算 facet 力矩误差。
  • 记录最大 pressure。
  • 记录最大 traction。
  • 新增 coupling_facet_pressure_081 测试。
  • 新增 coupling_facet_traction_081 测试。
  • 新增 coupling_facet_resultant_081 测试。
  • 新增 coupling_distribution_uniform_081 测试。
  • 新增 coupling_distribution_area_081 测试。
  • 新增 coupling_distribution_mass_081 测试。
  • 新增 coupling_load_balance_081 测试。
  • 将阶段 C 新测试接入 CTest。
  • 运行阶段 C facet 载荷分配专项测试。
  • 运行 git diff --check。
  • 准备阶段 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 本地提交说明。