diff --git a/CMakeLists.txt b/CMakeLists.txt index fe51546..f2252a5 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,6 +1,6 @@ cmake_minimum_required(VERSION 3.20) -project(SPHLite VERSION 0.3.0 LANGUAGES C CXX Fortran) +project(SPHLite VERSION 0.3.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 29a9a88..8955bd1 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。 -当前目标版本:0.3.0。该版本定位为 `Gas` 模块第一个正式开发版本,在 0.2.2 `Water` 稳定化基线之上建立气体输入、状态、EOS、显式推进、诊断、CSV 输出、restart 和接口最小闭环。不交付 `Explosive`、`Solid`、`Shell` 的生产路径,也不交付真实 FEM-SPH 联合运行。 +当前目标版本:0.3.1。该版本定位为 `Gas` 模块稳定化和前置加固版本,在 0.3.0 `Gas` 最小闭环之上补强多 Gas material/EOS、Gas 源项占位、诊断一致性、restart 兼容性和接口覆盖。不交付 `Explosive`、`Solid`、`Shell` 的生产路径,也不交付真实 FEM-SPH 联合运行。 代码仓库地址: @@ -63,7 +63,7 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: ## 当前状态 -0.3.0 当前实现重点包括: +0.3.1 当前实现重点包括: - CMake/CTest 工程骨架和 Fortran 95 核心库。 - C ABI、C++ 头文件薄包装和 Python `ctypes` 调试入口。 @@ -72,5 +72,5 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: - Water summary、稳定时间步诊断、CSV output、restart 和双 pressure wave smoke 小算例。 - Gas material、三类 Gas EOS、Gas 状态初始化、单相显式推进、气体 summary、bubble metrics、Gas CSV/restart 和公开诊断接口。 - CouplingInterface 的中立数据导出、外部粒子力导入和诊断占位;0.2.2 不暴露 CouplingInterface C ABI,真实 FEM-SPH 联合运行仍由外部 CouplingModule 后续实现。 -- `Explosive`、`Solid`、`Shell` 仍为后续阶段,不在 0.3.0 交付生产计算路径。 -- 0.3.0 release gate 与 source size 门禁。 +- `Explosive`、`Solid`、`Shell` 仍为后续阶段,不在 0.3.1 交付生产计算路径。 +- 0.3.1 release gate 与 source size 门禁。 diff --git a/docs/v3.1_development_plan.md b/docs/v3.1_development_plan.md new file mode 100644 index 0000000..f89dc78 --- /dev/null +++ b/docs/v3.1_development_plan.md @@ -0,0 +1,450 @@ +# SPHLite v3.1 开发计划 + +文档状态:0.3.1 开发计划草案 + +目标软件版本:SPHLite 0.3.1 + +## 1. 文档定位 + +本文档用于规划 SPHLite 0.3.1 版本的开发范围。0.3.1 是 0.3 `Gas` 版本线的稳定化和前置加固版本,目标是在 0.3.0 已发布的 Gas 最小闭环基础上,补强多 Gas material/EOS、Gas 源项占位、诊断一致性、restart 兼容性、接口覆盖和 release gate 可维护性。 + +0.3.1 不应演化为 0.4 `Explosive`。解析点火、爆轰到达时间、反应进度、炸药粒子 phase 转化和真实质量/动量/能量注入仍属于 0.4.0 或后续版本。 + +## 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/v3.0_development_plan.md` +- `docs/09_release_history.md` +- `docs/11_benchmark_matrix.md` + +## 3. 版本定位 + +### 3.1 与 0.3.0 的关系 + +0.3.0 已完成 Gas 最小闭环,包括 Gas 输入、三类 EOS、状态初始化、单相显式推进、summary、bubble metrics、CSV output、restart、Fortran API、C ABI、C++ wrapper、Python ctypes、CLI 诊断字段和默认 gate。 + +0.3.1 应继承 0.3.0 的工程骨架和测试体系,并解决 0.3.0 中为快速闭环而保留的限制: + +- Gas EOS 状态更偏向单 Gas material。 +- Bubble metrics 仍是单气团近似。 +- Gas dt 估计和 sound speed 策略较保守。 +- Gas 诊断 API 暴露字段较少。 +- `source_size` 中已有必要例外,后续维护成本需要控制。 +- Explosive 到 Gas 的源项入口尚未形成模块级占位。 + +### 3.2 与 0.4.0 的关系 + +0.4.0 建议作为 `Explosive` 起点。0.3.1 应为 0.4.0 做准备,但不提前实现 Explosive 生产算法。0.3.1 可以交付: + +- Gas material 级 EOS 表。 +- Gas 源项缓存和清零/累计占位。 +- 从外部或后续 Explosive 模块向 Gas 施加源项的 Fortran 内部入口。 +- 能验证源项不会破坏 Water/Gas 既有 gate 的小型测试。 + +0.3.1 不交付: + +- 起爆点输入语义。 +- 爆轰传播。 +- programmed burn 反应进度。 +- Explosive 粒子向 Gas phase 的真实迁移。 +- 工程级气泡脉动 benchmark。 + +## 4. 开发原则 + +### 4.1 保持模块边界 + +SPHLite 仍只修改本仓库内容,不修改 FEMLite 或其他外部模块。SPHLite 不直接依赖 FEMLite,也不直接依赖外部 CouplingModule、CoupleLite、CoupledLite 或 CouplingLite。 + +### 4.2 保持求解器定位 + +SPHLite 仍是求解器,不负责几何建模、网格生成或粒子生成。0.3.1 可新增测试输入文件或测试辅助脚本,但不得将其宣传为求解器的粒子生成能力。 + +### 4.3 保持 Fortran 95 核心 + +核心实现继续使用 Fortran 95。C ABI、C++ wrapper 和 Python ctypes 仍作为薄接口层。0.3.1 不引入破坏可移植性的第三方运行时依赖。 + +### 4.4 保持显式动力学路线 + +时间推进仍只支持显式动力学,主积分格式为 Velocity-Verlet。不引入隐式求解器、静力求解器、Newmark 路线或隐式-显式混合求解接口。 + +### 4.5 保持 Abaqus 子集策略 + +输入文件继续解析 SPHLite 支持的 Abaqus `.inp` 明确子集。不追求完整 Abaqus 兼容。能复用 Abaqus 关键词时不新增关键词;Abaqus 无法表达的能力使用 `*SPHLITE ...` 扩展关键词。 + +### 4.6 保持 Water 与 Gas 独立 + +Water 和 Gas 共享集中型粒子数据库,但计算路径保持独立。0.3.1 新增 Gas 多材料、源项占位或诊断字段时,不得改变 Water 的 Tait EOS、连续性方程、Monaghan 人工黏性、负压保留和 pressure wave smoke 行为。 + +## 5. 0.3.1 交付目标 + +0.3.1 建议交付以下内容: + +1. 将软件版本更新为 `0.3.1`。 +2. 支持同一模型中存在多个 `TYPE=GAS` material,并为每个 Gas material 维护独立 EOS 类型和参数。 +3. 支持同一输入中同时存在空气类理想气体和爆轰产物类 JWL Gas material。 +4. 将 Gas 压力更新、dt 估计、summary 和 restart 改为 material/EOS 分派,避免单一全局 Gas EOS 限制。 +5. 建立 Gas 源项缓存占位,包括质量、动量和能量源项累计量。 +6. 建立 Gas 源项清零、累计和显式步应用的 Fortran 内部入口,但不实现 Explosive 反应。 +7. 将 Gas 源项状态写入 restart,并可读回后继续显式步。 +8. 扩展 Gas 诊断,补充质量、动量、密度范围、dt 分量和源项累计量的稳定查询路径。 +9. 保持 C ABI 兼容,新增接口只能追加,不能破坏 0.3.0 的 `sphlite_get_gas_summary` 和 `sphlite_get_gas_bubble_metrics`。 +10. 增强 Python 和 CLI 的 Gas inspect/run 输出检查。 +11. 复核 `source_size` 例外,优先通过小规模拆分或辅助过程降低例外数量。 +12. 保持 0.3.0 默认 gate 全部通过,并新增 0.3.1 Gas 稳定化 gate。 +13. 更新 README、09 号发布记录和 11 号验收矩阵。 + +## 6. 非交付范围 + +0.3.1 不交付以下内容: + +1. 不实现 Explosive 的解析点火、爆轰传播或 programmed burn。 +2. 不实现 Explosive 粒子的真实反应进度 `lambda`。 +3. 不实现炸药粒子向 Gas phase 的生产级迁移。 +4. 不实现工程级水-气多相 Riemann 通量。 +5. 不实现复杂水-气界面重构、锐界面追踪或相变蒸发。 +6. 不实现生产级气泡多周期脉动 benchmark。 +7. 不实现 Solid 的 Johnson-Cook 材料模型和失效模型。 +8. 不实现 Shell 的 Mindlin-Reissner 生产求解路径。 +9. 不实现真实 FEM-SPH 接触耦合或连续体耦合。 +10. 不暴露未冻结的 CouplingInterface C ABI。 +11. 不新增几何、网格或粒子生成能力。 + +## 7. 输入范围 + +### 7.1 继承 0.3.0 Gas 输入 + +0.3.1 继续支持 0.3.0 的 Gas 输入形式: + +```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=... +``` + +### 7.2 多 Gas material 输入 + +0.3.1 应支持以下输入组合: + +```text +*MATERIAL, NAME=AIR, TYPE=GAS +*DENSITY +1.2 +*SECTION, ELSET=AIR_PARTICLES, MATERIAL=AIR +*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=AIR, GAMMA=1.4, E0=... + +*MATERIAL, NAME=PRODUCTS, TYPE=GAS +*DENSITY +1600.0 +*SECTION, ELSET=PRODUCT_PARTICLES, MATERIAL=PRODUCTS +*SPHLITE EOS, TYPE=JWL, MATERIAL=PRODUCTS, RHO0=..., A=..., B=..., R1=..., R2=..., OMEGA=..., E0=... +``` + +每个 `TYPE=GAS` material 必须具备: + +- `*DENSITY`。 +- 对应 `MATERIAL=...` 的 `*SPHLITE EOS`。 +- 至少一个 section 绑定,或明确没有 active 粒子时作为 warning/诊断处理。 + +### 7.3 Gas 源项输入策略 + +0.3.1 不建议新增用户可见的 Explosive 源项输入语义。若需要为测试创建源项,可采用以下两种方式之一: + +- Fortran 模块级测试直接调用 Gas 源项内部入口。 +- 使用 `*SPHLITE GAS SOURCE` 作为测试性扩展关键词,但默认文档中标记为实验性,不作为 0.3.1 稳定用户接口。 + +若实现实验性关键词,应保证缺失或非法字段报 error,不影响运行的未来字段 warning 后跳过。 + +## 8. Gas 多材料状态 + +0.3.1 应将 Gas EOS 状态从单一全局记录扩展为 material 级记录。建议状态包括: + +- Gas material 数量。 +- Gas material 内部 id。 +- Gas material 名称。 +- 每个 Gas material 的 EOS 类型。 +- 每个 Gas material 的密度、内能、温度默认值。 +- 理想气体参数表。 +- JWL 参数表。 +- Stiffened gas 参数表。 +- 每个 Gas material 的默认 `h`、`mass`、`volume` 控制策略。 +- 每个 Gas material 的外部体力或共享外部体力策略。 + +压力更新时必须根据粒子的 `material_id` 查找对应 EOS,而不是使用单一全局 Gas EOS。若 Gas 粒子的 material 没有 EOS,应报 error。 + +## 9. Gas 源项占位 + +0.3.1 应为 0.4.0 `Explosive` 预留 Gas 源项状态,但不实现 Explosive 反应。建议最小状态为: + +```fortran +real(rk), allocatable :: gas_mass_source(:) +real(rk), allocatable :: gas_energy_source(:) +real(rk), allocatable :: gas_momentum_source(:,:) +``` + +数组形状: + +- `gas_mass_source(npart)`。 +- `gas_energy_source(npart)`。 +- `gas_momentum_source(3,npart)`。 + +建议内部入口: + +- `sph_gas_clear_sources`。 +- `sph_gas_add_source_by_particle`。 +- `sph_gas_apply_sources_explicit`。 +- `sph_gas_get_source_summary`。 + +源项应用第一版只要求小规模守恒检查: + +- 质量源项增加 Gas 粒子质量或等效诊断质量。 +- 能量源项增加 Gas 粒子内能或等效能量状态。 +- 动量源项改变 Gas 粒子速度或动量诊断。 +- 非 Gas 粒子源项应报 error 或被明确拒绝。 + +具体能量到压力的物理转换仍以 Gas EOS 为准,不引入 Explosive 反应模型。 + +## 10. Gas 诊断扩展 + +0.3.1 应保持 0.3.0 诊断字段: + +- `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` + +建议新增或确认以下诊断: + +- `gas_momentum_x` +- `gas_momentum_y` +- `gas_momentum_z` +- `gas_min_density` +- `gas_max_density` +- `gas_dt_cfl` +- `gas_dt_accel` +- `gas_source_mass` +- `gas_source_energy` +- `gas_source_momentum_x` +- `gas_source_momentum_y` +- `gas_source_momentum_z` + +新增 C ABI 时应避免破坏已有函数,可新增: + +```c +int sphlite_get_gas_extended_summary(double *mass, + double *momentum, + double *density_range, + double *source_totals); +``` + +若字段尚未冻结,可先通过 Fortran API、Python debug 和 CLI 输出覆盖,C ABI 只追加最稳定字段。 + +## 11. Restart 和兼容策略 + +0.3.1 应更新 restart 状态策略: + +- 新写入状态建议为 `STATE_0_3_1` 或继续 `STATE_0_3` 并在文件内增加 Gas state revision。 +- 必须能读取 0.3.0 的 `STATE_0_3` restart。 +- 若读取 0.3.0 restart,缺失的多材料 EOS 表和源项状态应明确初始化为 0.3.1 默认值。 +- 读回后必须重建邻域。 +- 读回后必须能继续显式步。 + +restart 应保存: + +- Gas material/EOS 表。 +- Gas 默认粒子控制状态。 +- Gas 外部体力。 +- Gas 源项缓存。 +- Gas summary 诊断。 +- bubble metrics 历史状态。 +- Gas dt 诊断。 +- 粒子通用状态中的 `pressure`、`internal_energy`、`temperature`、`rho`、`volume`、`h`、`mass`、`v` 和 `vhalf`。 + +## 12. API、C ABI、C++、Python 和 CLI + +### 12.1 Fortran API + +建议新增或完善: + +- `sph_get_gas_extended_summary` +- `sph_get_gas_source_summary` +- `sph_gas_clear_sources` +- `sph_gas_add_source_by_particle` +- `sph_gas_apply_sources_explicit` + +### 12.2 C ABI + +C ABI 继续保持追加式设计。0.3.1 不破坏: + +- `sphlite_get_gas_summary` +- `sphlite_get_gas_bubble_metrics` +- `sphlite_get_gas_dt_limits` + +可新增稳定诊断接口,但不暴露 Fortran 内部数组指针。 + +### 12.3 C++ wrapper + +C++ wrapper 继续作为 C ABI 薄包装。新增结构体只表达 C ABI 返回数据,不重新定义 Gas 物理语义。 + +### 12.4 Python ctypes + +Python API 继续通过 C ABI 调用,用于: + +- 多 Gas material 输入 smoke。 +- Gas source 调试。 +- Gas extended summary 检查。 +- CLI 输出 checker。 + +Python 不直接访问 Fortran 内部符号。 + +### 12.5 CLI + +CLI inspect、check 和 run 模式应继续输出 0.3.0 Gas 字段。若 0.3.1 新增 extended 字段,应保证: + +- Water-only 输入输出字段仍稳定。 +- Gas-only 输入输出字段可检查。 +- Water/Gas 混合输入输出字段可检查。 +- 错误路径仍向 stderr 输出 `error_code` 和 `error_message`。 + +## 13. 测试计划 + +### 13.1 新增 0.3.1 测试 + +建议新增以下测试: + +- `input_gas_multimaterial`:多个 Gas material、多个 section、多个 EOS。 +- `gas_eos_dispatch`:按粒子 material 分派理想气体、JWL 和 Stiffened gas。 +- `gas_source`:质量、动量、能量源项清零、累计和应用。 +- `gas_source_errors`:非 Gas 粒子、非法粒子 id、非法源项数值。 +- `gas_extended_summary`:质量、动量、密度范围、源项累计量。 +- `gas_restart_031`:多 Gas material 和源项状态 restart。 +- `gas_restart_030_compat`:读取 0.3.0 `STATE_0_3` restart 的兼容路径。 +- `gas_cli_extended`:CLI inspect/run 的新增 Gas 字段。 +- `gas_python_extended`:Python ctypes 的新增 Gas 字段。 +- `gas_source_size_cleanup`:确认 source size 例外没有 stale 项。 + +### 13.2 既有回归测试 + +0.3.1 必须继续通过 0.3.0 默认 gate: + +- `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` +- `source_size` + +### 13.3 建议 0.3.1 Release Gate + +建议 0.3.1 默认 gate 为: + +```powershell +ctest --test-dir build-codex-unix --output-on-failure +ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure +git diff --check +``` + +若新增测试命名较多,也可使用明确正则列出 0.3.0 gate 与 0.3.1 新增 gate。实现完成后应同步更新 06、09、11 号文档。 + +## 14. 建议开发阶段 + +若后续根据本计划生成 `todo.md`,建议按以下阶段拆分: + +1. 0.3.1 版本号和 0.3.0 发布基线确认。 +2. 多 Gas material 输入文件和错误输入文件准备。 +3. Gas material/EOS 表数据结构。 +4. Gas EOS material 分派。 +5. Gas 状态初始化按 material 分派。 +6. Gas dt 和 sound speed 策略按 material 分派。 +7. Gas summary 和 extended summary。 +8. Gas 源项状态和内部入口。 +9. Gas 源项显式应用小步测试。 +10. Gas output 扩展字段。 +11. Gas restart 0.3.1 状态写入。 +12. 0.3.0 restart 兼容读入。 +13. Fortran API 和 C ABI 追加接口。 +14. C++ wrapper、Python ctypes 和 CLI 扩展。 +15. Source size 例外复核和必要拆分。 +16. Water、Gas 和 CouplingInterface 回归。 +17. README、09 和 11 号文档同步。 + +## 15. 验收标准 + +0.3.1 应满足以下验收标准: + +1. 软件版本为 `0.3.1`。 +2. 同一模型可包含多个 Gas material 和不同 EOS。 +3. Gas 压力、dt、summary 和 restart 按 material 正确分派。 +4. Gas 源项缓存可清零、累计、应用和诊断。 +5. Gas 源项不会误作用到 Water、Solid、Shell 或 inactive/failed 粒子。 +6. 0.3.0 Gas summary、bubble metrics、output、restart 和接口继续兼容。 +7. 0.3.0 `STATE_0_3` restart 可读入,并初始化 0.3.1 新状态默认值。 +8. Water 默认 gate 继续通过。 +9. 默认 gate、source size 和 `git diff --check` 通过。 +10. 文档不宣称 0.3.1 已实现 Explosive、Solid、Shell 或真实 FEM-SPH 耦合能力。 +11. 不新增 FEMLite 直接依赖。 +12. 不修改 SPHLite 文件夹之外的内容。 + +## 16. 风险与控制 + +| 风险 | 表现 | 控制方式 | +| --- | --- | --- | +| 0.3.1 范围膨胀 | 提前实现 Explosive 点火、爆轰或反应进度 | 只做 Gas 源项占位和小型守恒测试 | +| 多 Gas EOS 分派错误 | 空气粒子使用 JWL 或产物气体使用理想气体参数 | 用混合 Gas material 输入和逐粒子压力测试锁定 | +| restart 不兼容 | 0.3.0 restart 无法读入或新状态丢失 | 建立 `gas_restart_030_compat` 和 `gas_restart_031` | +| Water 行为漂移 | Gas 源项或全局数组改动影响 Water 单相结果 | Water gate 与 Gas gate 一起运行 | +| C ABI 过早暴露内部结构 | 多材料表或源项数组冻结过早 | C ABI 只追加稳定 summary,不暴露内部数组指针 | +| source size 债务扩大 | 继续增加例外导致维护困难 | 优先拆分长过程,例外需有 stale 检查 | +| Bubble 诊断被过度解释 | 单气团或多材料 smoke 被误认为工程 benchmark | 文档继续明确为小规模链路检查 | + +## 17. 0.4.0 启动条件 + +满足以下条件后,可以启动 0.4.0 `Explosive`: + +1. 0.3.1 多 Gas material/EOS 分派稳定。 +2. Gas 源项缓存、诊断、restart 和小型应用测试稳定。 +3. Gas 可接收质量、动量和能量源项而不破坏 Water/Gas gate。 +4. 默认 gate 可重复执行。 +5. 文档明确 Explosive 作用到 Gas 后形成 Bubble 的长期路线。 diff --git a/src/core/sph_precision.f90 b/src/core/sph_precision.f90 index 7a20fe8..2666401 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 = 3 - 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/data/gas_air_ideal_031.inp b/tests/data/gas_air_ideal_031.inp new file mode 100644 index 0000000..7b95dbd --- /dev/null +++ b/tests/data/gas_air_ideal_031.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=AIR_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=AIR, TYPE=GAS +*DENSITY +1.2 +*SECTION, ELSET=AIR_PARTICLES, MATERIAL=AIR +*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=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_air_products_mixed_031.inp b/tests/data/gas_air_products_mixed_031.inp new file mode 100644 index 0000000..eaa472e --- /dev/null +++ b/tests/data/gas_air_products_mixed_031.inp @@ -0,0 +1,26 @@ +*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=AIR_PARTICLES +1, 2 +*ELSET, ELSET=PRODUCT_PARTICLES +3, 4 +*MATERIAL, NAME=AIR, TYPE=GAS +*DENSITY +1.2 +*MATERIAL, NAME=PRODUCTS, TYPE=GAS +*DENSITY +1600.0 +*SECTION, ELSET=AIR_PARTICLES, MATERIAL=AIR +*SECTION, ELSET=PRODUCT_PARTICLES, MATERIAL=PRODUCTS +*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=AIR, GAMMA=1.4, E0=2.0, P0=0.0 +*SPHLITE EOS, TYPE=JWL, MATERIAL=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.01, VOLUME=0.008 +*SPHLITE TIME CONTROL, DT=1.0E-8, TIME=2.0E-8, STEPS=2, SAFETY=0.5 diff --git a/tests/data/gas_eos_unknown_material_031.inp b/tests/data/gas_eos_unknown_material_031.inp new file mode 100644 index 0000000..82fd2bf --- /dev/null +++ b/tests/data/gas_eos_unknown_material_031.inp @@ -0,0 +1,13 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=AIR_PARTICLES +1 +*MATERIAL, NAME=AIR, TYPE=GAS +*DENSITY +1.2 +*SECTION, ELSET=AIR_PARTICLES, MATERIAL=AIR +*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=MISSING_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_material_missing_density_031.inp b/tests/data/gas_material_missing_density_031.inp new file mode 100644 index 0000000..ddc5d01 --- /dev/null +++ b/tests/data/gas_material_missing_density_031.inp @@ -0,0 +1,11 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=AIR_PARTICLES +1 +*MATERIAL, NAME=AIR, TYPE=GAS +*SECTION, ELSET=AIR_PARTICLES, MATERIAL=AIR +*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=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_material_missing_eos_031.inp b/tests/data/gas_material_missing_eos_031.inp new file mode 100644 index 0000000..76c6564 --- /dev/null +++ b/tests/data/gas_material_missing_eos_031.inp @@ -0,0 +1,12 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=AIR_PARTICLES +1 +*MATERIAL, NAME=AIR, TYPE=GAS +*DENSITY +1.2 +*SECTION, ELSET=AIR_PARTICLES, MATERIAL=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_multisection_031.inp b/tests/data/gas_multisection_031.inp new file mode 100644 index 0000000..d612532 --- /dev/null +++ b/tests/data/gas_multisection_031.inp @@ -0,0 +1,22 @@ +*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=AIR_FRONT +1, 2 +*ELSET, ELSET=AIR_REAR +3, 4 +*MATERIAL, NAME=AIR, TYPE=GAS +*DENSITY +1.2 +*SECTION, ELSET=AIR_FRONT, MATERIAL=AIR +*SECTION, ELSET=AIR_REAR, MATERIAL=AIR +*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=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_products_jwl_031.inp b/tests/data/gas_products_jwl_031.inp new file mode 100644 index 0000000..6329507 --- /dev/null +++ b/tests/data/gas_products_jwl_031.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=PRODUCT_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=PRODUCTS, TYPE=GAS +*DENSITY +1600.0 +*SECTION, ELSET=PRODUCT_PARTICLES, MATERIAL=PRODUCTS +*SPHLITE EOS, TYPE=JWL, MATERIAL=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_stiffened_031.inp b/tests/data/gas_stiffened_031.inp new file mode 100644 index 0000000..16a7e97 --- /dev/null +++ b/tests/data/gas_stiffened_031.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=STIFF_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=STIFF_GAS, TYPE=GAS +*DENSITY +5.0 +*SECTION, ELSET=STIFF_PARTICLES, MATERIAL=STIFF_GAS +*SPHLITE EOS, TYPE=STIFFENED_GAS, MATERIAL=STIFF_GAS, RHO0=5.0, GAMMA=1.3, E0=2000.0, PINF=100.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_three_eos_031.inp b/tests/data/gas_three_eos_031.inp new file mode 100644 index 0000000..8b38dc9 --- /dev/null +++ b/tests/data/gas_three_eos_031.inp @@ -0,0 +1,37 @@ +*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 +5, 0.1, 0.1, 0.0 +6, 0.1, 0.0, 0.1 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +5, 5 +6, 6 +*ELSET, ELSET=AIR_PARTICLES +1, 2 +*ELSET, ELSET=PRODUCT_PARTICLES +3, 4 +*ELSET, ELSET=STIFF_PARTICLES +5, 6 +*MATERIAL, NAME=AIR, TYPE=GAS +*DENSITY +1.2 +*MATERIAL, NAME=PRODUCTS, TYPE=GAS +*DENSITY +1600.0 +*MATERIAL, NAME=STIFF_GAS, TYPE=GAS +*DENSITY +5.0 +*SECTION, ELSET=AIR_PARTICLES, MATERIAL=AIR +*SECTION, ELSET=PRODUCT_PARTICLES, MATERIAL=PRODUCTS +*SECTION, ELSET=STIFF_PARTICLES, MATERIAL=STIFF_GAS +*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=AIR, GAMMA=1.4, E0=2.0, P0=0.0 +*SPHLITE EOS, TYPE=JWL, MATERIAL=PRODUCTS, RHO0=1600.0, A=3.712E11, B=3.231E9, R1=4.15, R2=0.95, OMEGA=0.3, E0=4.2E6 +*SPHLITE EOS, TYPE=STIFFENED_GAS, MATERIAL=STIFF_GAS, RHO0=5.0, GAMMA=1.3, E0=2000.0, PINF=100.0 +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=0.01, VOLUME=0.008 +*SPHLITE TIME CONTROL, DT=1.0E-8, TIME=2.0E-8, STEPS=2, SAFETY=0.5 diff --git a/tests/data/gas_unbound_material_warning_031.inp b/tests/data/gas_unbound_material_warning_031.inp new file mode 100644 index 0000000..5b10be5 --- /dev/null +++ b/tests/data/gas_unbound_material_warning_031.inp @@ -0,0 +1,19 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +*ELSET, ELSET=AIR_PARTICLES +1, 2 +*MATERIAL, NAME=AIR, TYPE=GAS +*DENSITY +1.2 +*MATERIAL, NAME=PRODUCTS, TYPE=GAS +*DENSITY +1600.0 +*SECTION, ELSET=AIR_PARTICLES, MATERIAL=AIR +*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=AIR, GAMMA=1.4, E0=2.0, P0=0.0 +*SPHLITE EOS, TYPE=JWL, MATERIAL=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.01, VOLUME=0.008 +*SPHLITE TIME CONTROL, DT=1.0E-6, TIME=2.0E-6, STEPS=2, SAFETY=0.5 diff --git a/tests/interface/test_c_api.c b/tests/interface/test_c_api.c index bc364c4..66db71c 100644 --- a/tests/interface/test_c_api.c +++ b/tests/interface/test_c_api.c @@ -112,7 +112,7 @@ int main(void) ierr = sphlite_get_version(&major, &minor, &patch); if (ierr != 0) return fail("get_version failed"); - if (major != 0 || minor != 3 || patch != 0) return fail("unexpected version"); + if (major != 0 || minor != 3 || 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 a2443d2..dcbcb72 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 != 3 || version.patch != 0) { + if (version.major != 0 || version.minor != 3 || version.patch != 1) { return 1; } diff --git a/tests/unit/test_smoke.f90 b/tests/unit/test_smoke.f90 index 216cf0b..575890f 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 /= 3 .or. patch /= 0) call fail('unexpected version') + if (major /= 0 .or. minor /= 3 .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 01c4757..24806f7 100644 --- a/todo.md +++ b/todo.md @@ -1,217 +1,147 @@ # SPHLite TODO -当前目标版本:0.3.0 +当前目标版本:0.3.1 -本文档依据 `docs/v3.0_development_plan.md` 拆分。0.3.0 定位为 `Gas` 模块的第一个正式开发版本,目标是在 0.2.2 `Water` 稳定化基线之上建立 Gas 输入、状态、EOS、显式推进、诊断、输出、restart、接口和 release gate 的最小闭环。 +本文档依据 `docs/v3.1_development_plan.md` 拆分。0.3.1 定位为 `Gas` 模块稳定化和前置加固版本,目标是在 0.3.0 Gas 最小闭环基础上,补强多 Gas material/EOS、Gas 源项占位、诊断一致性、restart 兼容性、接口覆盖和 release gate 可维护性。 -所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.3.0 不实现 Explosive 生产算法、Solid 生产路径、Shell 生产路径或真实 FEM-SPH 联合运行。 +所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.3.1 不实现 Explosive 解析点火、爆轰传播、反应进度、炸药 phase 迁移、Solid/Shell 生产求解路径或真实 FEM-SPH 耦合。 执行约定:每完成 20 个待办事项,进行一次本地 git 提交,暂不推送远端。 -## 阶段 A:版本和基线 +## 阶段 A:版本基线与输入样例 -- [x] 确认当前 git 状态并记录 0.3.0 开发起点。 -- [x] 确认 `v0.2.2` 发布标签可作为 0.3.0 基线。 -- [x] 将核心软件版本更新为 `0.3.0`。 -- [x] 将 CMake 项目版本更新为 `0.3.0`。 +- [x] 确认当前 git 状态并记录 0.3.1 开发起点。 +- [x] 确认 `v0.3.0` 标签和 0.3.0 发布提交可作为 0.3.1 基线。 +- [x] 将核心软件版本更新为 `0.3.1`。 +- [x] 将 CMake 项目版本更新为 `0.3.1`。 - [x] 更新 Fortran smoke 测试中的版本期望。 - [x] 更新 C API 测试中的版本期望。 - [x] 更新 C++ API 测试中的版本期望。 - [x] 更新 Python debug 测试中的版本期望。 - [x] 更新 CLI `--version` 和 inspect 版本期望。 -- [x] 在 README 中记录 0.3.0 Gas 开发定位。 +- [x] 在 README 中记录 0.3.1 Gas 稳定化开发定位。 +- [x] 创建空气类 `TYPE=GAS` 理想气体输入样例。 +- [x] 创建爆轰产物类 `TYPE=GAS` JWL 输入样例。 +- [x] 创建 `TYPE=GAS` Stiffened gas 输入样例。 +- [x] 创建同一模型同时包含空气和爆轰产物 Gas material 的输入样例。 +- [x] 创建同一模型包含三类 Gas EOS 的输入样例。 +- [x] 创建多个 Gas section 绑定不同 Gas material 的输入样例。 +- [x] 创建 Gas material 没有关联 active 粒子的 warning 输入样例。 +- [x] 创建某个 Gas material 缺失 `*DENSITY` 的错误输入样例。 +- [x] 创建某个 Gas material 缺失 `*SPHLITE EOS` 的错误输入样例。 +- [x] 创建 `*SPHLITE EOS` 引用不存在 material 的错误输入样例。 -## 阶段 B:Gas 输入测试数据 +## 阶段 B:Gas 多材料输入解析与状态表 -- [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 混合粒子的输入文件。 +- [ ] 为 Gas material 数量增加集中式统计字段。 +- [ ] 为 Gas material 内部 id 增加存储字段。 +- [ ] 为 Gas material 名称增加存储字段。 +- [ ] 为 Gas material EOS 类型增加存储字段。 +- [ ] 为 Gas material 密度默认值增加存储字段。 +- [ ] 为 Gas material 内能默认值增加存储字段。 +- [ ] 为 Gas material 温度默认值增加存储字段。 +- [ ] 为理想气体 EOS 增加 material 级参数表。 +- [ ] 为 JWL EOS 增加 material 级参数表。 +- [ ] 为 Stiffened gas EOS 增加 material 级参数表。 +- [ ] 增加 Gas material 状态表初始化过程。 +- [ ] 增加 Gas material 状态表清理过程。 +- [ ] 增加按 material 名称查找 Gas material id 的过程。 +- [ ] 将 `*MATERIAL, TYPE=GAS` 解析结果注册到 Gas material 状态表。 +- [ ] 将 `*SPHLITE EOS, MATERIAL=...` 解析结果绑定到对应 Gas material。 +- [ ] 对同一 Gas material 重复定义 EOS 的输入报 error。 +- [ ] 对非 Gas material 定义 Gas EOS 的输入报 error。 +- [ ] 对 Gas material 缺失 EOS 的输入报 error。 +- [ ] 对 Gas material 无 active 粒子的输入报 warning。 +- [ ] 保持 0.3.0 单 Gas material 输入兼容通过。 -## 阶段 C:Gas 输入解析 +## 阶段 C:EOS 分派、状态初始化与时间步 -- [x] 扩展 material 识别以支持 `TYPE=GAS`。 -- [x] 保持 set 只作为集合而不参与 Gas 类型判断。 -- [x] 解析 `*SPHLITE EOS, TYPE=IDEAL_GAS`。 -- [x] 解析 `*SPHLITE EOS, TYPE=JWL`。 -- [x] 解析 `*SPHLITE EOS, TYPE=STIFFENED_GAS`。 -- [x] 校验 Gas EOS 必需字段缺失时报 error。 -- [x] 校验 Gas EOS 非法数值时报 error。 -- [x] 校验 Gas material 与 section 绑定关系。 -- [x] 确认 Gas warning 不影响可运行输入。 -- [x] 增加 `input_gas` 测试目标并接入 CTest。 +- [ ] 将 Gas 压力更新改为按粒子 `material_id` 分派 EOS。 +- [ ] 为理想气体压力更新增加 material 级分派测试。 +- [ ] 为 JWL 压力更新增加 material 级分派测试。 +- [ ] 为 Stiffened gas 压力更新增加 material 级分派测试。 +- [ ] 增加空气和爆轰产物混合输入的逐粒子压力检查。 +- [ ] 对 Gas 粒子 material 无 EOS 的状态更新路径报 error。 +- [ ] 将 Gas 初始密度设置改为按 material 分派。 +- [ ] 将 Gas 初始内能设置改为按 material 分派。 +- [ ] 将 Gas 初始温度设置改为按 material 分派。 +- [ ] 将 Gas 初始压力设置改为按 material EOS 计算。 +- [ ] 将 Gas 默认质量控制策略改为按 material 或共享策略处理。 +- [ ] 将 Gas 默认体积控制策略改为按 material 或共享策略处理。 +- [ ] 将 Gas 默认光滑长度策略改为按 material 或共享策略处理。 +- [ ] 将 Gas 外部体力策略保持为共享路径并补充混合材料测试。 +- [ ] 将 Gas 声速估计改为按 material/EOS 分派。 +- [ ] 将 Gas CFL 时间步限制改为记录 `gas_dt_cfl`。 +- [ ] 将 Gas 加速度时间步限制改为记录 `gas_dt_accel`。 +- [ ] 将 Gas 临界时间步取值改为使用各分量最小值。 +- [ ] 增加混合 Gas material 的时间步估计测试。 +- [ ] 确认 Water 时间步和 pressure wave smoke 行为未被 Gas 改动影响。 -## 阶段 D:Gas 模块状态 +## 阶段 D:Gas 源项占位、诊断与输出 -- [x] 初始化 Gas 模块生命周期状态。 -- [x] 重置 Gas 模块时清空 EOS 和诊断状态。 -- [x] 在数据库中确认 `SPH_PHASE_GAS` 常量与 C/Python 常量一致。 -- [x] 建立 Gas material 名称和内部 id 记录。 -- [x] 建立 Gas 默认 `h`、`mass` 和 `volume` 控制参数。 -- [x] 建立 Gas 外部体力状态。 -- [x] 建立 Gas 稳定时间步诊断状态。 -- [x] 建立 Gas summary 诊断状态。 -- [x] 建立 Gas bubble metrics 历史状态。 -- [x] 确认 Water 状态不读取 Gas 专属变量。 +- [ ] 增加 `gas_mass_source(:)` 状态数组。 +- [ ] 增加 `gas_energy_source(:)` 状态数组。 +- [ ] 增加 `gas_momentum_source(:,:)` 状态数组。 +- [ ] 在粒子数量变化或模型初始化时分配 Gas 源项数组。 +- [ ] 在模型清理时释放 Gas 源项数组。 +- [ ] 实现 `sph_gas_clear_sources` 内部过程。 +- [ ] 实现 `sph_gas_add_source_by_particle` 内部过程。 +- [ ] 实现 `sph_gas_apply_sources_explicit` 内部过程。 +- [ ] 实现 `sph_gas_get_source_summary` 内部过程。 +- [ ] 对非法粒子 id 添加 Gas 源项时报 error。 +- [ ] 对非 Gas 粒子添加 Gas 源项时报 error。 +- [ ] 对非法数值源项添加 Gas 源项时报 error。 +- [ ] 增加 Gas 质量源项累计和清零测试。 +- [ ] 增加 Gas 动量源项累计和清零测试。 +- [ ] 增加 Gas 能量源项累计和清零测试。 +- [ ] 增加 Gas 源项显式应用后质量变化测试。 +- [ ] 增加 Gas 源项显式应用后速度或动量变化测试。 +- [ ] 增加 Gas 源项显式应用后内能或能量变化测试。 +- [ ] 扩展 Gas summary,输出动量和密度范围。 +- [ ] 扩展 Gas output,输出稳定的 0.3.1 诊断字段。 -## 阶段 E:理想气体 EOS +## 阶段 E:Restart、API、C++、Python 与 CLI -- [x] 实现理想气体 EOS 参数设置。 -- [x] 校验理想气体 `gamma > 1`。 -- [x] 校验理想气体 `rho > 0`。 -- [x] 校验理想气体 `internal_energy >= 0`。 -- [x] 计算理想气体压力。 -- [x] 支持理想气体可选 `P0` 偏置。 -- [x] 增加理想气体参考压力测试。 -- [x] 增加理想气体压力单调性测试。 -- [x] 增加理想气体非法参数测试。 -- [x] 增加 `gas_eos_ideal` 测试目标并接入 CTest。 +- [ ] 设计 0.3.1 restart 的 Gas state revision 标识。 +- [ ] 将 Gas material/EOS 表写入 0.3.1 restart。 +- [ ] 将 Gas 默认粒子控制状态写入 0.3.1 restart。 +- [ ] 将 Gas 外部体力状态写入 0.3.1 restart。 +- [ ] 将 Gas 源项缓存写入 0.3.1 restart。 +- [ ] 将 Gas dt 诊断写入 0.3.1 restart。 +- [ ] 将 Gas bubble metrics 历史状态写入 0.3.1 restart。 +- [ ] 从 0.3.1 restart 读回 Gas material/EOS 表。 +- [ ] 从 0.3.1 restart 读回 Gas 源项缓存。 +- [ ] 从 0.3.1 restart 读回后重建邻域并继续显式步。 +- [ ] 增加读取 0.3.0 `STATE_0_3` restart 的兼容路径。 +- [ ] 为 0.3.0 restart 缺失的 Gas material 表初始化默认值。 +- [ ] 为 0.3.0 restart 缺失的 Gas 源项状态初始化零值。 +- [ ] 增加 `sph_get_gas_extended_summary` Fortran API。 +- [ ] 增加 `sph_get_gas_source_summary` Fortran API。 +- [ ] 在 C ABI 中追加 Gas extended summary 查询接口。 +- [ ] 在 C ABI 中追加 Gas source summary 查询接口。 +- [ ] 在 C++ wrapper 中增加 Gas extended/source summary 薄包装。 +- [ ] 在 Python ctypes 中增加 Gas extended/source summary 薄包装。 +- [ ] 在 CLI inspect/run 中增加 0.3.1 Gas 扩展字段检查。 -## 阶段 F:JWL EOS +## 阶段 F:测试接入、文档同步与发布门禁 -- [x] 实现 JWL EOS 参数设置。 -- [x] 校验 JWL `rho0 > 0`。 -- [x] 校验 JWL `R1 > 0` 和 `R2 > 0`。 -- [x] 校验 JWL `omega > 0`。 -- [x] 校验 JWL `internal_energy >= 0`。 -- [x] 按 `V = rho0 / rho` 计算相对体积。 -- [x] 计算 JWL 压力。 -- [x] 增加 JWL 有限性测试。 -- [x] 增加 JWL 非法参数测试。 -- [x] 增加 `gas_eos_jwl` 测试目标并接入 CTest。 - -## 阶段 G:Stiffened Gas EOS - -- [x] 实现 Stiffened gas EOS 参数设置。 -- [x] 锁定 Stiffened gas 的输入字段命名。 -- [x] 校验 Stiffened gas `gamma > 1`。 -- [x] 校验 Stiffened gas `rho0 > 0`。 -- [x] 校验 Stiffened gas `internal_energy >= 0`。 -- [x] 校验 Stiffened gas `PINF` 的允许范围。 -- [x] 计算 Stiffened gas 压力。 -- [x] 增加 Stiffened gas 有限性测试。 -- [x] 增加 Stiffened gas 非法参数测试。 -- [x] 增加 `gas_eos_stiffened` 测试目标并接入 CTest。 - -## 阶段 H:Gas 状态初始化 - -- [x] 将 Gas material 对应粒子初始化为 `SPH_PHASE_GAS`。 -- [x] 初始化 Gas 粒子 `rho`。 -- [x] 初始化 Gas 粒子 `pressure`。 -- [x] 初始化 Gas 粒子 `internal_energy`。 -- [x] 初始化 Gas 粒子 `temperature`。 -- [x] 初始化 Gas 粒子 `mass`。 -- [x] 初始化 Gas 粒子 `volume`。 -- [x] 初始化 Gas 粒子 `h`。 -- [x] 确认非 Gas 粒子不被 Gas 初始化改写。 -- [x] 增加 `gas_state` 测试目标并接入 CTest。 - -## 阶段 I:Gas Summary - -- [x] 统计 active Gas 粒子数量。 -- [x] 统计 Gas 总质量。 -- [x] 统计 Gas 总体积。 -- [x] 统计 Gas 动量。 -- [x] 计算 Gas 体积加权中心。 -- [x] 计算 Gas 平均压力。 -- [x] 计算 Gas 最大压力。 -- [x] 计算 Gas 密度范围。 -- [x] 确认 inactive 或 failed 粒子不进入 Gas summary。 -- [x] 增加 `gas_summary` 测试目标并接入 CTest。 - -## 阶段 J:Bubble 诊断 - -- [x] 按 Gas 总体积计算等效气泡半径。 -- [x] 保存上一时间步等效气泡半径。 -- [x] 计算等效气泡半径变化率。 -- [x] 保存上一时间步 Gas 中心。 -- [x] 计算 Gas 中心迁移量。 -- [x] 处理无 Gas 粒子时的 bubble metrics 默认值。 -- [x] 处理零体积 Gas 粒子时的错误路径。 -- [x] 在文档中说明 0.3.0 bubble metrics 为单气团近似。 -- [x] 增加 bubble metrics 单元测试。 -- [x] 将 bubble metrics 纳入 `gas_summary` 或独立测试。 - -## 阶段 K:Gas 单相显式推进 - -- [x] 实现 Gas 压力更新入口。 -- [x] 实现 Gas 密度变化率计算。 -- [x] 实现 Gas 压力加速度计算。 -- [x] 实现 Gas 人工黏性占位或明确跳过策略。 -- [x] 合成 Gas 外部体力加速度。 -- [x] 将 Gas 计算接入显式步进流程。 -- [x] 确认 Gas 显式步不改变 Water 单相结果。 -- [x] 实现 Gas 稳定时间步估计。 -- [x] 增加 Gas 单步推进测试。 -- [x] 增加 `solver_gas` 测试目标并接入 CTest。 - -## 阶段 L:Gas 输出 - -- [x] 保持粒子 CSV 通用字段兼容。 -- [x] 在 summary CSV 写入 `gas_particles`。 -- [x] 在 summary CSV 写入 `gas_mass`。 -- [x] 在 summary CSV 写入 `gas_volume`。 -- [x] 在 summary CSV 写入 Gas 中心三分量。 -- [x] 在 summary CSV 写入 Gas 平均压力和最大压力。 -- [x] 在 summary CSV 写入等效气泡半径。 -- [x] 在 summary CSV 写入半径变化率。 -- [x] 在 summary CSV 写入 `gas_dtcrit`。 -- [x] 增加 `gas_output` 测试目标并接入 CTest。 - -## 阶段 M:Gas Restart - -- [x] 更新 restart 状态版本策略。 -- [x] 写入 Gas EOS 类型和参数。 -- [x] 写入 Gas 默认粒子控制参数。 -- [x] 写入 Gas 外部体力。 -- [x] 写入 Gas summary 诊断状态。 -- [x] 写入 bubble metrics 历史状态。 -- [x] 写入 Gas 稳定时间步诊断。 -- [x] 读回 Gas restart 后重建邻域。 -- [x] 读回 Gas restart 后继续显式步。 -- [x] 增加 `gas_restart` 测试目标并接入 CTest。 - -## 阶段 N:Fortran API 与 C ABI - -- [x] 增加 Fortran `sph_get_gas_summary`。 -- [x] 增加 Fortran `sph_get_gas_bubble_metrics`。 -- [x] 增加 Fortran `sph_get_gas_dt_limits`。 -- [x] 增加 C ABI `sphlite_get_gas_summary`。 -- [x] 增加 C ABI `sphlite_get_gas_bubble_metrics`。 -- [x] 增加 C ABI `sphlite_get_gas_dt_limits`。 -- [x] 为 Gas C ABI 增加空指针错误测试。 -- [x] 为 Gas C ABI 增加未初始化错误测试。 -- [x] 为 Gas C ABI 增加未 build 错误测试。 -- [x] 更新 C API 测试目标以覆盖 Gas 诊断。 - -## 阶段 O:C++、Python 和 CLI - -- [x] 在 C++ wrapper 中增加 Gas summary 薄封装。 -- [x] 在 C++ wrapper 中增加 bubble metrics 薄封装。 -- [x] 在 C++ wrapper 测试中覆盖 Gas 诊断。 -- [x] 在 Python ctypes 中增加 Gas summary 封装。 -- [x] 在 Python ctypes 中增加 bubble metrics 封装。 -- [x] 在 Python debug 测试中覆盖 Gas inspect。 -- [x] 在 Python debug 测试中确认不访问 Fortran 内部符号。 -- [x] 在 CLI inspect 输出中增加 Gas 诊断字段。 -- [x] 在 CLI run 输出中增加 Gas 诊断字段。 -- [x] 更新 CLI 测试以覆盖 Gas 输入和错误路径。 - -## 阶段 P:回归、文档和发布记录 - -- [x] 运行 0.2.2 Water 默认 gate 并确认全部通过。 -- [x] 运行 0.3.0 新增 Gas gate 并确认全部通过。 -- [x] 运行 `source_size` 门禁。 -- [x] 运行 `git diff --check`。 -- [x] 确认没有提交 build 目录或临时输出。 -- [x] 更新 README 的 0.3.0 当前能力说明。 -- [x] 更新 `docs/09_release_history.md` 的 0.3.0 条目。 -- [x] 更新 `docs/11_benchmark_matrix.md` 的 0.3.0 gate。 -- [x] 复核文档未宣称 0.3.0 已实现 Explosive、Solid、Shell 或真实 FEM-SPH 耦合。 -- [x] 给出 0.3.0 是否发布以及是否进入 0.4.0 Explosive 的最终建议。 +- [ ] 新增 `input_gas_multimaterial` 测试并接入 CTest。 +- [ ] 新增 `gas_eos_dispatch` 测试并接入 CTest。 +- [ ] 新增 `gas_source` 测试并接入 CTest。 +- [ ] 新增 `gas_source_errors` 测试并接入 CTest。 +- [ ] 新增 `gas_extended_summary` 测试并接入 CTest。 +- [ ] 新增 `gas_restart_031` 测试并接入 CTest。 +- [ ] 新增 `gas_restart_030_compat` 测试并接入 CTest。 +- [ ] 新增 `gas_cli_extended` 测试并接入 CTest。 +- [ ] 新增 `gas_python_extended` 测试并接入 CTest。 +- [ ] 新增 `gas_source_size_cleanup` 测试或检查项并接入 CTest。 +- [ ] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。 +- [ ] 拆分因 0.3.1 改动变长的 Fortran 过程。 +- [ ] 保持 0.3.0 默认 gate 全部通过。 +- [ ] 单独运行 0.3.1 新增 Gas 稳定化 gate。 +- [ ] 运行 `source_size` 检查并确认无新增无理由例外。 +- [ ] 运行 `git diff --check` 并清理空白问题。 +- [ ] 更新 `docs/06_test_and_verification_plan.md` 的 0.3.1 测试范围。 +- [ ] 更新 `docs/09_release_history.md` 的 0.3.1 待发布记录。 +- [ ] 更新 `docs/11_benchmark_matrix.md` 的 0.3.1 验收矩阵。 +- [ ] 确认文档未宣称 0.3.1 已实现 Explosive、Solid、Shell 或真实 FEM-SPH 耦合。 diff --git a/tools/testing/test_cli.py b/tools/testing/test_cli.py index 51c0e46..f1b097b 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.3.0" not in version.stdout: + if "0.3.1" not in version.stdout: raise AssertionError("CLI version mismatch") inspect = run_command([exe, model]) @@ -78,7 +78,7 @@ def main() -> int: ): require_field(inspect.stdout, field) inspect_fields = read_fields(inspect.stdout) - if inspect_fields["version"] != "0.3.0": + if inspect_fields["version"] != "0.3.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 3a9b6f2..4f1424d 100644 --- a/tools/testing/test_python_debug.py +++ b/tools/testing/test_python_debug.py @@ -29,7 +29,7 @@ def main() -> int: raise AssertionError("Python wrapper is not using the C ABI library") if not hasattr(solver.lib, "sphlite_get_gas_summary"): raise AssertionError("Python wrapper is missing Gas C ABI diagnostics") - if solver.version() != (0, 3, 0): + if solver.version() != (0, 3, 1): raise AssertionError("Python version mismatch") solver.initialize()