diff --git a/CMakeLists.txt b/CMakeLists.txt index fdd25cc..e274ebb 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,6 +1,6 @@ cmake_minimum_required(VERSION 3.20) -project(SPHLite VERSION 0.8.0 LANGUAGES C CXX Fortran) +project(SPHLite VERSION 0.8.1 LANGUAGES C CXX Fortran) set(CMAKE_C_STANDARD 99) set(CMAKE_C_STANDARD_REQUIRED ON) diff --git a/README.md b/README.md index 708ad0d..a38b9a9 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。 -当前开发版本:0.8.0。该版本定位为 SPHLite 侧中立接触耦合接口起步版,在 0.7.1 局部爆炸稳定化版本之上推进 coupling region、粒子/Facet Proxy 导出、外部载荷/运动边界导入、显式步施加路径、诊断、接口和 mock coupling gate。不交付真实 FEMLite 联合运行、外部 CouplingModule、连续体耦合、生产级接触算法或工程级水下接触爆炸破坏 benchmark。 +当前开发版本:0.8.1。该版本定位为 SPHLite 侧中立接触耦合接口稳定化版,在 0.8.0 已发布接口基础上推进 facet pressure/traction/resultant 导入、受控载荷分配、接触状态诊断、输出、restart、接口和 mock coupling gate。不交付真实 FEMLite 联合运行、外部 CouplingModule、连续体耦合、生产级接触算法或工程级水下接触爆炸破坏 benchmark。 代码仓库地址: @@ -63,7 +63,7 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: ## 当前状态 -0.8.0 当前以 0.7.1 局部爆炸稳定化发布版本为起点,进入 SPHLite 侧中立接触耦合接口开发。0.5.0 以来已完成内容主要包括: +0.8.1 当前以 0.8.0 中立接触耦合接口发布版本为起点,进入 SPHLite 侧接触载荷分配和接触诊断加固开发。0.5.0 以来已完成内容主要包括: - CMake/CTest 工程骨架和 Fortran 95 核心库。 - C ABI、C++ 头文件薄包装和 Python `ctypes` 调试入口。 @@ -104,3 +104,5 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: - 0.8.0 仍不直接依赖 FEMLite,不实现外部 CouplingModule,不交付连续体耦合,不宣称工程级船舶水下接触爆炸破坏 benchmark。 - 0.8.0 本地发布 gate 已通过:完整 CTest 163/163,0.8.0 coupling 专项 gate 24/24,Water/Gas/Explosive/Solid/Shell 分类 gate 6/6、19/19、28/28、33/33、14/14,0.7.0 blast 回归 gate 19/19,0.7.1 blast 专项 gate 7/7,source size 相关 gate 8/8,`git diff --check` 通过。 - 0.8.0 交付的是 SPHLite 侧中立接触耦合接口和 mock coupling smoke;不宣称真实 FEMLite 联合运行、外部 CouplingModule、连续体一体化耦合、生产级接触算法或工程级船舶水下接触爆炸破坏 benchmark。 +- 0.8.1 将在 0.8.0 数据契约上追加 pressure、traction、facet resultant、载荷分配、接触状态、载荷守恒诊断和 0.8.1 mock coupling gate。 +- 0.8.1 仍不直接依赖 FEMLite,不实现外部 CouplingModule,不交付连续体耦合,不宣称工程级船舶水下接触爆炸破坏 benchmark。 diff --git a/docs/v8.1_development_plan.md b/docs/v8.1_development_plan.md new file mode 100644 index 0000000..963d5dc --- /dev/null +++ b/docs/v8.1_development_plan.md @@ -0,0 +1,584 @@ +# SPHLite v8.1 开发计划 + +文档状态:0.8.1 开发计划草案 +目标软件版本:SPHLite 0.8.1 + +## 1. 文档定位 + +本文档用于规划 SPHLite 0.8.1 版本的开发范围。0.8.1 延续 0.8.0 已发布的 SPHLite 侧中立接触耦合接口,重点从“接口可交换”推进到“接触载荷可控施加、可诊断、可恢复、可验收”。 + +0.8.1 仍不直接与 FEMLite 联合运行,不引用 FEMLite 模块,不修改 FEMLite,也不把外部 CouplingModule、CoupleLite、CoupledLite 或 CouplingLite 作为 SPHLite 内部依赖。0.8.1 只在 SPHLite 仓库内加固中立接触耦合接口和 mock coupling gate。 + +0.8.1 不启动连续体耦合版本线。连续体中一部分 FEM、一部分 SPH 的界面约束、重叠区耦合或投影算法仍建议保留到 0.9.0 之后规划。 + +## 2. 依据文件 + +本计划依据以下 01-06 号文档制定: + +- `docs/01_requirements_specification.md` +- `docs/02_software_architecture_design.md` +- `docs/03_detailed_design.md` +- `docs/04_mathematical_model_and_algorithms.md` +- `docs/05_interface_control_document.md` +- `docs/06_test_and_verification_plan.md` + +同时,0.8.1 以已经发布的 0.8.0 中立接触耦合接口版本为开发基线。 + +## 3. 版本定位 + +### 3.1 与 0.8.0 的关系 + +0.8.0 已完成以下基础能力: + +- `*SPHLITE COUPLING REGION` 的接触耦合输入子集。 +- coupling region 运行时表、粒子导出和 Shell/受控 surface facet proxy 导出。 +- 外部粒子力、facet load 和 motion boundary 的导入路径。 +- coupling 外部载荷进入 Velocity-Verlet 显式步。 +- coupling 力、冲量、做功、动量和能量交换诊断。 +- `STATE_0_8` restart 和既有 restart 兼容读入。 +- Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI inspect 的 coupling 起步接口。 +- mock coupling smoke 和 0.8.0 release gate。 + +0.8.1 不推翻 0.8.0 的数据契约,而是在其上补强: + +- facet 压力、牵引力和合力输入语义。 +- facet 载荷到粒子力的受控分配策略。 +- 接触状态诊断的导入、保存和输出。 +- 载荷守恒、力矩一致性、非有限值和 stale epoch 检查。 +- 更多 Solid/Shell mock 接触小模型。 +- 0.8.0 restart 和接口兼容性。 + +### 3.2 与 0.9.0 的关系 + +0.9.0 仍建议作为连续体耦合版本线起点。0.8.1 可以继续在输入、状态、诊断和错误路径中保留 `CONTACT` 与 `CONTINUUM` 的区分,但 0.8.1 默认 gate 不验收连续体耦合。 + +0.8.1 的交付重点是接触载荷交换边界,而不是 FEM-SPH 连续体同域计算。 + +### 3.3 与外部耦合模块的关系 + +外部耦合模块负责: + +- 外部求解器侧模型读取和区域识别。 +- SPH-FEM 或 SPH-其他求解器的匹配、搜索和投影。 +- 接触状态判定、穿透量计算、摩擦或约束策略。 +- 强耦合、弱耦合、子循环或松弛控制。 + +SPHLite 0.8.1 负责: + +- 接收外部模块给出的中立 facet 压力、牵引力、合力或粒子力。 +- 将受控 facet 载荷分配到 SPHLite 侧已有 coupling 粒子。 +- 在显式步中施加这些外部交换量。 +- 记录接触状态、载荷守恒、做功、动量交换、能量交换和错误诊断。 + +SPHLite 不在 0.8.1 内部实现真实接触搜索、FEM 侧映射、摩擦模型或约束求解器。 + +## 4. 开发原则 + +### 4.1 中立数据契约不破坏 + +0.8.1 必须追加式扩展 0.8.0 coupling 接口,不修改 0.8.0 已公开函数的参数顺序、数组展开顺序、错误码语义或字段含义。 + +新增命名应使用 `coupling`、`contact`、`facet`、`traction`、`pressure`、`region` 等中立术语,不暴露 FEMLite 内部类型或外部 CouplingModule 私有结构。 + +### 4.2 SPHLite 仍是求解器 + +0.8.1 不新增几何、网格或粒子生成能力。测试和示例可以继续使用 Python 生成 Abaqus 风格 `.inp` 文件,但这些脚本只作为测试辅助工具,不作为求解器功能。 + +### 4.3 显式动力学唯一时间推进 + +0.8.1 继续只支持 Velocity-Verlet 显式动力学。外部耦合载荷、接触状态和运动边界都必须在显式步中以受控顺序施加,不引入隐式耦合求解器。 + +### 4.4 小型可测优先 + +0.8.1 默认 gate 只覆盖小型、可重复 mock coupling 算例。真实 FEMLite 联合运行、外部 CouplingModule 集成、复杂摩擦、长时间滑移、大规模并行和工程级舱段破坏不进入默认 gate。 + +### 4.5 守恒和诊断先于复杂物理 + +0.8.1 的 facet 载荷分配策略应优先保证: + +- 输入和分配后的总力可比较。 +- 输入和分配后的参考力矩可比较。 +- 非有限值、负面积、空 facet、重复粒子和 stale epoch 可诊断。 +- 做功、动量交换和能量交换可追踪。 + +复杂接触压力积分、摩擦切向力、接触稳定化和罚函数参数库不进入 0.8.1 默认交付。 + +## 5. 0.8.1 交付目标 + +0.8.1 建议交付以下内容: + +1. 将软件版本更新为 `0.8.1`。 +2. 保持 0.8.0 完整 gate 全部通过。 +3. 明确 0.8.1 是接触耦合接口稳定化版本,不是真实 FEMLite 联合运行版本。 +4. 加固 `*SPHLITE COUPLING REGION` 对 facet 载荷输入模式的表达。 +5. 支持外部 facet pressure 导入,并转换为 SPHLite 侧粒子力。 +6. 支持外部 facet traction 导入,并转换为 SPHLite 侧粒子力。 +7. 支持外部 facet resultant force 导入,并转换为 SPHLite 侧粒子力。 +8. 支持至少两种受控分配策略:均匀分配和面积/质量权重分配。 +9. 对 Shell facet proxy 提供稳定的压力和牵引力施加路径。 +10. 对显式 surface/facet 提供 Solid facet 载荷施加路径。 +11. 对没有 facet proxy 的 Solid 体粒子接触 region 给出明确 error,不自动重构复杂外表面。 +12. 支持外部接触状态导入,包括 contact flag、normal、gap 或 penetration 的中立调试字段。 +13. 将接触状态纳入 diagnostics、输出和 restart 可恢复边界。 +14. 记录 facet 输入总力、分配后总力和总力误差。 +15. 记录 facet 输入参考力矩、分配后参考力矩和力矩误差。 +16. 记录最大压力、最大牵引力、最大接触穿透量、active contact 数量和 skipped contact 数量。 +17. 对负面积、零面积、非有限压力、非有限牵引力、非法法向、重复 facet id 和非法 epoch 给出明确错误或诊断。 +18. 加固 stale load 和重复导入策略,避免同一载荷在多个显式步中无意重复施加。 +19. 加固 coupling 外载荷与 blast 外载荷的叠加顺序,确认二者使用独立缓存并在总加速度阶段受控叠加。 +20. 扩展 summary CSV 和粒子 CSV 中的 0.8.1 coupling/contact 调试字段。 +21. 新增 `STATE_0_8_1` 或等价 0.8.1 restart 边界,保存新增接触状态、facet 载荷分配诊断和累计交换量。 +22. 保持 0.8.0 restart 兼容读入,新增字段初始化为空状态。 +23. 追加 Fortran API,用于 facet pressure/traction/resultant 导入、contact state 导入和载荷守恒诊断查询。 +24. 追加 C ABI 函数,不修改 0.8.0 已有 C ABI。 +25. 追加 C++ wrapper 的薄包装。 +26. 追加 Python `ctypes` 调试入口和 checker。 +27. CLI inspect 增加 0.8.1 contact/facet 诊断字段。 +28. 新增 0.8.1 coupling 专项 CTest gate。 +29. 更新 README、06、09 和 11 号文档中的 0.8.1 测试、验收和不交付范围。 +30. 不新增 FEMLite 直接依赖,不修改 SPHLite 文件夹之外的内容。 + +## 6. 非交付范围 + +0.8.1 不交付以下内容: + +1. 不交付真实 FEMLite 联合运行。 +2. 不交付外部 CouplingModule、CoupleLite、CoupledLite 或 CouplingLite 的实现。 +3. 不交付 FEM-SPH 连续体耦合、重叠区耦合或界面约束。 +4. 不交付生产级接触搜索、接触约束、摩擦、粘结或冲击稳定化算法。 +5. 不交付从 Solid 体粒子云自动重构复杂外表面的算法。 +6. 不交付工程级船舶水下接触爆炸舱段破坏 benchmark。 +7. 不交付复杂撕裂、穿孔、碎片云、焊缝失效库或碎片-流体接触。 +8. 不交付大规模并行、GPU 后端或性能优化版本。 +9. 不新增几何、网格或粒子生成能力。 + +## 7. 输入和控制参数建议 + +### 7.1 Coupling Region 扩展 + +0.8.1 建议在既有 `*SPHLITE COUPLING REGION` 基础上追加受控参数,不破坏 0.8.0 输入: + +```text +*SPHLITE COUPLING REGION, NAME=HULL_CONTACT, TYPE=CONTACT, + SET=SHELL_TARGET, EXPORT=BOTH, IMPORT=FACET_LOAD, + SURFACE=SHELL_SURFACE, LOAD_MODE=PRESSURE, DISTRIBUTION=AREA +``` + +建议参数: + +- `LOAD_MODE=PARTICLE_FORCE`:沿用 0.8.0 外部粒子力路径。 +- `LOAD_MODE=FACET_FORCE`:外部给出 facet 合力或分配后的 facet 粒子力。 +- `LOAD_MODE=PRESSURE`:外部给出 facet 压力标量,SPHLite 结合 facet 法向和面积生成合力。 +- `LOAD_MODE=TRACTION`:外部给出 facet 牵引力向量,SPHLite 结合面积生成合力。 +- `DISTRIBUTION=UNIFORM`:facet 合力在关联粒子间均匀分配。 +- `DISTRIBUTION=AREA`:按粒子关联面积或 facet 权重分配。 +- `DISTRIBUTION=MASS`:按粒子质量权重分配,可作为备选路径。 +- `CONTACT_STATE=IMPORT`:允许外部导入接触状态诊断。 + +0.8.1 不追求 Abaqus 接触关键字完整兼容。能够复用 set、surface 和 section 的位置继续复用;SPHLite 专有交换控制仍保留在 `*SPHLITE COUPLING REGION`。 + +### 7.2 输入校验 + +0.8.1 输入和导入校验应覆盖: + +- `LOAD_MODE` 非法时报 error。 +- `DISTRIBUTION` 非法时报 error。 +- 请求 pressure/traction 但 region 无 facet proxy 时报 error。 +- facet 面积非正时报 error 或拒绝导入并记录诊断。 +- 法向非有限或长度过小时拒绝 pressure 转换。 +- pressure、traction、resultant 非有限时拒绝导入。 +- 同一 epoch 重复导入时按固定策略处理并记录。 +- 不同 epoch 导入时清理上一 epoch 的未持久临时载荷。 + +## 8. 载荷分配算法 + +### 8.1 Pressure 到粒子力 + +外部导入 pressure 时,SPHLite 可按以下第一版公式生成 facet 合力: + +```text +F_facet = pressure * area * normal +``` + +压力正负号约定必须在接口文档和测试中固定。建议第一版采用“正 pressure 沿 facet normal 方向施加”的中立约定,实际物理方向由外部耦合模块在输入前决定。 + +### 8.2 Traction 到粒子力 + +外部导入 traction 时,SPHLite 可按以下公式生成 facet 合力: + +```text +F_facet = traction * area +``` + +traction 是中立向量,不在 SPHLite 内部分解为法向和切向摩擦分量。摩擦模型和接触稳定化由外部模块负责。 + +### 8.3 Resultant 到粒子力 + +外部导入 facet resultant force 时,SPHLite 只负责按指定 `DISTRIBUTION` 将合力分配到 facet 关联粒子。若外部已经给出粒子级 facet force,则 SPHLite 不再次分配,只进行有限性和映射检查。 + +### 8.4 分配策略 + +0.8.1 建议至少支持: + +- `UNIFORM`:所有关联粒子权重相同。 +- `AREA`:使用 facet 内部已有权重或受控面积权重。 +- `MASS`:使用粒子质量作为权重。 + +所有策略必须检查权重和为正。若权重非法,导入失败并保留上一稳定状态不被污染。 + +### 8.5 守恒检查 + +每次 facet 载荷导入和分配后应记录: + +- 输入总力。 +- 分配后总粒子力。 +- 总力误差。 +- 输入参考力矩。 +- 分配后参考力矩。 +- 力矩误差。 + +第一版不要求严格力矩守恒,但必须可诊断。若某分配策略无法保持力矩,应在测试和文档中明确。 + +## 9. 接触状态诊断 + +0.8.1 建议支持外部导入以下中立接触状态字段: + +- contact flag。 +- facet 或粒子级 normal。 +- gap。 +- penetration。 +- contact pressure。 +- active contact count。 +- skipped contact count。 + +这些字段用于诊断、输出和 restart 恢复,不代表 SPHLite 内部已经实现真实接触判定。 + +诊断字段应区分: + +- 接触耦合诊断。 +- 连续体耦合预留诊断。 +- blast 内部调试载荷诊断。 + +## 10. 显式求解器接入 + +0.8.1 的 coupling 载荷应继续进入统一外力缓存,并在 Velocity-Verlet 显式步的总加速度合成阶段施加: + +```text +a_total = a_internal + a_body + a_blast + a_coupling +``` + +要求: + +- coupling force 与 blast force 使用独立缓存。 +- motion boundary 与 pressure/traction 载荷的施加顺序固定。 +- failed 或 inactive 粒子按既有策略跳过或接受,但必须记录诊断。 +- 外部载荷对做功、动量交换和能量交换的贡献可查询。 + +## 11. Output 和 Restart + +### 11.1 Output + +0.8.1 建议追加以下输出字段: + +- active contact 数量。 +- skipped contact 数量。 +- 最大 pressure。 +- 最大 traction。 +- 最大 penetration。 +- facet 输入总力。 +- facet 分配后总力。 +- facet 总力误差。 +- facet 输入力矩。 +- facet 分配后力矩。 +- stale 或重复导入计数。 + +summary CSV 用于全局和 region 级诊断;粒子 CSV 只追加小规模调试所需字段,避免把过多临时内部字段固化为长期公共格式。 + +### 11.2 Restart + +0.8.1 若新增持久字段,建议引入 `STATE_0_8_1` 或等价 0.8.1 restart 边界。restart 至少保存: + +- coupling region 基本信息。 +- 当前导入载荷缓存。 +- facet 分配策略和 epoch 状态。 +- 接触状态诊断。 +- 累计做功、冲量、动量交换和能量交换。 +- stale、skipped、nonfinite 和分配误差计数。 + +0.8.0 restart 读入后应初始化 0.8.1 新增状态为空状态,保证旧算例可继续运行。 + +## 12. API、C ABI、C++、Python 和 CLI + +### 12.1 Fortran API + +建议追加以下 Fortran API: + +- `sph_coupling_apply_facet_pressures` +- `sph_coupling_apply_facet_tractions` +- `sph_coupling_apply_facet_resultants` +- `sph_coupling_apply_contact_state` +- `sph_coupling_get_load_balance` +- `sph_coupling_get_contact_diagnostics` + +Fortran API 是语义来源,C ABI 只做薄包装。 + +### 12.2 C ABI + +C ABI 必须追加新函数,不修改 0.8.0 已有函数。建议新增: + +```c +int sphlite_apply_coupling_facet_pressures(const char *region, + int num_facets, + const int *facet_id, + const double *pressure, + int distribution_mode, + int coupling_step); + +int sphlite_apply_coupling_facet_tractions(const char *region, + int num_facets, + const int *facet_id, + const double *traction, + int distribution_mode, + int coupling_step); + +int sphlite_apply_coupling_contact_state(const char *region, + int num_items, + const int *item_id, + const int *contact_flag, + const double *normal, + const double *gap, + const double *penetration, + int coupling_step); + +int sphlite_get_coupling_contact_diagnostics(const char *region, + double *values, + int value_capacity); +``` + +数组展开顺序应延续 0.8.0 约定。空指针、小容量、非法 region、非法 step、非法 facet id 和非有限输入必须走既有错误路径。 + +### 12.3 C++ wrapper 和 Python ctypes + +C++ 和 Python 继续作为 C ABI 薄包装。0.8.1 建议覆盖: + +- pressure 导入。 +- traction 导入。 +- contact state 导入。 +- load balance 查询。 +- contact diagnostics 查询。 +- mock coupling driver。 + +Python 仍主要用于调试、示例、checker 和验收,不作为唯一入口。 + +### 12.4 CLI + +CLI inspect 建议追加: + +- coupling region 的 `LOAD_MODE` 和 `DISTRIBUTION`。 +- active contact 和 skipped contact。 +- pressure/traction 最大值。 +- facet load balance summary。 +- stale import 和 nonfinite import 计数。 + +CLI 不负责真实外部耦合主循环。 + +## 13. 模块拆分建议 + +0.8.1 应优先控制 `CouplingInterface` 相关文件继续膨胀。建议按实际复杂度拆分或准备拆分: + +- `sph_coupling_region`:region 构建和输入校验。 +- `sph_coupling_export`:粒子和 facet proxy 导出。 +- `sph_coupling_import`:粒子力、motion 和通用导入。 +- `sph_coupling_facet_load`:pressure、traction、resultant 和分配策略。 +- `sph_coupling_contact_state`:接触状态导入和诊断。 +- `sph_coupling_apply`:显式步施加和缓存消费。 +- `sph_coupling_diagnostics`:守恒、功、动量、能量和错误计数。 +- `sph_coupling_restart`:0.8.1 restart 边界。 +- `sph_coupling_api`:Fortran API 聚合。 + +拆分不得改变公共 API 语义,不得引入循环依赖。 + +## 14. 测试计划 + +### 14.1 新增 0.8.1 测试 + +建议新增以下测试: + +- `input_coupling_load_mode_081`:`LOAD_MODE`、`DISTRIBUTION` 和 contact state 输入解析。 +- `input_coupling_load_errors_081`:非法 load mode、非法 distribution、缺少 facet、负面积和非有限输入错误。 +- `coupling_facet_pressure_081`:pressure 到 facet 合力再到粒子力的受控分配。 +- `coupling_facet_traction_081`:traction 到粒子力的受控分配。 +- `coupling_facet_resultant_081`:facet resultant 合力分配。 +- `coupling_distribution_uniform_081`:均匀分配策略。 +- `coupling_distribution_area_081`:面积或受控权重分配策略。 +- `coupling_distribution_mass_081`:质量权重分配策略。 +- `coupling_load_balance_081`:总力和力矩诊断。 +- `coupling_contact_state_081`:contact flag、normal、gap 和 penetration 导入。 +- `coupling_contact_diagnostics_081`:active contact、skipped contact、最大 pressure/traction/penetration 统计。 +- `coupling_solver_order_081`:pressure/traction 与 blast force 的显式步叠加顺序。 +- `coupling_stale_epoch_081`:stale load、重复导入和 epoch 清理策略。 +- `coupling_solid_surface_pressure_081`:显式 Solid surface/facet pressure smoke。 +- `coupling_shell_pressure_081`:Shell facet pressure smoke。 +- `coupling_mixed_pressure_motion_081`:pressure/traction 与 motion boundary 混合 smoke。 +- `coupling_output_081`:summary CSV 和粒子 CSV 新字段。 +- `coupling_restart_081`:0.8.1 restart 写入、读回和继续显式步。 +- `coupling_restart_080_compat`:0.8.0 restart 读入后初始化 0.8.1 空状态。 +- `coupling_fortran_api_081`:Fortran API 新入口。 +- `coupling_c_api_081`:C ABI 新入口、错误路径和小容量路径。 +- `coupling_cpp_api_081`:C++ wrapper smoke。 +- `coupling_python_081`:Python ctypes checker。 +- `coupling_cli_081`:CLI inspect 新字段。 +- `coupling_smoke_081`:Solid/Shell 多步 mock contact pressure smoke。 +- `coupling_source_size_081`:0.8.1 source size 和 stale exception 检查。 + +### 14.2 回归测试 + +0.8.1 必须继续通过: + +- 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。 +- 既有 C API/C++/Python/CLI gate。 +- source size 相关 gate。 + +### 14.3 建议 0.8.1 Release Gate + +建议 0.8.1 默认 gate 为: + +```powershell +cmake --build build-codex-unix --parallel +ctest --test-dir build-codex-unix --output-on-failure +ctest --test-dir build-codex-unix -R "^(input_coupling_load_mode_081|input_coupling_load_errors_081|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|coupling_contact_state_081|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|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|coupling_smoke_081|coupling_source_size_081)$" --output-on-failure +ctest --test-dir build-codex-unix -R "^(source_size|explosive_source_size|explosive_041_source_size|gas_source_size_cleanup|solid_source_size|solid_051_source_size|shell_061_source_size|coupling_source_size_080|coupling_source_size_081)$" --output-on-failure +git diff --check +``` + +实际测试名称可在实现阶段微调,但 release gate 必须覆盖输入、载荷导入、分配策略、接触状态、显式步响应、diagnostics、output、restart、接口层、source size 和 mock smoke。 + +## 15. 建议开发阶段 + +### 阶段 A:版本基线和范围收敛 + +1. 更新软件版本为 `0.8.1`。 +2. 确认 `v0.8.0` 为开发基线。 +3. 复核 0.8.0 release gate 和当前工作区状态。 +4. 更新 README 当前开发版本和 0.8.1 定位。 +5. 明确 0.8.1 不交付真实 FEMLite 联合运行、外部 CouplingModule 或连续体耦合。 + +### 阶段 B:输入和接触状态契约 + +1. 扩展 `*SPHLITE COUPLING REGION` 的 `LOAD_MODE` 和 `DISTRIBUTION` 控制。 +2. 加固非法 load mode、非法 distribution 和无 facet proxy 的错误路径。 +3. 设计 contact state 中立字段。 +4. 建立接触状态运行时缓存。 +5. 新增输入和接触状态基础测试。 + +### 阶段 C:Facet 载荷分配 + +1. 实现 pressure 导入和转换。 +2. 实现 traction 导入和转换。 +3. 实现 resultant force 导入。 +4. 实现 `UNIFORM` 分配。 +5. 实现 `AREA` 或受控权重分配。 +6. 实现 `MASS` 分配。 +7. 增加总力和力矩守恒诊断。 +8. 新增分配策略和错误路径测试。 + +### 阶段 D:显式步接入和诊断 + +1. 将 facet 分配后的粒子力接入 coupling 外力缓存。 +2. 固定 pressure/traction、particle force、motion boundary 和 blast force 的叠加顺序。 +3. 记录 active/skipped contact、最大 pressure、最大 traction 和最大 penetration。 +4. 记录 stale、重复导入、nonfinite 和分配误差计数。 +5. 新增 Solid surface、Shell facet 和混合 pressure-motion smoke。 + +### 阶段 E:Output、Restart 和接口层 + +1. 扩展 summary CSV coupling/contact 字段。 +2. 扩展粒子 CSV 调试字段。 +3. 实现 `STATE_0_8_1` 或等价 restart 边界。 +4. 实现 0.8.0 restart 兼容读入后的空状态初始化。 +5. 追加 Fortran API。 +6. 追加 C ABI。 +7. 追加 C++ wrapper。 +8. 追加 Python ctypes checker。 +9. 追加 CLI inspect 字段。 +10. 新增 output、restart 和接口层测试。 + +### 阶段 F:Mock Smoke、门禁和文档 + +1. 新增 0.8.1 mock contact pressure smoke。 +2. 运行 0.8.1 coupling 专项 gate。 +3. 运行 0.8.0 coupling 回归 gate。 +4. 运行 Water/Gas/Explosive/Solid/Shell 分类 gate。 +5. 运行 0.7.0 和 0.7.1 blast 回归 gate。 +6. 运行完整 CTest。 +7. 运行 source size 相关 gate。 +8. 运行 `git diff --check`。 +9. 检查代码、构建脚本、测试和工具目录未新增 FEMLite 直接依赖。 +10. 检查输出目录、CSV、VTK、restart 和临时结果未被提交。 +11. 更新 README、06、09 和 11 号文档。 +12. 准备 0.8.1 发布记录。 + +## 16. 验收标准 + +0.8.1 应满足以下验收标准: + +1. 软件版本为 `0.8.1`。 +2. 0.8.0 完整 gate 继续通过。 +3. `LOAD_MODE` 和 `DISTRIBUTION` 输入可解析并可校验。 +4. pressure、traction 和 resultant force 可导入。 +5. facet 载荷可按受控策略分配到 SPHLite 粒子。 +6. Shell facet pressure smoke 响应方向受控。 +7. Solid 显式 surface pressure smoke 响应方向受控。 +8. 无 facet proxy 的 Solid 接触载荷请求有明确错误。 +9. 总力、力矩和分配误差诊断可查询。 +10. contact flag、gap、penetration 和 normal 诊断可导入、输出和 restart 恢复。 +11. stale、重复导入、nonfinite、负面积和非法权重路径可测。 +12. coupling 外载荷与 blast 外载荷缓存互不覆盖。 +13. summary CSV 和粒子 CSV 的新增字段可由 gate 检查。 +14. 0.8.1 restart 可恢复新增 coupling/contact 状态并继续显式步。 +15. 0.8.0 restart 可兼容读入并初始化 0.8.1 空状态。 +16. Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI inspect 新路径可用。 +17. 0.8.1 coupling 专项 gate、完整 CTest、source size 和 `git diff --check` 通过。 +18. 文档明确 0.8.1 不交付真实 FEMLite 联合运行、外部 CouplingModule、连续体耦合、生产级接触算法或工程级舱段破坏 benchmark。 +19. 不新增 FEMLite 直接依赖。 +20. 不修改 SPHLite 文件夹之外的内容。 + +## 17. 风险与控制 + +| 风险 | 表现 | 控制方式 | +|---|---|---| +| 0.8.1 范围膨胀 | 试图实现真实接触搜索或外部 CouplingModule | 限定为 SPHLite 侧载荷分配、诊断和 mock gate | +| 接触和连续体耦合混淆 | 将 `CONTINUUM` 纳入默认验收 | 0.8.1 仅启用 `CONTACT` 路径 | +| pressure 正负号歧义 | 不同测试使用相反方向 | 在接口文档和测试中固定中立符号约定 | +| 分配策略不可守恒 | 粒子力与输入 facet 力偏差不可见 | 必须记录总力和力矩误差 | +| 无 facet proxy 时静默退化 | Solid 体粒子自动生成不可靠 surface | 缺少受控 facet 时直接 error | +| API 兼容性破坏 | 修改 0.8.0 函数参数或含义 | 只追加新函数,不修改旧函数 | +| restart 状态不完整 | 读回后接触诊断或 epoch 丢失 | 0.8.1 restart 保存新增持久状态 | +| source size 膨胀 | CouplingInterface 文件过大 | 优先拆分 facet load、contact state 和 diagnostics | +| 文档误导 | 误称已完成真实 FEMLite 联合运行 | 发布文档明确非交付边界 | + +## 18. 后续版本建议 + +0.8.1 完成后,建议按以下路线推进: + +1. 0.8.2:外部驱动示例、C ABI 稳定性加固、Python checker 加固和更完整的 restart 兼容测试。 +2. 0.8.x:与外部 CouplingModule 的非默认集成测试,不进入 SPHLite 默认 gate。 +3. 0.9.0:启动连续体耦合边界,区分 `Solid`-FEM 实体连续体耦合和 `Shell`-FEM 壳连续体耦合。 + +## 19. 0.8.2 或 0.9.0 启动条件 + +满足以下条件后,可继续推进 0.8.2 或评估 0.9.0: + +1. 0.8.1 pressure、traction、resultant、distribution 和 contact diagnostics gate 稳定。 +2. C ABI 的新增接触载荷契约被测试锁定。 +3. Solid/Shell 小模型接触载荷响应可重复。 +4. coupling diagnostics 和 restart 可恢复显式步继续计算。 +5. 文档明确 0.8.1 仍不是真实 FEMLite 联合运行,也不是连续体耦合版本。 +6. source size 受控,CouplingInterface 已拆分或例外有清晰登记。 diff --git a/src/core/sph_precision.f90 b/src/core/sph_precision.f90 index 77c5828..64b2a30 100644 --- a/src/core/sph_precision.f90 +++ b/src/core/sph_precision.f90 @@ -4,7 +4,7 @@ module sph_precision integer, parameter :: rk = selected_real_kind(12, 100) integer, parameter :: SPH_VERSION_MAJOR = 0 integer, parameter :: SPH_VERSION_MINOR = 8 - integer, parameter :: SPH_VERSION_PATCH = 0 + integer, parameter :: SPH_VERSION_PATCH = 1 integer, parameter :: SPH_NDIM = 3 integer, parameter :: SPH_ERROR_MESSAGE_LEN = 256 integer, parameter :: SPH_PATH_LEN = 1024 diff --git a/tests/interface/test_c_api.c b/tests/interface/test_c_api.c index 409bf79..a7c4865 100644 --- a/tests/interface/test_c_api.c +++ b/tests/interface/test_c_api.c @@ -238,7 +238,7 @@ int main(void) ierr = sphlite_get_version(&major, &minor, &patch); if (ierr != 0) return fail("get_version failed"); - if (major != 0 || minor != 8 || patch != 0) return fail("unexpected version"); + if (major != 0 || minor != 8 || patch != 1) return fail("unexpected version"); snprintf(path, sizeof(path), "%s/minimal_particles_011.inp", SPHLITE_TEST_DATA_DIR); ierr = sphlite_read_inp(path); diff --git a/tests/interface/test_cpp_api.cpp b/tests/interface/test_cpp_api.cpp index 35995db..2a740a4 100644 --- a/tests/interface/test_cpp_api.cpp +++ b/tests/interface/test_cpp_api.cpp @@ -14,7 +14,7 @@ int main() { sphlite::Session session; sphlite::Version version = sphlite::version(); - if (version.major != 0 || version.minor != 8 || version.patch != 0) { + if (version.major != 0 || version.minor != 8 || version.patch != 1) { return 1; } diff --git a/tests/unit/test_smoke.f90 b/tests/unit/test_smoke.f90 index b12294e..8ab4852 100644 --- a/tests/unit/test_smoke.f90 +++ b/tests/unit/test_smoke.f90 @@ -37,7 +37,7 @@ program test_smoke call sph_get_version(major, minor, patch, ierr) call assert_ok(ierr, 'version failed') - if (major /= 0 .or. minor /= 8 .or. patch /= 0) call fail('unexpected version') + if (major /= 0 .or. minor /= 8 .or. patch /= 1) call fail('unexpected version') call sph_db_allocate(2, ierr) call assert_ok(ierr, 'database allocation failed') diff --git a/todo.md b/todo.md index 8763d91..505ffdd 100644 --- a/todo.md +++ b/todo.md @@ -1,350 +1,257 @@ # SPHLite TODO -当前目标版本:0.8.0 +当前目标版本:0.8.1 -本文档根据 `docs/v8.0_development_plan.md` 生成。0.8.0 定位为 SPHLite 侧中立接触耦合接口起步版,目标是将 `CouplingInterface` 从占位推进到可由外部耦合模块逐步驱动的接触耦合接口。 +本文档根据 `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.0 不交付真实 FEMLite 联合运行,不交付外部 CouplingModule、CoupleLite、CoupledLite 或 CouplingLite,不交付连续体耦合,不宣称工程级水下接触爆炸破坏 benchmark。核心代码继续遵守 Fortran95 约束,C/C++/Python 接口采用追加式扩展。执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端,除非用户另行要求。 +所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.8.1 不交付真实 FEMLite 联合运行,不交付外部 CouplingModule、CoupleLite、CoupledLite 或 CouplingLite,不交付连续体耦合,不宣称工程级水下接触爆炸破坏 benchmark。核心代码继续遵守 Fortran95 约束,C/C++/Python 接口采用追加式扩展。执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端,除非用户另行要求。 -## 阶段 A:0.8.0 基线、范围收敛和版本更新 +## 阶段 A:0.8.1 基线、范围收敛和版本更新 - [x] 确认当前 git 工作区状态并记录已有未提交内容。 -- [x] 确认 `v0.7.1` 标签和远端发布提交可作为 0.8.0 开发基线。 -- [x] 复核 `docs/v8.0_development_plan.md` 的版本定位和非交付范围。 -- [x] 确认 0.8.0 只交付 SPHLite 侧中立接触耦合接口。 -- [x] 确认 0.8.0 不实现真实 FEMLite 联合运行。 -- [x] 确认 0.8.0 不实现外部 CouplingModule。 -- [x] 确认 0.8.0 不实现连续体耦合。 -- [x] 确认 0.8.0 不新增几何、网格或粒子生成能力。 -- [x] 复核现有 `CouplingInterface` 占位模块能力。 -- [x] 复核现有 coupling region 输入解析能力。 -- [x] 复核现有数据库 coupling region 字段。 -- [x] 复核现有外部粒子力进入显式步的路径。 -- [x] 复核现有 C ABI、C++ wrapper、Python ctypes 和 CLI 的接口边界。 -- [x] 将 CMake 项目版本更新为 `0.8.0`。 -- [x] 将核心 Fortran 版本号更新为 `0.8.0`。 +- [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.0`。 -- [x] 在 README 中说明 0.8.0 的接触耦合接口范围。 -- [x] 在 README 中说明 0.8.0 的不交付边界。 -- [x] 准备 0.8.0 coupling 专项 gate 的初始测试名称清单。 -- [x] 运行 0.7.1 关键 smoke 或版本相关测试。 +- [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:Coupling Region 输入语义和运行时表 +## 阶段 B:输入控制、载荷模式和接触状态契约 -- [x] 复核现有 `*SPHLITE COUPLING REGION` 关键词字段。 -- [x] 定义 `TYPE=CONTACT` 为 0.8.0 唯一启用耦合类型。 -- [x] 定义 `TYPE=CONTINUUM` 的预留错误路径。 -- [x] 定义 coupling region 名称唯一性规则。 -- [x] 定义 `EXPORT=PARTICLE` 的输入语义。 -- [x] 定义 `EXPORT=FACET` 的输入语义。 -- [x] 定义 `EXPORT=BOTH` 的输入语义。 -- [x] 定义 `IMPORT=FORCE` 的输入语义。 -- [x] 定义 `IMPORT=FACET_LOAD` 的输入语义。 -- [x] 定义 `IMPORT=MOTION` 的输入语义。 -- [x] 定义 `ENABLED` 字段的默认值和布尔解析规则。 -- [x] 支持读取 coupling region 的 `NAME` 字段。 -- [x] 支持读取 coupling region 的 `TYPE` 字段。 -- [x] 支持读取 coupling region 的 `SET` 字段。 -- [x] 支持读取 coupling region 的 `SURFACE` 字段占位。 -- [x] 支持读取 coupling region 的 `PHASE` 过滤字段。 -- [x] 支持读取 coupling region 的 `MATERIAL` 过滤字段。 -- [x] 支持读取 coupling region 的 `SECTION` 过滤字段。 -- [x] 支持读取 coupling region 的 `EXPORT` 字段。 -- [x] 支持读取 coupling region 的 `IMPORT` 字段。 -- [x] 支持读取 coupling region 的 `ENABLED` 字段。 -- [x] 对空 region 名称报 error。 -- [x] 对重复 region 名称报 error。 -- [x] 对非法 `TYPE` 报 error。 -- [x] 对非法 `EXPORT` 报 error。 -- [x] 对非法 `IMPORT` 报 error。 -- [x] 对非法 `ENABLED` 报 error。 -- [x] 对缺失或不存在的 `SET` 报 error。 -- [x] 对无法选中粒子的 active region 报 error。 -- [x] 对 disabled region 保留输入记录但不参与导出。 -- [x] 保持 `tests/data/coupling_region_011.inp` 兼容。 -- [x] 在数据库中保存 region type、export mode、import mode 和 enabled 状态。 -- [x] 在数据库中保存 region set、surface、phase、material 和 section 过滤条件。 -- [x] 建立运行时 region 内部 id。 -- [x] 建立运行时 region 粒子索引表。 -- [x] 建立运行时 region active 粒子计数。 -- [x] 建立运行时 region 禁用状态计数。 -- [x] 确认 coupling region 构建不污染 Blast region。 -- [x] 确认 coupling region 构建不污染 Gas source region。 -- [x] 新增 `input_coupling_region_080` 测试。 -- [x] 新增 `input_coupling_errors_080` 测试。 -- [x] 新增 `coupling_region_build_080` 测试。 -- [x] 将阶段 B 新测试接入 CTest。 -- [x] 运行阶段 B coupling 输入专项测试。 -- [x] 运行 `git diff --check`。 -- [x] 准备阶段 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 Proxy 导出 +## 阶段 C:Facet Pressure、Traction、Resultant 和分配策略 -- [x] 定义 coupling 粒子导出字段顺序。 -- [x] 定义 coupling 粒子 scalar 缓冲区字段顺序。 -- [x] 定义 coupling 粒子三维数组展开顺序。 -- [x] 实现按 region 查询 coupling 粒子数量。 -- [x] 实现按 region 导出 external particle id。 -- [x] 实现按 region 导出 internal particle index。 -- [x] 实现按 region 导出 particle phase。 -- [x] 实现按 region 导出 particle status。 -- [x] 实现按 region 导出 material id。 -- [x] 实现按 region 导出 section id。 -- [x] 实现按 region 导出 mass。 -- [x] 实现按 region 导出 volume。 -- [x] 实现按 region 导出 density。 -- [x] 实现按 region 导出 pressure。 -- [x] 实现按 region 导出 internal energy。 -- [x] 实现按 region 导出 temperature。 -- [x] 实现按 region 导出 smoothing length `h`。 -- [x] 实现按 region 导出 position `x`。 -- [x] 实现按 region 导出 velocity `v`。 -- [x] 实现按 region 导出 acceleration `a`。 -- [x] 对非法 region 名称返回 error。 -- [x] 对 disabled region 返回 0 个导出粒子。 -- [x] 对调用方容量不足返回 error。 -- [x] 对非有限导出状态记录诊断或返回 error。 -- [x] 定义 facet proxy 导出字段顺序。 -- [x] 定义 facet proxy 三维数组展开顺序。 -- [x] 实现 Shell coupling region 的 facet proxy 计数。 -- [x] 实现 Shell facet proxy 的 facet id。 -- [x] 实现 Shell facet proxy 的关联粒子 id。 -- [x] 实现 Shell facet proxy 的中心坐标。 -- [x] 实现 Shell facet proxy 的平均速度。 -- [x] 实现 Shell facet proxy 的法向。 -- [x] 实现 Shell facet proxy 的面积。 -- [x] 实现 Shell facet proxy 的 material 和 section 信息。 -- [x] 支持受控 surface/facet 输入的 facet proxy 占位导出。 -- [x] 明确 Solid 无 surface 时不自动重构复杂外表面。 -- [x] 对 `EXPORT=FACET` 但无 facet proxy 的 region 报 error。 -- [x] 对零面积 facet proxy 报 error。 -- [x] 对非有限法向或面积报 error。 -- [x] 新增 `coupling_particle_export_080` 测试。 -- [x] 新增 `coupling_facet_export_080` 测试。 -- [x] 新增 `coupling_facet_errors_080` 测试。 -- [x] 将阶段 C 新测试接入 CTest。 -- [x] 运行阶段 C coupling 导出专项测试。 -- [x] 运行 `git diff --check`。 -- [x] 准备阶段 C 本地提交说明。 +- [ ] 设计 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:外部粒子力、Facet Load 和运动边界导入 +## 阶段 D:显式步接入、接触诊断和回归隔离 -- [x] 设计 coupling 外部粒子力缓存数组。 -- [x] 设计 coupling facet load 缓存数组或分配后粒子力缓存。 -- [x] 设计 coupling 运动边界缓存数组。 -- [x] 设计 coupling step 或 epoch 状态。 -- [x] 设计 stale load 计数状态。 -- [x] 设计 skipped particle 计数状态。 -- [x] 设计 nonfinite import 计数状态。 -- [x] 在初始化阶段分配 coupling 导入缓存。 -- [x] 在 finalize 阶段释放 coupling 导入缓存。 -- [x] 在模型重建阶段清空 coupling 导入缓存。 -- [x] 实现按 external particle id 导入粒子力。 -- [x] 实现按 region export index 导入粒子力。 -- [x] 对非法 region 导入返回 error。 -- [x] 对非法粒子 id 导入返回 error。 -- [x] 对 disabled region 导入返回 error。 -- [x] 对非有限 force 导入返回 error 并记录计数。 -- [x] 对质量非正粒子导入返回 error。 -- [x] 对 inactive 粒子导入执行跳过并记录计数。 -- [x] 对 failed Solid 粒子导入执行受控跳过或受控接受。 -- [x] 对 failed Shell 粒子导入执行受控跳过或受控接受。 -- [x] 实现同一 epoch 内粒子力累加语义。 -- [x] 实现新 epoch 自动清零或显式清零语义。 -- [x] 实现 facet 粒子力导入。 -- [x] 实现 facet load 关联粒子映射。 -- [x] 对非法 facet id 返回 error。 -- [x] 对 facet 粒子数不匹配返回 error。 -- [x] 对 facet load 非有限值返回 error。 -- [x] 实现目标速度运动边界导入。 -- [x] 实现目标位置或位移运动边界导入。 -- [x] 定义 direct assignment 运动边界模式。 -- [x] 定义 penalty 运动边界模式占位或错误路径。 -- [x] 对运动边界非法 mode 返回 error。 -- [x] 对运动边界非有限目标值返回 error。 -- [x] 对运动边界作用于 inactive 粒子记录跳过计数。 -- [x] 新增 `coupling_particle_force_import_080` 测试。 -- [x] 新增 `coupling_facet_load_import_080` 测试。 -- [x] 新增 `coupling_motion_boundary_080` 测试。 -- [x] 将阶段 D 新测试接入 CTest。 -- [x] 运行阶段 D coupling 导入专项测试。 -- [x] 运行 `git diff --check`。 -- [x] 准备阶段 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:显式求解器接入和耦合诊断 +## 阶段 E:Output、Restart、Fortran API 和外部接口层 -- [x] 定义 coupling 外部力进入总加速度的位置。 -- [x] 定义 coupling 运动边界进入 Velocity-Verlet 的位置。 -- [x] 确认 coupling 外部力缓存独立于 Blast 外载荷缓存。 -- [x] 确认 coupling 外部力和 Blast 外载荷可叠加。 -- [x] 将 coupling 粒子力转换为加速度贡献。 -- [x] 将 coupling facet load 转换为粒子加速度贡献。 -- [x] 将 coupling 加速度贡献接入 Water 粒子路径。 -- [x] 将 coupling 加速度贡献接入 Gas 粒子路径。 -- [x] 将 coupling 加速度贡献接入 Solid 粒子路径。 -- [x] 将 coupling 加速度贡献接入 Shell 粒子平动路径。 -- [x] 确认 coupling 力不改变 Shell director 和 moment 占位状态。 -- [x] 在显式步中施加目标速度运动边界。 -- [x] 在显式步中施加目标位置运动边界。 -- [x] 计算 coupling 当前步总外部力。 -- [x] 计算 coupling 当前步总外部力矩或等价力矩。 -- [x] 计算 coupling 当前步冲量。 -- [x] 计算 coupling 累计冲量。 -- [x] 计算 coupling 当前步做功。 -- [x] 计算 coupling 累计做功。 -- [x] 计算 coupling 动量交换。 -- [x] 计算 coupling 能量交换。 -- [x] 计算 coupling 最大外部力。 -- [x] 计算 coupling 最大加速度贡献。 -- [x] 计算 coupling 最大目标速度误差。 -- [x] 计算 coupling 最大目标位置误差。 -- [x] 记录 coupling stale load 计数。 -- [x] 记录 coupling skipped particle 计数。 -- [x] 记录 coupling nonfinite import 计数。 -- [x] 在步末标记 step-local coupling 载荷已消费。 -- [x] 确认无 active coupling region 时安全跳过。 -- [x] 确认 disabled coupling region 不影响显式步。 -- [x] 确认空导入不产生虚假加速度。 -- [x] 确认 Water-only 回归不被 coupling 路径污染。 -- [x] 确认 Gas-only 回归不被 coupling 路径污染。 -- [x] 确认 Explosive 回归不被 coupling 路径污染。 -- [x] 确认 Solid-only 回归不被 coupling 路径污染。 -- [x] 确认 Shell-only 回归不被 coupling 路径污染。 -- [x] 新增 `coupling_diagnostics_080` 测试。 -- [x] 新增 `coupling_solver_order_080` 测试。 -- [x] 新增 `coupling_solid_response_080` 测试。 -- [x] 新增 `coupling_shell_response_080` 测试。 -- [x] 新增 `coupling_noop_regression_080` 测试。 -- [x] 将阶段 E 新测试接入 CTest。 -- [x] 运行阶段 E coupling 求解器专项测试。 -- [x] 运行 `git diff --check`。 -- [x] 准备阶段 E 本地提交说明。 +- [ ] 定义 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:Output、Restart、Fortran API 和外部接口层 +## 阶段 F:Mock Coupling Smoke、门禁、文档和发布准备 -- [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、门禁、文档和发布准备 - -- [x] 设计 Solid mock contact coupling smoke 样例。 -- [x] 设计 Shell mock contact coupling smoke 样例。 -- [x] 设计 Solid/Shell 混合 coupling smoke 样例。 -- [x] 设计 disabled coupling region smoke 样例。 -- [x] 设计 no-active coupling region smoke 样例。 -- [x] 设计 stale load 或重复导入 smoke 样例。 -- [x] 新增 Solid mock contact coupling 输入文件。 -- [x] 新增 Shell mock contact coupling 输入文件。 -- [x] 新增 Solid/Shell 混合 coupling 输入文件。 -- [x] 新增 disabled coupling region 输入文件。 -- [x] 新增 no-active coupling region 输入文件。 -- [x] 新增 stale load 或重复导入输入文件。 -- [x] 验证 smoke 中所有粒子状态保持有限。 -- [x] 验证 smoke 中 coupling 外部力方向受控。 -- [x] 验证 smoke 中 coupling 运动边界方向受控。 -- [x] 验证 smoke 中 Solid 响应方向受控。 -- [x] 验证 smoke 中 Shell 平动响应方向受控。 -- [x] 验证 smoke 中冲量和做功诊断有限。 -- [x] 验证 smoke 中动量和能量交换诊断有限。 -- [x] 验证 disabled region 不产生 coupling 响应。 -- [x] 验证 no-active region 不产生 coupling 响应。 -- [x] 验证 stale load 诊断按预期变化。 -- [x] 新增 `coupling_smoke_080` 测试。 -- [x] 新增 `coupling_source_size_080` 测试。 -- [x] 将阶段 G 新测试接入 CTest。 -- [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.0 当前状态和不交付范围。 -- [x] 更新 `docs/06_test_and_verification_plan.md` 的 0.8.0 release gate。 -- [x] 更新 `docs/09_release_history.md` 的 0.8.0 本地验收记录。 -- [x] 更新 `docs/11_benchmark_matrix.md` 的 0.8.0 gate 矩阵。 -- [x] 确认文档不宣称真实 FEMLite 联合运行。 -- [x] 确认文档不宣称连续体耦合。 -- [x] 确认文档不宣称工程级船舱破坏 benchmark。 -- [x] 准备 0.8.0 发布提交说明。 -- [x] 准备阶段 G 本地提交说明。 +- [ ] 设计 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 本地提交说明。 diff --git a/tools/testing/test_cli.py b/tools/testing/test_cli.py index 1e1a8c4..c827f3f 100644 --- a/tools/testing/test_cli.py +++ b/tools/testing/test_cli.py @@ -52,7 +52,7 @@ def main() -> int: version = run_command([exe, "--version"]) require_field(version.stdout, "version") - if "0.8.0" not in version.stdout: + if "0.8.1" not in version.stdout: raise AssertionError("CLI version mismatch") inspect = run_command([exe, model]) @@ -127,7 +127,7 @@ def main() -> int: ): require_field(inspect.stdout, field) inspect_fields = read_fields(inspect.stdout) - if inspect_fields["version"] != "0.8.0": + if inspect_fields["version"] != "0.8.1": raise AssertionError("inspect version field mismatch") if Path(inspect_fields["input"]) != Path(model): raise AssertionError("inspect input field mismatch") diff --git a/tools/testing/test_python_debug.py b/tools/testing/test_python_debug.py index 3fbc7d6..e52f937 100644 --- a/tools/testing/test_python_debug.py +++ b/tools/testing/test_python_debug.py @@ -76,7 +76,7 @@ def main() -> int: raise AssertionError("Python wrapper is missing Solid particle state C ABI") if not hasattr(solver.lib, "sphlite_get_solid_diagnostics"): raise AssertionError("Python wrapper is missing Solid 0.5.1 diagnostics C ABI") - if solver.version() != (0, 8, 0): + if solver.version() != (0, 8, 1): raise AssertionError("Python version mismatch") solver.initialize()