14 KiB
14 KiB
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_contactssummary CSV 字段。 - 追加
coupling_skipped_contactssummary CSV 字段。 - 追加
coupling_max_pressuresummary CSV 字段。 - 追加
coupling_max_tractionsummary CSV 字段。 - 追加
coupling_max_penetrationsummary CSV 字段。 - 追加
coupling_force_balance_errorsummary CSV 字段。 - 追加
coupling_moment_balance_errorsummary 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_pressuresFortran API。 - 新增
sph_coupling_apply_facet_tractionsFortran API。 - 新增
sph_coupling_apply_facet_resultantsFortran API。 - 新增
sph_coupling_apply_contact_stateFortran API。 - 新增
sph_coupling_get_load_balanceFortran API。 - 新增
sph_coupling_get_contact_diagnosticsFortran 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 本地提交说明。