diff --git a/CMakeLists.txt b/CMakeLists.txt index 07216eb..0ae0d21 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,6 +1,6 @@ cmake_minimum_required(VERSION 3.20) -project(SPHLite VERSION 0.7.1 LANGUAGES C CXX Fortran) +project(SPHLite VERSION 0.8.0 LANGUAGES C CXX Fortran) set(CMAKE_C_STANDARD 99) set(CMAKE_C_STANDARD_REQUIRED ON) diff --git a/README.md b/README.md index fc85a04..5715c63 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。 -当前发布版本:0.7.1。该版本定位为水-气-结构局部爆炸稳定化版本,在 0.7.0 小型 Water/Gas/Explosive/Solid/Shell smoke 起点之上加固多 blast region、结构载荷叠加、诊断一致性、输出和 restart 边界。不交付真实工程级水下接触爆炸响应、真实 FEM-SPH 接触耦合或连续体耦合、完整舱段破坏 benchmark、复杂撕裂/穿孔/碎片云、Shell 完整动力学闭环、大规模并行或 GPU 后端。 +当前开发版本:0.8.0。该版本定位为 SPHLite 侧中立接触耦合接口起步版,在 0.7.1 局部爆炸稳定化版本之上推进 coupling region、粒子/Facet Proxy 导出、外部载荷/运动边界导入、显式步施加路径、诊断、接口和 mock coupling gate。不交付真实 FEMLite 联合运行、外部 CouplingModule、连续体耦合、生产级接触算法或工程级水下接触爆炸破坏 benchmark。 代码仓库地址: @@ -63,7 +63,7 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: ## 当前状态 -0.7.1 当前以 0.7.0 局部爆炸 smoke 发布版本为起点,已完成多 blast region、载荷叠加、诊断一致性、输出边界、restart 边界和 release gate 稳定化。0.5.0 以来已完成内容主要包括: +0.8.0 当前以 0.7.1 局部爆炸稳定化发布版本为起点,进入 SPHLite 侧中立接触耦合接口开发。0.5.0 以来已完成内容主要包括: - CMake/CTest 工程骨架和 Fortran 95 核心库。 - C ABI、C++ 头文件薄包装和 Python `ctypes` 调试入口。 @@ -100,3 +100,5 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: - 0.7.1 新增多 blast region 输入加固、启用/禁用控制、重复 region 错误检查、Solid/Shell 载荷叠加诊断、多 region 输出/restart 边界测试和 `blast_smoke_071`。 - 0.7.1 本地 gate 已通过:完整 CTest 139/139,0.7.0 blast 回归 gate 14/14,0.7.1 blast 专项 gate 12/12,Water/Gas/Explosive/Solid/Shell 分类 gate 6/6、16/16、27/27、31/31、13/13,source size 相关 gate 7/7,`git diff --check` 通过。 - 0.7.1 仍限定在 SPHLite 内部局部爆炸链路稳定化,不进入 0.8 的 FEM-SPH 接触耦合或连续体耦合;不交付真实工程级水下接触爆炸响应、完整舱段破坏 benchmark、Shell 完整动力学闭环或公开 Blast C ABI/C++/Python 稳定接口。 +- 0.8.0 将 `CouplingInterface` 从占位推进为可由外部耦合模块逐步驱动的 SPHLite 侧接触耦合接口,计划覆盖 coupling region 输入、粒子/Facet Proxy 导出、外部力/面载荷/运动边界导入、显式步施加、诊断、restart、C ABI/C++/Python/CLI 和 mock coupling gate。 +- 0.8.0 仍不直接依赖 FEMLite,不实现外部 CouplingModule,不交付连续体耦合,不宣称工程级船舶水下接触爆炸破坏 benchmark。 diff --git a/docs/v8.0_development_plan.md b/docs/v8.0_development_plan.md new file mode 100644 index 0000000..eec1f93 --- /dev/null +++ b/docs/v8.0_development_plan.md @@ -0,0 +1,762 @@ +# SPHLite v8.0 开发计划 + +文档状态:0.8.0 开发计划草案 + +目标软件版本:SPHLite 0.8.0 + +## 1. 文档定位 + +本文档用于规划 SPHLite 0.8.0 版本的开发范围。0.8.0 是 SPHLite 从内部水-气-爆炸-结构 smoke 链路进入外部耦合边界的起点,目标是在 0.7.1 已完成局部爆炸稳定化 gate 的基础上,将 `CouplingInterface` 从中立占位推进到可由外部耦合模块逐步驱动的接触耦合接口。 + +0.8.0 不直接与 FEMLite 联合运行,不引用 FEMLite 模块,不修改 FEMLite,也不把外部 CouplingModule、CoupleLite、CoupledLite 或 CouplingLite 作为 SPHLite 内部依赖。0.8.0 只交付 SPHLite 侧的中立数据契约、区域导出、外部载荷/运动边界导入、显式步施加路径、诊断、接口和 mock coupling gate。 + +0.8.0 的核心价值是把后续真实 FEM-SPH 接触耦合所需的 SPHLite 侧边界固定下来,使外部耦合模块可以通过稳定 C ABI 或 Fortran API 每步获取 SPH 状态、计算接触力或运动边界,再把结果导回 SPHLite。 + +## 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.0 以已发布的 0.7.1 局部爆炸稳定化版本为开发基线。 + +## 3. 版本定位 + +### 3.1 与 0.7.1 的关系 + +0.7.1 已完成以下能力: + +- Water/Gas/Explosive/Solid/Shell 小型局部爆炸 smoke 链路。 +- 多 blast region 输入、启用/禁用控制、源/目标统计和结构载荷叠加。 +- Solid/Shell 外部载荷缓存、显式推进顺序、输出和 restart 边界测试。 +- 0.7.0 blast 回归 gate、0.7.1 blast 专项 gate、完整 CTest 和 source size gate。 + +0.8.0 不重写 0.7.1 的 Blast 路径。0.8.0 应复用 0.7.1 中外部载荷进入 Solid/Shell 显式响应的经验,把载荷来源从内部 Blast 调试投影扩展为外部耦合模块导入的中立载荷和运动边界。 + +### 3.2 与 0.8.x 的关系 + +0.8.0 建议只交付接触耦合接口起步闭环。后续 0.8.x 可继续推进: + +- 更完整的 facet 几何导出。 +- 接触法向、间隙、穿透量或接触状态诊断。 +- 真实压力载荷投影和更细的面力到粒子力分配。 +- 耦合 restart 状态加固和外部驱动示例。 +- 更完整的 C++、Python 和 CLI inspect 支持。 + +0.8.0 不需要一次性完成所有接触算法,只需要把 SPHLite 侧可稳定交换的数据和显式施加路径建立起来。 + +### 3.3 与 0.9.0 的关系 + +0.9.0 仍建议作为连续体耦合版本线起点。0.8.0 必须在输入、状态和诊断中区分接触耦合与连续体耦合,但 0.8.0 不交付 `Solid` 与 FEM 实体连续体耦合、`Shell` 与 FEM 壳连续体耦合、重叠区耦合或界面约束。 + +0.8.0 可以为连续体耦合预留 `COUPLING_TYPE_CONTINUUM`、交换量枚举和错误路径,但默认 gate 不验收连续体耦合。 + +### 3.4 与 CouplingModule 的关系 + +外部耦合模块负责: + +- FEM 侧模型读取和区域识别。 +- SPH-FEM 匹配、搜索和投影。 +- 接触状态判断、穿透量计算和接触力算法。 +- 强耦合、弱耦合、子循环或松弛控制。 +- FEMLite 或其他外部求解器的数据适配。 + +SPHLite 负责: + +- 导出 SPHLite 侧 coupling region 的粒子状态和边界近似。 +- 接收外部模块导入的粒子力、面力、体力或运动边界。 +- 在显式动力学步中施加这些外部交换量。 +- 记录耦合功、动量交换、能量交换、非有限值和错误诊断。 + +SPHLite C ABI 和文档中应保持中立命名,不出现 FEMLite 内部数据库、单元类或私有结构体。 + +### 3.5 0.8.0 核心目标 + +0.8.0 的核心目标是形成 SPHLite 侧接触耦合接口闭环: + +```text +0.7.1 Water/Gas/Explosive/Solid/Shell blast smoke baseline + -> coupling region input and validation + -> neutral particle export + -> neutral boundary/facet proxy export + -> external particle force and facet load import + -> external motion boundary import + -> Velocity-Verlet explicit step application + -> coupling work, momentum and energy diagnostics + -> Fortran API, C ABI, C++ wrapper and Python ctypes smoke + -> mock contact coupling gate without FEMLite dependency +``` + +## 4. 开发原则 + +### 4.1 中立接口优先 + +0.8.0 所有接口、模块名、测试名和错误消息应保持中立语义。可使用 `coupling`、`external`、`contact`、`facet`、`particle`、`region` 等命名,不使用 FEMLite 内部类型名。 + +### 4.2 不直接依赖外部耦合模块 + +SPHLite 不把 CouplingModule 作为构建依赖。默认 gate 只使用 SPHLite 仓库内的小型 mock coupling 测试,模拟外部模块每步导入载荷或运动边界。 + +### 4.3 保持求解器定位 + +SPHLite 仍是求解器,不负责几何、网格或粒子生成。0.8.0 可从输入集合、section、Shell 参考几何和已有粒子状态导出边界近似,但不得新增几何建模、网格生成、粒子生成或自动边界重构能力。 + +### 4.4 复用 Abaqus 子集优先 + +输入层应优先复用 Abaqus 子集中的 `*NSET`、`*ELSET`、`*SURFACE` 或已有 section/set 语义。Abaqus 子集无法表达的 SPHLite 侧耦合控制,使用 `*SPHLITE COUPLING REGION` 扩展关键词。 + +### 4.5 显式动力学单向步进 + +0.8.0 仍只支持 Velocity-Verlet 显式动力学。外部耦合模块可以在每个显式步前导入载荷或运动边界;SPHLite 只负责在当前显式步中施加,不引入隐式强耦合求解器。 + +### 4.6 小型可测优先 + +0.8.0 默认 gate 只覆盖小规模、可重复的中立耦合接口测试。真实 FEM-SPH 联合运行、长时间接触滑移、复杂摩擦和工程舱段破坏不进入默认 gate。 + +### 4.7 追加式接口扩展 + +C ABI、C++ wrapper、Python ctypes 和 CLI 必须追加式扩展,不改变 0.7.1 既有函数的参数、数组展开顺序、错误码或物理含义。 + +## 5. 0.8.0 交付目标 + +0.8.0 建议交付以下内容: + +1. 将软件版本更新为 `0.8.0`。 +2. 保持 0.7.1 完整 gate 全部通过。 +3. 明确 0.8.0 为接触耦合接口起步版,而非真实 FEM-SPH 联合运行版。 +4. 加固 `*SPHLITE COUPLING REGION` 输入语义,支持 `TYPE=CONTACT`。 +5. 支持 coupling region 通过 set、phase、material、section 或受控 surface 名称选择 SPHLite 侧粒子。 +6. 支持 coupling region 的 `EXPORT=PARTICLE`、`EXPORT=FACET` 或 `EXPORT=BOTH` 控制。 +7. 支持 coupling region 的 `IMPORT=FORCE`、`IMPORT=FACET_LOAD` 或 `IMPORT=MOTION` 控制。 +8. 对重复 region、空 region、非法 type/export/import、非法 set/surface 和不支持连续体耦合请求给出明确 error。 +9. 建立 coupling region 运行时表,保存名称、类型、导出模式、导入模式、关联 set/surface、active 粒子数和状态。 +10. 导出 coupling 粒子的 external id、internal id、phase、status、material、section、质量、体积、密度、压力、内能、温度、`h`、坐标、速度和加速度。 +11. 为 Shell coupling region 导出受控边界/facet proxy,包括 facet id、局部粒子 id、坐标、速度、法向、面积和 section 信息。 +12. 为 Solid coupling region 提供 particle contact export;若输入显式给出 surface/facet 关系,可导出受控 facet proxy,否则不得自动重构体表面。 +13. 支持外部粒子力导入,并按 particle external id 或 coupling export index 映射到内部粒子。 +14. 支持外部 facet load 导入,并分配到 facet 关联粒子。 +15. 支持外部运动边界导入,包括受控速度边界或位移目标边界的第一版路径。 +16. 外部载荷和运动边界必须在 Velocity-Verlet 显式步中进入总加速度、速度或位置更新的受控位置。 +17. 支持 stale load 或重复导入诊断,避免无意复用上一耦合步载荷。 +18. 记录 coupling 总力、总力矩或等价力矩、冲量、做功、动量交换、能量交换、最大导入力、最大运动边界误差和非有限计数。 +19. 支持无 active coupling region 时安全跳过,不影响 Water/Gas/Explosive/Solid/Shell 既有路径。 +20. 将 coupling summary 写入 summary CSV 的受控字段。 +21. 在粒子 CSV 中追加必要的 coupling 调试字段,至少覆盖外部力和运动边界状态。 +22. 新增正式 `STATE_0_8` 或等价 0.8 restart 块,保存 coupling region、当前外部载荷/运动边界和累计诊断;若实现阶段决定不保存某类可重建数据,必须在文档中明确边界并配套测试。 +23. 保持 0.7.1 及更早 restart 可兼容读入,并初始化空 coupling 状态。 +24. 新增 coupling Fortran API,覆盖 region 查询、particle export、facet export、force import、facet load import、motion import 和 diagnostics 查询。 +25. 新增 coupling C ABI,采用 caller-allocated buffer 和中立命名。 +26. 新增 C++ wrapper 的 coupling 薄包装。 +27. 新增 Python `ctypes` coupling 调试入口和 mock coupling smoke。 +28. CLI 支持 coupling inspect 字段,不要求 CLI 直接驱动真实外部耦合。 +29. 新增 0.8.0 coupling 专项 CTest gate。 +30. 更新 README、06、09 和 11 号文档中的 0.8.0 测试、验收和不交付范围。 +31. 不新增 FEMLite 直接依赖,不修改 SPHLite 文件夹之外的内容。 + +## 6. 非交付范围 + +0.8.0 不交付以下内容: + +1. 不交付真实 FEMLite 联合运行。 +2. 不交付外部 CouplingModule、CoupleLite、CoupledLite 或 CouplingLite 的实现。 +3. 不交付 FEM-SPH 连续体耦合、重叠区耦合或界面约束。 +4. 不交付生产级接触搜索、摩擦、粘结、冲击接触稳定化或罚函数参数库。 +5. 不交付完整 SPH-FEM facet 自动匹配和投影算法。 +6. 不交付从 Solid 体粒子自动重构复杂外表面的算法。 +7. 不交付工程级水下接触爆炸破坏 benchmark。 +8. 不交付复杂板壳撕裂、穿孔、碎片云和碎片-流体接触。 +9. 不交付大规模并行、GPU 后端或性能优化版本。 +10. 不新增几何、网格或粒子生成能力。 +11. 不改变 0.7.1 Blast 调试接口边界,不把 Blast 调试字段强行纳入公开 C ABI。 + +## 7. 输入和 Coupling Region + +### 7.1 输入关键词建议 + +0.8.0 建议扩展已有 `*SPHLITE COUPLING REGION`,示例语义如下: + +```text +*SPHLITE COUPLING REGION, NAME=HULL_CONTACT, TYPE=CONTACT, + SET=SHELL_TARGET, EXPORT=BOTH, IMPORT=FORCE, SURFACE=SHELL_SURFACE +``` + +建议参数: + +- `NAME`:coupling region 名称,必填且唯一。 +- `TYPE`:第一版支持 `CONTACT`;`CONTINUUM` 可预留但默认 error 或 warning 后不启用。 +- `SET`:SPHLite 侧粒子集合名称。 +- `SURFACE`:可选 surface/facet 名称,仅在已有输入子集可表达时使用。 +- `PHASE`:可选 phase 过滤,例如 `SOLID`、`SHELL`、`WATER` 或 `GAS`。 +- `MATERIAL`:可选 material 过滤。 +- `SECTION`:可选 section 过滤。 +- `EXPORT`:`PARTICLE`、`FACET` 或 `BOTH`。 +- `IMPORT`:`FORCE`、`FACET_LOAD`、`MOTION` 或组合式受控枚举。 +- `ENABLED`:可选启用状态,默认启用。 + +0.8.0 不追求完整 Abaqus coupling 或 contact 关键词兼容。能复用 set、surface 和 section 的地方应复用;SPHLite 专有的交换控制保留在 `*SPHLITE COUPLING REGION`。 + +### 7.2 输入校验 + +0.8.0 应覆盖以下校验: + +- region 名称为空时报 error。 +- region 名称重复时报 error。 +- `TYPE` 非 `CONTACT` 或未支持类型时报 error。 +- `SET`、`SURFACE`、`PHASE`、`MATERIAL`、`SECTION` 均无法选中粒子时报 error 或受控 warning,具体取决于是否影响运行。 +- 请求 `EXPORT=FACET` 但没有可用 facet proxy 时,应明确 error 或降级为 `PARTICLE` 并 warning;默认 gate 建议采用 error,避免静默改变耦合语义。 +- 请求 `IMPORT=MOTION` 作用于 failed 粒子或非 active 粒子时,应按受控策略跳过并记录诊断。 +- set 仍只表示集合,不作为物理类型判断依据。 + +### 7.3 Region 构建 + +0.8.0 构建模型时应建立运行时 coupling region: + +- region 内部 id。 +- region 名称。 +- region 类型。 +- 启用状态。 +- 导出模式。 +- 导入模式。 +- 粒子索引表。 +- facet proxy 索引表。 +- 当前步导入状态。 +- 累计诊断。 + +region 构建不得破坏 0.7.1 已有 Blast region、Gas source region 或输出 region 语义。 + +## 8. 中立数据契约 + +### 8.1 粒子导出字段 + +0.8.0 coupling particle export 建议至少包含: + +- external particle id。 +- internal particle index。 +- phase。 +- status。 +- material id。 +- section id。 +- mass。 +- volume。 +- rho。 +- pressure。 +- internal energy。 +- temperature。 +- h。 +- x(3)。 +- v(3)。 +- a(3)。 + +数组展开顺序延续 Fortran 列主序到 C 缓冲区: + +- `x[dim + 3 * particle]` +- `v[dim + 3 * particle]` +- `a[dim + 3 * particle]` + +### 8.2 Facet Proxy 导出字段 + +0.8.0 facet proxy export 建议至少包含: + +- facet id。 +- region id。 +- facet 粒子数。 +- facet 关联 particle external id。 +- facet 关联 internal index。 +- facet center x(3)。 +- facet velocity v(3)。 +- facet normal n(3)。 +- facet area。 +- facet phase 或主 phase。 +- facet material/section。 + +Shell facet proxy 可优先由 Shell 2D 几何和 director/局部基构建。Solid facet proxy 只在输入提供明确 surface 或受控 facet 信息时构建,不自动从体粒子云推断复杂外表面。 + +### 8.3 导入字段 + +外部耦合模块导入 SPHLite 的字段建议包括: + +- 粒子力 `force(3,n)`。 +- facet load 或分配后的 facet 粒子力。 +- 受控体力或压力等效力。 +- 目标速度 `target_velocity(3,n)`。 +- 目标位移或目标位置 `target_position(3,n)`。 +- 导入 step id 或 coupling epoch。 + +0.8.0 第一版不要求支持所有字段同时生产可用,但 API 和错误路径应清楚区分已支持和未支持输入。 + +## 9. 载荷和运动边界施加 + +### 9.1 外部粒子力 + +外部粒子力应进入统一外部力缓存,并在显式步加速度合成阶段施加: + +```text +a_total = a_internal + a_body + a_blast + a_coupling +a_coupling = external_force / mass +``` + +0.8.0 应确认: + +- mass 非正时报 error。 +- force 非有限时报 error 或记录并拒绝导入。 +- failed 粒子按受控策略跳过或接受,但必须记录。 +- 多次导入可选择覆盖或累加,语义必须固定并测试。 + +建议第一版采用“同一 coupling epoch 内累加,不同 epoch 清零”的策略。 + +### 9.2 Facet Load + +facet load 可由外部模块直接分配为 facet 内粒子力,也可作为总面力由 SPHLite 按权重分配。0.8.0 建议优先支持外部已分配的 facet 粒子力,以避免在 SPHLite 内部固化投影算法。 + +若实现总面力分配,第一版建议只支持: + +- 均匀分配。 +- 按粒子面积权重分配。 +- 非有限和零面积 error。 + +复杂接触压力积分、摩擦和接触点投影不进入 0.8.0。 + +### 9.3 运动边界 + +0.8.0 的运动边界用于模拟外部 FEM facet 运动驱动 SPH 边界或接触边界。第一版建议支持: + +- 目标速度导入。 +- 目标位置或位移导入。 +- 简单 penalty 或 direct assignment 模式的受控测试路径。 +- 运动边界粒子计数、最大速度差和最大位置差诊断。 + +运动边界不得变成隐式约束求解器。默认 gate 只检查小模型中方向、有限性、能量诊断和不污染非 coupling 粒子。 + +## 10. 显式求解器集成 + +0.8.0 推荐每步调用顺序: + +```text +external driver: + sphlite_export_coupling_state(region) + external coupling module computes contact or motion data + sphlite_apply_coupling_forces/loads/motion(region) + sphlite_advance_explicit(dt) + sphlite_get_coupling_diagnostics(region) +``` + +SPHLite 内部显式步建议: + +1. 读取当前 coupling 外部载荷和运动边界缓存。 +2. 在加速度合成阶段叠加 external coupling force。 +3. 在 Velocity-Verlet 更新阶段施加受控运动边界。 +4. 更新 coupling 做功、冲量、动量和能量诊断。 +5. 若设置为 step-local 载荷,在步末标记为已消费。 + +0.8.0 不实现外部耦合模块的时间循环控制策略。`sphlite_run_explicit` 在无外部驱动时只能运行无耦合或 mock 输入,不应伪装真实联合仿真。 + +## 11. Diagnostics、Output 和 Restart + +### 11.1 Diagnostics + +0.8.0 coupling diagnostics 建议包括: + +- coupling region 数量。 +- active coupling 粒子数。 +- active facet proxy 数量。 +- 当前步导入粒子力数量。 +- 当前步导入 facet load 数量。 +- 当前步运动边界数量。 +- 总外部力。 +- 总外部力矩或等价力矩。 +- 累计冲量。 +- 累计做功。 +- 动量交换。 +- 能量交换。 +- 最大外部力。 +- 最大 coupling 加速度。 +- 最大目标速度误差。 +- 最大目标位置误差。 +- stale load 计数。 +- skipped particle 计数。 +- nonfinite import 计数。 + +### 11.2 CSV 输出 + +summary CSV 建议追加: + +- `coupling_regions` +- `coupling_particles` +- `coupling_facets` +- `coupling_force_x` +- `coupling_force_y` +- `coupling_force_z` +- `coupling_impulse_x` +- `coupling_impulse_y` +- `coupling_impulse_z` +- `coupling_work` +- `coupling_energy_exchange` +- `coupling_nonfinite_imports` +- `coupling_stale_loads` + +粒子 CSV 可追加: + +- `coupling_force_x` +- `coupling_force_y` +- `coupling_force_z` +- `coupling_motion_flag` +- `coupling_region_id` + +若字段数量过多,0.8.0 应优先保证 Fortran API 和 C ABI 可查询,CSV 只保留 release gate 最有价值字段。 + +### 11.3 Restart + +0.8.0 建议新增 `STATE_0_8` 或等价 0.8 restart 块。应保存或可恢复: + +- coupling region 定义和运行时映射。 +- region 类型、导出模式、导入模式和启用状态。 +- 当前步尚未消费的外部力、facet load 和运动边界。 +- 累计冲量、做功、动量和能量诊断。 +- stale load、skipped particle 和 nonfinite import 计数。 +- 输出计数和时间控制状态。 + +兼容读入: + +- `STATE_0_8`:完整读回 coupling 状态并可继续显式步。 +- `STATE_0_7_1` 或当前 0.7.1 状态边界:读回既有状态并初始化空 coupling 状态。 +- 更早可支持状态:初始化空 coupling 状态。 + +若当前实现仍保留较早 restart state 名称,0.8.0 应在开发阶段明确实际状态版本名,并在 06、09、11 号文档中同步记录。 + +## 12. API、C ABI、C++、Python 和 CLI + +### 12.1 Fortran API + +建议新增或补强以下 Fortran API: + +- `sph_coupling_get_region_count` +- `sph_coupling_get_region_info` +- `sph_coupling_get_particle_count` +- `sph_coupling_export_particles` +- `sph_coupling_get_facet_count` +- `sph_coupling_export_facets` +- `sph_coupling_apply_particle_forces` +- `sph_coupling_apply_facet_loads` +- `sph_coupling_apply_motion_boundary` +- `sph_coupling_clear_imports` +- `sph_coupling_get_diagnostics` + +Fortran API 是语义来源,C ABI 只做薄包装。 + +### 12.2 C ABI + +C ABI 必须使用 `sphlite_` 前缀和中立命名。建议新增: + +```c +int sphlite_get_coupling_region_count(int *count); + +int sphlite_get_coupling_region_info(int region_index, + char *name, + int name_capacity, + int *region_type, + int *export_mode, + int *import_mode, + int *enabled); + +int sphlite_get_coupling_particle_count(const char *region, + int *count); + +int sphlite_get_coupling_particles(const char *region, + int max_particles, + int *particle_id_ext, + int *phase, + int *status, + int *material_id, + int *section_id, + double *scalars, + int scalar_capacity, + double *x, + double *v, + double *a, + int *count); + +int sphlite_get_coupling_facet_count(const char *region, + int *num_facets, + int *max_face_particles); + +int sphlite_get_coupling_facets(const char *region, + int num_facets, + int max_face_particles, + int *facet_id, + int *facet_npart, + int *facet_particles, + double *center, + double *velocity, + double *normal, + double *area); + +int sphlite_apply_coupling_particle_forces(const char *region, + int num_particles, + const int *particle_id_ext, + const double *forces, + int coupling_step); + +int sphlite_apply_coupling_facet_loads(const char *region, + int num_facets, + int max_face_particles, + const int *facet_id, + const int *facet_npart, + const double *particle_forces, + int coupling_step); + +int sphlite_apply_coupling_motion(const char *region, + int num_particles, + const int *particle_id_ext, + const double *target_x, + const double *target_v, + int mode, + int coupling_step); + +int sphlite_get_coupling_diagnostics(const char *region, + double *values, + int value_capacity); +``` + +数组展开顺序应在头文件注释中锁定,空指针、小容量、非法 region、非法 step、非有限值必须走既有错误路径。 + +### 12.3 C++ wrapper 和 Python ctypes + +C++ 和 Python 继续作为 C ABI 薄包装,不重新定义 coupling 物理语义。0.8.0 建议覆盖: + +- region count/info。 +- particle export。 +- facet export。 +- particle force import。 +- facet load import。 +- motion import。 +- diagnostics 查询。 +- mock coupling 显式步驱动。 + +Python 仍主要用于调试、示例、checker 和验收,不作为唯一入口。 + +### 12.4 CLI + +CLI 可追加 inspect 字段: + +- coupling region 列表。 +- coupling particle count。 +- coupling facet count。 +- coupling export/import mode。 +- coupling diagnostics summary。 + +CLI 不负责真实外部耦合主循环。真实外部耦合应通过 C ABI、Fortran API 或外部驱动程序逐步控制。 + +## 13. 模块拆分建议 + +0.8.0 建议避免继续把 `src/coupling_interface/sph_coupling_interface.f90` 扩成单一大文件。可按复杂度拆分: + +- `sph_coupling_region`:输入后的 region 构建、过滤和校验。 +- `sph_coupling_export`:粒子和 facet proxy 导出。 +- `sph_coupling_import`:外部力、facet load 和运动边界导入。 +- `sph_coupling_apply`:显式步施加和缓存消费。 +- `sph_coupling_diagnostics`:功、动量、能量、错误计数。 +- `sph_coupling_restart`:0.8 restart 状态。 +- `sph_coupling_api`:Fortran API 聚合。 + +是否拆分以 source size gate 和依赖关系为准。拆分不得引入循环依赖,不得改变公共 API 语义。 + +## 14. 测试计划 + +### 14.1 新增 0.8.0 测试 + +建议新增以下测试: + +- `input_coupling_region_080`:`TYPE=CONTACT`、export/import/enabled/set/surface/phase/material/section 解析。 +- `input_coupling_errors_080`:重复 region、非法 type、非法 export/import、缺失 set、空 region 和不支持 continuum error。 +- `coupling_region_build_080`:运行时 region 表、粒子索引和禁用 region。 +- `coupling_particle_export_080`:粒子 id、phase、status、material、section、状态量和有限性导出。 +- `coupling_facet_export_080`:Shell facet proxy 和受控 surface facet proxy 导出。 +- `coupling_facet_errors_080`:请求 facet 但无可用 surface/proxy 的错误路径。 +- `coupling_particle_force_import_080`:外部粒子力导入、映射、累加或覆盖语义。 +- `coupling_facet_load_import_080`:facet 粒子力导入和诊断。 +- `coupling_motion_boundary_080`:目标速度或位置边界导入和显式步影响。 +- `coupling_diagnostics_080`:总力、冲量、做功、动量、能量、stale load 和 nonfinite 计数。 +- `coupling_solver_order_080`:外部导入载荷在 Velocity-Verlet 显式步中的施加顺序。 +- `coupling_solid_response_080`:Solid coupling 粒子受外部力后速度和位置方向受控。 +- `coupling_shell_response_080`:Shell coupling 粒子受外部力或运动边界后平动响应受控。 +- `coupling_noop_regression_080`:无 active region、禁用 region、空导入时不污染既有路径。 +- `coupling_restart_080`:0.8 coupling restart 写入、读回和继续显式步。 +- `coupling_restart_071_compat`:0.7.1 或既有 restart 读入后初始化空 coupling 状态。 +- `coupling_output_080`:summary CSV 和粒子 CSV coupling 字段。 +- `coupling_fortran_api_080`:Fortran API region/export/import/diagnostics 查询。 +- `coupling_c_api_080`:C ABI 正常路径、空指针、小容量、非法 region 和非有限输入错误。 +- `coupling_cpp_api_080`:C++ wrapper 薄包装 smoke。 +- `coupling_python_080`:Python ctypes mock coupling smoke。 +- `coupling_cli_080`:CLI inspect coupling region 和 diagnostics 字段。 +- `coupling_smoke_080`:Solid/Shell 小模型 mock contact coupling 多步 smoke。 +- `coupling_source_size_080`:CouplingInterface 0.8 source size 和 stale exception 检查。 + +### 14.2 回归测试 + +0.8.0 必须继续通过 0.7.1 完整 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.0 Release Gate + +建议 0.8.0 默认 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_region_080|input_coupling_errors_080|coupling_region_build_080|coupling_particle_export_080|coupling_facet_export_080|coupling_facet_errors_080|coupling_particle_force_import_080|coupling_facet_load_import_080|coupling_motion_boundary_080|coupling_diagnostics_080|coupling_solver_order_080|coupling_solid_response_080|coupling_shell_response_080|coupling_noop_regression_080|coupling_restart_080|coupling_restart_071_compat|coupling_output_080|coupling_fortran_api_080|coupling_c_api_080|coupling_cpp_api_080|coupling_python_080|coupling_cli_080|coupling_smoke_080|coupling_source_size_080)$" --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)$" --output-on-failure +git diff --check +``` + +实际测试名称可在实现阶段微调,但 0.8.0 release gate 必须覆盖输入、region 构建、粒子导出、facet 导出、载荷导入、运动边界、显式步响应、diagnostics、restart、接口层、source size 和 mock smoke。 + +## 15. 建议开发阶段 + +若后续根据本计划生成 `todo.md`,建议按以下阶段拆分: + +### 阶段 A:版本基线和范围收敛 + +1. 更新软件版本为 `0.8.0`。 +2. 确认 `v0.7.1` 为开发基线。 +3. 运行或复核 0.7.1 关键 gate。 +4. 更新 README 当前开发版本和 0.8.0 定位。 +5. 明确 0.8.0 不交付真实 FEMLite 联合运行或连续体耦合。 + +### 阶段 B:Coupling Region 输入和运行时表 + +1. 加固 `*SPHLITE COUPLING REGION` 输入语义。 +2. 支持 `TYPE=CONTACT`、export/import/enabled 字段。 +3. 支持 set、surface、phase、material 和 section 过滤。 +4. 实现重复、非法、空 region 和不支持 continuum 的错误路径。 +5. 建立运行时 region 表和粒子索引。 +6. 新增输入和 region 构建测试。 + +### 阶段 C:粒子和 Facet Proxy 导出 + +1. 实现 coupling 粒子 count 和 caller-allocated export。 +2. 锁定粒子导出字段和数组展开顺序。 +3. 实现 Shell facet proxy 导出。 +4. 实现受控 surface/facet proxy 导出。 +5. 明确 Solid 无 surface 时不自动重构复杂外表面。 +6. 新增 particle export、facet export 和 facet error 测试。 + +### 阶段 D:外部载荷和运动边界导入 + +1. 实现外部粒子力导入。 +2. 实现 facet load 或 facet 粒子力导入。 +3. 实现导入 step/epoch 和 stale load 诊断。 +4. 实现目标速度或目标位置运动边界导入。 +5. 处理 failed、inactive、非有限和质量非正粒子。 +6. 新增 force import、facet load import 和 motion boundary 测试。 + +### 阶段 E:显式求解器接入和诊断 + +1. 将 coupling 外部载荷接入总加速度。 +2. 将运动边界接入 Velocity-Verlet 受控更新路径。 +3. 记录当前步总力、冲量、做功、动量和能量交换。 +4. 记录 skipped、stale 和 nonfinite 计数。 +5. 确认无 active coupling 时安全跳过。 +6. 新增 solver order、Solid/Shell response、noop 和 diagnostics 测试。 + +### 阶段 F:Output、Restart 和接口层 + +1. 追加 summary CSV coupling 字段。 +2. 追加粒子 CSV coupling 调试字段。 +3. 设计并实现 `STATE_0_8` 或等价 0.8 restart 边界。 +4. 实现 0.7.1 restart 兼容读入后的空 coupling 状态。 +5. 新增 Fortran API。 +6. 新增 C ABI。 +7. 新增 C++ wrapper。 +8. 新增 Python ctypes。 +9. 新增 CLI inspect 字段。 +10. 新增 output、restart 和接口层测试。 + +### 阶段 G:Mock Coupling Smoke、门禁和文档 + +1. 新增 Solid mock contact coupling smoke。 +2. 新增 Shell mock contact coupling smoke。 +3. 新增 Solid/Shell 混合 coupling smoke。 +4. 运行完整 CTest。 +5. 运行 0.8.0 coupling 专项 gate。 +6. 运行 0.7.1 blast 回归 gate。 +7. 运行 source size 相关 gate。 +8. 运行 `git diff --check`。 +9. 检查代码、构建脚本、测试和工具目录未新增 FEMLite 直接依赖。 +10. 更新 README、06、09 和 11 号文档。 +11. 准备 0.8.0 发布记录。 + +## 16. 验收标准 + +0.8.0 应满足以下验收标准: + +1. 软件版本为 `0.8.0`。 +2. 0.7.1 完整 gate 继续通过。 +3. `*SPHLITE COUPLING REGION` 可表达受控接触 coupling region。 +4. 非法或不支持 coupling 输入有明确 error。 +5. coupling region 运行时表可构建并可查询。 +6. coupling 粒子状态导出字段完整、有限且数组顺序稳定。 +7. Shell facet proxy 或受控 surface facet proxy 可导出。 +8. 请求无法构建的 facet proxy 时不静默降级。 +9. 外部粒子力可导入并影响显式步响应。 +10. facet load 或 facet 粒子力可导入并影响关联粒子。 +11. 运动边界可导入并在小模型中产生受控响应。 +12. stale load、重复导入、failed/inactive 粒子和非有限输入有诊断或错误路径。 +13. coupling 做功、冲量、动量交换和能量交换诊断可查询。 +14. 无 active coupling region 时不影响 Water/Gas/Explosive/Solid/Shell 既有结果。 +15. summary CSV 和粒子 CSV 的 coupling 字段可由 gate 检查。 +16. `STATE_0_8` 或实际 0.8 restart 边界可恢复 coupling 状态并继续显式步。 +17. 0.7.1 或既有 restart 兼容读入后 coupling 状态安全初始化。 +18. Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI inspect 路径可用。 +19. 0.8.0 coupling 专项 gate、完整 CTest、source size 和 `git diff --check` 通过。 +20. 文档明确 0.8.0 不交付真实 FEMLite 联合运行、连续体耦合、生产级接触算法或工程级舱段破坏 benchmark。 +21. 不新增 FEMLite 直接依赖。 +22. 不修改 SPHLite 文件夹之外的内容。 + +## 17. 风险与控制 + +| 风险 | 表现 | 控制方式 | +|---|---|---| +| 0.8.0 范围膨胀 | 试图实现 CouplingModule 或真实 FEMLite 联合运行 | 限定为 SPHLite 侧中立接口和 mock gate | +| 接触与连续体耦合混淆 | 0.8.0 把连续体耦合也纳入实现 | `TYPE=CONTACT` 作为唯一启用类型,continuum 只预留错误路径 | +| facet 语义不稳 | 自动从体粒子重构复杂表面导致结果不可控 | 只支持 Shell 或显式 surface/facet proxy | +| 接口过早固化错误字段 | C ABI 暴露过多未验证物理量 | 只公开中立状态、载荷和诊断字段,Blast 调试字段仍不公开 | +| 外部力重复施加 | 多次导入或 stale load 被重复消费 | 引入 coupling step/epoch 和消费状态诊断 | +| 运动边界破坏显式稳定性 | direct assignment 导致能量跳变 | 默认 gate 只做受控小模型,并记录做功和误差 | +| 与 Blast 外载荷路径冲突 | coupling force 和 blast force 缓存互相覆盖 | 使用独立 coupling 外力缓存,并在总加速度阶段明确叠加 | +| restart 不完整 | 读回后导入载荷或累计诊断丢失 | `STATE_0_8` 保存 coupling 持久状态和累计量 | +| API 兼容破坏 | 修改既有 C ABI 或 phase/status 常量 | 追加新函数,不改变 0.7.1 接口 | +| source size 膨胀 | CouplingInterface 单文件过大 | 按 region/export/import/apply/diagnostics/restart/api 拆分 | + +## 18. 后续版本建议 + +0.8.0 完成后,建议后续按以下路线推进: + +1. 0.8.1:真实压力载荷投影、facet 面力分配策略、接触诊断加固和更多 mock 接触小模型。 +2. 0.8.2:外部驱动示例、C ABI 稳定性加固、Python checker 和 coupling restart 兼容性加固。 +3. 0.8.x:与外部 CouplingModule 的非默认集成测试,不进入 SPHLite 默认 gate。 +4. 0.9.0:启动连续体耦合边界,区分 `Solid`-FEM 实体连续体耦合和 `Shell`-FEM 壳连续体耦合。 + +## 19. 0.9.0 启动条件 + +满足以下条件后,可以启动 0.9.0 连续体耦合版本线: + +1. 0.8.0 coupling region、particle export、facet export、load import 和 motion import gate 稳定。 +2. C ABI 的 coupling 数据契约被文档和测试锁定。 +3. 外部载荷和运动边界对 Solid/Shell 小模型响应可重复。 +4. coupling diagnostics 和 restart 可恢复显式步继续计算。 +5. 文档明确 0.8.0 仍不是真实 FEMLite 联合运行,也不是连续体耦合版本。 +6. source size 受控,CouplingInterface 已拆分或有明确例外登记。 diff --git a/src/core/sph_precision.f90 b/src/core/sph_precision.f90 index 96b6fd9..77c5828 100644 --- a/src/core/sph_precision.f90 +++ b/src/core/sph_precision.f90 @@ -3,8 +3,8 @@ module sph_precision integer, parameter :: rk = selected_real_kind(12, 100) integer, parameter :: SPH_VERSION_MAJOR = 0 - integer, parameter :: SPH_VERSION_MINOR = 7 - integer, parameter :: SPH_VERSION_PATCH = 1 + integer, parameter :: SPH_VERSION_MINOR = 8 + integer, parameter :: SPH_VERSION_PATCH = 0 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 d40a7b4..409bf79 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 != 7 || patch != 1) return fail("unexpected version"); + if (major != 0 || minor != 8 || patch != 0) 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 d9b44c3..35995db 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 != 7 || version.patch != 1) { + if (version.major != 0 || version.minor != 8 || version.patch != 0) { return 1; } diff --git a/tests/unit/test_smoke.f90 b/tests/unit/test_smoke.f90 index f061bc2..b12294e 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 /= 7 .or. patch /= 1) call fail('unexpected version') + if (major /= 0 .or. minor /= 8 .or. patch /= 0) 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 c4af02e..5aab846 100644 --- a/todo.md +++ b/todo.md @@ -1,207 +1,350 @@ # SPHLite TODO -当前目标版本:0.7.1 +当前目标版本:0.8.0 -本文档面向用户指定的 `docs/v7.1_development_plan.md`。当前仓库中暂未检出该计划文件;补入后应首先复核本清单,并按计划文件修正版本范围、gate 名称和不交付边界。 +本文档根据 `docs/v8.0_development_plan.md` 生成。0.8.0 定位为 SPHLite 侧中立接触耦合接口起步版,目标是将 `CouplingInterface` 从占位推进到可由外部耦合模块逐步驱动的接触耦合接口。 -在 `docs/v7.1_development_plan.md` 缺失期间,本清单按 01-06 号文档、0.7.0 已发布边界、README 当前状态和 0.7.0 blast 实现现状拆分。0.7.1 暂定位为局部爆炸链路稳定化版本:在 0.7.0 小型 Water/Gas/Explosive/Solid/Shell smoke 起点之上,加固多 blast region、载荷叠加、诊断一致性、restart 边界和 release gate,不进入 0.8 FEM-SPH 接触耦合,也不宣称工程级水下接触爆炸响应。 +所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.8.0 不交付真实 FEMLite 联合运行,不交付外部 CouplingModule、CoupleLite、CoupledLite 或 CouplingLite,不交付连续体耦合,不宣称工程级水下接触爆炸破坏 benchmark。核心代码继续遵守 Fortran95 约束,C/C++/Python 接口采用追加式扩展。执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端,除非用户另行要求。 -所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。核心代码继续遵守 Fortran95 约束,C/C++/Python 接口只在语义冻结后再扩展。执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端,除非用户另行要求。 - -## 阶段 A:0.7.1 基线、计划复核和版本边界 +## 阶段 A:0.8.0 基线、范围收敛和版本更新 - [x] 确认当前 git 工作区状态并记录已有未提交内容。 -- [x] 确认 `v0.7.0` 标签和远端发布提交可作为 0.7.1 开发基线。 -- [x] 检查 `docs/v7.1_development_plan.md` 是否已补入仓库。 -- [x] 若 `docs/v7.1_development_plan.md` 仍缺失,在本清单顶部保留复核提示。 -- [x] 若 `docs/v7.1_development_plan.md` 已补入,逐条比对并修正本清单范围。 -- [x] 确认 0.7.1 定位为局部爆炸稳定化版本,而不是 0.8 耦合版本。 -- [x] 确认 0.7.1 不交付真实 FEM-SPH 接触耦合或连续体耦合。 -- [x] 确认 0.7.1 不交付工程级船舱水下接触爆炸 benchmark。 -- [x] 将核心 Fortran 版本号更新为 `0.7.1`。 -- [x] 将 CMake 项目版本更新为 `0.7.1`。 +- [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] 更新 Fortran smoke 测试中的版本期望。 - [x] 更新 C API 测试中的版本期望。 -- [x] 更新 C++ API 测试中的版本期望。 +- [x] 更新 C++ wrapper 测试中的版本期望。 - [x] 更新 Python debug 测试中的版本期望。 -- [x] 更新 CLI `--version` 和 inspect 版本期望。 -- [x] 更新 README 当前开发版本为 `0.7.1`。 -- [x] 在 README 中说明 0.7.1 的局部爆炸稳定化范围。 -- [x] 在 README 中说明 0.7.1 的不交付边界。 -- [x] 准备 0.7.1 release gate 的初始测试名称清单。 +- [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] 运行 `git diff --check`。 - [x] 准备阶段 A 本地提交说明。 -## 阶段 B:blast region 输入稳定化和多区域控制 +## 阶段 B:Coupling Region 输入语义和运行时表 -- [x] 复核现有 `*SPHLITE BLAST REGION` 关键词字段。 -- [x] 明确 0.7.1 多 blast region 的输入语义。 -- [x] 明确 blast region 名称唯一性规则。 -- [x] 明确重复 blast region 名称的 error 路径。 -- [x] 明确 blast region 最大数量超过上限的 error 路径。 -- [x] 明确 `ENABLED` 或等价启停字段的默认值。 -- [x] 明确源 phase 默认值仍保持 0.7.0 行为。 -- [x] 明确目标 phase 默认值仍保持 0.7.0 行为。 -- [x] 明确 `TARGET SET` 缺失时继续报 error。 -- [x] 明确空 target set 的 warning 或 no-op 规则。 -- [x] 明确中心坐标必须为有限值。 -- [x] 明确半径必须为正有限值。 -- [x] 明确载荷比例系数必须为有限值。 -- [x] 明确时间窗必须为非负有限值。 -- [x] 明确未知 source phase 的 error 路径。 -- [x] 明确未知 target phase 的 error 路径。 -- [x] 明确未知 projection mode 的 error 路径。 -- [x] 支持同一输入文件中读取多个 blast region。 -- [x] 保持单 region 0.7.0 输入样例兼容。 -- [x] 新增 `input_blast_multiregion` 测试。 -- [x] 新增 `input_blast_region_errors_071` 测试。 -- [x] 将 0.7.1 blast 输入测试接入 CTest。 -- [x] 准备阶段 B 本地提交说明。 +- [ ] 复核现有 `*SPHLITE COUPLING REGION` 关键词字段。 +- [ ] 定义 `TYPE=CONTACT` 为 0.8.0 唯一启用耦合类型。 +- [ ] 定义 `TYPE=CONTINUUM` 的预留错误路径。 +- [ ] 定义 coupling region 名称唯一性规则。 +- [ ] 定义 `EXPORT=PARTICLE` 的输入语义。 +- [ ] 定义 `EXPORT=FACET` 的输入语义。 +- [ ] 定义 `EXPORT=BOTH` 的输入语义。 +- [ ] 定义 `IMPORT=FORCE` 的输入语义。 +- [ ] 定义 `IMPORT=FACET_LOAD` 的输入语义。 +- [ ] 定义 `IMPORT=MOTION` 的输入语义。 +- [ ] 定义 `ENABLED` 字段的默认值和布尔解析规则。 +- [ ] 支持读取 coupling region 的 `NAME` 字段。 +- [ ] 支持读取 coupling region 的 `TYPE` 字段。 +- [ ] 支持读取 coupling region 的 `SET` 字段。 +- [ ] 支持读取 coupling region 的 `SURFACE` 字段占位。 +- [ ] 支持读取 coupling region 的 `PHASE` 过滤字段。 +- [ ] 支持读取 coupling region 的 `MATERIAL` 过滤字段。 +- [ ] 支持读取 coupling region 的 `SECTION` 过滤字段。 +- [ ] 支持读取 coupling region 的 `EXPORT` 字段。 +- [ ] 支持读取 coupling region 的 `IMPORT` 字段。 +- [ ] 支持读取 coupling region 的 `ENABLED` 字段。 +- [ ] 对空 region 名称报 error。 +- [ ] 对重复 region 名称报 error。 +- [ ] 对非法 `TYPE` 报 error。 +- [ ] 对非法 `EXPORT` 报 error。 +- [ ] 对非法 `IMPORT` 报 error。 +- [ ] 对非法 `ENABLED` 报 error。 +- [ ] 对缺失或不存在的 `SET` 报 error。 +- [ ] 对无法选中粒子的 active region 报 error。 +- [ ] 对 disabled region 保留输入记录但不参与导出。 +- [ ] 保持 `tests/data/coupling_region_011.inp` 兼容。 +- [ ] 在数据库中保存 region type、export mode、import mode 和 enabled 状态。 +- [ ] 在数据库中保存 region set、surface、phase、material 和 section 过滤条件。 +- [ ] 建立运行时 region 内部 id。 +- [ ] 建立运行时 region 粒子索引表。 +- [ ] 建立运行时 region active 粒子计数。 +- [ ] 建立运行时 region 禁用状态计数。 +- [ ] 确认 coupling region 构建不污染 Blast region。 +- [ ] 确认 coupling region 构建不污染 Gas source region。 +- [ ] 新增 `input_coupling_region_080` 测试。 +- [ ] 新增 `input_coupling_errors_080` 测试。 +- [ ] 新增 `coupling_region_build_080` 测试。 +- [ ] 将阶段 B 新测试接入 CTest。 +- [ ] 运行阶段 B coupling 输入专项测试。 +- [ ] 运行 `git diff --check`。 +- [ ] 准备阶段 B 本地提交说明。 -## 阶段 C:源项快照、目标筛选和多区域诊断 +## 阶段 C:粒子导出和 Facet Proxy 导出 -- [x] 复核现有 blast source snapshot 数据结构。 -- [x] 确认 source snapshot 按 region 独立刷新。 -- [x] 统计每个 region 内 active Water 源粒子数量。 -- [x] 统计每个 region 内 active Gas 源粒子数量。 -- [x] 统计每个 region 内 active Explosive 源粒子数量。 -- [x] 统计每个 region 内源粒子总质量。 -- [x] 统计每个 region 内源粒子总能量。 -- [x] 统计每个 region 内 Water 压力范围。 -- [x] 统计每个 region 内 Gas 总体积。 -- [x] 统计每个 region 内 Explosive 平均反应进度。 -- [x] 对 region 外源粒子执行跳过计数。 -- [x] 对非 active 源粒子执行跳过计数。 -- [x] 对不匹配 source phase 的粒子执行跳过计数。 -- [x] 确认无源粒子时返回安全默认诊断。 -- [x] 复核现有 blast target 筛选规则。 -- [x] 确认 target 筛选按 region 独立执行。 -- [x] 按 target set 筛选结构粒子。 -- [x] 按 target phase 筛选 Solid 和 Shell 粒子。 -- [x] 跳过 failed Solid 目标并记录计数。 -- [x] 跳过 failed Shell 目标并记录计数。 -- [x] 确认无目标粒子时返回安全默认诊断。 -- [x] 新增 `blast_multiregion_snapshot` 测试。 -- [x] 新增 `blast_multiregion_target_filter` 测试。 -- [x] 将源项和目标筛选测试接入 CTest。 -- [x] 准备阶段 C 本地提交说明。 +- [ ] 定义 coupling 粒子导出字段顺序。 +- [ ] 定义 coupling 粒子 scalar 缓冲区字段顺序。 +- [ ] 定义 coupling 粒子三维数组展开顺序。 +- [ ] 实现按 region 查询 coupling 粒子数量。 +- [ ] 实现按 region 导出 external particle id。 +- [ ] 实现按 region 导出 internal particle index。 +- [ ] 实现按 region 导出 particle phase。 +- [ ] 实现按 region 导出 particle status。 +- [ ] 实现按 region 导出 material id。 +- [ ] 实现按 region 导出 section id。 +- [ ] 实现按 region 导出 mass。 +- [ ] 实现按 region 导出 volume。 +- [ ] 实现按 region 导出 density。 +- [ ] 实现按 region 导出 pressure。 +- [ ] 实现按 region 导出 internal energy。 +- [ ] 实现按 region 导出 temperature。 +- [ ] 实现按 region 导出 smoothing length `h`。 +- [ ] 实现按 region 导出 position `x`。 +- [ ] 实现按 region 导出 velocity `v`。 +- [ ] 实现按 region 导出 acceleration `a`。 +- [ ] 对非法 region 名称返回 error。 +- [ ] 对 disabled region 返回 0 个导出粒子。 +- [ ] 对调用方容量不足返回 error。 +- [ ] 对非有限导出状态记录诊断或返回 error。 +- [ ] 定义 facet proxy 导出字段顺序。 +- [ ] 定义 facet proxy 三维数组展开顺序。 +- [ ] 实现 Shell coupling region 的 facet proxy 计数。 +- [ ] 实现 Shell facet proxy 的 facet id。 +- [ ] 实现 Shell facet proxy 的关联粒子 id。 +- [ ] 实现 Shell facet proxy 的中心坐标。 +- [ ] 实现 Shell facet proxy 的平均速度。 +- [ ] 实现 Shell facet proxy 的法向。 +- [ ] 实现 Shell facet proxy 的面积。 +- [ ] 实现 Shell facet proxy 的 material 和 section 信息。 +- [ ] 支持受控 surface/facet 输入的 facet proxy 占位导出。 +- [ ] 明确 Solid 无 surface 时不自动重构复杂外表面。 +- [ ] 对 `EXPORT=FACET` 但无 facet proxy 的 region 报 error。 +- [ ] 对零面积 facet proxy 报 error。 +- [ ] 对非有限法向或面积报 error。 +- [ ] 新增 `coupling_particle_export_080` 测试。 +- [ ] 新增 `coupling_facet_export_080` 测试。 +- [ ] 新增 `coupling_facet_errors_080` 测试。 +- [ ] 将阶段 C 新测试接入 CTest。 +- [ ] 运行阶段 C coupling 导出专项测试。 +- [ ] 运行 `git diff --check`。 +- [ ] 准备阶段 C 本地提交说明。 -## 阶段 D:结构载荷缓存、叠加和守恒诊断 +## 阶段 D:外部粒子力、Facet Load 和运动边界导入 -- [x] 复核现有 Solid 外载荷缓存数组布局。 -- [x] 复核现有 Shell 外载荷缓存数组布局。 -- [x] 确认每个显式步开始前清零 blast 外载荷缓存。 -- [x] 确认禁用 blast load 时缓存保持零值。 -- [x] 支持多个 blast region 对同一 Solid 目标载荷叠加。 -- [x] 支持多个 blast region 对同一 Shell 目标载荷叠加。 -- [x] 保持 Solid 和 Shell 外载荷缓存相互隔离。 -- [x] 保持 Water 粒子不被结构外载荷缓存污染。 -- [x] 保持 Gas 粒子不被结构外载荷缓存污染。 -- [x] 保持 Explosive 粒子不被结构外载荷缓存污染。 -- [x] 统一距离权重归一化的零分母处理。 -- [x] 统一非有限载荷贡献的跳过处理。 -- [x] 记录每个 region 的载荷目标数。 -- [x] 记录每个 region 的载荷 pair 数。 -- [x] 记录每个 region 的零权重 pair 数。 -- [x] 记录每个 region 的非有限贡献数。 -- [x] 记录每个 region 的总力。 -- [x] 记录每个 region 的 Solid 分力。 -- [x] 记录每个 region 的 Shell 分力。 -- [x] 记录每个 region 的冲量累计。 -- [x] 记录每个 region 的做功累计。 -- [x] 记录每个 region 的最大粒子力。 -- [x] 新增 `blast_load_superposition` 测试。 -- [x] 新增 `blast_load_diagnostics_071` 测试。 -- [x] 将结构载荷稳定化测试接入 CTest。 -- [x] 准备阶段 D 本地提交说明。 +- [ ] 设计 coupling 外部粒子力缓存数组。 +- [ ] 设计 coupling facet load 缓存数组或分配后粒子力缓存。 +- [ ] 设计 coupling 运动边界缓存数组。 +- [ ] 设计 coupling step 或 epoch 状态。 +- [ ] 设计 stale load 计数状态。 +- [ ] 设计 skipped particle 计数状态。 +- [ ] 设计 nonfinite import 计数状态。 +- [ ] 在初始化阶段分配 coupling 导入缓存。 +- [ ] 在 finalize 阶段释放 coupling 导入缓存。 +- [ ] 在模型重建阶段清空 coupling 导入缓存。 +- [ ] 实现按 external particle id 导入粒子力。 +- [ ] 实现按 region export index 导入粒子力。 +- [ ] 对非法 region 导入返回 error。 +- [ ] 对非法粒子 id 导入返回 error。 +- [ ] 对 disabled region 导入返回 error。 +- [ ] 对非有限 force 导入返回 error 并记录计数。 +- [ ] 对质量非正粒子导入返回 error。 +- [ ] 对 inactive 粒子导入执行跳过并记录计数。 +- [ ] 对 failed Solid 粒子导入执行受控跳过或受控接受。 +- [ ] 对 failed Shell 粒子导入执行受控跳过或受控接受。 +- [ ] 实现同一 epoch 内粒子力累加语义。 +- [ ] 实现新 epoch 自动清零或显式清零语义。 +- [ ] 实现 facet 粒子力导入。 +- [ ] 实现 facet load 关联粒子映射。 +- [ ] 对非法 facet id 返回 error。 +- [ ] 对 facet 粒子数不匹配返回 error。 +- [ ] 对 facet load 非有限值返回 error。 +- [ ] 实现目标速度运动边界导入。 +- [ ] 实现目标位置或位移运动边界导入。 +- [ ] 定义 direct assignment 运动边界模式。 +- [ ] 定义 penalty 运动边界模式占位或错误路径。 +- [ ] 对运动边界非法 mode 返回 error。 +- [ ] 对运动边界非有限目标值返回 error。 +- [ ] 对运动边界作用于 inactive 粒子记录跳过计数。 +- [ ] 新增 `coupling_particle_force_import_080` 测试。 +- [ ] 新增 `coupling_facet_load_import_080` 测试。 +- [ ] 新增 `coupling_motion_boundary_080` 测试。 +- [ ] 将阶段 D 新测试接入 CTest。 +- [ ] 运行阶段 D coupling 导入专项测试。 +- [ ] 运行 `git diff --check`。 +- [ ] 准备阶段 D 本地提交说明。 -## 阶段 E:Velocity-Verlet 接入、时间窗和响应回归 +## 阶段 E:显式求解器接入和耦合诊断 -- [x] 复核 blast load 在 Velocity-Verlet 显式步中的调用顺序。 -- [x] 确认 Explosive 更新早于 blast source snapshot。 -- [x] 确认 Gas 源项应用早于结构载荷投影。 -- [x] 确认 Water 压力更新早于结构载荷投影。 -- [x] 确认 Gas 压力更新早于结构载荷投影。 -- [x] 确认 blast load 只在时间窗内生效。 -- [x] 确认时间窗结束后外载荷缓存清零。 -- [x] 确认禁用 blast load 时完整显式步保持 no-op。 -- [x] 将 Solid blast 外载荷并入 Solid 加速度路径。 -- [x] 保持 Solid-only 无 blast 输入回归结果不变。 -- [x] 将 Shell blast 平动外载荷并入 Shell 受控入口。 -- [x] 保持 Shell director 不被 blast 外载荷非法修改。 -- [x] 保持 Shell 内力路径仍不宣称完整闭环。 -- [x] 验证 Solid/Shell 混合目标的载荷隔离。 -- [x] 验证多个 region 叠加后的 Solid 响应方向。 -- [x] 验证多个 region 叠加后的 Shell 响应方向。 -- [x] 验证 failed Solid 目标不产生响应。 -- [x] 验证 failed Shell 目标不产生响应。 -- [x] 验证 Water-only 模型不进入结构载荷路径。 -- [x] 验证 Gas-only 模型不进入结构载荷路径。 -- [x] 验证 Explosive-only 模型不进入结构载荷路径。 -- [x] 新增 `blast_solver_order_071` 测试。 -- [x] 新增 `blast_response_multiregion` 测试。 -- [x] 新增 `blast_noop_regression_071` 测试。 -- [x] 将显式推进回归测试接入 CTest。 -- [x] 准备阶段 E 本地提交说明。 +- [ ] 定义 coupling 外部力进入总加速度的位置。 +- [ ] 定义 coupling 运动边界进入 Velocity-Verlet 的位置。 +- [ ] 确认 coupling 外部力缓存独立于 Blast 外载荷缓存。 +- [ ] 确认 coupling 外部力和 Blast 外载荷可叠加。 +- [ ] 将 coupling 粒子力转换为加速度贡献。 +- [ ] 将 coupling facet load 转换为粒子加速度贡献。 +- [ ] 将 coupling 加速度贡献接入 Water 粒子路径。 +- [ ] 将 coupling 加速度贡献接入 Gas 粒子路径。 +- [ ] 将 coupling 加速度贡献接入 Solid 粒子路径。 +- [ ] 将 coupling 加速度贡献接入 Shell 粒子平动路径。 +- [ ] 确认 coupling 力不改变 Shell director 和 moment 占位状态。 +- [ ] 在显式步中施加目标速度运动边界。 +- [ ] 在显式步中施加目标位置运动边界。 +- [ ] 计算 coupling 当前步总外部力。 +- [ ] 计算 coupling 当前步总外部力矩或等价力矩。 +- [ ] 计算 coupling 当前步冲量。 +- [ ] 计算 coupling 累计冲量。 +- [ ] 计算 coupling 当前步做功。 +- [ ] 计算 coupling 累计做功。 +- [ ] 计算 coupling 动量交换。 +- [ ] 计算 coupling 能量交换。 +- [ ] 计算 coupling 最大外部力。 +- [ ] 计算 coupling 最大加速度贡献。 +- [ ] 计算 coupling 最大目标速度误差。 +- [ ] 计算 coupling 最大目标位置误差。 +- [ ] 记录 coupling stale load 计数。 +- [ ] 记录 coupling skipped particle 计数。 +- [ ] 记录 coupling nonfinite import 计数。 +- [ ] 在步末标记 step-local coupling 载荷已消费。 +- [ ] 确认无 active coupling region 时安全跳过。 +- [ ] 确认 disabled coupling region 不影响显式步。 +- [ ] 确认空导入不产生虚假加速度。 +- [ ] 确认 Water-only 回归不被 coupling 路径污染。 +- [ ] 确认 Gas-only 回归不被 coupling 路径污染。 +- [ ] 确认 Explosive 回归不被 coupling 路径污染。 +- [ ] 确认 Solid-only 回归不被 coupling 路径污染。 +- [ ] 确认 Shell-only 回归不被 coupling 路径污染。 +- [ ] 新增 `coupling_diagnostics_080` 测试。 +- [ ] 新增 `coupling_solver_order_080` 测试。 +- [ ] 新增 `coupling_solid_response_080` 测试。 +- [ ] 新增 `coupling_shell_response_080` 测试。 +- [ ] 新增 `coupling_noop_regression_080` 测试。 +- [ ] 将阶段 E 新测试接入 CTest。 +- [ ] 运行阶段 E coupling 求解器专项测试。 +- [ ] 运行 `git diff --check`。 +- [ ] 准备阶段 E 本地提交说明。 -## 阶段 F:输出、restart 边界和公开接口策略 +## 阶段 F:Output、Restart、Fortran API 和外部接口层 -- [x] 复核 0.7.0 summary CSV blast 字段。 -- [x] 扩展 summary CSV 的多 region 输出规则。 -- [x] 保持单 region summary CSV 字段兼容。 -- [x] 为多 region 输出记录 region 数量。 -- [x] 为多 region 输出记录每个 region 的源粒子数量。 -- [x] 为多 region 输出记录每个 region 的目标粒子数量。 -- [x] 为多 region 输出记录每个 region 的总力。 -- [x] 为多 region 输出记录每个 region 的能量输入。 -- [x] 为多 region 输出记录每个 region 的跳过计数。 -- [x] 复核 particle CSV blast 外载荷字段。 -- [x] 确认 particle CSV 输出叠加后的粒子外载荷。 -- [x] 确认默认未开启输出时不生成临时结果文件。 -- [x] 明确 0.7.1 是否新增正式 blast restart state。 -- [x] 若不新增正式 state,保持 `STATE_0_7` 未冻结边界并补充测试。 -- [x] 若新增正式 state,保存 blast 控制、诊断和外载荷缓存。 -- [x] 若新增正式 state,验证读回后继续显式步一致。 -- [x] 保持既有 restart 兼容读入路径稳定。 -- [x] 明确 0.7.1 不新增公开 C ABI blast 稳定接口。 -- [x] 明确 0.7.1 不新增 C++ wrapper blast 稳定接口。 -- [x] 明确 0.7.1 不新增 Python blast 稳定接口。 -- [x] 保留 Fortran 内部 blast summary 查询入口。 -- [x] 新增 `blast_output_071` 测试。 -- [x] 新增 `blast_restart_boundary_071` 或 `blast_restart_071` 测试。 -- [x] 将输出和 restart 测试接入 CTest。 -- [x] 准备阶段 F 本地提交说明。 +- [ ] 定义 summary CSV 的 coupling 字段清单。 +- [ ] 追加 `coupling_regions` summary CSV 字段。 +- [ ] 追加 `coupling_particles` summary CSV 字段。 +- [ ] 追加 `coupling_facets` summary CSV 字段。 +- [ ] 追加 `coupling_force_x/y/z` summary CSV 字段。 +- [ ] 追加 `coupling_impulse_x/y/z` summary CSV 字段。 +- [ ] 追加 `coupling_work` summary CSV 字段。 +- [ ] 追加 `coupling_energy_exchange` summary CSV 字段。 +- [ ] 追加 `coupling_nonfinite_imports` summary CSV 字段。 +- [ ] 追加 `coupling_stale_loads` summary CSV 字段。 +- [ ] 定义粒子 CSV 的 coupling 字段清单。 +- [ ] 追加粒子 CSV 的 `coupling_force_x/y/z` 字段。 +- [ ] 追加粒子 CSV 的 `coupling_motion_flag` 字段。 +- [ ] 追加粒子 CSV 的 `coupling_region_id` 字段。 +- [ ] 明确 0.8.0 restart 状态版本名称。 +- [ ] 实现 `STATE_0_8` 或等价 0.8 restart 写入。 +- [ ] 在 restart 中保存 coupling region 定义和映射。 +- [ ] 在 restart 中保存 coupling export/import mode。 +- [ ] 在 restart 中保存未消费外部力缓存。 +- [ ] 在 restart 中保存未消费 facet load 缓存。 +- [ ] 在 restart 中保存未消费运动边界缓存。 +- [ ] 在 restart 中保存累计冲量和做功。 +- [ ] 在 restart 中保存动量和能量交换诊断。 +- [ ] 在 restart 中保存 stale、skipped 和 nonfinite 计数。 +- [ ] 实现 `STATE_0_8` 或等价 0.8 restart 读回。 +- [ ] 实现 0.7.1 或既有 restart 兼容读入后的空 coupling 状态。 +- [ ] 实现 restart 读回后继续显式步的 coupling 状态恢复。 +- [ ] 新增 `sph_coupling_get_region_count` Fortran API。 +- [ ] 新增 `sph_coupling_get_region_info` Fortran API。 +- [ ] 新增 `sph_coupling_export_particles` Fortran API。 +- [ ] 新增 `sph_coupling_export_facets` Fortran API。 +- [ ] 新增 `sph_coupling_apply_particle_forces` Fortran API。 +- [ ] 新增 `sph_coupling_apply_facet_loads` Fortran API。 +- [ ] 新增 `sph_coupling_apply_motion_boundary` Fortran API。 +- [ ] 新增 `sph_coupling_clear_imports` Fortran API。 +- [ ] 新增 `sph_coupling_get_diagnostics` Fortran API。 +- [ ] 在 C 头文件中声明 coupling region 查询接口。 +- [ ] 在 C 头文件中声明 coupling particle export 接口。 +- [ ] 在 C 头文件中声明 coupling facet export 接口。 +- [ ] 在 C 头文件中声明 coupling force import 接口。 +- [ ] 在 C 头文件中声明 coupling facet load import 接口。 +- [ ] 在 C 头文件中声明 coupling motion import 接口。 +- [ ] 在 C 头文件中声明 coupling diagnostics 接口。 +- [ ] 实现 C ABI 的空指针错误路径。 +- [ ] 实现 C ABI 的小容量错误路径。 +- [ ] 实现 C ABI 的非法 region 错误路径。 +- [ ] 实现 C ABI 的非有限输入错误路径。 +- [ ] 在 C++ wrapper 中追加 coupling region 查询薄包装。 +- [ ] 在 C++ wrapper 中追加 coupling export 薄包装。 +- [ ] 在 C++ wrapper 中追加 coupling import 薄包装。 +- [ ] 在 Python ctypes 中追加 coupling region 查询。 +- [ ] 在 Python ctypes 中追加 coupling particle export。 +- [ ] 在 Python ctypes 中追加 coupling force import。 +- [ ] 在 Python ctypes 中追加 coupling diagnostics 查询。 +- [ ] 在 CLI inspect 中追加 coupling region 列表字段。 +- [ ] 在 CLI inspect 中追加 coupling export/import mode 字段。 +- [ ] 在 CLI inspect 中追加 coupling diagnostics 字段。 +- [ ] 新增 `coupling_output_080` 测试。 +- [ ] 新增 `coupling_restart_080` 测试。 +- [ ] 新增 `coupling_restart_071_compat` 测试。 +- [ ] 新增 `coupling_fortran_api_080` 测试。 +- [ ] 新增 `coupling_c_api_080` 测试。 +- [ ] 新增 `coupling_cpp_api_080` 测试。 +- [ ] 新增 `coupling_python_080` 测试。 +- [ ] 新增 `coupling_cli_080` 测试。 +- [ ] 将阶段 F 新测试接入 CTest。 +- [ ] 运行阶段 F output、restart 和接口专项测试。 +- [ ] 运行 `git diff --check`。 +- [ ] 准备阶段 F 本地提交说明。 -## 阶段 G:smoke、门禁、文档和发布准备 +## 阶段 G:Mock Coupling Smoke、门禁、文档和发布准备 -- [x] 设计 0.7.1 多 region 局部爆炸 smoke 样例。 -- [x] 新增 Solid 多 region blast smoke 输入样例。 -- [x] 新增 Shell 多 region blast smoke 输入样例。 -- [x] 新增 Solid/Shell 混合多 region blast smoke 输入样例。 -- [x] 新增禁用 blast load 的 smoke 回归样例。 -- [x] 新增空 target set 或无 active target 的 smoke 样例。 -- [x] 验证 smoke 中所有粒子状态保持有限。 -- [x] 验证 smoke 中 Explosive 反应进度单调或受控。 -- [x] 验证 smoke 中 Gas 体积和压力诊断方向受控。 -- [x] 验证 smoke 中 Solid/Shell 载荷方向受控。 -- [x] 验证 smoke 中冲量和能量诊断为有限值。 -- [x] 新增 `blast_smoke_071` 测试。 -- [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] 更新 `docs/06_test_and_verification_plan.md` 的 0.7.1 release gate。 -- [x] 更新 `docs/09_release_history.md` 的 0.7.1 本地验收记录。 -- [x] 更新 `docs/11_benchmark_matrix.md` 的 0.7.1 gate 矩阵。 -- [x] 更新 README 的 0.7.1 当前状态和不交付范围。 -- [x] 确认文档不宣称真实 FEM-SPH 联合运行。 -- [x] 确认文档不宣称工程级船舱破坏 benchmark。 -- [x] 准备 0.7.1 发布提交说明。 -- [x] 准备阶段 G 本地提交说明。 +- [ ] 设计 Solid mock contact coupling smoke 样例。 +- [ ] 设计 Shell mock contact coupling smoke 样例。 +- [ ] 设计 Solid/Shell 混合 coupling smoke 样例。 +- [ ] 设计 disabled coupling region smoke 样例。 +- [ ] 设计 no-active coupling region smoke 样例。 +- [ ] 设计 stale load 或重复导入 smoke 样例。 +- [ ] 新增 Solid mock contact coupling 输入文件。 +- [ ] 新增 Shell mock contact coupling 输入文件。 +- [ ] 新增 Solid/Shell 混合 coupling 输入文件。 +- [ ] 新增 disabled coupling region 输入文件。 +- [ ] 新增 no-active coupling region 输入文件。 +- [ ] 新增 stale load 或重复导入输入文件。 +- [ ] 验证 smoke 中所有粒子状态保持有限。 +- [ ] 验证 smoke 中 coupling 外部力方向受控。 +- [ ] 验证 smoke 中 coupling 运动边界方向受控。 +- [ ] 验证 smoke 中 Solid 响应方向受控。 +- [ ] 验证 smoke 中 Shell 平动响应方向受控。 +- [ ] 验证 smoke 中冲量和做功诊断有限。 +- [ ] 验证 smoke 中动量和能量交换诊断有限。 +- [ ] 验证 disabled region 不产生 coupling 响应。 +- [ ] 验证 no-active region 不产生 coupling 响应。 +- [ ] 验证 stale load 诊断按预期变化。 +- [ ] 新增 `coupling_smoke_080` 测试。 +- [ ] 新增 `coupling_source_size_080` 测试。 +- [ ] 将阶段 G 新测试接入 CTest。 +- [ ] 运行 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.0 当前状态和不交付范围。 +- [ ] 更新 `docs/06_test_and_verification_plan.md` 的 0.8.0 release gate。 +- [ ] 更新 `docs/09_release_history.md` 的 0.8.0 本地验收记录。 +- [ ] 更新 `docs/11_benchmark_matrix.md` 的 0.8.0 gate 矩阵。 +- [ ] 确认文档不宣称真实 FEMLite 联合运行。 +- [ ] 确认文档不宣称连续体耦合。 +- [ ] 确认文档不宣称工程级船舱破坏 benchmark。 +- [ ] 准备 0.8.0 发布提交说明。 +- [ ] 准备阶段 G 本地提交说明。 diff --git a/tools/testing/test_cli.py b/tools/testing/test_cli.py index f3adc87..1e1a8c4 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.7.1" not in version.stdout: + if "0.8.0" 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.7.1": + if inspect_fields["version"] != "0.8.0": 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 ec10900..668d9df 100644 --- a/tools/testing/test_python_debug.py +++ b/tools/testing/test_python_debug.py @@ -71,7 +71,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, 7, 1): + if solver.version() != (0, 8, 0): raise AssertionError("Python version mismatch") solver.initialize()