585 lines
26 KiB
Markdown
585 lines
26 KiB
Markdown
# 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 已拆分或例外有清晰登记。
|