diff --git a/CMakeLists.txt b/CMakeLists.txt index e5aa453..9b01947 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,6 +1,6 @@ cmake_minimum_required(VERSION 3.20) -project(SPHLite VERSION 0.3.1 LANGUAGES C CXX Fortran) +project(SPHLite VERSION 0.4.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 8955bd1..1f7735f 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。 -当前目标版本:0.3.1。该版本定位为 `Gas` 模块稳定化和前置加固版本,在 0.3.0 `Gas` 最小闭环之上补强多 Gas material/EOS、Gas 源项占位、诊断一致性、restart 兼容性和接口覆盖。不交付 `Explosive`、`Solid`、`Shell` 的生产路径,也不交付真实 FEM-SPH 联合运行。 +当前目标版本:0.4.0。该版本定位为 `Explosive` 模块起步版本,在 0.3.1 `Gas` 稳定化基础上建立解析点火、爆轰到达时间、programmed burn 反应进度,以及向 `Gas` 释放质量、动量和能量的最小闭环。不交付 `Solid`、`Shell` 的生产路径,也不交付真实 FEM-SPH 联合运行或工程级水下爆炸 benchmark。 代码仓库地址: @@ -63,14 +63,15 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: ## 当前状态 -0.3.1 当前实现重点包括: +0.4.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、Gas 状态初始化、单相显式推进、气体 summary、bubble metrics、Gas CSV/restart 和公开诊断接口。 +- Gas material、三类 Gas EOS、Gas 状态初始化、单相显式推进、气体 summary、bubble metrics、Gas CSV/restart、Gas 源项缓存和公开诊断接口。 +- `Explosive` 的解析点火、爆轰到达时间、反应进度、释放量统计、Gas 源项注入和 phase 转化最小闭环。 - CouplingInterface 的中立数据导出、外部粒子力导入和诊断占位;0.2.2 不暴露 CouplingInterface C ABI,真实 FEM-SPH 联合运行仍由外部 CouplingModule 后续实现。 -- `Explosive`、`Solid`、`Shell` 仍为后续阶段,不在 0.3.1 交付生产计算路径。 -- 0.3.1 release gate 与 source size 门禁。 +- `Solid`、`Shell` 仍为后续阶段,不在 0.4.0 交付生产计算路径。 +- 0.4.0 release gate 与 source size 门禁。 diff --git a/docs/v4.0_development_plan.md b/docs/v4.0_development_plan.md new file mode 100644 index 0000000..1c8e366 --- /dev/null +++ b/docs/v4.0_development_plan.md @@ -0,0 +1,511 @@ +# SPHLite v4.0 开发计划 + +文档状态:0.4.0 开发计划草案 + +目标软件版本:SPHLite 0.4.0 + +## 1. 文档定位 + +本文档用于规划 SPHLite 0.4.0 版本的开发范围。0.4.0 是 `Explosive` 版本线的起步版本,目标是在 0.3.1 已完成 `Gas` 多材料、EOS 分派、源项缓存、扩展诊断和 restart 兼容的基础上,建立炸药粒子的解析点火、爆轰到达时间、反应进度和向 `Gas` 释放质量、动量、能量的最小闭环。 + +0.4.0 应服务于船舶水下接触爆炸长期目标,但不应膨胀为完整水下爆炸工程 benchmark。第一版重点是把 `Explosive` 与 `Gas` 的模块边界、状态、输入、显式推进、restart、接口和测试 gate 建稳。 + +## 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.1_development_plan.md` +- `docs/09_release_history.md` +- `docs/10_development_roadmap.md` +- `docs/11_benchmark_matrix.md` + +## 3. 版本定位 + +### 3.1 与 0.3.1 的关系 + +0.3.1 已完成 `Gas` 稳定化和 0.4.0 前置条件: + +- 多个 `TYPE=GAS` material 可各自绑定 EOS。 +- JWL、理想气体和 Stiffened gas 可按 material 分派。 +- `Gas` 具备质量、动量和能量源项缓存。 +- `Gas` 源项可清零、累计、应用和诊断。 +- `Gas` restart、CLI、Python、C ABI 和扩展 summary 已有稳定 gate。 + +0.4.0 应利用上述能力,不重新定义气体模块,也不把气泡作为独立一级模块。炸药反应产生的产物气体进入 `Gas` 后,再由 `Gas` 诊断气体体积、等效气泡半径、压力和中心迁移。 + +### 3.2 与 0.5.0 的关系 + +0.5.0 建议作为 `Solid` 起点。0.4.0 不实现 Johnson-Cook 结构材料、结构损伤、实体结构破裂或结构接触响应。若 0.4.0 需要检查爆炸载荷方向,可使用 Water/Gas/Explosive 小模型,不引入生产级结构响应。 + +### 3.3 0.4.0 核心目标 + +0.4.0 的核心目标是形成如下最小闭环: + +```text +Explosive material + ignition point + -> detonation arrival time + -> reaction progress lambda + -> mass/momentum/energy release + -> Gas source or Gas phase conversion + -> Gas pressure/update/output/restart diagnostics +``` + +## 4. 开发原则 + +### 4.1 保持模块边界 + +SPHLite 仍只修改本仓库内容,不修改 FEMLite 或其他外部模块。SPHLite 不直接依赖 FEMLite,也不直接依赖外部 CouplingModule、CoupleLite、CoupledLite 或 CouplingLite。 + +`Explosive` 只负责点火、爆轰到达、反应进度和源项释放;`Gas` 负责产物气体 EOS、压力更新、气体统计和气泡诊断。 + +### 4.2 保持求解器定位 + +SPHLite 是求解器,不负责几何建模、网格生成或粒子生成。0.4.0 可以新增测试 `.inp` 文件和 Python checker,但这些只能作为测试和示例辅助,不作为求解器粒子生成能力宣传。 + +### 4.3 保持 Fortran 95 核心 + +核心实现继续使用 Fortran 95。C ABI、C++ wrapper 和 Python ctypes 仍作为薄接口层。0.4.0 不引入破坏 FEMLite 风格工具链兼容性的第三方运行时依赖。 + +### 4.4 保持显式动力学路线 + +时间推进继续只支持 Velocity-Verlet 显式动力学。0.4.0 不引入隐式求解、静力求解、Newmark 路线或隐式-显式混合接口。 + +### 4.5 保持 Abaqus 子集策略 + +输入文件继续解析 SPHLite 支持的 Abaqus `.inp` 明确子集。能复用 Abaqus 关键词时不新增关键词;Abaqus 无法表达的炸药点火、爆轰和反应控制使用 `*SPHLITE ...` 扩展关键词。 + +### 4.6 保持 Water/Gas 回归稳定 + +0.4.0 新增 `Explosive` 后,必须保持 0.2 `Water` 和 0.3 `Gas` 既有 gate 稳定。炸药反应不得改变未参与爆炸的 Water/Gas-only 算例结果。 + +## 5. 0.4.0 交付目标 + +0.4.0 建议交付以下内容: + +1. 将软件版本更新为 `0.4.0`。 +2. 新增 `Explosive` 模块骨架和生命周期 reset/build/advance/finalize 路径。 +3. 支持 `TYPE=EXPLOSIVE` material 和 explosive section 的输入识别。 +4. 支持炸药密度、爆速、单位质量能量、反应时间窗口和产物 Gas material 映射。 +5. 支持至少一个解析点火点,包括坐标和起爆时间。 +6. 按初始坐标计算炸药粒子的爆轰到达时间 `td(i)`。 +7. 保存并推进不可逆反应进度 `lambda(i)`,范围为 `0 <= lambda <= 1`。 +8. 由反应进度增量生成质量、动量和能量释放量。 +9. 将释放量写入 0.3.1 已有的 `Gas` 源项缓存,并通过显式步应用到产物 Gas 状态。 +10. 支持炸药粒子不可逆转化为产物 Gas phase 的最小路径。 +11. 保留源项注入路径,用于炸药粒子不立即改变 phase 的测试和后续扩展。 +12. 输出 explosive summary,包括反应粒子数、平均反应进度、释放质量、释放能量和爆轰到达时间范围。 +13. 将 `Explosive` 状态写入 0.4.0 restart,并可读回继续显式步。 +14. 保持 C ABI 追加式兼容,新增 Explosive 查询接口不得破坏既有 Water/Gas 接口。 +15. 增强 Python 和 CLI,使其可以检查 explosive 输入、运行和 summary 字段。 +16. 新增 0.4.0 `Explosive` 默认 gate,并保持 0.3.1 默认 gate 全部通过。 +17. 更新 README、06、09 和 11 号文档中的 0.4.0 测试和验收记录。 + +## 6. 非交付范围 + +0.4.0 不交付以下内容: + +1. 不实现完整化学反应爆轰模型。 +2. 不实现球面经验载荷模型作为主模型。 +3. 不实现生产级近场水下爆炸强冲击 Riemann-SPH。 +4. 不实现复杂水-气界面重构、空化、相变蒸发或多气团合并/破碎算法。 +5. 不实现工程级多周期气泡脉动 benchmark。 +6. 不实现 `Solid` Johnson-Cook 材料、失效或破裂。 +7. 不实现 `Shell` Mindlin-Reissner 生产求解路径。 +8. 不实现真实 FEM-SPH 接触耦合或连续体耦合。 +9. 不暴露未冻结的 CouplingInterface C ABI。 +10. 不新增几何、网格或粒子生成能力。 + +## 7. 输入范围 + +### 7.1 Explosive material 输入 + +0.4.0 建议使用 Abaqus 风格 material/section 识别炸药粒子: + +```text +*MATERIAL, NAME=TNT, TYPE=EXPLOSIVE +*DENSITY +rho0 +*SECTION, ELSET=CHARGE_PARTICLES, MATERIAL=TNT +``` + +`TYPE=EXPLOSIVE` material 必须具备: + +- `*DENSITY`。 +- 至少一个 section 绑定,或明确没有 active 粒子时作为 warning/诊断处理。 +- 对应的 `*SPHLITE EXPLOSIVE` 控制记录。 + +### 7.2 Explosive 控制关键词 + +爆速、能量和产物 Gas material 无法用 Abaqus 通用关键词完整表达,建议使用扩展关键词: + +```text +*SPHLITE EXPLOSIVE, MATERIAL=TNT, TYPE=PROGRAMMED_BURN, DETONATION_VELOCITY=..., ENERGY=..., BURN_TIME=..., PRODUCT_MATERIAL=PRODUCTS, CONVERSION=PHASE +``` + +字段建议: + +- `MATERIAL`:炸药 material 名称。 +- `TYPE=PROGRAMMED_BURN`:0.4.0 默认反应模型。 +- `DETONATION_VELOCITY`:爆速,必须为正。 +- `ENERGY`:单位质量释放能量,必须非负。 +- `BURN_TIME`:反应时间窗口,必须非负;取 0 时表示到达后瞬时完成反应。 +- `PRODUCT_MATERIAL`:产物 Gas material,必须为 `TYPE=GAS` 且具备 EOS。 +- `CONVERSION`:`PHASE` 或 `SOURCE`。0.4.0 默认建议为 `PHASE`。 + +### 7.3 点火输入 + +点火点建议使用扩展关键词: + +```text +*SPHLITE IGNITION, MATERIAL=TNT, X=..., Y=..., Z=..., TIME=... +``` + +0.4.0 release gate 至少覆盖单点点火。模块状态可预留多个点火记录;若实现多点点火,爆轰到达时间取所有点火点中的最小到达时间: + +```text +td(i) = min_k( t_ign(k) + |x0(i) - x_ign(k)| / D ) +``` + +其中 `x0(i)` 使用炸药粒子初始坐标,`D` 使用该炸药 material 的爆速。 + +### 7.4 与 Gas 输入的关系 + +产物 Gas material 使用 0.3.1 已有 Gas 输入语义: + +```text +*MATERIAL, NAME=PRODUCTS, TYPE=GAS +*DENSITY +rho_products +*SPHLITE EOS, TYPE=JWL, MATERIAL=PRODUCTS, RHO0=..., A=..., B=..., R1=..., R2=..., OMEGA=..., E0=... +``` + +如果 `PRODUCT_MATERIAL` 缺失、不是 Gas material、或没有 EOS,必须报 error。 + +## 8. Explosive 状态设计 + +0.4.0 建议新增 `Explosive` 模块级状态: + +```fortran +integer :: explosive_material_count +integer, allocatable :: explosive_material_id(:) +integer, allocatable :: explosive_product_material_id(:) +real(rk), allocatable :: explosive_density0(:) +real(rk), allocatable :: explosive_detonation_velocity(:) +real(rk), allocatable :: explosive_energy_per_mass(:) +real(rk), allocatable :: explosive_burn_time(:) +integer, allocatable :: explosive_conversion_mode(:) + +integer, allocatable :: explosive_ignition_status(:) +real(rk), allocatable :: explosive_detonation_time(:) +real(rk), allocatable :: explosive_reaction_progress(:) +real(rk), allocatable :: explosive_released_mass(:) +real(rk), allocatable :: explosive_released_energy(:) +real(rk), allocatable :: explosive_released_momentum(:,:) +``` + +数组形状建议: + +- `explosive_detonation_time(npart)`。 +- `explosive_reaction_progress(npart)`。 +- `explosive_released_mass(npart)`。 +- `explosive_released_energy(npart)`。 +- `explosive_released_momentum(3,npart)`。 + +`reaction_progress` 是不可逆状态,只能增加不能降低。已经完全反应的粒子应保持 `lambda = 1`,并通过 phase/status 或 summary 表达后续状态。 + +## 9. 反应和源项算法 + +### 9.1 爆轰到达时间 + +0.4.0 使用解析爆轰到达时间,不使用固定球面载荷模型。对每个 active explosive 粒子: + +```text +td(i) = t_ign + |x0(i) - x_ign| / D +``` + +多点火记录若进入实现,则取最小 `td(i)`。 + +### 9.2 反应进度 + +当当前时间达到 `td(i)` 后,按 programmed burn 更新反应进度: + +```text +lambda_target = clamp((t - td(i)) / burn_time, 0, 1) +delta_lambda = max(lambda_target - lambda_old, 0) +``` + +当 `burn_time = 0` 时,`t >= td(i)` 的粒子可在当前显式步内直接达到 `lambda = 1`。 + +### 9.3 释放量 + +反应增量建议按以下第一版近似产生源项: + +```text +dm = delta_lambda * m_explosive_initial +dE = dm * energy_per_mass +dp = dm * v_explosive +``` + +其中动量源项第一版默认继承炸药粒子当前速度;静止炸药测试中动量源项为零,便于守恒检查。后续如需 Chapman-Jouguet 速度或方向性冲量,应单独规划。 + +### 9.4 Gas phase 转化路径 + +`CONVERSION=PHASE` 是 0.4.0 推荐默认路径。粒子反应后不可逆进入 `PHASE_GAS`,material 改为 `PRODUCT_MATERIAL`,并由 `Gas` 的 EOS、压力更新和诊断接管。 + +0.4.0 可采用分阶段转化策略: + +- `lambda = 0`:保持 `PHASE_EXPLOSIVE`。 +- `0 < lambda < 1`:保持 explosive 状态,同时记录部分反应进度和已释放源项。 +- `lambda = 1`:不可逆转为 `PHASE_GAS`,material 改为 product Gas material。 + +如果实现更早的部分转化,也必须保证 restart 和 summary 能恢复同一状态。 + +### 9.5 Gas source 注入路径 + +`CONVERSION=SOURCE` 作为 0.4.0 的保留路径,用于炸药粒子不立即改变 phase、但向已有 Gas 粒子或目标 Gas region 注入质量、动量和能量。第一版若无法明确目标 Gas 粒子,应报 error,不得静默丢弃源项。 + +无论选择哪条路径,0.4.0 都应复用 `Gas` 的源项缓存和 summary,不在 `Explosive` 中复制 Gas EOS 或压力计算。 + +## 10. 显式求解器集成 + +0.4.0 建议在显式步中加入 `Explosive` 更新阶段: + +```text +estimate dt +Velocity-Verlet first half update +rebuild or reuse neighbor state +Water/Gas force and EOS update +Explosive detonation/reaction update +Gas source apply and pressure refresh +Velocity-Verlet second half update +output/restart diagnostics +``` + +具体顺序可按现有求解器结构微调,但必须满足: + +- `Explosive` 反应使用当前步明确的时间点。 +- 源项应用后 `Gas` 压力和 summary 是一致的。 +- Water-only 和 Gas-only 算例不进入 Explosive 路径。 +- 反应进度和 phase 改变可被 restart 恢复。 + +时间步估计建议增加反应约束: + +```text +dt_reaction = burn_time / n_reaction_substeps +``` + +当 `burn_time = 0` 时不新增该约束;当 `burn_time > 0` 时,`dtcrit` 应考虑反应进度变化的可控性。`n_reaction_substeps` 可先作为内部常量或输入控制项。 + +## 11. Restart 和兼容策略 + +0.4.0 restart 建议写入 `STATE_0_4`,并保存完整 `Explosive` 模块状态: + +- Explosive material 表。 +- product Gas material 映射。 +- 点火记录。 +- 每粒子爆轰到达时间。 +- 每粒子反应进度。 +- 每粒子已释放质量、动量和能量。 +- phase 转化状态。 +- Explosive summary 诊断。 +- Gas 源项缓存和 0.3.1 Gas 状态。 + +兼容策略: + +- 必须继续读取 0.3.1 restart。 +- 读取 0.3.1 restart 时,若没有 Explosive 状态,应初始化为空 Explosive 状态。 +- 若 0.3.1 restart 中存在 Gas 源项缓存,应按 0.3.1 兼容逻辑保留。 +- 读回后必须能继续显式步,并重建邻域或运行时派生状态。 + +## 12. API、C ABI、C++、Python 和 CLI + +### 12.1 Fortran API + +建议新增或完善: + +- `sph_explosive_reset` +- `sph_explosive_build` +- `sph_explosive_compute_detonation_times` +- `sph_explosive_advance` +- `sph_get_explosive_summary` +- `sph_set_ignition_point` + +Fortran API 是核心语义来源,C ABI 只做薄包装。 + +### 12.2 C ABI + +C ABI 继续保持追加式设计。可新增: + +```c +int sphlite_set_ignition_point(double x, double y, double z, double time); + +int sphlite_get_explosive_summary(int *particle_count, + int *reacted_count, + double *lambda_range, + double *released_totals, + double *detonation_time_range); +``` + +建议字段含义: + +- `lambda_range[0]`:最小反应进度。 +- `lambda_range[1]`:最大反应进度。 +- `lambda_range[2]`:质量加权或粒子平均反应进度。 +- `released_totals[0]`:累计释放质量。 +- `released_totals[1]`:累计释放能量。 +- `released_totals[2..4]`:累计释放动量。 +- `detonation_time_range[0]`:最小爆轰到达时间。 +- `detonation_time_range[1]`:最大爆轰到达时间。 + +C ABI 不暴露 Fortran 内部 allocatable 数组指针。 + +### 12.3 C++ wrapper + +C++ wrapper 继续作为 C ABI 薄包装。新增 Explosive summary 结构体时,只表达 C ABI 返回数据,不重新定义反应模型。 + +### 12.4 Python ctypes + +Python API 继续通过 C ABI 调用,用于: + +- Explosive 输入 smoke。 +- 点火点设置和 summary 读取。 +- 反应进度 checker。 +- CLI 输出 checker。 + +Python 不直接访问 Fortran 内部符号。 + +### 12.5 CLI + +CLI inspect、check 和 run 模式应增加 Explosive 字段检查。建议输出或 summary CSV 包含: + +- `explosive_particles` +- `explosive_reacted_particles` +- `explosive_lambda_min` +- `explosive_lambda_max` +- `explosive_lambda_mean` +- `explosive_released_mass` +- `explosive_released_energy` +- `explosive_released_momentum_x` +- `explosive_released_momentum_y` +- `explosive_released_momentum_z` +- `explosive_detonation_time_min` +- `explosive_detonation_time_max` + +错误路径仍应向 stderr 输出 `error_code` 和 `error_message`。 + +## 13. 测试计划 + +### 13.1 新增 0.4.0 测试 + +建议新增以下测试: + +- `input_explosive`:`TYPE=EXPLOSIVE` material、section、control 和 ignition 输入。 +- `input_explosive_errors`:缺失密度、缺失 product Gas、非法爆速、非法 burn time、非法能量。 +- `explosive_detonation_time`:按初始坐标和爆速计算 `td(i)`。 +- `explosive_reaction_progress`:programmed burn 下 `lambda` 单调增加并限制在 `[0,1]`。 +- `explosive_release_source`:反应进度增量产生质量、动量和能量源项。 +- `explosive_to_gas_phase`:完全反应后 phase 不可逆转为 Gas。 +- `explosive_gas_coupling`:产物 Gas material 使用 JWL EOS 并更新 Gas summary。 +- `explosive_summary`:summary 字段和累计释放量一致。 +- `explosive_restart_040`:0.4.0 restart 写入读回后继续显式步。 +- `explosive_restart_031_compat`:读取 0.3.1 restart 并初始化空 Explosive 状态。 +- `explosive_c_api`:C ABI 点火点和 summary 查询。 +- `explosive_python`:Python ctypes 读取 Explosive summary。 +- `explosive_cli`:CLI inspect/run 输出 Explosive 字段。 +- `explosive_source_size`:新增模块和过程满足 source size gate。 + +### 13.2 既有回归测试 + +0.4.0 必须继续通过 0.3.1 默认 gate,包括 Water、Gas、restart、output、API、CLI、Python、CouplingInterface 占位和 source size。 + +### 13.3 建议 0.4.0 Release Gate + +建议 0.4.0 默认 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 +``` + +若新增测试命名较多,可额外单独运行: + +```powershell +ctest --test-dir build-codex-unix -R "^(input_explosive|input_explosive_errors|explosive_detonation_time|explosive_reaction_progress|explosive_release_source|explosive_to_gas_phase|explosive_gas_coupling|explosive_summary|explosive_restart_040|explosive_restart_031_compat|explosive_c_api|explosive_python|explosive_cli|explosive_source_size)$" --output-on-failure +``` + +## 14. 建议开发阶段 + +若后续根据本计划生成 `todo.md`,建议按以下阶段拆分: + +1. 0.4.0 版本号和 0.3.1 发布基线确认。 +2. Explosive 输入样例和错误输入样例准备。 +3. `PHASE_EXPLOSIVE`、material type 和 section 校验加固。 +4. Explosive material/control 数据结构。 +5. Ignition point 数据结构和输入解析。 +6. Product Gas material 映射和校验。 +7. 爆轰到达时间计算。 +8. Programmed burn 反应进度推进。 +9. 质量、动量和能量释放量累计。 +10. Gas source 注入路径。 +11. Gas phase 转化路径。 +12. 显式求解器中的 Explosive 更新挂接。 +13. Explosive summary 和 output 字段。 +14. 0.4.0 restart 写入。 +15. 0.4.0 restart 读回和 0.3.1 兼容读入。 +16. Fortran API 和 C ABI 追加接口。 +17. C++ wrapper、Python ctypes 和 CLI 扩展。 +18. Source size 例外复核和必要拆分。 +19. Water、Gas、Explosive 和 CouplingInterface 回归。 +20. README、06、09 和 11 号文档同步。 + +## 15. 验收标准 + +0.4.0 应满足以下验收标准: + +1. 软件版本为 `0.4.0`。 +2. `TYPE=EXPLOSIVE` material 可通过 Abaqus 风格 `.inp` 子集读取。 +3. 点火点、爆速、反应能量、反应时间窗口和 product Gas material 可被校验。 +4. 爆轰到达时间按解析公式计算。 +5. 反应进度 `lambda` 单调、不可逆,且限制在 `[0,1]`。 +6. 反应增量可产生质量、动量和能量释放量。 +7. 释放量可进入 `Gas` 源项缓存或触发产物 Gas phase 转化。 +8. 产物 Gas 使用 `Gas` 模块 EOS 和 summary,不在 `Explosive` 中重复压力计算。 +9. 0.4.0 restart 可恢复 Explosive 反应状态并继续显式步。 +10. 0.3.1 restart 可兼容读入并初始化空 Explosive 状态。 +11. C ABI、C++ wrapper、Python ctypes 和 CLI 追加接口可用。 +12. Water/Gas 既有默认 gate 继续通过。 +13. 默认 gate、source size 和 `git diff --check` 通过。 +14. 文档不宣称 0.4.0 已实现 Solid、Shell、真实 FEM-SPH 耦合或工程级水下爆炸 benchmark。 +15. 不新增 FEMLite 直接依赖。 +16. 不修改 SPHLite 文件夹之外的内容。 + +## 16. 风险与控制 + +| 风险 | 表现 | 控制方式 | +| --- | --- | --- | +| 0.4.0 范围膨胀 | 试图同时实现工程级水下爆炸、结构破坏或耦合 | 只交付 Explosive 最小闭环和小型 gate | +| Explosive/Gas 边界混乱 | Explosive 重复实现 Gas EOS 或气泡诊断 | Explosive 只释放源项,Gas 负责 EOS 和气泡诊断 | +| phase 转化不一致 | 同一粒子在 restart 后 phase/material/lambda 不一致 | restart 保存 lambda、phase、product material 和已释放量 | +| 源项重复释放 | restart 或多步推进后重复计算同一反应增量 | 只按 `delta_lambda` 释放,并保存累计释放量 | +| 动量或能量量纲混乱 | 能量按总量和单位质量混用 | 输入字段明确 `ENERGY` 为单位质量能量,测试锁定累计值 | +| Water/Gas 回归漂移 | Explosive 路径影响非爆炸算例 | 对无 Explosive 输入直接跳过模块更新,默认 gate 全量回归 | +| C ABI 过早冻结内部结构 | 直接暴露 reaction array 或 material table | C ABI 只返回 summary 和测试所需稳定字段 | +| source size 债务扩大 | 新模块过程过长或例外过多 | 按 ignition、reaction、source、restart 拆分过程 | + +## 17. 0.5.0 启动条件 + +满足以下条件后,可以启动 0.5.0 `Solid`: + +1. 0.4.0 Explosive 输入、点火、爆轰到达时间和反应进度稳定。 +2. Explosive 到 Gas 的质量、动量和能量释放路径稳定。 +3. Explosive/Gas restart 可重复读写并继续计算。 +4. Water/Gas/Explosive 默认 gate 可重复执行。 +5. 文档明确 0.4.0 尚未实现结构响应、破裂和真实 FEM-SPH 耦合。 diff --git a/src/core/sph_precision.f90 b/src/core/sph_precision.f90 index 2666401..0103c71 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 = 3 - integer, parameter :: SPH_VERSION_PATCH = 1 + integer, parameter :: SPH_VERSION_MINOR = 4 + 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/explosive_bad_ignition_040.inp b/tests/data/explosive_bad_ignition_040.inp new file mode 100644 index 0000000..2992756 --- /dev/null +++ b/tests/data/explosive_bad_ignition_040.inp @@ -0,0 +1,18 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=CHARGE_PARTICLES +1 +*MATERIAL, NAME=TNT, TYPE=EXPLOSIVE +*DENSITY +1600.0 +*SECTION, ELSET=CHARGE_PARTICLES, MATERIAL=TNT +*MATERIAL, NAME=PRODUCTS, TYPE=GAS +*DENSITY +1600.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 EXPLOSIVE, MATERIAL=TNT, TYPE=PROGRAMMED_BURN, DETONATION_VELOCITY=6900.0, ENERGY=4.2E6, BURN_TIME=1.0E-7, PRODUCT_MATERIAL=PRODUCTS, CONVERSION=PHASE +*SPHLITE IGNITION, MATERIAL=TNT, Y=0.0, Z=0.0, TIME=0.0 +*SPHLITE PARTICLE CONTROL, H=0.10, MASS=0.02, VOLUME=1.25E-5 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/explosive_bad_product_040.inp b/tests/data/explosive_bad_product_040.inp new file mode 100644 index 0000000..a22bb74 --- /dev/null +++ b/tests/data/explosive_bad_product_040.inp @@ -0,0 +1,14 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=CHARGE_PARTICLES +1 +*MATERIAL, NAME=TNT, TYPE=EXPLOSIVE +*DENSITY +1600.0 +*SECTION, ELSET=CHARGE_PARTICLES, MATERIAL=TNT +*SPHLITE EXPLOSIVE, MATERIAL=TNT, TYPE=PROGRAMMED_BURN, DETONATION_VELOCITY=6900.0, ENERGY=4.2E6, BURN_TIME=1.0E-7, PRODUCT_MATERIAL=MISSING_PRODUCTS, CONVERSION=PHASE +*SPHLITE IGNITION, MATERIAL=TNT, X=0.0, Y=0.0, Z=0.0, TIME=0.0 +*SPHLITE PARTICLE CONTROL, H=0.10, MASS=0.02, VOLUME=1.25E-5 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/explosive_bad_velocity_040.inp b/tests/data/explosive_bad_velocity_040.inp new file mode 100644 index 0000000..d33305f --- /dev/null +++ b/tests/data/explosive_bad_velocity_040.inp @@ -0,0 +1,18 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=CHARGE_PARTICLES +1 +*MATERIAL, NAME=TNT, TYPE=EXPLOSIVE +*DENSITY +1600.0 +*SECTION, ELSET=CHARGE_PARTICLES, MATERIAL=TNT +*MATERIAL, NAME=PRODUCTS, TYPE=GAS +*DENSITY +1600.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 EXPLOSIVE, MATERIAL=TNT, TYPE=PROGRAMMED_BURN, DETONATION_VELOCITY=-1.0, ENERGY=4.2E6, BURN_TIME=1.0E-7, PRODUCT_MATERIAL=PRODUCTS, CONVERSION=PHASE +*SPHLITE IGNITION, MATERIAL=TNT, X=0.0, Y=0.0, Z=0.0, TIME=0.0 +*SPHLITE PARTICLE CONTROL, H=0.10, MASS=0.02, VOLUME=1.25E-5 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/explosive_conversion_phase_040.inp b/tests/data/explosive_conversion_phase_040.inp new file mode 100644 index 0000000..6590580 --- /dev/null +++ b/tests/data/explosive_conversion_phase_040.inp @@ -0,0 +1,24 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.05, 0.0, 0.0 +3, 0.10, 0.0, 0.0 +4, 0.15, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=CHARGE_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=TNT, TYPE=EXPLOSIVE +*DENSITY +1600.0 +*SECTION, ELSET=CHARGE_PARTICLES, MATERIAL=TNT +*MATERIAL, NAME=PRODUCTS, TYPE=GAS +*DENSITY +1600.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 EXPLOSIVE, MATERIAL=TNT, TYPE=PROGRAMMED_BURN, DETONATION_VELOCITY=6900.0, ENERGY=4.2E6, BURN_TIME=0.0, PRODUCT_MATERIAL=PRODUCTS, CONVERSION=PHASE +*SPHLITE IGNITION, MATERIAL=TNT, X=0.0, Y=0.0, Z=0.0, TIME=0.0 +*SPHLITE PARTICLE CONTROL, H=0.10, MASS=0.02, VOLUME=1.25E-5 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/explosive_conversion_source_040.inp b/tests/data/explosive_conversion_source_040.inp new file mode 100644 index 0000000..3617f94 --- /dev/null +++ b/tests/data/explosive_conversion_source_040.inp @@ -0,0 +1,31 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.05, 0.0, 0.0 +3, 0.10, 0.0, 0.0 +4, 0.20, 0.0, 0.0 +5, 0.25, 0.0, 0.0 +6, 0.30, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +5, 5 +6, 6 +*ELSET, ELSET=CHARGE_PARTICLES +1, 2, 3 +*ELSET, ELSET=PRODUCT_PARTICLES +4, 5, 6 +*MATERIAL, NAME=TNT, TYPE=EXPLOSIVE +*DENSITY +1600.0 +*SECTION, ELSET=CHARGE_PARTICLES, MATERIAL=TNT +*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 EXPLOSIVE, MATERIAL=TNT, TYPE=PROGRAMMED_BURN, DETONATION_VELOCITY=6900.0, ENERGY=4.2E6, BURN_TIME=1.0E-7, PRODUCT_MATERIAL=PRODUCTS, CONVERSION=SOURCE +*SPHLITE IGNITION, MATERIAL=TNT, X=0.0, Y=0.0, Z=0.0, TIME=0.0 +*SPHLITE PARTICLE CONTROL, H=0.10, MASS=0.02, VOLUME=1.25E-5 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=2.0E-7, STEPS=2, SAFETY=0.5 diff --git a/tests/data/explosive_ignition_single_040.inp b/tests/data/explosive_ignition_single_040.inp new file mode 100644 index 0000000..6954a24 --- /dev/null +++ b/tests/data/explosive_ignition_single_040.inp @@ -0,0 +1,24 @@ +*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=CHARGE_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=TNT, TYPE=EXPLOSIVE +*DENSITY +1600.0 +*SECTION, ELSET=CHARGE_PARTICLES, MATERIAL=TNT +*MATERIAL, NAME=PRODUCTS, TYPE=GAS +*DENSITY +1600.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 EXPLOSIVE, MATERIAL=TNT, TYPE=PROGRAMMED_BURN, DETONATION_VELOCITY=6900.0, ENERGY=4.2E6, BURN_TIME=1.0E-7, PRODUCT_MATERIAL=PRODUCTS, CONVERSION=PHASE +*SPHLITE IGNITION, MATERIAL=TNT, X=0.05, Y=0.0, Z=0.0, TIME=2.0E-7 +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=0.02, VOLUME=1.25E-5 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=4.0E-7, STEPS=4, SAFETY=0.5 diff --git a/tests/data/explosive_minimal_040.inp b/tests/data/explosive_minimal_040.inp new file mode 100644 index 0000000..70265f7 --- /dev/null +++ b/tests/data/explosive_minimal_040.inp @@ -0,0 +1,24 @@ +*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=CHARGE_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=TNT, TYPE=EXPLOSIVE +*DENSITY +1600.0 +*SECTION, ELSET=CHARGE_PARTICLES, MATERIAL=TNT +*MATERIAL, NAME=PRODUCTS, TYPE=GAS +*DENSITY +1600.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 EXPLOSIVE, MATERIAL=TNT, TYPE=PROGRAMMED_BURN, DETONATION_VELOCITY=6900.0, ENERGY=4.2E6, BURN_TIME=1.0E-6, PRODUCT_MATERIAL=PRODUCTS, CONVERSION=PHASE +*SPHLITE IGNITION, MATERIAL=TNT, X=0.0, Y=0.0, Z=0.0, TIME=0.0 +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=0.02, VOLUME=1.25E-5 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=2.0E-7, STEPS=2, SAFETY=0.5 diff --git a/tests/data/explosive_product_jwl_040.inp b/tests/data/explosive_product_jwl_040.inp new file mode 100644 index 0000000..2e2e516 --- /dev/null +++ b/tests/data/explosive_product_jwl_040.inp @@ -0,0 +1,24 @@ +*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=CHARGE_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=TNT, TYPE=EXPLOSIVE +*DENSITY +1600.0 +*SECTION, ELSET=CHARGE_PARTICLES, MATERIAL=TNT +*MATERIAL, NAME=TNT_PRODUCTS, TYPE=GAS +*DENSITY +1600.0 +*SPHLITE EOS, TYPE=JWL, MATERIAL=TNT_PRODUCTS, RHO0=1600.0, A=3.712E11, B=3.231E9, R1=4.15, R2=0.95, OMEGA=0.3, E0=4.2E6 +*SPHLITE EXPLOSIVE, MATERIAL=TNT, TYPE=PROGRAMMED_BURN, DETONATION_VELOCITY=6900.0, ENERGY=4.2E6, BURN_TIME=0.0, PRODUCT_MATERIAL=TNT_PRODUCTS, CONVERSION=PHASE +*SPHLITE IGNITION, MATERIAL=TNT, X=0.0, Y=0.0, Z=0.0, TIME=0.0 +*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/explosive_programmed_burn_040.inp b/tests/data/explosive_programmed_burn_040.inp new file mode 100644 index 0000000..83d91c0 --- /dev/null +++ b/tests/data/explosive_programmed_burn_040.inp @@ -0,0 +1,24 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.2, 0.0, 0.0 +4, 0.3, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=CHARGE_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=TNT, TYPE=EXPLOSIVE +*DENSITY +1600.0 +*SECTION, ELSET=CHARGE_PARTICLES, MATERIAL=TNT +*MATERIAL, NAME=PRODUCTS, TYPE=GAS +*DENSITY +1600.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 EXPLOSIVE, MATERIAL=TNT, TYPE=PROGRAMMED_BURN, DETONATION_VELOCITY=6900.0, ENERGY=4.2E6, BURN_TIME=4.0E-7, PRODUCT_MATERIAL=PRODUCTS, CONVERSION=PHASE +*SPHLITE IGNITION, MATERIAL=TNT, X=0.0, Y=0.0, Z=0.0, TIME=1.0E-7 +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=0.02, VOLUME=1.25E-5 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=6.0E-7, STEPS=6, SAFETY=0.5 diff --git a/tests/data/explosive_section_040.inp b/tests/data/explosive_section_040.inp new file mode 100644 index 0000000..d69a147 --- /dev/null +++ b/tests/data/explosive_section_040.inp @@ -0,0 +1,24 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.05, 0.0, 0.0 +3, 0.10, 0.0, 0.0 +4, 0.15, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=CHARGE_LINE +1, 2, 3, 4 +*MATERIAL, NAME=PBX, TYPE=EXPLOSIVE +*DENSITY +1750.0 +*SECTION, ELSET=CHARGE_LINE, MATERIAL=PBX +*MATERIAL, NAME=PRODUCTS, TYPE=GAS +*DENSITY +1750.0 +*SPHLITE EOS, TYPE=JWL, MATERIAL=PRODUCTS, RHO0=1750.0, A=5.0E11, B=5.0E9, R1=4.5, R2=1.1, OMEGA=0.32, E0=5.0E6 +*SPHLITE EXPLOSIVE, MATERIAL=PBX, TYPE=PROGRAMMED_BURN, DETONATION_VELOCITY=7600.0, ENERGY=5.0E6, BURN_TIME=5.0E-7, PRODUCT_MATERIAL=PRODUCTS, CONVERSION=PHASE +*SPHLITE IGNITION, MATERIAL=PBX, X=0.0, Y=0.0, Z=0.0, TIME=0.0 +*SPHLITE PARTICLE CONTROL, H=0.10, MASS=0.01, VOLUME=5.714E-6 +*SPHLITE TIME CONTROL, DT=5.0E-8, TIME=1.0E-7, STEPS=2, SAFETY=0.5 diff --git a/tests/interface/test_c_api.c b/tests/interface/test_c_api.c index fd6751d..5f89dd0 100644 --- a/tests/interface/test_c_api.c +++ b/tests/interface/test_c_api.c @@ -127,7 +127,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 != 1) return fail("unexpected version"); + if (major != 0 || minor != 4 || 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 ee412df..6f40489 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 != 1) { + if (version.major != 0 || version.minor != 4 || version.patch != 0) { return 1; } diff --git a/tests/unit/test_smoke.f90 b/tests/unit/test_smoke.f90 index 575890f..c0ae734 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 /= 1) call fail('unexpected version') + if (major /= 0 .or. minor /= 4 .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 b797e58..df5594a 100644 --- a/todo.md +++ b/todo.md @@ -1,147 +1,147 @@ # SPHLite TODO -当前目标版本:0.3.1 +当前目标版本:0.4.0 -本文档依据 `docs/v3.1_development_plan.md` 拆分。0.3.1 定位为 `Gas` 模块稳定化和前置加固版本,目标是在 0.3.0 Gas 最小闭环基础上,补强多 Gas material/EOS、Gas 源项占位、诊断一致性、restart 兼容性、接口覆盖和 release gate 可维护性。 +本文档依据 `docs/v4.0_development_plan.md` 拆分。0.4.0 定位为 `Explosive` 模块起步版本,目标是在 0.3.1 `Gas` 多材料、EOS 分派、源项缓存、扩展诊断和 restart 兼容基础上,建立炸药粒子的解析点火、爆轰到达时间、反应进度和向 `Gas` 释放质量、动量、能量的最小闭环。 -所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.3.1 不实现 Explosive 解析点火、爆轰传播、反应进度、炸药 phase 迁移、Solid/Shell 生产求解路径或真实 FEM-SPH 耦合。 +所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.4.0 不实现 Solid、Shell、真实 FEM-SPH 耦合、工程级水下爆炸 benchmark、完整化学反应爆轰模型或球面经验载荷主模型。 -执行约定:每完成 20 个待办事项,进行一次本地 git 提交,暂不推送远端。 +执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端。 -## 阶段 A:版本基线与输入样例 +## 阶段 A:版本基线、范围声明与输入样例 -- [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] 确认当前 git 状态并记录 0.4.0 开发起点。 +- [x] 确认 0.3.1 最终提交可作为 0.4.0 开发基线。 +- [x] 将核心软件版本更新为 `0.4.0`。 +- [x] 将 CMake 项目版本更新为 `0.4.0`。 - [x] 更新 Fortran smoke 测试中的版本期望。 - [x] 更新 C API 测试中的版本期望。 - [x] 更新 C++ API 测试中的版本期望。 - [x] 更新 Python debug 测试中的版本期望。 - [x] 更新 CLI `--version` 和 inspect 版本期望。 -- [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 的错误输入样例。 +- [x] 在 README 中记录 0.4.0 Explosive 起步版本定位。 +- [x] 创建最小 `TYPE=EXPLOSIVE` material 输入样例。 +- [x] 创建 explosive section 绑定炸药粒子的输入样例。 +- [x] 创建 product Gas material 使用 JWL EOS 的输入样例。 +- [x] 创建 `*SPHLITE EXPLOSIVE` programmed burn 控制输入样例。 +- [x] 创建 `*SPHLITE IGNITION` 单点点火输入样例。 +- [x] 创建 `CONVERSION=PHASE` 的炸药到 Gas 转化输入样例。 +- [x] 创建 `CONVERSION=SOURCE` 的 Gas 源项注入输入样例。 +- [x] 创建爆速为非法值的错误输入样例。 +- [x] 创建 product Gas material 缺失或非法的错误输入样例。 +- [x] 创建点火字段缺失或非法的错误输入样例。 -## 阶段 B:Gas 多材料输入解析与状态表 +## 阶段 B:Explosive 输入解析、材料控制与校验 -- [x] 为 Gas material 数量增加集中式统计字段。 -- [x] 为 Gas material 内部 id 增加存储字段。 -- [x] 为 Gas material 名称增加存储字段。 -- [x] 为 Gas material EOS 类型增加存储字段。 -- [x] 为 Gas material 密度默认值增加存储字段。 -- [x] 为 Gas material 内能默认值增加存储字段。 -- [x] 为 Gas material 温度默认值增加存储字段。 -- [x] 为理想气体 EOS 增加 material 级参数表。 -- [x] 为 JWL EOS 增加 material 级参数表。 -- [x] 为 Stiffened gas EOS 增加 material 级参数表。 -- [x] 增加 Gas material 状态表初始化过程。 -- [x] 增加 Gas material 状态表清理过程。 -- [x] 增加按 material 名称查找 Gas material id 的过程。 -- [x] 将 `*MATERIAL, TYPE=GAS` 解析结果注册到 Gas material 状态表。 -- [x] 将 `*SPHLITE EOS, MATERIAL=...` 解析结果绑定到对应 Gas material。 -- [x] 对同一 Gas material 重复定义 EOS 的输入报 error。 -- [x] 对非 Gas material 定义 Gas EOS 的输入报 error。 -- [x] 对 Gas material 缺失 EOS 的输入报 error。 -- [x] 对 Gas material 无 active 粒子的输入报 warning。 -- [x] 保持 0.3.0 单 Gas material 输入兼容通过。 +- [ ] 为 `TYPE=EXPLOSIVE` material 增加输入识别路径。 +- [ ] 为 explosive material 数量增加集中式统计字段。 +- [ ] 为 explosive material 内部 id 增加存储字段。 +- [ ] 为 explosive material 名称增加存储字段。 +- [ ] 为 explosive 初始密度增加 material 级存储字段。 +- [ ] 为 explosive 爆速增加 material 级存储字段。 +- [ ] 为 explosive 单位质量能量增加 material 级存储字段。 +- [ ] 为 explosive 反应时间窗口增加 material 级存储字段。 +- [ ] 为 explosive product Gas material 映射增加存储字段。 +- [ ] 为 explosive conversion mode 增加存储字段。 +- [ ] 增加 explosive material 状态表初始化过程。 +- [ ] 增加 explosive material 状态表清理过程。 +- [ ] 增加按 material 名称查找 explosive material id 的过程。 +- [ ] 将 `*SPHLITE EXPLOSIVE` 解析结果绑定到 explosive material。 +- [ ] 将 `*SPHLITE IGNITION` 解析结果绑定到 explosive material。 +- [ ] 对 explosive material 缺失 `*DENSITY` 的输入报 error。 +- [ ] 对 explosive material 缺失 `*SPHLITE EXPLOSIVE` 的输入报 error。 +- [ ] 对 explosive section 未绑定 active 粒子的输入报 warning。 +- [ ] 对 product material 不是 Gas material 的输入报 error。 +- [ ] 对 product Gas material 缺失 EOS 的输入报 error。 -## 阶段 C:EOS 分派、状态初始化与时间步 +## 阶段 C:Explosive 模块状态、点火与爆轰到达时间 -- [x] 将 Gas 压力更新改为按粒子 `material_id` 分派 EOS。 -- [x] 为理想气体压力更新增加 material 级分派测试。 -- [x] 为 JWL 压力更新增加 material 级分派测试。 -- [x] 为 Stiffened gas 压力更新增加 material 级分派测试。 -- [x] 增加空气和爆轰产物混合输入的逐粒子压力检查。 -- [x] 对 Gas 粒子 material 无 EOS 的状态更新路径报 error。 -- [x] 将 Gas 初始密度设置改为按 material 分派。 -- [x] 将 Gas 初始内能设置改为按 material 分派。 -- [x] 将 Gas 初始温度设置改为按 material 分派。 -- [x] 将 Gas 初始压力设置改为按 material EOS 计算。 -- [x] 将 Gas 默认质量控制策略改为按 material 或共享策略处理。 -- [x] 将 Gas 默认体积控制策略改为按 material 或共享策略处理。 -- [x] 将 Gas 默认光滑长度策略改为按 material 或共享策略处理。 -- [x] 将 Gas 外部体力策略保持为共享路径并补充混合材料测试。 -- [x] 将 Gas 声速估计改为按 material/EOS 分派。 -- [x] 将 Gas CFL 时间步限制改为记录 `gas_dt_cfl`。 -- [x] 将 Gas 加速度时间步限制改为记录 `gas_dt_accel`。 -- [x] 将 Gas 临界时间步取值改为使用各分量最小值。 -- [x] 增加混合 Gas material 的时间步估计测试。 -- [x] 确认 Water 时间步和 pressure wave smoke 行为未被 Gas 改动影响。 +- [ ] 新增 `src/explosive` 模块目录和 Fortran 源文件骨架。 +- [ ] 将 Explosive 源文件接入 CMake 构建列表。 +- [ ] 增加 `sph_explosive_reset` 生命周期入口。 +- [ ] 增加 `sph_explosive_build` 模型构建入口。 +- [ ] 增加 `sph_explosive_finalize` 或清理入口。 +- [ ] 为每粒子爆轰到达时间增加状态数组。 +- [ ] 为每粒子反应进度 `lambda` 增加状态数组。 +- [ ] 为每粒子累计释放质量增加状态数组。 +- [ ] 为每粒子累计释放能量增加状态数组。 +- [ ] 为每粒子累计释放动量增加状态数组。 +- [ ] 为每粒子 ignition status 增加状态数组。 +- [ ] 增加 Explosive 状态数组分配过程。 +- [ ] 增加 Explosive 状态数组清零过程。 +- [ ] 增加 Explosive active 粒子筛选过程。 +- [ ] 增加单点点火记录的内部设置过程。 +- [ ] 增加多点点火记录的状态预留和清理过程。 +- [ ] 实现按初始坐标计算单点爆轰到达时间。 +- [ ] 实现多点点火到达时间取最小值的预留路径。 +- [ ] 增加爆轰到达时间范围诊断过程。 +- [ ] 增加爆轰到达时间模块测试并接入 CTest。 -## 阶段 D:Gas 源项占位、诊断与输出 +## 阶段 D:反应进度、释放量、Gas 源项与 phase 转化 -- [x] 增加 `gas_mass_source(:)` 状态数组。 -- [x] 增加 `gas_energy_source(:)` 状态数组。 -- [x] 增加 `gas_momentum_source(:,:)` 状态数组。 -- [x] 在粒子数量变化或模型初始化时分配 Gas 源项数组。 -- [x] 在模型清理时释放 Gas 源项数组。 -- [x] 实现 `sph_gas_clear_sources` 内部过程。 -- [x] 实现 `sph_gas_add_source_by_particle` 内部过程。 -- [x] 实现 `sph_gas_apply_sources_explicit` 内部过程。 -- [x] 实现 `sph_gas_get_source_summary` 内部过程。 -- [x] 对非法粒子 id 添加 Gas 源项时报 error。 -- [x] 对非 Gas 粒子添加 Gas 源项时报 error。 -- [x] 对非法数值源项添加 Gas 源项时报 error。 -- [x] 增加 Gas 质量源项累计和清零测试。 -- [x] 增加 Gas 动量源项累计和清零测试。 -- [x] 增加 Gas 能量源项累计和清零测试。 -- [x] 增加 Gas 源项显式应用后质量变化测试。 -- [x] 增加 Gas 源项显式应用后速度或动量变化测试。 -- [x] 增加 Gas 源项显式应用后内能或能量变化测试。 -- [x] 扩展 Gas summary,输出动量和密度范围。 -- [x] 扩展 Gas output,输出稳定的 0.3.1 诊断字段。 +- [ ] 实现 programmed burn 反应进度目标值计算。 +- [ ] 实现 `burn_time = 0` 的瞬时反应路径。 +- [ ] 实现 `burn_time > 0` 的线性反应窗口路径。 +- [ ] 保证 `lambda` 被限制在 `[0,1]` 范围内。 +- [ ] 保证 `lambda` 单调不可逆增加。 +- [ ] 计算每步 `delta_lambda` 反应增量。 +- [ ] 按 `delta_lambda * mass_initial` 计算释放质量。 +- [ ] 按释放质量和单位质量能量计算释放能量。 +- [ ] 按释放质量和当前速度计算释放动量。 +- [ ] 将释放质量累计到 Explosive 诊断状态。 +- [ ] 将释放能量累计到 Explosive 诊断状态。 +- [ ] 将释放动量累计到 Explosive 诊断状态。 +- [ ] 实现 `CONVERSION=SOURCE` 到 Gas 源项缓存的注入路径。 +- [ ] 实现 `CONVERSION=PHASE` 的完全反应后 phase 转化路径。 +- [ ] 将完全反应粒子的 material 改为 product Gas material。 +- [ ] 在 phase 转化后刷新 Gas 压力和 summary。 +- [ ] 对无法确定目标 Gas 状态的 source 注入路径报 error。 +- [ ] 将 Explosive 更新挂接到显式求解器步骤中。 +- [ ] 增加反应时间步约束诊断或预留字段。 +- [ ] 确认无 Explosive 输入时 Water/Gas 算例不进入 Explosive 更新路径。 -## 阶段 E:Restart、API、C++、Python 与 CLI +## 阶段 E:Summary、Output、Restart、API、C++、Python 与 CLI -- [x] 设计 0.3.1 restart 的 Gas state revision 标识。 -- [x] 将 Gas material/EOS 表写入 0.3.1 restart。 -- [x] 将 Gas 默认粒子控制状态写入 0.3.1 restart。 -- [x] 将 Gas 外部体力状态写入 0.3.1 restart。 -- [x] 将 Gas 源项缓存写入 0.3.1 restart。 -- [x] 将 Gas dt 诊断写入 0.3.1 restart。 -- [x] 将 Gas bubble metrics 历史状态写入 0.3.1 restart。 -- [x] 从 0.3.1 restart 读回 Gas material/EOS 表。 -- [x] 从 0.3.1 restart 读回 Gas 源项缓存。 -- [x] 从 0.3.1 restart 读回后重建邻域并继续显式步。 -- [x] 增加读取 0.3.0 `STATE_0_3` restart 的兼容路径。 -- [x] 为 0.3.0 restart 缺失的 Gas material 表初始化默认值。 -- [x] 为 0.3.0 restart 缺失的 Gas 源项状态初始化零值。 -- [x] 增加 `sph_get_gas_extended_summary` Fortran API。 -- [x] 增加 `sph_get_gas_source_summary` Fortran API。 -- [x] 在 C ABI 中追加 Gas extended summary 查询接口。 -- [x] 在 C ABI 中追加 Gas source summary 查询接口。 -- [x] 在 C++ wrapper 中增加 Gas extended/source summary 薄包装。 -- [x] 在 Python ctypes 中增加 Gas extended/source summary 薄包装。 -- [x] 在 CLI inspect/run 中增加 0.3.1 Gas 扩展字段检查。 +- [ ] 增加 Explosive summary 内部统计过程。 +- [ ] 统计 explosive 粒子总数和已反应粒子数。 +- [ ] 统计 `lambda` 最小值、最大值和平均值。 +- [ ] 统计累计释放质量、能量和三向动量。 +- [ ] 统计爆轰到达时间最小值和最大值。 +- [ ] 将 Explosive summary 字段写入 summary CSV。 +- [ ] 将 Explosive 关键粒子状态写入粒子 CSV 输出。 +- [ ] 将 0.4.0 restart 状态版本更新为 `STATE_0_4`。 +- [ ] 将 Explosive material 表写入 0.4.0 restart。 +- [ ] 将 product Gas material 映射写入 0.4.0 restart。 +- [ ] 将点火记录写入 0.4.0 restart。 +- [ ] 将每粒子爆轰到达时间写入 0.4.0 restart。 +- [ ] 将每粒子反应进度和累计释放量写入 0.4.0 restart。 +- [ ] 从 0.4.0 restart 读回 Explosive 状态并继续显式步。 +- [ ] 从 0.3.1 restart 读回时初始化空 Explosive 状态。 +- [ ] 增加 `sph_get_explosive_summary` Fortran API。 +- [ ] 增加 `sph_set_ignition_point` Fortran API。 +- [ ] 在 C ABI 中追加点火点设置和 Explosive summary 查询接口。 +- [ ] 在 C++ wrapper 和 Python ctypes 中增加 Explosive 薄包装。 +- [ ] 在 CLI inspect/run 中增加 Explosive 字段检查。 -## 阶段 F:测试接入、文档同步与发布门禁 +## 阶段 F:测试接入、回归、文档同步与发布门禁 -- [x] 新增 `input_gas_multimaterial` 测试并接入 CTest。 -- [x] 新增 `gas_eos_dispatch` 测试并接入 CTest。 -- [x] 新增 `gas_source` 测试并接入 CTest。 -- [x] 新增 `gas_source_errors` 测试并接入 CTest。 -- [x] 新增 `gas_extended_summary` 测试并接入 CTest。 -- [x] 新增 `gas_restart_031` 测试并接入 CTest。 -- [x] 新增 `gas_restart_030_compat` 测试并接入 CTest。 -- [x] 新增 `gas_cli_extended` 测试并接入 CTest。 -- [x] 新增 `gas_python_extended` 测试并接入 CTest。 -- [x] 新增 `gas_source_size_cleanup` 测试或检查项并接入 CTest。 -- [x] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。 -- [x] 拆分因 0.3.1 改动变长的 Fortran 过程。 -- [x] 保持 0.3.0 默认 gate 全部通过。 -- [x] 单独运行 0.3.1 新增 Gas 稳定化 gate。 -- [x] 运行 `source_size` 检查并确认无新增无理由例外。 -- [x] 运行 `git diff --check` 并清理空白问题。 -- [x] 更新 `docs/06_test_and_verification_plan.md` 的 0.3.1 测试范围。 -- [x] 更新 `docs/09_release_history.md` 的 0.3.1 待发布记录。 -- [x] 更新 `docs/11_benchmark_matrix.md` 的 0.3.1 验收矩阵。 -- [x] 确认文档未宣称 0.3.1 已实现 Explosive、Solid、Shell 或真实 FEM-SPH 耦合。 +- [ ] 新增 `input_explosive` 测试并接入 CTest。 +- [ ] 新增 `input_explosive_errors` 测试并接入 CTest。 +- [ ] 新增 `explosive_detonation_time` 测试并接入 CTest。 +- [ ] 新增 `explosive_reaction_progress` 测试并接入 CTest。 +- [ ] 新增 `explosive_release_source` 测试并接入 CTest。 +- [ ] 新增 `explosive_to_gas_phase` 测试并接入 CTest。 +- [ ] 新增 `explosive_gas_coupling` 测试并接入 CTest。 +- [ ] 新增 `explosive_summary` 测试并接入 CTest。 +- [ ] 新增 `explosive_restart_040` 测试并接入 CTest。 +- [ ] 新增 `explosive_restart_031_compat` 测试并接入 CTest。 +- [ ] 新增 `explosive_c_api` 测试并接入 CTest。 +- [ ] 新增 `explosive_python` 测试并接入 CTest。 +- [ ] 新增 `explosive_cli` 测试并接入 CTest。 +- [ ] 新增 `explosive_source_size` 测试或检查项并接入 CTest。 +- [ ] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。 +- [ ] 保持 0.3.1 默认 gate 全部通过。 +- [ ] 单独运行 0.4.0 新增 Explosive gate。 +- [ ] 运行 `source_size` 检查并确认无新增无理由例外。 +- [ ] 运行 `git diff --check` 并清理空白问题。 +- [ ] 更新 README、06、09 和 11 号文档的 0.4.0 测试和验收记录。 diff --git a/tools/testing/test_cli.py b/tools/testing/test_cli.py index 7bcb700..9db65b2 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.1" not in version.stdout: + if "0.4.0" not in version.stdout: raise AssertionError("CLI version mismatch") inspect = run_command([exe, model]) @@ -86,7 +86,7 @@ def main() -> int: ): require_field(inspect.stdout, field) inspect_fields = read_fields(inspect.stdout) - if inspect_fields["version"] != "0.3.1": + if inspect_fields["version"] != "0.4.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 1c68559..02349d4 100644 --- a/tools/testing/test_python_debug.py +++ b/tools/testing/test_python_debug.py @@ -31,7 +31,7 @@ def main() -> int: raise AssertionError("Python wrapper is missing Gas C ABI diagnostics") if not hasattr(solver.lib, "sphlite_get_gas_extended_summary"): raise AssertionError("Python wrapper is missing Gas extended C ABI diagnostics") - if solver.version() != (0, 3, 1): + if solver.version() != (0, 4, 0): raise AssertionError("Python version mismatch") solver.initialize()