From 44c0a1e144d33d43719b83b26b1e8e93c1c53895 Mon Sep 17 00:00:00 2001 From: Codex Date: Fri, 3 Jul 2026 09:08:36 +0800 Subject: [PATCH] Start 0.3.0 Gas development --- CMakeLists.txt | 2 +- README.md | 9 +- docs/v3.0_development_plan.md | 429 ++++++++++++++++++ src/core/sph_precision.f90 | 4 +- tests/data/gas_bad_eos_value_030.inp | 13 + tests/data/gas_ideal_minimal_030.inp | 19 + tests/data/gas_jwl_minimal_030.inp | 19 + tests/data/gas_missing_density_030.inp | 11 + tests/data/gas_missing_eos_030.inp | 12 + tests/data/gas_missing_eos_material_030.inp | 13 + tests/data/gas_missing_eos_type_030.inp | 13 + tests/data/gas_stiffened_minimal_030.inp | 19 + .../data/gas_unknown_sphlite_warning_030.inp | 16 + tests/data/water_gas_mixed_030.inp | 27 ++ tests/interface/test_c_api.c | 2 +- tests/interface/test_cpp_api.cpp | 2 +- tests/unit/test_smoke.f90 | 2 +- todo.md | 315 ++++++++----- tools/testing/test_cli.py | 4 +- tools/testing/test_python_debug.py | 2 +- 20 files changed, 797 insertions(+), 136 deletions(-) create mode 100644 docs/v3.0_development_plan.md create mode 100644 tests/data/gas_bad_eos_value_030.inp create mode 100644 tests/data/gas_ideal_minimal_030.inp create mode 100644 tests/data/gas_jwl_minimal_030.inp create mode 100644 tests/data/gas_missing_density_030.inp create mode 100644 tests/data/gas_missing_eos_030.inp create mode 100644 tests/data/gas_missing_eos_material_030.inp create mode 100644 tests/data/gas_missing_eos_type_030.inp create mode 100644 tests/data/gas_stiffened_minimal_030.inp create mode 100644 tests/data/gas_unknown_sphlite_warning_030.inp create mode 100644 tests/data/water_gas_mixed_030.inp diff --git a/CMakeLists.txt b/CMakeLists.txt index 58fcb9e..196fd72 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,6 +1,6 @@ cmake_minimum_required(VERSION 3.20) -project(SPHLite VERSION 0.2.2 LANGUAGES C CXX Fortran) +project(SPHLite VERSION 0.3.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 658ebc3..4e5eb50 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。 -当前目标版本:0.2.2。该版本定位为 `Water` 基础 SPH 稳定化补丁版,在 0.2.1 加固基线基础上复核版本发布、输入解析、粒子状态一致性、Water 数值行为、显式推进、CSV 输出、restart、CLI/API、CouplingInterface 边界和 release gate。不交付 `Gas`、`Explosive`、`Solid`、`Shell` 的生产路径,也不交付真实 FEM-SPH 联合运行。 +当前目标版本:0.3.0。该版本定位为 `Gas` 模块第一个正式开发版本,在 0.2.2 `Water` 稳定化基线之上建立气体输入、状态、EOS、显式推进、诊断、CSV 输出、restart 和接口最小闭环。不交付 `Explosive`、`Solid`、`Shell` 的生产路径,也不交付真实 FEM-SPH 联合运行。 代码仓库地址: @@ -63,13 +63,14 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: ## 当前状态 -0.2.2 当前实现重点包括: +0.3.0 当前开发重点包括: - CMake/CTest 工程骨架和 Fortran 95 核心库。 - C ABI、C++ 头文件薄包装和 Python `ctypes` 调试入口。 - Abaqus `.inp` 明确子集解析,以及 `*SPHLITE EOS`、`*SPHLITE VISCOSITY`、`*SPHLITE PARTICLE CONTROL`、`*SPHLITE BODY FORCE`。 - 3D Water 粒子的 Wendland/Cubic 核函数、uniform cell 邻域搜索、Tait EOS、Monaghan 人工黏性、连续性方程和 Velocity-Verlet 显式推进。 - Water summary、稳定时间步诊断、CSV output、restart 和双 pressure wave smoke 小算例。 +- Gas material、Gas EOS、气体 summary、bubble metrics、Gas CSV/restart 和公开诊断接口将作为 0.3.0 的新增闭环。 - CouplingInterface 的中立数据导出、外部粒子力导入和诊断占位;0.2.2 不暴露 CouplingInterface C ABI,真实 FEM-SPH 联合运行仍由外部 CouplingModule 后续实现。 -- `Gas`、`Explosive`、`Solid`、`Shell` 仍为后续阶段,不在 0.2.2 交付生产计算路径。 -- 0.2.2 release gate 与 source size 门禁。 +- `Explosive`、`Solid`、`Shell` 仍为后续阶段,不在 0.3.0 交付生产计算路径。 +- 0.3.0 release gate 与 source size 门禁。 diff --git a/docs/v3.0_development_plan.md b/docs/v3.0_development_plan.md new file mode 100644 index 0000000..2945e2d --- /dev/null +++ b/docs/v3.0_development_plan.md @@ -0,0 +1,429 @@ +# SPHLite v3.0 开发计划 + +文档状态:0.3.0 开发计划草案 + +目标软件版本:SPHLite 0.3.0 + +## 1. 文档定位 + +本文档用于规划 SPHLite 0.3.0 版本的开发范围。0.3.0 是 `Gas` 模块的第一个正式开发版本,目标是在 0.2.2 `Water` 稳定化基线之上,建立气体粒子的输入、状态、EOS、显式推进、诊断、输出、restart 和接口最小闭环。 + +0.3.0 不应演化为水下爆炸综合版本。爆炸点火、反应进度、向气体注入质量/能量、结构响应、板壳破裂和真实 FEM-SPH 联合运行仍属于后续版本。 + +## 2. 依据文件 + +本计划依据以下文件制定: + +- `README.md` +- `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` +- `docs/v2.2_development_plan.md` +- `docs/v3.0_gas_handoff.md` + +## 3. 版本定位 + +### 3.1 与 0.2.2 的关系 + +0.2.2 已完成 `Water` 阶段稳定化补丁,默认 gate、source size 和发布记录均已通过。0.3.0 应继承 0.2.2 的工程骨架、集中数据库、输入解析、邻域搜索、Velocity-Verlet 显式推进、CSV 输出、restart、C ABI、C++ wrapper、Python ctypes 和 CLI。 + +0.3.0 不应破坏 0.2.2 的 Water 行为。所有新增 Gas 能力必须与已有 Water gate 一起通过。 + +### 3.2 与 0.4 的关系 + +0.4 版本应作为 `Explosive` 模块开发起点。0.3.0 可以为 Explosive 到 Gas 的质量、动量和能量注入预留状态、接口和诊断字段,但不实现解析点火、爆轰传播、programmed burn 或炸药粒子反应。 + +## 4. 开发原则 + +### 4.1 保持模块边界 + +SPHLite 仍只修改本仓库内容,不修改 FEMLite 或其他外部模块。SPHLite 不直接依赖 FEMLite,也不直接依赖外部 CouplingModule、CoupleLite、CoupledLite 或 CouplingLite。 + +### 4.2 保持求解器定位 + +SPHLite 是求解器,不负责几何建模、网格生成或粒子生成。0.3.0 的 Gas 输入文件可由测试或示例脚本生成,但生成器不作为求解器功能宣传或交付。 + +### 4.3 保持 Fortran 95 核心 + +核心实现继续使用 Fortran 95,C ABI、C++ wrapper 和 Python ctypes 仍作为薄接口层。0.3.0 不引入破坏可移植性的第三方运行时依赖。 + +### 4.4 保持显式动力学路线 + +时间推进仍只支持显式动力学,主积分格式为 Velocity-Verlet。0.3.0 不引入隐式求解器、静力求解器或 Newmark 路线。 + +### 4.5 保持 Abaqus 子集策略 + +输入文件继续解析 SPHLite 支持的 Abaqus `.inp` 明确子集。不追求完整 Abaqus 兼容。能复用 Abaqus 关键词时不新增关键词;Abaqus 无法表达的能力使用 `*SPHLITE ...` 扩展关键词。 + +### 4.6 保持 Water 与 Gas 独立 + +Water 和 Gas 共享集中型粒子数据库,但计算路径保持独立。Gas 新增状态、EOS、诊断和测试不得改变 Water 的 Tait EOS、连续性方程、人工黏性、负压保留和 pressure wave smoke 行为。 + +## 5. 0.3.0 交付目标 + +0.3.0 建议交付以下内容: + +1. 将软件版本更新为 `0.3.0`。 +2. 解析 `TYPE=GAS` material 和 Gas 相关 `.inp` 输入。 +3. 建立 Gas 粒子的 phase、材料、密度、压力、内能、温度、质量、体积和光滑长度初始化路径。 +4. 实现 Gas EOS 的最小闭环:理想气体、JWL 和 Stiffened gas。 +5. 实现 Gas 单相显式推进最小路径,包括压力更新、密度变化率、压力力或等价加速度贡献。 +6. 实现 Gas summary,包括气体质量、体积、中心、动量、平均压力、最大压力、密度范围和稳定时间步诊断。 +7. 实现气泡诊断入口,包括等效气泡半径、半径变化率和中心迁移指标。 +8. 将 Gas 状态写入 CSV 输出和 restart,并可读回后继续显式步。 +9. 扩展 Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 的 Gas 诊断查询。 +10. 建立 Gas 默认 gate,同时保持 0.2.2 Water gate 全部通过。 +11. 更新 README、09 号发布记录和 11 号验收矩阵。 + +## 6. 非交付范围 + +0.3.0 不交付以下内容: + +1. 不实现 Explosive 的解析点火、爆轰传播或反应进度。 +2. 不实现 Explosive 向 Gas 的真实质量、动量和能量注入。 +3. 不实现生产级气泡多周期脉动 benchmark。 +4. 不实现复杂水-气界面重构、锐界面追踪、相变蒸发或多相 Riemann 通量。 +5. 不实现 Solid 的 Johnson-Cook 材料模型和失效模型。 +6. 不实现 Shell 的 Mindlin-Reissner 生产求解路径。 +7. 不实现真实 FEM-SPH 接触耦合或连续体耦合。 +8. 不暴露未冻结的 CouplingInterface C ABI。 +9. 不新增几何、网格或粒子生成能力。 +10. 不把测试 smoke 宣称为工程精度 benchmark。 + +## 7. 输入范围 + +### 7.1 复用 Abaqus 关键词 + +0.3.0 应继续复用以下 Abaqus 风格关键词: + +- `*NODE` +- `*ELEMENT` +- `*NSET` +- `*ELSET` +- `*MATERIAL` +- `*DENSITY` +- `*SECTION` 或已支持的 section 关键词 + +`Gas` 粒子类型通过 material 和 section 识别,set 仍只表示集合,不参与类型判断。 + +### 7.2 Gas 扩展关键词 + +建议 0.3.0 支持以下 `*SPHLITE` 扩展: + +```text +*MATERIAL, NAME=GAS_NAME, TYPE=GAS +*DENSITY +rho0 +*SECTION, ELSET=GAS_PARTICLES, MATERIAL=GAS_NAME +*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=GAS_NAME, GAMMA=..., E0=..., P0=... +*SPHLITE EOS, TYPE=JWL, MATERIAL=GAS_NAME, RHO0=..., A=..., B=..., R1=..., R2=..., OMEGA=..., E0=... +*SPHLITE EOS, TYPE=STIFFENED_GAS, MATERIAL=GAS_NAME, RHO0=..., GAMMA=..., E0=..., PINF=... +*SPHLITE PARTICLE CONTROL, H=..., MASS=..., VOLUME=... +*SPHLITE BODY FORCE, X=..., Y=..., Z=... +*SPHLITE TIME CONTROL, DT=..., TIME=..., STEPS=..., SAFETY=... +``` + +若字段缺失导致 Gas 无法运行,应报 error。不影响运行的未支持字段可 warning 后跳过。 + +### 7.3 EOS 字段策略 + +理想气体第一版建议采用内能形式: + +- `p = (gamma - 1) * rho * e + p0` +- `gamma > 1` +- `rho > 0` +- `e >= 0` + +JWL 第一版建议采用相对体积形式: + +- `V = rho0 / rho` +- `p = A * exp(-R1 * V) + B * exp(-R2 * V) + omega * e / V` +- `rho0 > 0` +- `A`、`B`、`R1`、`R2`、`omega` 和 `E0` 由输入给定并校验。 + +Stiffened gas 第一版建议采用内能形式,并在实现时锁定公式和字段命名。若实现过程中发现字段约定不足,应先补测试和文档,再进入默认 gate。 + +## 8. 数据库和 Gas 状态 + +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 material 名称和内部 id。 +- Gas EOS 类型。 +- 理想气体参数。 +- JWL 参数。 +- Stiffened gas 参数。 +- Gas 默认粒子控制参数。 +- Gas 外部体力。 +- Gas 质量、动量、体积、中心和压力诊断。 +- Gas 等效气泡半径、半径变化率和中心迁移诊断。 +- Gas 稳定时间步约束。 + +0.3.0 可以先不实现气体团簇连通分量算法。若不实现,等效气泡半径按所有 active Gas 粒子总体积计算,并在文档中说明这是单气团近似。 + +## 9. Gas 数值路径 + +### 9.1 Gas 压力更新 + +Gas 压力由 EOS 和当前密度、内能或温度状态更新。第一版应保证: + +- 非 Gas 粒子不被 Gas EOS 更新。 +- inactive 或 failed 粒子不参与 Gas 计算。 +- 非法密度、非法内能或非法 EOS 参数报 error。 +- 压力计算结果必须有限。 + +### 9.2 Gas 密度与动量更新 + +0.3.0 应建立 Gas 单相显式推进最小路径: + +- 使用已有邻域搜索和核函数。 +- 使用 phase 过滤,只处理 active Gas 粒子。 +- 密度变化率优先采用连续性方程路线。 +- 压力力使用与 Gas EOS 一致的压力状态。 +- 外部体力进入显式步加速度合成。 + +复杂水-气界面压力交换可以预留,但不作为 0.3.0 默认交付要求。若实现简单水-气相互作用,应进入独立 smoke,并不得破坏 Water 单相回归。 + +### 9.3 气泡诊断 + +0.3.0 的 Bubble 只作为 Gas 诊断,不作为独立模块。最小诊断包括: + +- Gas 总体积。 +- Gas 中心。 +- Gas 平均压力。 +- Gas 最大压力。 +- 等效气泡半径。 +- 等效半径变化率。 +- 中心迁移距离或中心速度。 + +等效半径可先按球体体积公式计算: + +```text +R_eq = (3 * V_gas / (4 * pi))^(1/3) +``` + +半径变化率可由当前和上一输出/上一时间步的等效半径差分得到。restart 应保存计算半径变化率所需的历史量。 + +## 10. 输出和 Restart + +### 10.1 输出 + +0.3.0 继续使用 CSV 和 summary CSV 作为默认 gate 输出。不要求新增 VTK 生产输出。 + +粒子 CSV 继续输出通用粒子字段。summary CSV 应新增或确认包含: + +- `gas_particles` +- `gas_mass` +- `gas_volume` +- `gas_center_x` +- `gas_center_y` +- `gas_center_z` +- `gas_mean_pressure` +- `gas_max_pressure` +- `gas_equivalent_radius` +- `gas_radius_rate` +- `gas_dtcrit` + +### 10.2 Restart + +restart 应保存 Gas 模块级状态,至少包括: + +- Gas EOS 类型和参数。 +- Gas 默认粒子控制参数。 +- Gas 外部体力。 +- Gas 诊断量。 +- 等效气泡半径历史量。 +- Gas 稳定时间步约束。 +- 粒子通用状态中的 pressure、internal_energy、temperature、rho、volume 和 h。 + +0.3.0 可以继续沿用当前 restart 文本格式,但必须更新状态版本策略或在发布记录中说明 `STATE_0_2` 是否仍适用于 0.3.0。若新增 Gas 状态导致旧格式不可兼容,应明确报 error,不静默读取错误状态。 + +## 11. API、C ABI、C++、Python 和 CLI + +### 11.1 Fortran API + +建议新增或完善: + +- `sph_get_gas_summary` +- `sph_get_gas_bubble_metrics` +- `sph_get_gas_dt_limits` + +### 11.2 C ABI + +建议实现 05 号文档中的 Gas 诊断接口: + +```c +int sphlite_get_gas_summary(double *volume, + double *center, + double *mean_pressure, + double *max_pressure); + +int sphlite_get_gas_bubble_metrics(double *equivalent_radius, + double *radius_rate, + double *center); +``` + +如需补充质量、动量或 dt 诊断,优先新增保持中立语义的 `sphlite_get_gas_dt_limits` 或扩展 Fortran/Python 调试接口,避免破坏已有 C ABI。 + +### 11.3 C++ wrapper + +C++ wrapper 继续作为 C ABI 薄包装,只增加轻量结构体和 RAII 使用示例,不重新定义 Gas 物理语义。 + +### 11.4 Python ctypes + +Python API 继续通过 C ABI 调用,用于: + +- Gas 输入 smoke。 +- Gas EOS 检查。 +- Gas summary 和 bubble metrics 读取。 +- CLI 输出 checker。 + +Python 不直接访问 Fortran 内部符号。 + +### 11.5 CLI + +CLI inspect、check 和 run 模式应增加 Gas 诊断字段。CLI 不应绕过公共生命周期接口。 + +建议 CLI 输出字段包括: + +- `gas_particles` +- `gas_volume` +- `gas_mean_pressure` +- `gas_max_pressure` +- `gas_equivalent_radius` +- `gas_dtcrit` + +## 12. 测试计划 + +### 12.1 新增 Gas 测试 + +建议新增以下测试: + +- `input_gas`:Gas material、Gas EOS、缺失字段、warning/error。 +- `gas_eos_ideal`:理想气体压力、非法参数和有限性。 +- `gas_eos_jwl`:JWL 压力、相对体积、非法参数和有限性。 +- `gas_eos_stiffened`:Stiffened gas 压力、非法参数和有限性。 +- `gas_state`:Gas phase、状态初始化、非 Gas 跳过。 +- `gas_summary`:质量、体积、中心、压力和等效半径。 +- `solver_gas`:Gas 单相显式步、dt 诊断和状态有限性。 +- `gas_output`:Gas summary CSV 字段。 +- `gas_restart`:Gas restart 写入、读回和继续显式步。 + +### 12.2 既有回归测试 + +0.3.0 必须继续通过 0.2.2 默认 gate: + +- `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` +- `source_size` + +### 12.3 建议 0.3.0 Release Gate + +建议 0.3.0 默认 gate 为: + +```powershell +ctest --test-dir build-codex-unix -R "^(smoke|input|input_gas|kernel|neighbor|water_eos|water_density|water_viscosity|water_force|solver_water|gas_eos_ideal|gas_eos_jwl|gas_eos_stiffened|gas_state|gas_summary|solver_gas|output|gas_output|restart|gas_restart|coupling_interface|c_api|cpp_api|python_debug|cli|pressure_wave_smoke)$" --output-on-failure +ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure +git diff --check +``` + +若实际测试名称在实现中调整,应同步更新 06、09、11 号文档。 + +## 13. 建议开发阶段 + +若后续根据本计划生成 `todo.md`,建议按以下阶段拆分: + +1. 0.3.0 版本号和基线确认。 +2. Gas 输入测试数据准备。 +3. Gas 输入解析和校验。 +4. Gas 数据库状态和模块初始化。 +5. 理想气体 EOS。 +6. JWL EOS。 +7. Stiffened gas EOS。 +8. Gas 压力更新和 summary。 +9. Gas 气泡诊断。 +10. Gas 单相显式推进。 +11. Gas 输出。 +12. Gas restart。 +13. Fortran API 和 C ABI。 +14. C++ wrapper、Python ctypes 和 CLI。 +15. Water 回归和 CouplingInterface 边界复核。 +16. source size 和 release gate。 +17. README、09 和 11 号文档同步。 + +## 14. 验收标准 + +0.3.0 应满足以下验收标准: + +1. 软件版本为 `0.3.0`。 +2. Gas material 和 Gas EOS 输入可解析、可校验、错误路径清晰。 +3. 理想气体、JWL 和 Stiffened gas EOS 单元测试通过。 +4. Gas 粒子可完成最小显式推进,状态保持有限。 +5. Gas summary 和 bubble metrics 可通过 Fortran API、C ABI、Python 或 CLI 查询。 +6. Gas 输出 CSV 和 summary CSV 字段可检查。 +7. Gas restart 可写入、读回,并继续显式步。 +8. 0.2.2 Water 默认 gate 继续通过。 +9. 默认 gate 和 source size 门禁通过。 +10. 文档不宣称 0.3.0 已实现 Explosive、Solid、Shell 或真实 FEM-SPH 耦合能力。 +11. 不新增 FEMLite 直接依赖。 +12. 不修改 SPHLite 文件夹之外的内容。 + +## 15. 风险与控制 + +| 风险 | 表现 | 控制方式 | +| --- | --- | --- | +| 0.3.0 范围膨胀 | 提前实现 Explosive、水气结构综合爆炸或 FEM-SPH 联合运行 | 将 0.3.0 限定为 Gas 最小闭环 | +| EOS 字段混乱 | JWL、理想气体和 Stiffened gas 参数命名不一致 | 先写输入测试和错误路径,再接入求解 | +| Water 行为漂移 | Gas 复用求解器时改变 Water 结果 | Water gate 与 Gas gate 一起运行 | +| restart 不完整 | Gas 历史诊断或 EOS 参数读回丢失 | Gas restart 测试覆盖写入、读回和继续步 | +| API 过早固化 | C ABI 暴露未稳定的 Gas 内部结构 | 只暴露 summary 和 bubble metrics 等稳定诊断 | +| 气泡诊断被误认为工程 benchmark | 等效半径小型 smoke 被过度解释 | 文档明确为单气团近似和小规模链路检查 | +| CouplingInterface 边界混乱 | 引入 FEMLite 内部结构或外部模块依赖 | 继续只保留中立接口概念 | + +## 16. 0.4.0 启动条件 + +满足以下条件后,可以启动 0.4.0 `Explosive`: + +1. 0.3.0 Gas EOS、summary、bubble metrics、output 和 restart 稳定。 +2. Gas 与 Water 的共享数据库和独立计算路径明确。 +3. Gas 可接收后续 Explosive 质量、动量和能量源项的状态入口。 +4. 默认 gate 可重复执行。 +5. 文档明确 Explosive 作用到 Gas 后形成 Bubble 的长期路线。 + diff --git a/src/core/sph_precision.f90 b/src/core/sph_precision.f90 index 2e9fd17..7a20fe8 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 = 2 - integer, parameter :: SPH_VERSION_PATCH = 2 + integer, parameter :: SPH_VERSION_MINOR = 3 + 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/data/gas_bad_eos_value_030.inp b/tests/data/gas_bad_eos_value_030.inp new file mode 100644 index 0000000..c378420 --- /dev/null +++ b/tests/data/gas_bad_eos_value_030.inp @@ -0,0 +1,13 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=GAS_PARTICLES +1 +*MATERIAL, NAME=GAS_AIR, TYPE=GAS +*DENSITY +1.2 +*SECTION, ELSET=GAS_PARTICLES, MATERIAL=GAS_AIR +*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=GAS_AIR, GAMMA=1.0, E0=2.0, P0=0.0 +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=0.01, VOLUME=0.008 +*SPHLITE TIME CONTROL, DT=1.0E-6, TIME=1.0E-6, STEPS=1, SAFETY=0.5 diff --git a/tests/data/gas_ideal_minimal_030.inp b/tests/data/gas_ideal_minimal_030.inp new file mode 100644 index 0000000..3cdf100 --- /dev/null +++ b/tests/data/gas_ideal_minimal_030.inp @@ -0,0 +1,19 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +4, 0.0, 0.0, 0.1 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=GAS_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=GAS_AIR, TYPE=GAS +*DENSITY +1.2 +*SECTION, ELSET=GAS_PARTICLES, MATERIAL=GAS_AIR +*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=GAS_AIR, GAMMA=1.4, E0=2.0, P0=0.0 +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=0.01, VOLUME=0.008 +*SPHLITE TIME CONTROL, DT=1.0E-6, TIME=2.0E-6, STEPS=2, SAFETY=0.5 diff --git a/tests/data/gas_jwl_minimal_030.inp b/tests/data/gas_jwl_minimal_030.inp new file mode 100644 index 0000000..a5c8847 --- /dev/null +++ b/tests/data/gas_jwl_minimal_030.inp @@ -0,0 +1,19 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +4, 0.0, 0.0, 0.1 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=GAS_PRODUCTS +1, 2, 3, 4 +*MATERIAL, NAME=GAS_PRODUCTS, TYPE=GAS +*DENSITY +1600.0 +*SECTION, ELSET=GAS_PRODUCTS, MATERIAL=GAS_PRODUCTS +*SPHLITE EOS, TYPE=JWL, MATERIAL=GAS_PRODUCTS, RHO0=1600.0, A=3.712E11, B=3.231E9, R1=4.15, R2=0.95, OMEGA=0.3, E0=4.2E6 +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=0.02, VOLUME=1.25E-5 +*SPHLITE TIME CONTROL, DT=1.0E-8, TIME=2.0E-8, STEPS=2, SAFETY=0.5 diff --git a/tests/data/gas_missing_density_030.inp b/tests/data/gas_missing_density_030.inp new file mode 100644 index 0000000..fa3356e --- /dev/null +++ b/tests/data/gas_missing_density_030.inp @@ -0,0 +1,11 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=GAS_PARTICLES +1 +*MATERIAL, NAME=GAS_AIR, TYPE=GAS +*SECTION, ELSET=GAS_PARTICLES, MATERIAL=GAS_AIR +*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=GAS_AIR, GAMMA=1.4, E0=2.0, P0=0.0 +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=0.01, VOLUME=0.008 +*SPHLITE TIME CONTROL, DT=1.0E-6, TIME=1.0E-6, STEPS=1, SAFETY=0.5 diff --git a/tests/data/gas_missing_eos_030.inp b/tests/data/gas_missing_eos_030.inp new file mode 100644 index 0000000..30d5bb8 --- /dev/null +++ b/tests/data/gas_missing_eos_030.inp @@ -0,0 +1,12 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=GAS_PARTICLES +1 +*MATERIAL, NAME=GAS_AIR, TYPE=GAS +*DENSITY +1.2 +*SECTION, ELSET=GAS_PARTICLES, MATERIAL=GAS_AIR +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=0.01, VOLUME=0.008 +*SPHLITE TIME CONTROL, DT=1.0E-6, TIME=1.0E-6, STEPS=1, SAFETY=0.5 diff --git a/tests/data/gas_missing_eos_material_030.inp b/tests/data/gas_missing_eos_material_030.inp new file mode 100644 index 0000000..5347585 --- /dev/null +++ b/tests/data/gas_missing_eos_material_030.inp @@ -0,0 +1,13 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=GAS_PARTICLES +1 +*MATERIAL, NAME=GAS_AIR, TYPE=GAS +*DENSITY +1.2 +*SECTION, ELSET=GAS_PARTICLES, MATERIAL=GAS_AIR +*SPHLITE EOS, TYPE=IDEAL_GAS, GAMMA=1.4, E0=2.0, P0=0.0 +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=0.01, VOLUME=0.008 +*SPHLITE TIME CONTROL, DT=1.0E-6, TIME=1.0E-6, STEPS=1, SAFETY=0.5 diff --git a/tests/data/gas_missing_eos_type_030.inp b/tests/data/gas_missing_eos_type_030.inp new file mode 100644 index 0000000..f9c479b --- /dev/null +++ b/tests/data/gas_missing_eos_type_030.inp @@ -0,0 +1,13 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=GAS_PARTICLES +1 +*MATERIAL, NAME=GAS_AIR, TYPE=GAS +*DENSITY +1.2 +*SECTION, ELSET=GAS_PARTICLES, MATERIAL=GAS_AIR +*SPHLITE EOS, MATERIAL=GAS_AIR, GAMMA=1.4, E0=2.0, P0=0.0 +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=0.01, VOLUME=0.008 +*SPHLITE TIME CONTROL, DT=1.0E-6, TIME=1.0E-6, STEPS=1, SAFETY=0.5 diff --git a/tests/data/gas_stiffened_minimal_030.inp b/tests/data/gas_stiffened_minimal_030.inp new file mode 100644 index 0000000..584ebf1 --- /dev/null +++ b/tests/data/gas_stiffened_minimal_030.inp @@ -0,0 +1,19 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +4, 0.0, 0.0, 0.1 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=GAS_STIFF +1, 2, 3, 4 +*MATERIAL, NAME=GAS_STIFF, TYPE=GAS +*DENSITY +5.0 +*SECTION, ELSET=GAS_STIFF, MATERIAL=GAS_STIFF +*SPHLITE EOS, TYPE=STIFFENED_GAS, MATERIAL=GAS_STIFF, RHO0=5.0, GAMMA=1.3, E0=10.0, PINF=1000.0 +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=0.05, VOLUME=0.01 +*SPHLITE TIME CONTROL, DT=1.0E-6, TIME=2.0E-6, STEPS=2, SAFETY=0.5 diff --git a/tests/data/gas_unknown_sphlite_warning_030.inp b/tests/data/gas_unknown_sphlite_warning_030.inp new file mode 100644 index 0000000..892c723 --- /dev/null +++ b/tests/data/gas_unknown_sphlite_warning_030.inp @@ -0,0 +1,16 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +*ELSET, ELSET=GAS_PARTICLES +1, 2 +*MATERIAL, NAME=GAS_AIR, TYPE=GAS +*DENSITY +1.2 +*SECTION, ELSET=GAS_PARTICLES, MATERIAL=GAS_AIR +*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=GAS_AIR, GAMMA=1.4, E0=2.0, P0=0.0 +*SPHLITE GAS FUTURE, MATERIAL=GAS_AIR, NOTE=SKIP +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=0.01, VOLUME=0.008 +*SPHLITE TIME CONTROL, DT=1.0E-6, TIME=1.0E-6, STEPS=1, SAFETY=0.5 diff --git a/tests/data/water_gas_mixed_030.inp b/tests/data/water_gas_mixed_030.inp new file mode 100644 index 0000000..b555b8a --- /dev/null +++ b/tests/data/water_gas_mixed_030.inp @@ -0,0 +1,27 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 1.0, 0.0, 0.0 +4, 1.1, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=WATER_PARTICLES +1, 2 +*ELSET, ELSET=GAS_PARTICLES +3, 4 +*MATERIAL, NAME=WATER, TYPE=WATER +*DENSITY +1000.0 +*MATERIAL, NAME=GAS_AIR, TYPE=GAS +*DENSITY +1.2 +*SECTION, ELSET=WATER_PARTICLES, MATERIAL=WATER +*SECTION, ELSET=GAS_PARTICLES, MATERIAL=GAS_AIR +*SPHLITE EOS, TYPE=TAIT, MATERIAL=WATER, RHO0=1000.0, C0=1480.0, GAMMA=7.0, P0=0.0 +*SPHLITE VISCOSITY, TYPE=MONAGHAN, MATERIAL=WATER, ALPHA=0.1, BETA=0.0, ETA2=0.01 +*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=GAS_AIR, GAMMA=1.4, E0=2.0, P0=0.0 +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=1.0, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-6, TIME=1.0E-6, STEPS=1, SAFETY=0.5 diff --git a/tests/interface/test_c_api.c b/tests/interface/test_c_api.c index 5a7d959..56837be 100644 --- a/tests/interface/test_c_api.c +++ b/tests/interface/test_c_api.c @@ -78,7 +78,7 @@ int main(void) ierr = sphlite_get_version(&major, &minor, &patch); if (ierr != 0) return fail("get_version failed"); - if (major != 0 || minor != 2 || patch != 2) return fail("unexpected version"); + if (major != 0 || minor != 3 || 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 a4d928a..e323638 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 != 2 || version.patch != 2) { + if (version.major != 0 || version.minor != 3 || version.patch != 0) { return 1; } diff --git a/tests/unit/test_smoke.f90 b/tests/unit/test_smoke.f90 index b656593..216cf0b 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 /= 2 .or. patch /= 2) call fail('unexpected version') + if (major /= 0 .or. minor /= 3 .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 c4abb42..bab59cd 100644 --- a/todo.md +++ b/todo.md @@ -1,148 +1,217 @@ # SPHLite TODO -当前目标版本:0.2.2 +当前目标版本:0.3.0 -本文档依据 `docs/v2.2_development_plan.md` 拆分。0.2.2 定位为 0.2 Water 阶段后的补丁、稳定化与 0.3.0 Gas 开发前的交接版本。所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。 +本文档依据 `docs/v3.0_development_plan.md` 拆分。0.3.0 定位为 `Gas` 模块的第一个正式开发版本,目标是在 0.2.2 `Water` 稳定化基线之上建立 Gas 输入、状态、EOS、显式推进、诊断、输出、restart、接口和 release gate 的最小闭环。 + +所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.3.0 不实现 Explosive 生产算法、Solid 生产路径、Shell 生产路径或真实 FEM-SPH 联合运行。 执行约定:每完成 20 个待办事项,进行一次本地 git 提交,暂不推送远端。 -## 阶段 A:基线与版本状态 +## 阶段 A:版本和基线 -- [x] 确认当前 git 状态并记录 0.2.2 开发起点。 -- [x] 确认 0.2.1 最终本地提交可作为 0.2.2 基线。 -- [x] 确认 `docs/v2.2_development_plan.md` 与 01-06 号文档无范围冲突。 -- [x] 确认 0.2.2 不新增 Gas 生产求解路径。 -- [x] 确认 0.2.2 不新增 Explosive 生产算法。 -- [x] 确认 0.2.2 不新增 Solid 生产求解路径。 -- [x] 确认 0.2.2 不新增 Shell 生产求解路径。 -- [x] 确认 0.2.2 不新增真实 FEM-SPH 耦合运行。 -- [x] 确认 0.2.2 不新增几何、网格或粒子生成目录。 -- [x] 记录 0.2.2 是否作为实际补丁版本发布的初始判断。 +- [x] 确认当前 git 状态并记录 0.3.0 开发起点。 +- [x] 确认 `v0.2.2` 发布标签可作为 0.3.0 基线。 +- [x] 将核心软件版本更新为 `0.3.0`。 +- [x] 将 CMake 项目版本更新为 `0.3.0`。 +- [x] 更新 Fortran smoke 测试中的版本期望。 +- [x] 更新 C API 测试中的版本期望。 +- [x] 更新 C++ API 测试中的版本期望。 +- [x] 更新 Python debug 测试中的版本期望。 +- [x] 更新 CLI `--version` 和 inspect 版本期望。 +- [x] 在 README 中记录 0.3.0 Gas 开发定位。 -## 阶段 B:版本号与发布文档 +## 阶段 B:Gas 输入测试数据 -- [x] 将核心软件版本更新或确认到 `0.2.2`。 -- [x] 将 CMake 项目版本更新或确认到 `0.2.2`。 -- [x] 更新或确认 CLI `--version` 的 0.2.2 期望。 -- [x] 更新或确认 Fortran smoke 测试中的版本期望。 -- [x] 更新或确认 C API 测试中的版本期望。 -- [x] 更新或确认 C++ API 测试中的版本期望。 -- [x] 更新或确认 Python debug 测试中的版本期望。 -- [x] 更新 README 中的当前版本与 0.2.2 定位说明。 -- [x] 更新 `docs/09_release_history.md` 中的 0.2.2 条目。 -- [x] 更新 `docs/11_benchmark_matrix.md` 中的 0.2.2 gate 记录占位。 +- [x] 创建最小 `TYPE=GAS` 理想气体输入文件。 +- [x] 创建最小 `TYPE=GAS` JWL 输入文件。 +- [x] 创建最小 `TYPE=GAS` Stiffened gas 输入文件。 +- [x] 创建缺失 Gas `*DENSITY` 的错误输入文件。 +- [x] 创建缺失 Gas `*SPHLITE EOS` 的错误输入文件。 +- [x] 创建缺失 Gas EOS `TYPE` 的错误输入文件。 +- [x] 创建缺失 Gas EOS `MATERIAL` 的错误输入文件。 +- [x] 创建非法 Gas EOS 数值的错误输入文件。 +- [x] 创建 Gas 未支持但可跳过关键词的 warning 输入文件。 +- [x] 创建 Water 与 Gas 混合粒子的输入文件。 -## 阶段 C:文档一致性复核 +## 阶段 C:Gas 输入解析 -- [x] 复核 README 未宣称 0.2.2 已实现 Gas 生产能力。 -- [x] 复核 README 未宣称 0.2.2 已实现 Explosive 生产能力。 -- [x] 复核 README 未宣称 0.2.2 已实现 Solid 生产能力。 -- [x] 复核 README 未宣称 0.2.2 已实现 Shell 生产能力。 -- [x] 复核 README 未宣称 0.2.2 已实现真实 FEM-SPH 耦合。 -- [x] 复核 01 号文档中长期目标与 0.2.2 交付范围区分清楚。 -- [x] 复核 02 号文档中求解器定位与 0.2.2 范围一致。 -- [x] 复核 03 号文档中集中型数据管理描述与当前代码一致。 -- [x] 复核 04 号文档中 Water 算法策略与当前代码一致。 -- [x] 复核 05-06 号文档中接口和测试边界与 0.2.2 一致。 +- [ ] 扩展 material 识别以支持 `TYPE=GAS`。 +- [ ] 保持 set 只作为集合而不参与 Gas 类型判断。 +- [ ] 解析 `*SPHLITE EOS, TYPE=IDEAL_GAS`。 +- [ ] 解析 `*SPHLITE EOS, TYPE=JWL`。 +- [ ] 解析 `*SPHLITE EOS, TYPE=STIFFENED_GAS`。 +- [ ] 校验 Gas EOS 必需字段缺失时报 error。 +- [ ] 校验 Gas EOS 非法数值时报 error。 +- [ ] 校验 Gas material 与 section 绑定关系。 +- [ ] 确认 Gas warning 不影响可运行输入。 +- [ ] 增加 `input_gas` 测试目标并接入 CTest。 -## 阶段 D:输入解析回归 +## 阶段 D:Gas 模块状态 -- [x] 复核 Abaqus 子集解析仍不追求完整 Abaqus 兼容。 -- [x] 复核可复用 Abaqus 关键词时未新增重复 SPHLite 关键词。 -- [x] 复核 unsupported-but-safe 关键词继续报 warning。 -- [x] 复核缺失必要关键词时继续报 error。 -- [x] 复核输入错误信息仍包含足够定位上下文。 -- [x] 复核 `*MATERIAL, TYPE=WATER` 大小写兼容。 -- [x] 复核 Water material 与 `*DENSITY` 绑定校验。 -- [x] 复核 `*SECTION` material 引用存在性校验。 -- [x] 复核 `*SPHLITE EOS, TYPE=TAIT` 校验。 -- [x] 复核 `*SPHLITE TIME CONTROL` 正值校验。 +- [ ] 初始化 Gas 模块生命周期状态。 +- [ ] 重置 Gas 模块时清空 EOS 和诊断状态。 +- [ ] 在数据库中确认 `SPH_PHASE_GAS` 常量与 C/Python 常量一致。 +- [ ] 建立 Gas material 名称和内部 id 记录。 +- [ ] 建立 Gas 默认 `h`、`mass` 和 `volume` 控制参数。 +- [ ] 建立 Gas 外部体力状态。 +- [ ] 建立 Gas 稳定时间步诊断状态。 +- [ ] 建立 Gas summary 诊断状态。 +- [ ] 建立 Gas bubble metrics 历史状态。 +- [ ] 确认 Water 状态不读取 Gas 专属变量。 -## 阶段 E:数据模型与邻域回归 +## 阶段 E:理想气体 EOS -- [x] 复核集中型粒子数据管理未被绕开。 -- [x] 复核 Water、Gas、Explosive、Solid、Shell 共享基础粒子数据结构。 -- [x] 复核 Water 计算路径不依赖 Gas 状态变量。 -- [x] 复核 phase 改变机制不引入新的不可控相变模型。 -- [x] 复核 inactive 粒子不参与 Water 相互作用。 -- [x] 复核 failed 粒子不参与 Water 相互作用。 -- [x] 复核粒子 `h(i)` 的独立支持仍可用。 -- [x] 复核 kernel 在 `h <= 0` 时保持错误路径。 -- [x] 复核 neighbor 搜索在重复坐标粒子下保持稳定。 -- [x] 复核 neighbor 搜索在稀疏粒子布局下保持稳定。 +- [ ] 实现理想气体 EOS 参数设置。 +- [ ] 校验理想气体 `gamma > 1`。 +- [ ] 校验理想气体 `rho > 0`。 +- [ ] 校验理想气体 `internal_energy >= 0`。 +- [ ] 计算理想气体压力。 +- [ ] 支持理想气体可选 `P0` 偏置。 +- [ ] 增加理想气体参考压力测试。 +- [ ] 增加理想气体压力单调性测试。 +- [ ] 增加理想气体非法参数测试。 +- [ ] 增加 `gas_eos_ideal` 测试目标并接入 CTest。 -## 阶段 F:Water 数值行为回归 +## 阶段 F:JWL EOS -- [x] 复核 Water 密度仍采用连续性方程更新。 -- [x] 复核 summation density 未进入主求解流程。 -- [x] 复核默认 Water EOS 仍为 Tait 模型。 -- [x] 复核 `B` 未显式给定时仍由 `rho0*c0*c0/gamma` 推导。 -- [x] 复核显式给定 `B` 时结果保持当前策略。 -- [x] 复核 `rho < rho0` 时继续保留负压。 -- [x] 复核 0.2.2 不新增压力截断策略。 -- [x] 复核 0.2.2 不新增空化生产模型。 -- [x] 复核人工黏性参数和诊断行为保持 0.2.1 兼容。 -- [x] 复核 pressure wave smoke 不被扩展为工程精度 benchmark。 +- [ ] 实现 JWL EOS 参数设置。 +- [ ] 校验 JWL `rho0 > 0`。 +- [ ] 校验 JWL `R1 > 0` 和 `R2 > 0`。 +- [ ] 校验 JWL `omega > 0`。 +- [ ] 校验 JWL `internal_energy >= 0`。 +- [ ] 按 `V = rho0 / rho` 计算相对体积。 +- [ ] 计算 JWL 压力。 +- [ ] 增加 JWL 有限性测试。 +- [ ] 增加 JWL 非法参数测试。 +- [ ] 增加 `gas_eos_jwl` 测试目标并接入 CTest。 -## 阶段 G:求解、输出与重启动 +## 阶段 G:Stiffened Gas EOS -- [x] 复核显式时间推进仍采用 Velocity-Verlet 路线。 -- [x] 复核 0.2.2 不引入隐式求解器。 -- [x] 复核 stable dt 诊断仍覆盖 CFL、加速度和黏性约束。 -- [x] 复核 `TIME` 与 `STEPS` 双约束运行逻辑。 -- [x] 复核最后小步不超过 `end_time`。 -- [x] 复核粒子 CSV 输出字段保持 0.2.1 兼容。 -- [x] 复核 summary CSV 输出字段保持 0.2.1 兼容。 -- [x] 复核手动输出不改变物理状态。 -- [x] 复核 restart 写入 Water 求解关键状态。 -- [x] 复核 restart 读回后可继续 Water 显式步。 +- [ ] 实现 Stiffened gas EOS 参数设置。 +- [ ] 锁定 Stiffened gas 的输入字段命名。 +- [ ] 校验 Stiffened gas `gamma > 1`。 +- [ ] 校验 Stiffened gas `rho0 > 0`。 +- [ ] 校验 Stiffened gas `internal_energy >= 0`。 +- [ ] 校验 Stiffened gas `PINF` 的允许范围。 +- [ ] 计算 Stiffened gas 压力。 +- [ ] 增加 Stiffened gas 有限性测试。 +- [ ] 增加 Stiffened gas 非法参数测试。 +- [ ] 增加 `gas_eos_stiffened` 测试目标并接入 CTest。 -## 阶段 H:接口与耦合边界 +## 阶段 H:Gas 状态初始化 -- [x] 复核 Fortran 公共 API 保持 0.2.1 兼容。 -- [x] 复核 C ABI 头文件保持 0.2.1 兼容。 -- [x] 复核 C wrapper 不重新定义物理语义。 -- [x] 复核 C++ wrapper 仍为轻量 RAII 封装。 -- [x] 复核 Python wrapper 仍通过 C ABI 调用。 -- [x] 复核 Python 不直接访问 Fortran 内部符号。 -- [x] 复核 CLI 不绕过公共生命周期接口。 -- [x] 复核 CouplingInterface 不出现 FEMLite 内部结构依赖。 -- [x] 复核 CouplingInterface 命名不绑定外部模块最终名称。 -- [x] 复核默认 gate 不运行真实 FEM-SPH 联合测试。 +- [ ] 将 Gas material 对应粒子初始化为 `SPH_PHASE_GAS`。 +- [ ] 初始化 Gas 粒子 `rho`。 +- [ ] 初始化 Gas 粒子 `pressure`。 +- [ ] 初始化 Gas 粒子 `internal_energy`。 +- [ ] 初始化 Gas 粒子 `temperature`。 +- [ ] 初始化 Gas 粒子 `mass`。 +- [ ] 初始化 Gas 粒子 `volume`。 +- [ ] 初始化 Gas 粒子 `h`。 +- [ ] 确认非 Gas 粒子不被 Gas 初始化改写。 +- [ ] 增加 `gas_state` 测试目标并接入 CTest。 -## 阶段 I:测试门禁 +## 阶段 I:Gas Summary -- [x] 完整配置 CMake 构建目录。 -- [x] 完整编译 `sphlite_core`。 -- [x] 完整编译 `sphlite_c`。 -- [x] 完整编译 `sphlite_c_shared`。 -- [x] 完整编译 `sphlite` CLI。 -- [x] 完整编译 Fortran 测试目标。 -- [x] 完整编译 C/C++ 测试目标。 -- [x] 运行默认 gate 中的 smoke 测试。 -- [x] 运行默认 gate 中的 input 测试。 -- [x] 运行默认 gate 中的 Water 数值测试集合。 -- [x] 运行默认 gate 中的 output 与 restart 测试。 -- [x] 运行默认 gate 中的 API 与 CLI 测试。 -- [x] 运行默认 gate 中的 coupling_interface 测试。 -- [x] 运行默认 gate 中的 pressure_wave_smoke 测试。 -- [x] 运行 `source_size` 门禁。 -- [x] 运行 `git diff --check`。 +- [ ] 统计 active Gas 粒子数量。 +- [ ] 统计 Gas 总质量。 +- [ ] 统计 Gas 总体积。 +- [ ] 统计 Gas 动量。 +- [ ] 计算 Gas 体积加权中心。 +- [ ] 计算 Gas 平均压力。 +- [ ] 计算 Gas 最大压力。 +- [ ] 计算 Gas 密度范围。 +- [ ] 确认 inactive 或 failed 粒子不进入 Gas summary。 +- [ ] 增加 `gas_summary` 测试目标并接入 CTest。 -## 阶段 J:发布决策与 0.3.0 交接 +## 阶段 J:Bubble 诊断 -- [x] 确认没有提交 build 目录。 -- [x] 确认没有提交 Python 缓存。 -- [x] 确认没有提交 CSV 临时结果。 -- [x] 确认没有提交 restart 临时结果。 -- [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 变更。 +- [ ] 按 Gas 总体积计算等效气泡半径。 +- [ ] 保存上一时间步等效气泡半径。 +- [ ] 计算等效气泡半径变化率。 +- [ ] 保存上一时间步 Gas 中心。 +- [ ] 计算 Gas 中心迁移量。 +- [ ] 处理无 Gas 粒子时的 bubble metrics 默认值。 +- [ ] 处理零体积 Gas 粒子时的错误路径。 +- [ ] 在文档中说明 0.3.0 bubble metrics 为单气团近似。 +- [ ] 增加 bubble metrics 单元测试。 +- [ ] 将 bubble metrics 纳入 `gas_summary` 或独立测试。 + +## 阶段 K:Gas 单相显式推进 + +- [ ] 实现 Gas 压力更新入口。 +- [ ] 实现 Gas 密度变化率计算。 +- [ ] 实现 Gas 压力加速度计算。 +- [ ] 实现 Gas 人工黏性占位或明确跳过策略。 +- [ ] 合成 Gas 外部体力加速度。 +- [ ] 将 Gas 计算接入显式步进流程。 +- [ ] 确认 Gas 显式步不改变 Water 单相结果。 +- [ ] 实现 Gas 稳定时间步估计。 +- [ ] 增加 Gas 单步推进测试。 +- [ ] 增加 `solver_gas` 测试目标并接入 CTest。 + +## 阶段 L:Gas 输出 + +- [ ] 保持粒子 CSV 通用字段兼容。 +- [ ] 在 summary CSV 写入 `gas_particles`。 +- [ ] 在 summary CSV 写入 `gas_mass`。 +- [ ] 在 summary CSV 写入 `gas_volume`。 +- [ ] 在 summary CSV 写入 Gas 中心三分量。 +- [ ] 在 summary CSV 写入 Gas 平均压力和最大压力。 +- [ ] 在 summary CSV 写入等效气泡半径。 +- [ ] 在 summary CSV 写入半径变化率。 +- [ ] 在 summary CSV 写入 `gas_dtcrit`。 +- [ ] 增加 `gas_output` 测试目标并接入 CTest。 + +## 阶段 M:Gas Restart + +- [ ] 更新 restart 状态版本策略。 +- [ ] 写入 Gas EOS 类型和参数。 +- [ ] 写入 Gas 默认粒子控制参数。 +- [ ] 写入 Gas 外部体力。 +- [ ] 写入 Gas summary 诊断状态。 +- [ ] 写入 bubble metrics 历史状态。 +- [ ] 写入 Gas 稳定时间步诊断。 +- [ ] 读回 Gas restart 后重建邻域。 +- [ ] 读回 Gas restart 后继续显式步。 +- [ ] 增加 `gas_restart` 测试目标并接入 CTest。 + +## 阶段 N:Fortran API 与 C ABI + +- [ ] 增加 Fortran `sph_get_gas_summary`。 +- [ ] 增加 Fortran `sph_get_gas_bubble_metrics`。 +- [ ] 增加 Fortran `sph_get_gas_dt_limits`。 +- [ ] 增加 C ABI `sphlite_get_gas_summary`。 +- [ ] 增加 C ABI `sphlite_get_gas_bubble_metrics`。 +- [ ] 增加 C ABI `sphlite_get_gas_dt_limits`。 +- [ ] 为 Gas C ABI 增加空指针错误测试。 +- [ ] 为 Gas C ABI 增加未初始化错误测试。 +- [ ] 为 Gas C ABI 增加未 build 错误测试。 +- [ ] 更新 C API 测试目标以覆盖 Gas 诊断。 + +## 阶段 O:C++、Python 和 CLI + +- [ ] 在 C++ wrapper 中增加 Gas summary 薄封装。 +- [ ] 在 C++ wrapper 中增加 bubble metrics 薄封装。 +- [ ] 在 C++ wrapper 测试中覆盖 Gas 诊断。 +- [ ] 在 Python ctypes 中增加 Gas summary 封装。 +- [ ] 在 Python ctypes 中增加 bubble metrics 封装。 +- [ ] 在 Python debug 测试中覆盖 Gas inspect。 +- [ ] 在 Python debug 测试中确认不访问 Fortran 内部符号。 +- [ ] 在 CLI inspect 输出中增加 Gas 诊断字段。 +- [ ] 在 CLI run 输出中增加 Gas 诊断字段。 +- [ ] 更新 CLI 测试以覆盖 Gas 输入和错误路径。 + +## 阶段 P:回归、文档和发布记录 + +- [ ] 运行 0.2.2 Water 默认 gate 并确认全部通过。 +- [ ] 运行 0.3.0 新增 Gas gate 并确认全部通过。 +- [ ] 运行 `source_size` 门禁。 +- [ ] 运行 `git diff --check`。 +- [ ] 确认没有提交 build 目录或临时输出。 +- [ ] 更新 README 的 0.3.0 当前能力说明。 +- [ ] 更新 `docs/09_release_history.md` 的 0.3.0 条目。 +- [ ] 更新 `docs/11_benchmark_matrix.md` 的 0.3.0 gate。 +- [ ] 复核文档未宣称 0.3.0 已实现 Explosive、Solid、Shell 或真实 FEM-SPH 耦合。 +- [ ] 给出 0.3.0 是否发布以及是否进入 0.4.0 Explosive 的最终建议。 diff --git a/tools/testing/test_cli.py b/tools/testing/test_cli.py index 2f107de..3b1a86a 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.2.2" not in version.stdout: + if "0.3.0" not in version.stdout: raise AssertionError("CLI version mismatch") inspect = run_command([exe, model]) @@ -72,7 +72,7 @@ def main() -> int: ): require_field(inspect.stdout, field) inspect_fields = read_fields(inspect.stdout) - if inspect_fields["version"] != "0.2.2": + if inspect_fields["version"] != "0.3.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 b3c50db..f6e8203 100644 --- a/tools/testing/test_python_debug.py +++ b/tools/testing/test_python_debug.py @@ -27,7 +27,7 @@ def main() -> int: raise AssertionError("Python constants are not locked") if not hasattr(solver.lib, "sphlite_get_water_summary"): raise AssertionError("Python wrapper is not using the C ABI library") - if solver.version() != (0, 2, 2): + if solver.version() != (0, 3, 0): raise AssertionError("Python version mismatch") solver.initialize()