From 2bc527179ee94f71e64e3b5e9d78614ad96d8417 Mon Sep 17 00:00:00 2001 From: Codex Date: Sat, 4 Jul 2026 00:05:45 +0800 Subject: [PATCH] Start 0.7.1 blast stabilization baseline --- CMakeLists.txt | 2 +- README.md | 5 +- src/core/sph_precision.f90 | 2 +- tests/interface/test_c_api.c | 2 +- tests/interface/test_cpp_api.cpp | 2 +- tests/unit/test_smoke.f90 | 2 +- todo.md | 402 +++++++++++++---------------- tools/testing/test_cli.py | 4 +- tools/testing/test_python_debug.py | 2 +- 9 files changed, 193 insertions(+), 230 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index 2d3038b..2273ecc 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,6 +1,6 @@ cmake_minimum_required(VERSION 3.20) -project(SPHLite VERSION 0.7.0 LANGUAGES C CXX Fortran) +project(SPHLite VERSION 0.7.1 LANGUAGES C CXX Fortran) set(CMAKE_C_STANDARD 99) set(CMAKE_C_STANDARD_REQUIRED ON) diff --git a/README.md b/README.md index ce6efeb..0e05ede 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。 -当前开发版本:0.7.0。该版本定位为水-气-结构局部爆炸 smoke 起点,在 0.6.1 已发布的 Shell 运动学基线之上建立小型 Water/Gas/Explosive/Solid/Shell 链路、受控结构外载荷缓存和诊断。不交付真实工程级水下接触爆炸响应、真实 FEM-SPH 接触耦合或连续体耦合、完整舱段破坏 benchmark、复杂撕裂/穿孔/碎片云、Shell 完整动力学闭环、大规模并行或 GPU 后端。 +当前开发版本:0.7.1。该版本定位为水-气-结构局部爆炸稳定化版本,在 0.7.0 小型 Water/Gas/Explosive/Solid/Shell smoke 起点之上加固多 blast region、结构载荷叠加、诊断一致性、输出和 restart 边界。不交付真实工程级水下接触爆炸响应、真实 FEM-SPH 接触耦合或连续体耦合、完整舱段破坏 benchmark、复杂撕裂/穿孔/碎片云、Shell 完整动力学闭环、大规模并行或 GPU 后端。 代码仓库地址: @@ -63,7 +63,7 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: ## 当前状态 -0.7.0 当前以 0.6.1 `Shell` 运动学基线发布版本为起点,进入水-气-结构局部爆炸 smoke 和受控结构载荷路径开发。0.5.0 以来已完成内容主要包括: +0.7.1 当前以 0.7.0 局部爆炸 smoke 发布版本为起点,进入多 blast region、载荷叠加和诊断稳定化开发。0.5.0 以来已完成内容主要包括: - CMake/CTest 工程骨架和 Fortran 95 核心库。 - C ABI、C++ 头文件薄包装和 Python `ctypes` 调试入口。 @@ -97,3 +97,4 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: - 0.7.0 新增小型 Water/Gas/Explosive/Solid/Shell 局部爆炸 smoke、结构外载荷缓存、载荷诊断和默认回归 gate;该版本只用于链路验收,不作为工程精度 benchmark。 - 0.7.0 局部爆炸诊断先提供 Fortran API 和 CSV 调试输出,不新增公开 C ABI/C++/Python 稳定接口,也不写入正式 `STATE_0_7` restart。 - 0.7.0 本地 gate 已通过:完整 CTest 127/127,局部爆炸专项 gate 14/14,source size 相关 gate 7/7,`git diff --check` 通过。 +- 0.7.1 将继续限定在 SPHLite 内部局部爆炸链路稳定化,不进入 0.8 的 FEM-SPH 接触耦合或连续体耦合;新增能力必须以多 region 小模型、诊断和回归 gate 验收。 diff --git a/src/core/sph_precision.f90 b/src/core/sph_precision.f90 index 4813d03..96b6fd9 100644 --- a/src/core/sph_precision.f90 +++ b/src/core/sph_precision.f90 @@ -4,7 +4,7 @@ module sph_precision integer, parameter :: rk = selected_real_kind(12, 100) integer, parameter :: SPH_VERSION_MAJOR = 0 integer, parameter :: SPH_VERSION_MINOR = 7 - integer, parameter :: SPH_VERSION_PATCH = 0 + integer, parameter :: SPH_VERSION_PATCH = 1 integer, parameter :: SPH_NDIM = 3 integer, parameter :: SPH_ERROR_MESSAGE_LEN = 256 integer, parameter :: SPH_PATH_LEN = 1024 diff --git a/tests/interface/test_c_api.c b/tests/interface/test_c_api.c index 72898e5..d40a7b4 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 != 0) return fail("unexpected version"); + if (major != 0 || minor != 7 || patch != 1) return fail("unexpected version"); snprintf(path, sizeof(path), "%s/minimal_particles_011.inp", SPHLITE_TEST_DATA_DIR); ierr = sphlite_read_inp(path); diff --git a/tests/interface/test_cpp_api.cpp b/tests/interface/test_cpp_api.cpp index 9e08cff..d9b44c3 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 != 0) { + if (version.major != 0 || version.minor != 7 || version.patch != 1) { return 1; } diff --git a/tests/unit/test_smoke.f90 b/tests/unit/test_smoke.f90 index 81a2383..f061bc2 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 /= 0) call fail('unexpected version') + if (major /= 0 .or. minor /= 7 .or. patch /= 1) call fail('unexpected version') call sph_db_allocate(2, ierr) call assert_ok(ierr, 'database allocation failed') diff --git a/todo.md b/todo.md index 627182f..cfc943d 100644 --- a/todo.md +++ b/todo.md @@ -1,245 +1,207 @@ # SPHLite TODO -当前目标版本:0.7.0 +当前目标版本:0.7.1 -本文档面向用户指定的 `docs/v7.0_development_plan.md`。当前仓库中暂未检出该计划文件;待 `docs/v7.0_development_plan.md` 补入后,应先复核本文档。本清单暂按已发布的 0.6.1、01-06 号文档、`docs/v6.1_development_plan.md` 中的 0.7.0 后续路线拆分。0.7.0 暂定位为水-气-结构局部爆炸 smoke 起点,覆盖小型 Water/Gas/Explosive/Solid/Shell 链路。 +本文档面向用户指定的 `docs/v7.1_development_plan.md`。当前仓库中暂未检出该计划文件;补入后应首先复核本清单,并按计划文件修正版本范围、gate 名称和不交付边界。 -所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.7.0 不交付真实工程级水下接触爆炸响应,不交付真实 FEM-SPH 接触耦合或连续体耦合,不交付工程级船舱破坏 benchmark,不交付复杂撕裂、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。 +在 `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 接触耦合,也不宣称工程级水下接触爆炸响应。 -执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端。 +所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。核心代码继续遵守 Fortran95 约束,C/C++/Python 接口只在语义冻结后再扩展。执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端,除非用户另行要求。 -## 阶段 A:版本基线、范围声明与 0.7.0 样例 +## 阶段 A:0.7.1 基线、计划复核和版本边界 -- [x] 确认当前 git 状态并记录已有未提交内容。 -- [x] 确认 `v0.6.1` 标签和远端发布提交可作为 0.7.0 开发基线。 -- [x] 复核 `docs/v7.0_development_plan.md` 是否已补入仓库。 -- [x] 若 `docs/v7.0_development_plan.md` 缺失,在 todo 顶部保留复核提示。 -- [x] 将核心软件版本更新为 `0.7.0`。 -- [x] 将 CMake 项目版本更新为 `0.7.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] 更新 Fortran smoke 测试中的版本期望。 - [x] 更新 C API 测试中的版本期望。 - [x] 更新 C++ API 测试中的版本期望。 - [x] 更新 Python debug 测试中的版本期望。 - [x] 更新 CLI `--version` 和 inspect 版本期望。 -- [x] 在 README 中记录 0.7.0 水-气-结构局部爆炸 smoke 定位。 -- [x] 在 README 中明确 0.7.0 不交付工程级爆炸响应。 -- [x] 在 README 中明确 0.7.0 不交付真实 FEM-SPH 耦合。 -- [x] 创建 Water/Gas/Explosive/Solid 最小混合输入样例。 -- [x] 创建 Water/Gas/Explosive/Shell 最小混合输入样例。 -- [x] 创建 Water/Gas/Explosive/Solid/Shell 混合输入样例。 -- [x] 创建无结构粒子的局部爆炸 smoke 输入样例。 -- [x] 创建无水粒子的 Gas/Explosive/Structure 错误或 warning 样例。 -- [x] 创建无 Gas product material 的 Explosive 错误输入样例。 -- [x] 创建结构载荷目标 set 缺失错误输入样例。 -- [x] 创建结构载荷半径非法错误输入样例。 -- [x] 创建结构载荷比例系数非有限错误输入样例。 -- [x] 创建 Shell-only 受控爆炸载荷诊断样例。 -- [x] 创建 Solid-only 受控爆炸载荷诊断样例。 -- [x] 创建 Solid/Shell 混合载荷隔离样例。 -- [x] 运行 0.6.1 完整 gate 并记录基线结果。 +- [x] 更新 README 当前开发版本为 `0.7.1`。 +- [x] 在 README 中说明 0.7.1 的局部爆炸稳定化范围。 +- [x] 在 README 中说明 0.7.1 的不交付边界。 +- [x] 准备 0.7.1 release gate 的初始测试名称清单。 - [x] 准备阶段 A 本地提交说明。 -## 阶段 B:0.7.0 输入控制、结构目标和局部爆炸区域 +## 阶段 B:blast region 输入稳定化和多区域控制 -- [x] 设计 0.7.0 局部爆炸 smoke 的输入关键词边界。 -- [x] 优先复用既有 Abaqus 子集表达材料、section、set 和 element 信息。 -- [x] 定义 SPHLite 调试扩展关键词的最小集合。 -- [x] 设计局部爆炸区域名称、中心和半径字段。 -- [x] 设计结构载荷目标 set 或 elset 字段。 -- [x] 设计结构载荷源 phase 过滤字段。 -- [x] 设计结构载荷目标 phase 过滤字段。 -- [x] 设计压力载荷比例系数字段。 -- [x] 设计冲量或时间窗口控制字段。 -- [x] 设计载荷投影模式字段。 -- [x] 设计 Solid 和 Shell 目标共用的输入约定。 -- [x] 支持读取局部爆炸区域控制参数。 -- [x] 支持读取结构载荷目标集合名称。 -- [x] 支持读取源相过滤参数。 -- [x] 支持读取目标相过滤参数。 -- [x] 支持读取载荷比例系数。 -- [x] 支持读取载荷时间窗口。 -- [x] 支持读取载荷投影模式。 -- [x] 校验局部爆炸区域半径为正有限值。 -- [x] 校验载荷比例系数为有限值。 -- [x] 校验时间窗口为非负有限值。 -- [x] 校验源 phase 名称合法。 -- [x] 校验目标 phase 名称合法。 -- [x] 校验目标 set 存在。 -- [x] 对未被使用的局部爆炸控制项报 warning。 -- [x] 对 active 结构粒子缺失载荷控制保持 no-op。 -- [x] 新增 `input_blast_region` 测试。 -- [x] 新增 `input_blast_errors` 测试。 -- [x] 将输入控制测试接入 CTest。 -- [x] 准备阶段 B 本地提交说明。 +- [ ] 复核现有 `*SPHLITE BLAST REGION` 关键词字段。 +- [ ] 明确 0.7.1 多 blast region 的输入语义。 +- [ ] 明确 blast region 名称唯一性规则。 +- [ ] 明确重复 blast region 名称的 error 路径。 +- [ ] 明确 blast region 最大数量超过上限的 error 路径。 +- [ ] 明确 `ENABLED` 或等价启停字段的默认值。 +- [ ] 明确源 phase 默认值仍保持 0.7.0 行为。 +- [ ] 明确目标 phase 默认值仍保持 0.7.0 行为。 +- [ ] 明确 `TARGET SET` 缺失时继续报 error。 +- [ ] 明确空 target set 的 warning 或 no-op 规则。 +- [ ] 明确中心坐标必须为有限值。 +- [ ] 明确半径必须为正有限值。 +- [ ] 明确载荷比例系数必须为有限值。 +- [ ] 明确时间窗必须为非负有限值。 +- [ ] 明确未知 source phase 的 error 路径。 +- [ ] 明确未知 target phase 的 error 路径。 +- [ ] 明确未知 projection mode 的 error 路径。 +- [ ] 支持同一输入文件中读取多个 blast region。 +- [ ] 保持单 region 0.7.0 输入样例兼容。 +- [ ] 新增 `input_blast_multiregion` 测试。 +- [ ] 新增 `input_blast_region_errors_071` 测试。 +- [ ] 将 0.7.1 blast 输入测试接入 CTest。 +- [ ] 准备阶段 B 本地提交说明。 -## 阶段 C:局部爆炸源项快照和载荷候选筛选 +## 阶段 C:源项快照、目标筛选和多区域诊断 -- [x] 设计局部爆炸源项快照数据结构。 -- [x] 设计源粒子到结构粒子的邻域筛选规则。 -- [x] 设计载荷候选计数诊断。 -- [x] 设计载荷源相质量诊断。 -- [x] 设计载荷源相能量诊断。 -- [x] 设计载荷源相平均压力诊断。 -- [x] 设计局部爆炸区域内 Gas 体积诊断。 -- [x] 设计局部爆炸区域内 Explosive 反应进度诊断。 -- [x] 设计局部爆炸区域内 Water 压力范围诊断。 -- [x] 设计局部爆炸区域内结构目标数量诊断。 -- [x] 在显式步前刷新 Water 压力快照。 -- [x] 在显式步前刷新 Gas 压力快照。 -- [x] 在 Explosive 更新后刷新 Gas 源项贡献快照。 -- [x] 在载荷构造前刷新结构目标 active 状态。 -- [x] 对非 active 源粒子执行跳过规则。 -- [x] 对 failed 结构粒子执行受控跳过或保留规则。 -- [x] 对非目标 set 结构粒子执行跳过规则。 -- [x] 对局部爆炸区域外源粒子执行跳过规则。 -- [x] 对局部爆炸区域外目标粒子执行跳过规则。 -- [x] 确认无源粒子时返回安全默认诊断。 -- [x] 确认无目标粒子时返回安全默认诊断。 -- [x] 确认 Water-only 模型不进入结构载荷路径。 -- [x] 确认 Gas-only 模型不进入结构载荷路径。 -- [x] 确认 Explosive-only 模型不进入结构载荷路径。 -- [x] 确认 Solid-only 模型不读取 Gas 源项。 -- [x] 确认 Shell-only 模型不读取 Gas 源项。 -- [x] 新增 `blast_source_snapshot` 测试。 -- [x] 新增 `blast_target_filter` 测试。 -- [x] 将源项快照测试接入 CTest。 -- [x] 准备阶段 C 本地提交说明。 +- [ ] 复核现有 blast source snapshot 数据结构。 +- [ ] 确认 source snapshot 按 region 独立刷新。 +- [ ] 统计每个 region 内 active Water 源粒子数量。 +- [ ] 统计每个 region 内 active Gas 源粒子数量。 +- [ ] 统计每个 region 内 active Explosive 源粒子数量。 +- [ ] 统计每个 region 内源粒子总质量。 +- [ ] 统计每个 region 内源粒子总能量。 +- [ ] 统计每个 region 内 Water 压力范围。 +- [ ] 统计每个 region 内 Gas 总体积。 +- [ ] 统计每个 region 内 Explosive 平均反应进度。 +- [ ] 对 region 外源粒子执行跳过计数。 +- [ ] 对非 active 源粒子执行跳过计数。 +- [ ] 对不匹配 source phase 的粒子执行跳过计数。 +- [ ] 确认无源粒子时返回安全默认诊断。 +- [ ] 复核现有 blast target 筛选规则。 +- [ ] 确认 target 筛选按 region 独立执行。 +- [ ] 按 target set 筛选结构粒子。 +- [ ] 按 target phase 筛选 Solid 和 Shell 粒子。 +- [ ] 跳过 failed Solid 目标并记录计数。 +- [ ] 跳过 failed Shell 目标并记录计数。 +- [ ] 确认无目标粒子时返回安全默认诊断。 +- [ ] 新增 `blast_multiregion_snapshot` 测试。 +- [ ] 新增 `blast_multiregion_target_filter` 测试。 +- [ ] 将源项和目标筛选测试接入 CTest。 +- [ ] 准备阶段 C 本地提交说明。 -## 阶段 D:结构外载荷缓存、投影和守恒诊断 +## 阶段 D:结构载荷缓存、叠加和守恒诊断 -- [x] 设计结构外载荷缓存数组布局。 -- [x] 设计 Solid 外载荷缓存字段。 -- [x] 设计 Shell 外载荷缓存字段。 -- [x] 设计载荷投影的方向约定。 -- [x] 设计载荷投影的权重归一化约定。 -- [x] 设计压力到力的面积或体积尺度约定。 -- [x] 设计载荷做功诊断。 -- [x] 设计载荷冲量诊断。 -- [x] 设计载荷动量输入诊断。 -- [x] 设计载荷能量输入诊断。 -- [x] 初始化结构外载荷缓存默认值。 -- [x] 在每个显式步开始前清零结构外载荷缓存。 -- [x] 将局部 Water 压力贡献映射到候选结构目标。 -- [x] 将局部 Gas 压力贡献映射到候选结构目标。 -- [x] 将 Explosive release 诊断贡献映射到载荷统计。 -- [x] 对 Solid 目标累加外力贡献。 -- [x] 对 Shell 目标累加外力贡献。 -- [x] 对 Shell 目标累加等效外力矩占位诊断。 -- [x] 对权重和为零的候选对报 warning 或跳过。 -- [x] 检查外载荷有限性。 -- [x] 检查外载荷缓存不污染 Water 粒子。 -- [x] 检查外载荷缓存不污染 Gas 粒子。 -- [x] 检查外载荷缓存不污染 Explosive 粒子。 -- [x] 检查 Solid/Shell 目标之间载荷隔离。 -- [x] 检查无 active 结构目标时载荷统计为零。 -- [x] 检查无局部爆炸源时载荷统计为零。 -- [x] 新增 `blast_load_accumulator` 测试。 -- [x] 新增 `blast_load_conservation` 测试。 -- [x] 将结构外载荷测试接入 CTest。 -- [x] 准备阶段 D 本地提交说明。 +- [ ] 复核现有 Solid 外载荷缓存数组布局。 +- [ ] 复核现有 Shell 外载荷缓存数组布局。 +- [ ] 确认每个显式步开始前清零 blast 外载荷缓存。 +- [ ] 确认禁用 blast load 时缓存保持零值。 +- [ ] 支持多个 blast region 对同一 Solid 目标载荷叠加。 +- [ ] 支持多个 blast region 对同一 Shell 目标载荷叠加。 +- [ ] 保持 Solid 和 Shell 外载荷缓存相互隔离。 +- [ ] 保持 Water 粒子不被结构外载荷缓存污染。 +- [ ] 保持 Gas 粒子不被结构外载荷缓存污染。 +- [ ] 保持 Explosive 粒子不被结构外载荷缓存污染。 +- [ ] 统一距离权重归一化的零分母处理。 +- [ ] 统一非有限载荷贡献的跳过处理。 +- [ ] 记录每个 region 的载荷目标数。 +- [ ] 记录每个 region 的载荷 pair 数。 +- [ ] 记录每个 region 的零权重 pair 数。 +- [ ] 记录每个 region 的非有限贡献数。 +- [ ] 记录每个 region 的总力。 +- [ ] 记录每个 region 的 Solid 分力。 +- [ ] 记录每个 region 的 Shell 分力。 +- [ ] 记录每个 region 的冲量累计。 +- [ ] 记录每个 region 的做功累计。 +- [ ] 记录每个 region 的最大粒子力。 +- [ ] 新增 `blast_load_superposition` 测试。 +- [ ] 新增 `blast_load_diagnostics_071` 测试。 +- [ ] 将结构载荷稳定化测试接入 CTest。 +- [ ] 准备阶段 D 本地提交说明。 -## 阶段 E:显式推进接入、Solid/Shell 响应和隔离规则 +## 阶段 E:Velocity-Verlet 接入、时间窗和响应回归 -- [x] 设计局部爆炸载荷在 Velocity-Verlet 中的调用顺序。 -- [x] 确认 Explosive 更新早于爆炸载荷投影。 -- [x] 确认 Gas 源项应用早于结构载荷诊断。 -- [x] 确认 Water/Gas 压力更新早于结构载荷投影。 -- [x] 将 Solid 外载荷并入 Solid 加速度或外力入口。 -- [x] 将 Shell 外载荷并入 Shell 受控外力入口。 -- [x] 对尚未完成的 Shell 内力路径保持受控 no-op 或诊断占位。 -- [x] 确认 Shell 外载荷不宣称完整 Shell 动力学闭环。 -- [x] 确认 Solid 外载荷不改变既有 Solid-only gate 结果。 -- [x] 确认 Shell 外载荷不改变既有 Shell 运动学 gate 结果。 -- [x] 确认 Water-only 显式步结果保持稳定。 -- [x] 确认 Gas-only 显式步结果保持稳定。 -- [x] 确认 Explosive-Gas 显式步结果保持稳定。 -- [x] 确认 Solid-only 显式步结果保持稳定。 -- [x] 确认无载荷控制时完整显式步行为不变。 -- [x] 添加局部爆炸载荷启用开关。 -- [x] 添加局部爆炸载荷禁用路径测试。 -- [x] 添加单步载荷施加测试。 -- [x] 添加多步载荷累积测试。 -- [x] 添加载荷时间窗口结束后清零测试。 -- [x] 添加结构加速度方向检查测试。 -- [x] 添加 Shell director 不被外载荷路径非法修改的测试。 -- [x] 添加 failed Solid 目标处理测试。 -- [x] 添加 failed Shell 目标处理测试。 -- [x] 新增 `blast_solver_order` 测试。 -- [x] 新增 `blast_solid_response` 测试。 -- [x] 新增 `blast_shell_response` 测试。 -- [x] 新增 `blast_noop_regression` 测试。 -- [x] 将显式推进接入测试接入 CTest。 -- [x] 准备阶段 E 本地提交说明。 +- [ ] 复核 blast load 在 Velocity-Verlet 显式步中的调用顺序。 +- [ ] 确认 Explosive 更新早于 blast source snapshot。 +- [ ] 确认 Gas 源项应用早于结构载荷投影。 +- [ ] 确认 Water 压力更新早于结构载荷投影。 +- [ ] 确认 Gas 压力更新早于结构载荷投影。 +- [ ] 确认 blast load 只在时间窗内生效。 +- [ ] 确认时间窗结束后外载荷缓存清零。 +- [ ] 确认禁用 blast load 时完整显式步保持 no-op。 +- [ ] 将 Solid blast 外载荷并入 Solid 加速度路径。 +- [ ] 保持 Solid-only 无 blast 输入回归结果不变。 +- [ ] 将 Shell blast 平动外载荷并入 Shell 受控入口。 +- [ ] 保持 Shell director 不被 blast 外载荷非法修改。 +- [ ] 保持 Shell 内力路径仍不宣称完整闭环。 +- [ ] 验证 Solid/Shell 混合目标的载荷隔离。 +- [ ] 验证多个 region 叠加后的 Solid 响应方向。 +- [ ] 验证多个 region 叠加后的 Shell 响应方向。 +- [ ] 验证 failed Solid 目标不产生响应。 +- [ ] 验证 failed Shell 目标不产生响应。 +- [ ] 验证 Water-only 模型不进入结构载荷路径。 +- [ ] 验证 Gas-only 模型不进入结构载荷路径。 +- [ ] 验证 Explosive-only 模型不进入结构载荷路径。 +- [ ] 新增 `blast_solver_order_071` 测试。 +- [ ] 新增 `blast_response_multiregion` 测试。 +- [ ] 新增 `blast_noop_regression_071` 测试。 +- [ ] 将显式推进回归测试接入 CTest。 +- [ ] 准备阶段 E 本地提交说明。 -## 阶段 F:诊断、输出、restart 占位和公开接口边界 +## 阶段 F:输出、restart 边界和公开接口策略 -- [x] 设计 0.7.0 局部爆炸 summary 诊断结构。 -- [x] 记录局部爆炸区域 active 源粒子数。 -- [x] 记录局部爆炸区域 active 目标粒子数。 -- [x] 记录 Water 压力贡献统计。 -- [x] 记录 Gas 压力贡献统计。 -- [x] 记录 Explosive release 贡献统计。 -- [x] 记录 Solid 接收总载荷。 -- [x] 记录 Shell 接收总载荷。 -- [x] 记录结构载荷总冲量。 -- [x] 记录结构载荷总做功。 -- [x] 记录结构载荷最大粒子力。 -- [x] 记录结构载荷最大粒子加速度贡献。 -- [x] 记录被跳过源粒子数量。 -- [x] 记录被跳过目标粒子数量。 -- [x] 设计 summary CSV 的 0.7.0 调试字段。 -- [x] 将局部爆炸 summary 写入 summary CSV。 -- [x] 设计粒子 CSV 的 0.7.0 调试字段。 -- [x] 将结构外载荷字段写入粒子 CSV。 -- [x] 确认默认输出不开启时不生成临时结果。 -- [x] 设计 restart 中 0.7.0 状态边界。 -- [x] 明确 0.7.0 是否写入正式 `STATE_0_7`。 -- [x] 若写入 restart,保存局部爆炸控制和诊断状态(0.7.0 已决策不写入)。 -- [x] 若不写入 restart,在文档中明确为非交付范围。 -- [x] 保持 0.6.1 restart 兼容读入路径稳定。 -- [x] 设计 Fortran 内部诊断查询入口。 -- [x] 明确 C ABI 是否暴露 0.7.0 调试字段。 -- [x] 若暴露 C ABI,补齐小容量和空指针错误路径(0.7.0 已决策不暴露)。 -- [x] 若不暴露 C ABI,在文档中明确为非交付范围。 -- [x] 新增 `blast_summary` 测试。 -- [x] 新增 `blast_output` 测试。 -- [x] 新增 `blast_restart_boundary` 测试。 -- [x] 将诊断输出测试接入 CTest。 -- [x] 准备阶段 F 本地提交说明。 +- [ ] 复核 0.7.0 summary CSV blast 字段。 +- [ ] 扩展 summary CSV 的多 region 输出规则。 +- [ ] 保持单 region summary CSV 字段兼容。 +- [ ] 为多 region 输出记录 region 数量。 +- [ ] 为多 region 输出记录每个 region 的源粒子数量。 +- [ ] 为多 region 输出记录每个 region 的目标粒子数量。 +- [ ] 为多 region 输出记录每个 region 的总力。 +- [ ] 为多 region 输出记录每个 region 的能量输入。 +- [ ] 为多 region 输出记录每个 region 的跳过计数。 +- [ ] 复核 particle CSV blast 外载荷字段。 +- [ ] 确认 particle CSV 输出叠加后的粒子外载荷。 +- [ ] 确认默认未开启输出时不生成临时结果文件。 +- [ ] 明确 0.7.1 是否新增正式 blast restart state。 +- [ ] 若不新增正式 state,保持 `STATE_0_7` 未冻结边界并补充测试。 +- [ ] 若新增正式 state,保存 blast 控制、诊断和外载荷缓存。 +- [ ] 若新增正式 state,验证读回后继续显式步一致。 +- [ ] 保持既有 restart 兼容读入路径稳定。 +- [ ] 明确 0.7.1 不新增公开 C ABI blast 稳定接口。 +- [ ] 明确 0.7.1 不新增 C++ wrapper blast 稳定接口。 +- [ ] 明确 0.7.1 不新增 Python blast 稳定接口。 +- [ ] 保留 Fortran 内部 blast summary 查询入口。 +- [ ] 新增 `blast_output_071` 测试。 +- [ ] 新增 `blast_restart_boundary_071` 或 `blast_restart_071` 测试。 +- [ ] 将输出和 restart 测试接入 CTest。 +- [ ] 准备阶段 F 本地提交说明。 -## 阶段 G:局部爆炸 smoke、回归 gate 和文档发布准备 +## 阶段 G:smoke、门禁、文档和发布准备 -- [x] 设计 0.7.0 局部爆炸 smoke 的最小物理链路。 -- [x] 设计 Water/Gas/Explosive/Solid smoke 验收指标。 -- [x] 设计 Water/Gas/Explosive/Shell smoke 验收指标。 -- [x] 设计 Water/Gas/Explosive/Solid/Shell smoke 验收指标。 -- [x] 实现单步局部爆炸 smoke 测试。 -- [x] 实现多步局部爆炸 smoke 测试。 -- [x] 检查 smoke 中 Gas 体积或压力统计方向。 -- [x] 检查 smoke 中 Explosive 反应进度单调性。 -- [x] 检查 smoke 中 Solid/Shell 载荷方向。 -- [x] 检查 smoke 中载荷冲量非负或受控。 -- [x] 检查 smoke 中能量诊断有限性。 -- [x] 检查 smoke 中所有粒子状态有限性。 -- [x] 运行 Water 回归 gate。 -- [x] 运行 Gas 回归 gate。 -- [x] 运行 Explosive 回归 gate。 -- [x] 运行 Solid 回归 gate。 -- [x] 运行 Shell 0.6.1 回归 gate。 -- [x] 运行 CouplingInterface 回归 gate。 -- [x] 运行 output 回归 gate。 -- [x] 运行 restart 回归 gate。 -- [x] 运行完整 CTest。 -- [x] 运行 0.7.0 局部爆炸专项 gate。 -- [x] 运行 source size 相关 gate。 -- [x] 运行 `git diff --check`。 -- [x] 更新 README 中 0.7.0 当前状态和不交付范围。 -- [x] 更新 `docs/06_test_and_verification_plan.md` 的 0.7.0 release gate。 -- [x] 更新 `docs/09_release_history.md` 的 0.7.0 本地验收记录。 -- [x] 更新 `docs/11_benchmark_matrix.md` 的 0.7.0 gate 矩阵。 -- [x] 确认文档不宣称工程级水下接触爆炸响应。 -- [x] 确认文档不宣称真实 FEM-SPH 联合运行。 -- [x] 确认文档不宣称完整舱段破坏 benchmark。 -- [x] 确认输出目录、CSV、VTK、restart 和临时结果未提交。 -- [x] 确认代码、构建脚本、测试和工具目录未新增 FEMLite 直接依赖。 -- [x] 准备 0.7.0 发布提交说明。 +- [ ] 设计 0.7.1 多 region 局部爆炸 smoke 样例。 +- [ ] 新增 Solid 多 region blast smoke 输入样例。 +- [ ] 新增 Shell 多 region blast smoke 输入样例。 +- [ ] 新增 Solid/Shell 混合多 region blast smoke 输入样例。 +- [ ] 新增禁用 blast load 的 smoke 回归样例。 +- [ ] 新增空 target set 或无 active target 的 smoke 样例。 +- [ ] 验证 smoke 中所有粒子状态保持有限。 +- [ ] 验证 smoke 中 Explosive 反应进度单调或受控。 +- [ ] 验证 smoke 中 Gas 体积和压力诊断方向受控。 +- [ ] 验证 smoke 中 Solid/Shell 载荷方向受控。 +- [ ] 验证 smoke 中冲量和能量诊断为有限值。 +- [ ] 新增 `blast_smoke_071` 测试。 +- [ ] 运行 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 和临时结果未被提交。 +- [ ] 更新 `docs/06_test_and_verification_plan.md` 的 0.7.1 release gate。 +- [ ] 更新 `docs/09_release_history.md` 的 0.7.1 本地验收记录。 +- [ ] 更新 `docs/11_benchmark_matrix.md` 的 0.7.1 gate 矩阵。 +- [ ] 更新 README 的 0.7.1 当前状态和不交付范围。 +- [ ] 确认文档不宣称真实 FEM-SPH 联合运行。 +- [ ] 确认文档不宣称工程级船舱破坏 benchmark。 +- [ ] 准备 0.7.1 发布提交说明。 +- [ ] 准备阶段 G 本地提交说明。 diff --git a/tools/testing/test_cli.py b/tools/testing/test_cli.py index 0dcda22..f3adc87 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.0" not in version.stdout: + if "0.7.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.7.0": + if inspect_fields["version"] != "0.7.1": raise AssertionError("inspect version field mismatch") if Path(inspect_fields["input"]) != Path(model): raise AssertionError("inspect input field mismatch") diff --git a/tools/testing/test_python_debug.py b/tools/testing/test_python_debug.py index f986b45..ec10900 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, 0): + if solver.version() != (0, 7, 1): raise AssertionError("Python version mismatch") solver.initialize()