Finalize 0.2.2 handoff records

This commit is contained in:
Codex
2026-07-03 08:45:16 +08:00
parent 3ff6488864
commit 1952fb9c21
5 changed files with 144 additions and 13 deletions
+30 -1
View File
@@ -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 开发。
后续每个版本应记录:
+1 -1
View File
@@ -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. 基础数值矩阵
+1
View File
@@ -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 长期路线入口 |
## 当前讨论重点
+101
View File
@@ -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 全部通过。
+11 -11
View File
@@ -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 变更。