Start SPHLite 0.8.1 development

This commit is contained in:
Codex
2026-07-04 10:38:03 +08:00
parent 53c005e9ad
commit 89cce9a974
10 changed files with 829 additions and 336 deletions
+1 -1
View File
@@ -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)
+4 -2
View File
@@ -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。
+584
View File
@@ -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 已拆分或例外有清晰登记。
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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);
+1 -1
View File
@@ -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;
}
+1 -1
View File
@@ -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')
+233 -326
View File
@@ -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 本地提交说明。
+2 -2
View File
@@ -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")
+1 -1
View File
@@ -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()