diff --git a/docs/09_release_history.md b/docs/09_release_history.md index 5ac4bbe..2a7fa7c 100644 --- a/docs/09_release_history.md +++ b/docs/09_release_history.md @@ -127,7 +127,36 @@ cmake --build build-codex-unix - 0.2.2 不交付 `Gas`、`Explosive`、`Solid`、`Shell` 生产路径。 - 0.2.2 不交付真实 FEM-SPH 联合运行;CouplingInterface 仍为中立 Fortran 模块级占位,不暴露 C ABI coupling 接口。 - 0.2.2 不新增几何、网格或粒子生成能力。 -- 0.2.2 release gate 结果将在本版本完成时记录。 +- 0.2.2 release gate 已通过:默认 gate 17/17 通过,`source_size` 1/1 通过,`git diff --check` 通过。 + +验收结果: + +- `cmake -S . -B build-codex-unix -G "Unix Makefiles" -DCMAKE_C_COMPILER=C:/gcc-16.1.0-64/bin/gcc.exe -DCMAKE_CXX_COMPILER=C:/gcc-16.1.0-64/bin/g++.exe -DCMAKE_Fortran_COMPILER=C:/gcc-16.1.0-64/bin/gfortran.exe -DCMAKE_MAKE_PROGRAM=C:/gcc-16.1.0-64/bin/make.exe` 通过。 +- `cmake --build build-codex-unix --parallel` 通过。 +- `ctest --test-dir build-codex-unix -R "^(smoke|input|kernel|neighbor|water_eos|water_density|water_viscosity|water_force|solver_water|output|restart|coupling_interface|c_api|cpp_api|python_debug|cli|pressure_wave_smoke)$" --output-on-failure` 通过:17/17。 +- `ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure` 通过:1/1。 +- `git diff --check` 通过。 + +实际修复和整理: + +- 软件版本、CMake 项目版本、CLI/API 测试期望统一更新为 0.2.2。 +- README、09 和 11 号文档记录 0.2.2 稳定化补丁定位。 +- 04 号算法文档明确 0.2.2 继续沿用 0.2.1 的 Water 连续性方程、Tait EOS、负压保留和无空化修正策略。 +- CouplingInterface 中陈旧的 0.1.1 占位错误信息改为中立表述。 +- 新增 `docs/v3.0_gas_handoff.md`,作为 0.3.0 Gas 输入、状态、EOS 测试命名和 Bubble 长期路线入口。 + +剩余风险和限制: + +- 0.2.2 仍不交付 `Gas`、`Explosive`、`Solid`、`Shell` 生产路径。 +- 0.2.2 仍不交付真实 FEM-SPH 联合运行。 +- CouplingInterface 仍不暴露 C ABI coupling 接口。 +- VTK 输出仍不进入默认 gate;0.2.2 默认输出为 CSV 和 summary CSV。 +- pressure wave smoke 仍只用于小规模链路检查,不作为工程精度 benchmark。 + +发布建议: + +- 建议发布 0.2.2 作为 Water 阶段稳定化补丁版本。 +- 0.2.2 发布后,后续主线建议进入 0.3.0 Gas 开发。 后续每个版本应记录: diff --git a/docs/11_benchmark_matrix.md b/docs/11_benchmark_matrix.md index 0c7b37c..1fefa99 100644 --- a/docs/11_benchmark_matrix.md +++ b/docs/11_benchmark_matrix.md @@ -138,7 +138,7 @@ | 日期 | 构建目录 | 结果 | |---|---|---| -| 2026-07-03 | `build-codex-unix` | 待最终 gate 回填 | +| 2026-07-03 | `build-codex-unix` | 0.2.2 gate 17/17 通过,`source_size` 1/1 通过,`git diff --check` 通过 | ## 3. 基础数值矩阵 diff --git a/docs/README.md b/docs/README.md index 2e486f8..18536a2 100644 --- a/docs/README.md +++ b/docs/README.md @@ -17,6 +17,7 @@ SPHLite 文档结构仿照 FEMLite,采用 01-11 固定编号文件维护需求 | [09 版本历史与验收记录](09_release_history.md) | 版本目标、完成状态和验收证据 | | [10 后续开发路线图](10_development_roadmap.md) | 阶段计划、优先级和延期能力 | | [11 Benchmark 与验收矩阵](11_benchmark_matrix.md) | 代表算例、验收指标和默认/非默认 gate | +| [0.3.0 Gas 交接入口](v3.0_gas_handoff.md) | Gas 输入、状态、EOS 测试命名和 Bubble 长期路线入口 | ## 当前讨论重点 diff --git a/docs/v3.0_gas_handoff.md b/docs/v3.0_gas_handoff.md new file mode 100644 index 0000000..2ea0869 --- /dev/null +++ b/docs/v3.0_gas_handoff.md @@ -0,0 +1,101 @@ +# SPHLite 0.3.0 Gas 交接入口 + +文档状态:0.2.2 交接记录 + +本文档只为 0.3.0 `Gas` 开发提供入口,不代表 0.2.2 已实现 Gas 生产求解路径。 + +## 1. 输入关键词草案入口 + +0.3.0 应继续使用 Abaqus `.inp` 明确子集,能复用 Abaqus 关键词时不新增关键词。 + +建议优先讨论以下输入入口: + +- `*MATERIAL, NAME=..., TYPE=GAS` +- `*DENSITY` +- `*SECTION, ELSET=..., MATERIAL=...` +- `*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=..., RHO0=..., GAMMA=..., P0=...` +- `*SPHLITE EOS, TYPE=STIFFENED_GAS, MATERIAL=..., RHO0=..., C0=..., GAMMA=..., P0=...` +- `*SPHLITE EOS, TYPE=JWL, MATERIAL=..., A=..., B=..., R1=..., R2=..., OMEGA=..., E0=...` +- `*SPHLITE PARTICLE CONTROL, H=..., MASS=..., VOLUME=...` +- `*SPHLITE BODY FORCE, X=..., Y=..., Z=...` +- `*SPHLITE TIME CONTROL, DT=..., TIME=..., STEPS=..., SAFETY=...` + +若 Gas 需要温度或内能初值,应优先复用通用粒子状态或材料参数,不急于新增生成器式关键词。 + +## 2. 状态变量清单入口 + +Gas 应共享集中型粒子数据库中的通用状态: + +- `particle_id_ext` +- `particle_phase` +- `particle_status` +- `material_id` +- `section_id` +- `x0` +- `x` +- `v` +- `a` +- `vhalf` +- `mass` +- `rho` +- `volume` +- `pressure` +- `internal_energy` +- `temperature` +- `h` + +Gas 模块内部可规划以下派生状态或诊断: + +- Gas EOS 参数。 +- Gas 粒子数量、质量、动量、体积和压力范围。 +- 气团或气泡诊断的中心、等效半径、体积和脉动量。 +- JWL 或其他爆轰产物气体所需的能量状态。 +- 与 Explosive 质量/能量注入相关的累计诊断量。 + +## 3. EOS 测试命名入口 + +0.3.0 默认 gate 可从小型单元测试开始,建议命名为: + +- `gas_eos_ideal` +- `gas_eos_stiffened` +- `gas_eos_jwl` +- `gas_state` +- `gas_summary` +- `solver_gas` +- `gas_output` +- `gas_restart` +- `input_gas` + +这些测试只应验证小规模可重复数值链路,不应提前升级为工程 benchmark。 + +## 4. Water 与 Gas 边界 + +Water 与 Gas 共享基础粒子数据,但计算路径应保持独立: + +- Water 粒子继续由 `SPH_PHASE_WATER` 和 Water material 识别。 +- Gas 粒子应由 `SPH_PHASE_GAS` 和 Gas material 识别。 +- Water EOS、密度连续性方程、人工黏性和压力力不应读取 Gas 专属状态。 +- Gas EOS 和气团诊断不应改变 Water 求解路径。 +- phase 改变可以规划,但 0.3.0 初期应先实现稳定的 Gas 单相闭环。 + +## 5. Explosive 到 Gas 的长期路线 + +长期路线应保持“Explosive 作用到 Gas 后形成 Bubble”的设计: + +- `Explosive` 表示点火、反应进度和能量释放。 +- `Gas` 表示爆轰产物气体、舱内空气、空泡和混合气体。 +- Explosive 不通过预设球面模型直接制造气泡几何。 +- Explosive 应向 Gas 注入质量、动量或内能,由 Gas EOS 和流动计算形成气泡产生与脉动。 +- Bubble 应作为 Gas 的诊断结果或气团统计结果,而不是独立取代 Gas 的基础模块。 + +## 6. 0.3.0 最小启动建议 + +建议 0.3.0 从以下最小闭环开始: + +1. 解析 `TYPE=GAS` material 和 Gas EOS。 +2. 建立 Gas 粒子的 phase、压力和内能初始化。 +3. 实现一个最小 Gas EOS 单元测试。 +4. 实现 Gas summary。 +5. 将 Gas 状态写入 CSV 和 restart。 +6. 保持 Water gate 全部通过。 + diff --git a/todo.md b/todo.md index df6e0c8..c4abb42 100644 --- a/todo.md +++ b/todo.md @@ -135,14 +135,14 @@ - [x] 确认没有提交 Python 缓存。 - [x] 确认没有提交 CSV 临时结果。 - [x] 确认没有提交 restart 临时结果。 -- [ ] 确认没有提交 VTK 临时结果。 -- [ ] 记录 0.2.2 release gate 结果。 -- [ ] 记录 0.2.2 中实际修复的问题列表。 -- [ ] 记录 0.2.2 中未修复但可接受的剩余风险。 -- [ ] 整理 0.3.0 Gas 输入关键词草案入口。 -- [ ] 整理 0.3.0 Gas 状态变量清单入口。 -- [ ] 整理 0.3.0 Gas EOS 测试命名入口。 -- [ ] 整理 Water 与 Gas 共享数据但独立计算的边界说明。 -- [ ] 整理 Explosive 作用到 Gas 后形成 Bubble 的长期路线说明。 -- [ ] 给出 0.2.2 是否发布或跳过的最终建议。 -- [ ] 确认工作区只保留应提交的 0.2.2 变更。 +- [x] 确认没有提交 VTK 临时结果。 +- [x] 记录 0.2.2 release gate 结果。 +- [x] 记录 0.2.2 中实际修复的问题列表。 +- [x] 记录 0.2.2 中未修复但可接受的剩余风险。 +- [x] 整理 0.3.0 Gas 输入关键词草案入口。 +- [x] 整理 0.3.0 Gas 状态变量清单入口。 +- [x] 整理 0.3.0 Gas EOS 测试命名入口。 +- [x] 整理 Water 与 Gas 共享数据但独立计算的边界说明。 +- [x] 整理 Explosive 作用到 Gas 后形成 Bubble 的长期路线说明。 +- [x] 给出 0.2.2 是否发布或跳过的最终建议。 +- [x] 确认工作区只保留应提交的 0.2.2 变更。