Add coupling output restart and APIs

This commit is contained in:
Codex
2026-07-04 09:59:52 +08:00
parent 5be6b178bc
commit 5d9933d014
22 changed files with 2636 additions and 89 deletions
+69 -69
View File
@@ -229,75 +229,75 @@
## 阶段 F:Output、Restart、Fortran API 和外部接口层
- [ ] 定义 summary CSV 的 coupling 字段清单。
- [ ] 追加 `coupling_regions` summary CSV 字段。
- [ ] 追加 `coupling_particles` summary CSV 字段。
- [ ] 追加 `coupling_facets` summary CSV 字段。
- [ ] 追加 `coupling_force_x/y/z` summary CSV 字段。
- [ ] 追加 `coupling_impulse_x/y/z` summary CSV 字段。
- [ ] 追加 `coupling_work` summary CSV 字段。
- [ ] 追加 `coupling_energy_exchange` summary CSV 字段。
- [ ] 追加 `coupling_nonfinite_imports` summary CSV 字段。
- [ ] 追加 `coupling_stale_loads` summary CSV 字段。
- [ ] 定义粒子 CSV 的 coupling 字段清单。
- [ ] 追加粒子 CSV 的 `coupling_force_x/y/z` 字段。
- [ ] 追加粒子 CSV 的 `coupling_motion_flag` 字段。
- [ ] 追加粒子 CSV 的 `coupling_region_id` 字段。
- [ ] 明确 0.8.0 restart 状态版本名称。
- [ ] 实现 `STATE_0_8` 或等价 0.8 restart 写入。
- [ ] 在 restart 中保存 coupling region 定义和映射。
- [ ] 在 restart 中保存 coupling export/import mode。
- [ ] 在 restart 中保存未消费外部力缓存。
- [ ] 在 restart 中保存未消费 facet load 缓存。
- [ ] 在 restart 中保存未消费运动边界缓存。
- [ ] 在 restart 中保存累计冲量和做功。
- [ ] 在 restart 中保存动量和能量交换诊断。
- [ ] 在 restart 中保存 stale、skipped 和 nonfinite 计数。
- [ ] 实现 `STATE_0_8` 或等价 0.8 restart 读回。
- [ ] 实现 0.7.1 或既有 restart 兼容读入后的空 coupling 状态。
- [ ] 实现 restart 读回后继续显式步的 coupling 状态恢复。
- [ ] 新增 `sph_coupling_get_region_count` Fortran API。
- [ ] 新增 `sph_coupling_get_region_info` Fortran API。
- [ ] 新增 `sph_coupling_export_particles` Fortran API。
- [ ] 新增 `sph_coupling_export_facets` Fortran API。
- [ ] 新增 `sph_coupling_apply_particle_forces` Fortran API。
- [ ] 新增 `sph_coupling_apply_facet_loads` Fortran API。
- [ ] 新增 `sph_coupling_apply_motion_boundary` Fortran API。
- [ ] 新增 `sph_coupling_clear_imports` Fortran API。
- [ ] 新增 `sph_coupling_get_diagnostics` Fortran API。
- [ ] 在 C 头文件中声明 coupling region 查询接口。
- [ ] 在 C 头文件中声明 coupling particle export 接口。
- [ ] 在 C 头文件中声明 coupling facet export 接口。
- [ ] 在 C 头文件中声明 coupling force import 接口。
- [ ] 在 C 头文件中声明 coupling facet load import 接口。
- [ ] 在 C 头文件中声明 coupling motion import 接口。
- [ ] 在 C 头文件中声明 coupling diagnostics 接口。
- [ ] 实现 C ABI 的空指针错误路径。
- [ ] 实现 C ABI 的小容量错误路径。
- [ ] 实现 C ABI 的非法 region 错误路径。
- [ ] 实现 C ABI 的非有限输入错误路径。
- [ ] 在 C++ wrapper 中追加 coupling region 查询薄包装。
- [ ] 在 C++ wrapper 中追加 coupling export 薄包装。
- [ ] 在 C++ wrapper 中追加 coupling import 薄包装。
- [ ] 在 Python ctypes 中追加 coupling region 查询。
- [ ] 在 Python ctypes 中追加 coupling particle export。
- [ ] 在 Python ctypes 中追加 coupling force import。
- [ ] 在 Python ctypes 中追加 coupling diagnostics 查询。
- [ ] 在 CLI inspect 中追加 coupling region 列表字段。
- [ ] 在 CLI inspect 中追加 coupling export/import mode 字段。
- [ ] 在 CLI inspect 中追加 coupling diagnostics 字段。
- [ ] 新增 `coupling_output_080` 测试。
- [ ] 新增 `coupling_restart_080` 测试。
- [ ] 新增 `coupling_restart_071_compat` 测试。
- [ ] 新增 `coupling_fortran_api_080` 测试。
- [ ] 新增 `coupling_c_api_080` 测试。
- [ ] 新增 `coupling_cpp_api_080` 测试。
- [ ] 新增 `coupling_python_080` 测试。
- [ ] 新增 `coupling_cli_080` 测试。
- [ ] 将阶段 F 新测试接入 CTest。
- [ ] 运行阶段 F output、restart 和接口专项测试。
- [ ] 运行 `git diff --check`。
- [ ] 准备阶段 F 本地提交说明。
- [x] 定义 summary CSV 的 coupling 字段清单。
- [x] 追加 `coupling_regions` summary CSV 字段。
- [x] 追加 `coupling_particles` summary CSV 字段。
- [x] 追加 `coupling_facets` summary CSV 字段。
- [x] 追加 `coupling_force_x/y/z` summary CSV 字段。
- [x] 追加 `coupling_impulse_x/y/z` summary CSV 字段。
- [x] 追加 `coupling_work` summary CSV 字段。
- [x] 追加 `coupling_energy_exchange` summary CSV 字段。
- [x] 追加 `coupling_nonfinite_imports` summary CSV 字段。
- [x] 追加 `coupling_stale_loads` summary CSV 字段。
- [x] 定义粒子 CSV 的 coupling 字段清单。
- [x] 追加粒子 CSV 的 `coupling_force_x/y/z` 字段。
- [x] 追加粒子 CSV 的 `coupling_motion_flag` 字段。
- [x] 追加粒子 CSV 的 `coupling_region_id` 字段。
- [x] 明确 0.8.0 restart 状态版本名称。
- [x] 实现 `STATE_0_8` 或等价 0.8 restart 写入。
- [x] 在 restart 中保存 coupling region 定义和映射。
- [x] 在 restart 中保存 coupling export/import mode。
- [x] 在 restart 中保存未消费外部力缓存。
- [x] 在 restart 中保存未消费 facet load 缓存。
- [x] 在 restart 中保存未消费运动边界缓存。
- [x] 在 restart 中保存累计冲量和做功。
- [x] 在 restart 中保存动量和能量交换诊断。
- [x] 在 restart 中保存 stale、skipped 和 nonfinite 计数。
- [x] 实现 `STATE_0_8` 或等价 0.8 restart 读回。
- [x] 实现 0.7.1 或既有 restart 兼容读入后的空 coupling 状态。
- [x] 实现 restart 读回后继续显式步的 coupling 状态恢复。
- [x] 新增 `sph_coupling_get_region_count` Fortran API。
- [x] 新增 `sph_coupling_get_region_info` Fortran API。
- [x] 新增 `sph_coupling_export_particles` Fortran API。
- [x] 新增 `sph_coupling_export_facets` Fortran API。
- [x] 新增 `sph_coupling_apply_particle_forces` Fortran API。
- [x] 新增 `sph_coupling_apply_facet_loads` Fortran API。
- [x] 新增 `sph_coupling_apply_motion_boundary` Fortran API。
- [x] 新增 `sph_coupling_clear_imports` Fortran API。
- [x] 新增 `sph_coupling_get_diagnostics` Fortran API。
- [x] 在 C 头文件中声明 coupling region 查询接口。
- [x] 在 C 头文件中声明 coupling particle export 接口。
- [x] 在 C 头文件中声明 coupling facet export 接口。
- [x] 在 C 头文件中声明 coupling force import 接口。
- [x] 在 C 头文件中声明 coupling facet load import 接口。
- [x] 在 C 头文件中声明 coupling motion import 接口。
- [x] 在 C 头文件中声明 coupling diagnostics 接口。
- [x] 实现 C ABI 的空指针错误路径。
- [x] 实现 C ABI 的小容量错误路径。
- [x] 实现 C ABI 的非法 region 错误路径。
- [x] 实现 C ABI 的非有限输入错误路径。
- [x] 在 C++ wrapper 中追加 coupling region 查询薄包装。
- [x] 在 C++ wrapper 中追加 coupling export 薄包装。
- [x] 在 C++ wrapper 中追加 coupling import 薄包装。
- [x] 在 Python ctypes 中追加 coupling region 查询。
- [x] 在 Python ctypes 中追加 coupling particle export。
- [x] 在 Python ctypes 中追加 coupling force import。
- [x] 在 Python ctypes 中追加 coupling diagnostics 查询。
- [x] 在 CLI inspect 中追加 coupling region 列表字段。
- [x] 在 CLI inspect 中追加 coupling export/import mode 字段。
- [x] 在 CLI inspect 中追加 coupling diagnostics 字段。
- [x] 新增 `coupling_output_080` 测试。
- [x] 新增 `coupling_restart_080` 测试。
- [x] 新增 `coupling_restart_071_compat` 测试。
- [x] 新增 `coupling_fortran_api_080` 测试。
- [x] 新增 `coupling_c_api_080` 测试。
- [x] 新增 `coupling_cpp_api_080` 测试。
- [x] 新增 `coupling_python_080` 测试。
- [x] 新增 `coupling_cli_080` 测试。
- [x] 将阶段 F 新测试接入 CTest。
- [x] 运行阶段 F output、restart 和接口专项测试。
- [x] 运行 `git diff --check`。
- [x] 准备阶段 F 本地提交说明。
## 阶段 G:Mock Coupling Smoke、门禁、文档和发布准备