258 lines
14 KiB
Markdown
258 lines
14 KiB
Markdown
# 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:显式步接入、接触诊断和回归隔离
|
||
|
||
- [x] 将 pressure 分配后的粒子力接入 coupling 外力缓存。
|
||
- [x] 将 traction 分配后的粒子力接入 coupling 外力缓存。
|
||
- [x] 将 resultant 分配后的粒子力接入 coupling 外力缓存。
|
||
- [x] 固定 particle force、facet force、pressure、traction 和 motion boundary 的施加顺序。
|
||
- [x] 固定 coupling 外载荷与 blast 外载荷的叠加顺序。
|
||
- [x] 确认 coupling 外载荷缓存独立于 blast 外载荷缓存。
|
||
- [x] 记录 active contact 数量。
|
||
- [x] 记录 skipped contact 数量。
|
||
- [x] 记录最大 penetration。
|
||
- [x] 记录 stale epoch 计数。
|
||
- [x] 记录重复导入计数。
|
||
- [x] 记录 nonfinite contact import 计数。
|
||
- [x] 记录负面积或零面积 facet 计数。
|
||
- [x] 记录非法权重计数。
|
||
- [x] 将 contact diagnostics 合入 coupling diagnostics 查询。
|
||
- [x] 确认无 active contact 时安全跳过。
|
||
- [x] 确认 disabled coupling region 不影响显式步。
|
||
- [x] 确认空 pressure/traction 导入不产生虚假加速度。
|
||
- [x] 确认 Water-only 回归不被 0.8.1 coupling 路径污染。
|
||
- [x] 确认 Gas-only 回归不被 0.8.1 coupling 路径污染。
|
||
- [x] 确认 Explosive 回归不被 0.8.1 coupling 路径污染。
|
||
- [x] 确认 Solid-only 回归不被 0.8.1 coupling 路径污染。
|
||
- [x] 确认 Shell-only 回归不被 0.8.1 coupling 路径污染。
|
||
- [x] 新增 `coupling_contact_diagnostics_081` 测试。
|
||
- [x] 新增 `coupling_solver_order_081` 测试。
|
||
- [x] 新增 `coupling_stale_epoch_081` 测试。
|
||
- [x] 新增 `coupling_solid_surface_pressure_081` 测试。
|
||
- [x] 新增 `coupling_shell_pressure_081` 测试。
|
||
- [x] 新增 `coupling_mixed_pressure_motion_081` 测试。
|
||
- [x] 将阶段 D 新测试接入 CTest。
|
||
- [x] 运行阶段 D 显式步和诊断专项测试。
|
||
- [x] 运行 `git diff --check`。
|
||
- [x] 准备阶段 D 本地提交说明。
|
||
|
||
## 阶段 E:Output、Restart、Fortran API 和外部接口层
|
||
|
||
- [x] 定义 summary CSV 的 0.8.1 contact 字段清单。
|
||
- [x] 追加 `coupling_active_contacts` summary CSV 字段。
|
||
- [x] 追加 `coupling_skipped_contacts` summary CSV 字段。
|
||
- [x] 追加 `coupling_max_pressure` summary CSV 字段。
|
||
- [x] 追加 `coupling_max_traction` summary CSV 字段。
|
||
- [x] 追加 `coupling_max_penetration` summary CSV 字段。
|
||
- [x] 追加 `coupling_force_balance_error` summary CSV 字段。
|
||
- [x] 追加 `coupling_moment_balance_error` summary CSV 字段。
|
||
- [x] 定义粒子 CSV 的 0.8.1 contact 调试字段清单。
|
||
- [x] 追加粒子 CSV 的 `coupling_contact_flag` 字段。
|
||
- [x] 追加粒子 CSV 的 `coupling_gap` 字段。
|
||
- [x] 追加粒子 CSV 的 `coupling_penetration` 字段。
|
||
- [x] 明确 0.8.1 restart 状态版本名称。
|
||
- [x] 实现 `STATE_0_8_1` 或等价 0.8.1 restart 写入。
|
||
- [x] 在 restart 中保存 load mode 和 distribution mode。
|
||
- [x] 在 restart 中保存 contact state 缓存。
|
||
- [x] 在 restart 中保存 facet 分配诊断。
|
||
- [x] 在 restart 中保存新增 contact diagnostics。
|
||
- [x] 实现 `STATE_0_8_1` 或等价 0.8.1 restart 读回。
|
||
- [x] 实现 0.8.0 restart 兼容读入后的空 0.8.1 状态初始化。
|
||
- [x] 实现 restart 读回后继续显式步的 0.8.1 coupling 状态恢复。
|
||
- [x] 新增 `sph_coupling_apply_facet_pressures` Fortran API。
|
||
- [x] 新增 `sph_coupling_apply_facet_tractions` Fortran API。
|
||
- [x] 新增 `sph_coupling_apply_facet_resultants` Fortran API。
|
||
- [x] 新增 `sph_coupling_apply_contact_state` Fortran API。
|
||
- [x] 新增 `sph_coupling_get_load_balance` Fortran API。
|
||
- [x] 新增 `sph_coupling_get_contact_diagnostics` Fortran API。
|
||
- [x] 在 C 头文件中声明 facet pressure 导入接口。
|
||
- [x] 在 C 头文件中声明 facet traction 导入接口。
|
||
- [x] 在 C 头文件中声明 contact state 导入接口。
|
||
- [x] 在 C 头文件中声明 contact diagnostics 查询接口。
|
||
- [x] 实现 C ABI 新接口的空指针错误路径。
|
||
- [x] 实现 C ABI 新接口的小容量错误路径。
|
||
- [x] 实现 C ABI 新接口的非法 region 错误路径。
|
||
- [x] 实现 C ABI 新接口的非有限输入错误路径。
|
||
- [x] 在 C++ wrapper 中追加 pressure、traction 和 diagnostics 薄包装。
|
||
- [x] 在 Python ctypes 中追加 pressure、traction 和 diagnostics 调试入口。
|
||
- [x] 在 CLI inspect 中追加 load mode、distribution 和 contact diagnostics 字段。
|
||
- [x] 新增 `coupling_output_081` 测试。
|
||
- [x] 新增 `coupling_restart_081` 测试。
|
||
- [x] 新增 `coupling_restart_080_compat` 测试。
|
||
- [x] 新增 `coupling_fortran_api_081` 测试。
|
||
- [x] 新增 `coupling_c_api_081` 测试。
|
||
- [x] 新增 `coupling_cpp_api_081` 测试。
|
||
- [x] 新增 `coupling_python_081` 测试。
|
||
- [x] 新增 `coupling_cli_081` 测试。
|
||
- [x] 将阶段 E 新测试接入 CTest。
|
||
- [x] 运行阶段 E output、restart 和接口专项测试。
|
||
- [x] 运行 `git diff --check`。
|
||
- [x] 准备阶段 E 本地提交说明。
|
||
|
||
## 阶段 F:Mock Coupling Smoke、门禁、文档和发布准备
|
||
|
||
- [x] 设计 Solid surface pressure mock coupling smoke 样例。
|
||
- [x] 设计 Shell pressure mock coupling smoke 样例。
|
||
- [x] 设计 traction mock coupling smoke 样例。
|
||
- [x] 设计 pressure-motion 混合 mock coupling smoke 样例。
|
||
- [x] 设计 stale epoch mock coupling smoke 样例。
|
||
- [x] 新增 Solid surface pressure 输入文件。
|
||
- [x] 新增 Shell pressure 输入文件。
|
||
- [x] 新增 traction 输入文件。
|
||
- [x] 新增 pressure-motion 混合输入文件。
|
||
- [x] 新增 stale epoch 输入文件。
|
||
- [x] 验证 smoke 中所有粒子状态保持有限。
|
||
- [x] 验证 smoke 中 pressure 方向受控。
|
||
- [x] 验证 smoke 中 traction 方向受控。
|
||
- [x] 验证 smoke 中 motion boundary 方向受控。
|
||
- [x] 验证 smoke 中 Solid 响应方向受控。
|
||
- [x] 验证 smoke 中 Shell 平动响应方向受控。
|
||
- [x] 验证 smoke 中总力误差和力矩误差有限。
|
||
- [x] 验证 smoke 中 contact diagnostics 有限。
|
||
- [x] 验证 stale epoch 诊断按预期变化。
|
||
- [x] 新增 `coupling_smoke_081` 测试。
|
||
- [x] 新增 `coupling_source_size_081` 测试。
|
||
- [x] 将阶段 F 新测试接入 CTest。
|
||
- [x] 运行 0.8.1 coupling 专项 gate。
|
||
- [x] 运行 0.8.0 coupling 回归 gate。
|
||
- [x] 运行 Water 回归 gate。
|
||
- [x] 运行 Gas 回归 gate。
|
||
- [x] 运行 Explosive 回归 gate。
|
||
- [x] 运行 Solid 回归 gate。
|
||
- [x] 运行 Shell 回归 gate。
|
||
- [x] 运行 0.7.0 blast 回归 gate。
|
||
- [x] 运行 0.7.1 blast 专项 gate。
|
||
- [x] 运行完整 CTest。
|
||
- [x] 运行 source size 相关 gate。
|
||
- [x] 运行 `git diff --check`。
|
||
- [x] 检查代码、构建脚本、测试和工具目录未新增 FEMLite 直接依赖。
|
||
- [x] 检查输出目录、CSV、VTK、restart 和临时结果未被提交。
|
||
- [x] 更新 README 的 0.8.1 当前状态和不交付范围。
|
||
- [x] 更新 `docs/06_test_and_verification_plan.md` 的 0.8.1 release gate。
|
||
- [x] 更新 `docs/09_release_history.md` 的 0.8.1 本地验收记录。
|
||
- [x] 更新 `docs/11_benchmark_matrix.md` 的 0.8.1 gate 矩阵。
|
||
- [x] 确认文档不宣称真实 FEMLite 联合运行。
|
||
- [x] 确认文档不宣称连续体耦合。
|
||
- [x] 确认文档不宣称工程级船舶水下接触爆炸破坏 benchmark。
|
||
- [x] 准备 0.8.1 发布提交说明。
|
||
- [x] 准备阶段 F 本地提交说明。
|