Files
SPHLite/docs/v8.1_development_plan.md
T
2026-07-04 10:38:03 +08:00

585 lines
26 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 已拆分或例外有清晰登记。