diff --git a/CMakeLists.txt b/CMakeLists.txt index 6d77ab2..00628d9 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,6 +1,6 @@ cmake_minimum_required(VERSION 3.20) -project(SPHLite VERSION 0.4.0 LANGUAGES C CXX Fortran) +project(SPHLite VERSION 0.4.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 b67b1fe..edff4eb 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。 -当前发布版本:0.4.0。该版本定位为 `Explosive` 模块起步版本,在 0.3.1 `Gas` 稳定化基础上建立解析点火、爆轰到达时间、programmed burn 反应进度,以及向 `Gas` 释放质量、动量和能量的最小闭环。不交付 `Solid`、`Shell` 的生产路径,也不交付真实 FEM-SPH 联合运行或工程级水下爆炸 benchmark。 +当前开发版本:0.4.1。该版本定位为 `Explosive` 稳定化版本,在 0.4.0 已建立解析点火、爆轰到达时间、programmed burn、Gas 源项注入、phase 转化、restart 和接口 gate 的基础上,加固多点点火、多炸药材料、冻结反应质量、release balance、Water/Gas/Explosive 混合 smoke 和 restart 兼容。不交付 `Solid`、`Shell` 的生产路径,也不交付真实 FEM-SPH 联合运行或工程级水下爆炸 benchmark。 代码仓库地址: @@ -63,7 +63,7 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: ## 当前状态 -0.4.0 当前已完成 `Explosive` 起步闭环,主要包括: +0.4.1 当前在 `Explosive` 起步闭环基础上开展稳定化,0.4.0 已完成内容主要包括: - CMake/CTest 工程骨架和 Fortran 95 核心库。 - C ABI、C++ 头文件薄包装和 Python `ctypes` 调试入口。 diff --git a/docs/v4.1_development_plan.md b/docs/v4.1_development_plan.md new file mode 100644 index 0000000..f3eb246 --- /dev/null +++ b/docs/v4.1_development_plan.md @@ -0,0 +1,472 @@ +# SPHLite v4.1 开发计划 + +文档状态:0.4.1 开发计划草案 + +目标软件版本:SPHLite 0.4.1 + +## 1. 文档定位 + +本文档用于规划 SPHLite 0.4.1 版本的开发范围。0.4.1 是 0.4 `Explosive` 版本线的稳定化和加固版本,目标是在 0.4.0 已完成解析点火、爆轰到达时间、programmed burn、Gas 源项注入、phase 转化、restart 和接口 gate 的基础上,提升 Explosive-Gas-Water 链路的一致性、可诊断性和回归覆盖。 + +0.4.1 不作为 0.5 `Solid` 的启动版本。0.4.1 的重点是把 0.4.0 的最小闭环变成更稳的数值和接口基线,使后续 `Solid`、`Shell` 和耦合版本可以依赖 Explosive/Gas 的质量、动量、能量和 restart 行为。 + +## 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/v4.0_development_plan.md` +- `docs/09_release_history.md` +- `docs/11_benchmark_matrix.md` + +## 3. 版本定位 + +### 3.1 与 0.4.0 的关系 + +0.4.0 已完成 `Explosive` 起步闭环: + +- `TYPE=EXPLOSIVE` material、explosive section 和 product Gas material 输入识别。 +- `*SPHLITE EXPLOSIVE` programmed burn 控制。 +- `*SPHLITE IGNITION` 单点点火。 +- 解析爆轰到达时间。 +- 反应进度 `lambda`、释放质量、释放动量和释放能量。 +- `CONVERSION=SOURCE` 到 Gas 源项缓存。 +- `CONVERSION=PHASE` 到 product Gas phase。 +- Explosive summary、CSV 输出、`STATE_0_4` restart、C ABI、C++ wrapper、Python ctypes 和 CLI 字段。 +- Explosive 专项 gate 和完整 release gate。 + +0.4.1 不重写 0.4.0 路线,而是围绕以下薄弱点加固: + +- 多点点火记录和最小到达时间行为需要独立 gate。 +- 释放质量应基于炸药初始质量或明确冻结的反应基准,避免 phase 转化或源项应用后重复或漂移。 +- SOURCE 和 PHASE 两条路径的质量、动量、能量诊断应可比较。 +- Water/Gas/Explosive 混合小算例应进入默认回归,避免 Explosive 加入后破坏 Water/Gas 既有路径。 +- restart 后继续推进不得重复释放源项。 +- output、CLI 和 Python 应能区分 active explosive 粒子、已转化 Gas 粒子和历史 tracked explosive 粒子。 + +### 3.2 与 0.5.0 的关系 + +0.5.0 仍建议作为 `Solid` 版本线起点。0.4.1 不实现 Johnson-Cook 材料、结构损伤、结构断裂或结构接触响应。0.4.1 可以为后续结构版本准备爆炸载荷和 Gas 压力诊断,但不能宣称已实现结构响应。 + +### 3.3 0.4.1 核心目标 + +0.4.1 的核心目标是形成更可验证的 Explosive-Gas-Water 稳定化闭环: + +```text +multiple ignition records + -> deterministic detonation arrival min + -> initial-mass-based reaction release + -> SOURCE/PHASE conservation diagnostics + -> Gas pressure and Water/Gas smoke response + -> restart continue without repeated release + -> API/CLI/Python/output consistency +``` + +## 4. 开发原则 + +### 4.1 保持 0.4 版本线边界 + +0.4.1 只加固 `Explosive`、`Gas`、`Water` 交界处的最小链路,不进入 `Solid`、`Shell` 或真实 FEM-SPH 耦合。所有开发仍限定在 SPHLite 仓库内,不修改 FEMLite 或外部 CouplingModule。 + +### 4.2 不引入几何或粒子生成能力 + +SPHLite 仍是求解器,不负责几何建模、网格生成或粒子生成。新增 `.inp` 样例和 Python checker 仅作为测试辅助,不作为求解器功能。 + +### 4.3 保持 Fortran 95 和追加式接口 + +核心实现继续使用 Fortran 95。C ABI、C++ wrapper、Python ctypes 和 CLI 只做追加式扩展,不破坏 0.4.0 已有接口和测试。 + +### 4.4 保持显式动力学主流程 + +时间推进继续只支持 Velocity-Verlet 显式动力学。0.4.1 可以加固反应时间步约束和显式步内更新顺序,但不引入隐式求解、静力求解或混合求解接口。 + +### 4.5 优先保证可诊断性 + +0.4.1 的物理模型仍是起步阶段。相比扩大模型复杂度,本版本优先保证质量、动量、能量、phase 转化、源项应用和 restart 的可诊断、可回归和可解释。 + +## 5. 0.4.1 交付目标 + +0.4.1 建议交付以下内容: + +1. 将软件版本更新为 `0.4.1`。 +2. 保持 0.4.0 默认 gate 全部通过。 +3. 为 Explosive 新增初始反应质量基准状态,例如 `explosive_initial_mass(:)` 或等价冻结状态。 +4. 确保释放质量按反应质量基准和 `delta_lambda` 计算,而不是受后续 phase 转化或 Gas 源项应用影响。 +5. 完善多点点火记录,爆轰到达时间取所有匹配点火记录的最小值。 +6. 增加多点点火输入样例和独立 gate。 +7. 增加 Explosive material 多材料输入样例和 gate,验证不同炸药 material 拥有独立爆速、能量、burn time 和 product Gas 映射。 +8. 加固 `CONVERSION=SOURCE` 的目标 Gas 粒子选择和诊断,至少按 product material 汇总目标。 +9. 加固 `CONVERSION=PHASE` 后的 Gas summary、pressure、density 和 material 状态刷新。 +10. 增加 SOURCE 与 PHASE 两条路径的释放量一致性或可解释差异诊断。 +11. 增加 Explosive-Gas-Water 小型 smoke,验证爆炸产物 Gas 进入 Gas 诊断后不会破坏 Water/Gas 既有显式推进。 +12. 增加 release balance summary,包括释放质量、释放能量、释放动量、Gas 源项累计和 phase 转化数量。 +13. 在 CSV summary、CLI 和 Python 中暴露 0.4.1 新增诊断字段。 +14. 将 0.4.1 restart 状态版本更新为 `STATE_0_4_1`,保存新增反应质量基准和 release balance 相关状态。 +15. 保持 `STATE_0_4` restart 兼容读入,并为新增字段提供可重复默认值。 +16. 增加 restart 后继续推进不重复释放源项的专项测试。 +17. 保持 C ABI 追加式兼容,新增 summary 接口或扩展接口不得破坏 0.4.0 ABI。 +18. 复核 source size,保持 `Explosive` 拆分后的文件和过程规模受控。 +19. 更新 README、06、09 和 11 号文档中的 0.4.1 测试和验收记录。 +20. 不新增 FEMLite 直接依赖,不修改 SPHLite 文件夹之外的内容。 + +## 6. 非交付范围 + +0.4.1 不交付以下内容: + +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 多点点火 + +0.4.1 应明确支持同一 Explosive material 的多个点火记录: + +```text +*SPHLITE IGNITION, MATERIAL=TNT, X=..., Y=..., Z=..., TIME=... +*SPHLITE IGNITION, MATERIAL=TNT, X=..., Y=..., Z=..., TIME=... +``` + +对每个 active explosive 粒子: + +```text +td(i) = min_k( t_ign(k) + |x0(i) - x_ign(k)| / D_material ) +``` + +验收重点: + +- 多点点火顺序不影响最终 `td(i)`。 +- 只使用与粒子 material 匹配的点火记录。 +- 缺少匹配点火记录时仍为 error。 +- 点火坐标非有限值、时间为负值仍为 error。 + +### 7.2 多炸药 material + +0.4.1 应增加一个多炸药 material 小样例: + +```text +*MATERIAL, NAME=TNT, TYPE=EXPLOSIVE +*MATERIAL, NAME=PBX, TYPE=EXPLOSIVE +``` + +每个 Explosive material 可拥有独立: + +- `*DENSITY` +- `DETONATION_VELOCITY` +- `ENERGY` +- `BURN_TIME` +- `PRODUCT_MATERIAL` +- `CONVERSION` +- 点火记录 + +不同 material 的爆轰到达时间、反应进度和释放量应彼此独立统计。product Gas material 可相同,也可不同;若不同,则 Gas material/EOS 分派继续由 `Gas` 模块负责。 + +### 7.3 释放量诊断字段 + +0.4.1 可以新增扩展 summary 字段,但不改变 0.4.0 已有字段含义。建议新增: + +- `explosive_initial_mass` +- `explosive_remaining_mass` +- `explosive_converted_particles` +- `explosive_source_particles` +- `explosive_release_mass_error` +- `explosive_release_energy_error` +- `explosive_source_mass_total` +- `explosive_source_energy_total` + +如果新增字段过多,C ABI 可采用新增函数而不是修改 0.4.0 已有函数语义。 + +## 8. 状态设计 + +### 8.1 反应质量基准 + +0.4.1 建议新增每粒子反应质量基准: + +```fortran +real(rk), allocatable :: explosive_initial_mass(:) +``` + +语义: + +- 在 `sph_explosive_build` 阶段从 `mass(i)` 冻结。 +- SOURCE 和 PHASE 路径均使用该值计算 `dm = delta_lambda * explosive_initial_mass(i)`。 +- restart 必须保存该值。 +- 从 `STATE_0_4` 读入时,如缺失该字段,应以当前粒子质量作为兼容默认值,但不得导致已反应粒子重复释放。 + +### 8.2 转化和源项计数 + +0.4.1 可新增或派生: + +```fortran +integer :: explosive_converted_count +integer :: explosive_source_particle_count +real(rk) :: explosive_release_balance(5) +``` + +其中 `explosive_release_balance` 可用于记录质量、能量和三向动量的总释放量或误差量。若不新增存储数组,也应能通过现有 per-particle 状态可靠计算。 + +### 8.3 Restart 状态版本 + +0.4.1 restart 建议写入 `STATE_0_4_1`。新增状态包括: + +- 反应质量基准。 +- SOURCE/PHASE 诊断计数或可恢复状态。 +- release balance 诊断所需累计量。 + +兼容读入: + +- `STATE_0_4_1`:完整读回。 +- `STATE_0_4`:初始化新增状态,保持已释放量和 `lambda` 不重复释放。 +- `STATE_0_3_1`:初始化空 Explosive 状态。 + +## 9. 算法加固 + +### 9.1 反应释放公式 + +0.4.1 应明确使用冻结反应质量: + +```text +dm = delta_lambda * m0_explosive(i) +dE = dm * energy_per_mass(material) +dp = dm * v_explosive(i) +``` + +其中 `m0_explosive(i)` 为 build 或 restart 恢复的反应质量基准。该公式避免 phase 转化后 `mass(i)` 被 Gas 源项或后续模型改变时影响反应释放量。 + +### 9.2 SOURCE 路径目标分配 + +SOURCE 路径第一版继续采用 product Gas material 作为目标选择依据。0.4.1 应加固: + +- 无 active product Gas target 时 error。 +- 目标粒子数、总源项、每粒子源项在 summary 中可诊断。 +- 多 product Gas material 时只向匹配 material 的 Gas 粒子注入。 +- 源项应用后 Gas summary 和 source summary 保持一致。 + +### 9.3 PHASE 路径状态刷新 + +PHASE 路径中,完全反应粒子转为 product Gas 后应确保: + +- `particle_phase = PHASE_GAS`。 +- `material_id = product_material_id`。 +- `rho`、`volume`、`internal_energy` 与 product Gas 初始状态和 EOS 约定一致。 +- Gas pressure 和 summary 在同一步内刷新。 +- 原 Explosive 历史状态仍可被 summary 和 restart 追踪。 + +### 9.4 Water/Gas/Explosive 小型链路 + +0.4.1 应新增小型混合算例,至少包括: + +- 若干 Water 粒子。 +- 若干 Gas product 粒子或 phase 转化后的 Gas 粒子。 +- 若干 Explosive 粒子。 + +该 smoke 不作为工程精度 benchmark,只检查: + +- 显式步可推进。 +- Water summary 仍有限。 +- Gas summary 产生正体积和有限压力。 +- Explosive release summary 非负且可重复。 +- output/restart 可覆盖混合 phase。 + +## 10. API、C ABI、C++、Python 和 CLI + +### 10.1 Fortran API + +建议新增或完善: + +- `sph_get_explosive_release_balance` +- `sph_get_explosive_material_summary` +- `sph_explosive_get_tracked_counts` +- `sph_explosive_get_source_balance` + +若实现阶段认为现有 `sph_get_explosive_summary` 足够,可保持原接口并只增加内部测试。但新增诊断字段若需要对外可见,应优先通过追加 API 实现。 + +### 10.2 C ABI + +C ABI 应保持 0.4.0 兼容。建议新增独立函数,而不是改变现有 `sphlite_get_explosive_summary` 的数组长度约定: + +```c +int sphlite_get_explosive_release_balance(double *mass_values, + double *energy_values, + double *momentum_values); +``` + +建议语义: + +- `mass_values[0]`:初始炸药质量。 +- `mass_values[1]`:累计释放质量。 +- `mass_values[2]`:剩余可反应质量。 +- `energy_values[0]`:累计释放能量。 +- `energy_values[1]`:Gas source 累计能量或等价转化能量。 +- `momentum_values[0..2]`:累计释放动量。 + +具体字段可在实现时进一步收敛,但必须在测试中锁定。 + +### 10.3 C++ wrapper 和 Python ctypes + +C++ 和 Python 继续做薄包装,不引入独立物理语义。Python checker 应覆盖: + +- 多点点火 inspect/run。 +- release balance 字段。 +- restart 后继续 run 的 summary 不重复释放。 + +### 10.4 CLI + +CLI inspect/run 应继续输出 0.4.0 字段,并追加 0.4.1 字段。错误路径仍输出 `error_code` 和 `error_message`。CLI 测试应覆盖: + +- 多点点火输入。 +- 多 material 输入。 +- SOURCE 路径。 +- PHASE 路径。 +- restart 读回后的 run 或 inspect。 + +## 11. 输出和 Restart + +### 11.1 CSV 输出 + +0.4.1 建议在 summary CSV 中追加 release balance 字段。粒子 CSV 可追加: + +- `explosive_initial_mass` +- `explosive_remaining_mass` +- `explosive_conversion_flag` + +如果粒子 CSV 字段变多,应同步更新 output 测试,确保 header 稳定。 + +### 11.2 Restart + +0.4.1 restart 必须验证: + +- `STATE_0_4_1` 写入和读回。 +- `STATE_0_4` 兼容读入。 +- `STATE_0_3_1` 兼容读入并初始化空 Explosive 状态。 +- 读回后继续显式步不重复释放质量、动量和能量。 +- 读回后多点点火、material table、product mapping 和 release balance 保持一致。 + +## 12. 测试计划 + +### 12.1 新增 0.4.1 测试 + +建议新增以下测试: + +- `input_explosive_multi_ignition`:多点点火输入、顺序无关和最小到达时间。 +- `input_explosive_multimaterial`:多个 Explosive material、多个 product Gas material 和独立控制参数。 +- `explosive_initial_mass_release`:释放量基于冻结初始质量。 +- `explosive_release_balance`:释放质量、能量、动量和剩余质量一致。 +- `explosive_source_targeting`:SOURCE 只注入匹配 product Gas material。 +- `explosive_phase_refresh`:PHASE 转化后 Gas 状态和 summary 刷新。 +- `explosive_restart_041`:`STATE_0_4_1` 写入读回并继续显式步。 +- `explosive_restart_040_compat`:`STATE_0_4` 兼容读入并初始化新增字段。 +- `explosive_restart_no_double_release`:restart 后继续推进不重复释放。 +- `explosive_water_gas_smoke`:Water/Gas/Explosive 混合小算例显式推进。 +- `explosive_release_c_api`:C ABI release balance 查询。 +- `explosive_release_python`:Python ctypes release balance 查询。 +- `explosive_release_cli`:CLI 输出 release balance 字段。 +- `explosive_041_source_size`:0.4.1 新增拆分和 source size gate。 + +### 12.2 既有回归测试 + +0.4.1 必须继续通过 0.4.0 完整 gate,包括: + +- Water gate。 +- Gas gate。 +- Explosive 0.4.0 gate。 +- output/restart gate。 +- C API/C++/Python/CLI gate。 +- source size gate。 + +### 12.3 建议 0.4.1 Release Gate + +建议 0.4.1 默认 gate 为: + +```powershell +cmake --build build-codex-unix --parallel +ctest --test-dir build-codex-unix --output-on-failure +ctest --test-dir build-codex-unix -R "^(input_explosive_multi_ignition|input_explosive_multimaterial|explosive_initial_mass_release|explosive_release_balance|explosive_source_targeting|explosive_phase_refresh|explosive_restart_041|explosive_restart_040_compat|explosive_restart_no_double_release|explosive_water_gas_smoke|explosive_release_c_api|explosive_release_python|explosive_release_cli|explosive_041_source_size)$" --output-on-failure +ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure +git diff --check +``` + +## 13. 建议开发阶段 + +若后续根据本计划生成 `todo.md`,建议按以下阶段拆分: + +1. 0.4.1 版本号和 0.4.0 发布基线确认。 +2. 0.4.1 输入样例和错误输入样例准备。 +3. 多点点火输入和到达时间 gate。 +4. 多 Explosive material 输入和 product Gas 映射 gate。 +5. `explosive_initial_mass` 或等价反应质量基准状态。 +6. SOURCE/PHASE 释放量统一按冻结质量计算。 +7. release balance summary 内部统计。 +8. SOURCE 目标 Gas material 分配加固。 +9. PHASE 转化后 Gas 状态刷新加固。 +10. Water/Gas/Explosive 混合 smoke。 +11. summary CSV 和粒子 CSV 字段扩展。 +12. `STATE_0_4_1` restart 写入。 +13. `STATE_0_4_1` restart 读回。 +14. `STATE_0_4` 和 `STATE_0_3_1` 兼容读入。 +15. restart 后不重复释放专项测试。 +16. Fortran API 和 C ABI 追加接口。 +17. C++ wrapper、Python ctypes 和 CLI 扩展。 +18. source size 复核和必要拆分。 +19. 0.4.0 全量回归和 0.4.1 新增 gate。 +20. README、06、09 和 11 号文档同步。 + +## 14. 验收标准 + +0.4.1 应满足以下验收标准: + +1. 软件版本为 `0.4.1`。 +2. 0.4.0 release gate 继续通过。 +3. 多点点火的爆轰到达时间按最小到达时间计算。 +4. 多 Explosive material 可独立控制爆速、能量、burn time、product Gas 和 conversion mode。 +5. 释放质量基于冻结反应质量基准,不受 phase 转化或后续 Gas 源项应用影响。 +6. `lambda` 单调、不可逆,且限制在 `[0,1]`。 +7. SOURCE 路径只向匹配 product Gas material 的 active Gas 粒子注入源项。 +8. PHASE 路径完全反应后可刷新 Gas 状态和 summary。 +9. release balance summary 可解释累计释放质量、能量和动量。 +10. 0.4.1 restart 可恢复新增状态并继续显式步。 +11. 0.4.0 restart 可兼容读入,并初始化新增 0.4.1 状态。 +12. restart 后继续推进不重复释放源项。 +13. C ABI、C++ wrapper、Python ctypes 和 CLI 追加字段可用。 +14. Water/Gas/Explosive 混合 smoke 可重复通过。 +15. 默认 gate、0.4.1 专项 gate、source size 和 `git diff --check` 通过。 +16. 文档不宣称 0.4.1 已实现 Solid、Shell、真实 FEM-SPH 耦合或工程级水下爆炸 benchmark。 +17. 不新增 FEMLite 直接依赖。 +18. 不修改 SPHLite 文件夹之外的内容。 + +## 15. 风险与控制 + +| 风险 | 表现 | 控制方式 | +| --- | --- | --- | +| 0.4.1 范围膨胀 | 提前实现 Solid、Shell 或工程爆炸 benchmark | 限定为 Explosive 稳定化和混合 smoke | +| 多点点火行为不确定 | 输入顺序影响到达时间 | 测试锁定最小到达时间和顺序无关 | +| 释放量重复计算 | restart 或 phase 转化后重复释放质量/能量 | 使用 `delta_lambda` 和冻结初始质量,新增 no-double-release gate | +| SOURCE 目标不清晰 | 源项注入到错误 Gas material | 按 product material 过滤,并测试多 Gas material | +| PHASE 转化状态不一致 | 转化后 material、rho、volume、pressure 不匹配 | 转化后刷新 Gas 状态和 summary,并测试 restart | +| API 兼容破坏 | 修改 0.4.0 summary 数组长度或字段含义 | 新增 API,不改变旧接口语义 | +| output 字段膨胀 | CSV header 频繁变化 | 新增字段必须有 output 测试锁定 | +| source size 债务扩大 | Explosive 稳定化代码堆回主文件 | 保持 state/helper/reaction/restart 拆分 | + +## 16. 0.5.0 启动条件 + +满足以下条件后,可以启动 0.5.0 `Solid`: + +1. 0.4.1 多点点火、多材料和 release balance 稳定。 +2. SOURCE 和 PHASE 两条路径的质量、动量、能量诊断可重复。 +3. 0.4.1 restart 和 0.4.0 兼容 restart 可重复通过。 +4. Water/Gas/Explosive 混合 smoke 可重复通过。 +5. 0.4.1 文档明确尚未实现结构响应、破裂和真实 FEM-SPH 耦合。 diff --git a/src/core/sph_precision.f90 b/src/core/sph_precision.f90 index 0103c71..7e9f148 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 = 4 - 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/explosive_missing_matching_ignition_041.inp b/tests/data/explosive_missing_matching_ignition_041.inp new file mode 100644 index 0000000..0b6a2e2 --- /dev/null +++ b/tests/data/explosive_missing_matching_ignition_041.inp @@ -0,0 +1,23 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +*ELSET, ELSET=CHARGE_PARTICLES +1, 2 +*MATERIAL, NAME=TNT, TYPE=EXPLOSIVE +*DENSITY +1600.0 +*SECTION, ELSET=CHARGE_PARTICLES, MATERIAL=TNT +*MATERIAL, NAME=PBX, TYPE=EXPLOSIVE +*DENSITY +1750.0 +*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=PBX, 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_multi_ignition_cross_material_041.inp b/tests/data/explosive_multi_ignition_cross_material_041.inp new file mode 100644 index 0000000..e3fd270 --- /dev/null +++ b/tests/data/explosive_multi_ignition_cross_material_041.inp @@ -0,0 +1,32 @@ +*NODE +1, 0.00, 0.0, 0.0 +2, 0.10, 0.0, 0.0 +3, 0.20, 0.0, 0.0 +4, 0.30, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=TNT_PARTICLES +1, 2 +*ELSET, ELSET=PBX_PARTICLES +3, 4 +*MATERIAL, NAME=TNT, TYPE=EXPLOSIVE +*DENSITY +1600.0 +*SECTION, ELSET=TNT_PARTICLES, MATERIAL=TNT +*MATERIAL, NAME=PBX, TYPE=EXPLOSIVE +*DENSITY +1750.0 +*SECTION, ELSET=PBX_PARTICLES, MATERIAL=PBX +*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 EXPLOSIVE, MATERIAL=PBX, TYPE=PROGRAMMED_BURN, DETONATION_VELOCITY=7600.0, ENERGY=5.0E6, BURN_TIME=0.0, PRODUCT_MATERIAL=PRODUCTS, CONVERSION=PHASE +*SPHLITE IGNITION, MATERIAL=TNT, X=0.00, Y=0.0, Z=0.0, TIME=0.0 +*SPHLITE IGNITION, MATERIAL=PBX, X=0.30, 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_multi_ignition_forward_041.inp b/tests/data/explosive_multi_ignition_forward_041.inp new file mode 100644 index 0000000..8504b7d --- /dev/null +++ b/tests/data/explosive_multi_ignition_forward_041.inp @@ -0,0 +1,25 @@ +*NODE +1, 0.00, 0.0, 0.0 +2, 0.10, 0.0, 0.0 +3, 0.20, 0.0, 0.0 +4, 0.30, 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.00, Y=0.0, Z=0.0, TIME=0.0 +*SPHLITE IGNITION, MATERIAL=TNT, X=0.30, Y=0.0, Z=0.0, TIME=1.0E-6 +*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_multi_ignition_reversed_041.inp b/tests/data/explosive_multi_ignition_reversed_041.inp new file mode 100644 index 0000000..059a547 --- /dev/null +++ b/tests/data/explosive_multi_ignition_reversed_041.inp @@ -0,0 +1,25 @@ +*NODE +1, 0.00, 0.0, 0.0 +2, 0.10, 0.0, 0.0 +3, 0.20, 0.0, 0.0 +4, 0.30, 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.30, Y=0.0, Z=0.0, TIME=1.0E-6 +*SPHLITE IGNITION, MATERIAL=TNT, X=0.00, 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_multi_product_gas_041.inp b/tests/data/explosive_multi_product_gas_041.inp new file mode 100644 index 0000000..5d3725e --- /dev/null +++ b/tests/data/explosive_multi_product_gas_041.inp @@ -0,0 +1,36 @@ +*NODE +1, 0.00, 0.0, 0.0 +2, 0.05, 0.0, 0.0 +3, 0.20, 0.0, 0.0 +4, 0.25, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=TNT_PARTICLES +1, 2 +*ELSET, ELSET=PBX_PARTICLES +3, 4 +*MATERIAL, NAME=TNT, TYPE=EXPLOSIVE +*DENSITY +1600.0 +*SECTION, ELSET=TNT_PARTICLES, MATERIAL=TNT +*MATERIAL, NAME=PBX, TYPE=EXPLOSIVE +*DENSITY +1750.0 +*SECTION, ELSET=PBX_PARTICLES, MATERIAL=PBX +*MATERIAL, NAME=PRODUCTS_A, TYPE=GAS +*DENSITY +1600.0 +*MATERIAL, NAME=PRODUCTS_B, TYPE=GAS +*DENSITY +1700.0 +*SPHLITE EOS, TYPE=JWL, MATERIAL=PRODUCTS_A, RHO0=1600.0, A=3.712E11, B=3.231E9, R1=4.15, R2=0.95, OMEGA=0.3, E0=4.2E6 +*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=PRODUCTS_B, GAMMA=1.35, E0=5.0E6, P0=0.0 +*SPHLITE EXPLOSIVE, MATERIAL=TNT, TYPE=PROGRAMMED_BURN, DETONATION_VELOCITY=6900.0, ENERGY=4.2E6, BURN_TIME=0.0, PRODUCT_MATERIAL=PRODUCTS_A, CONVERSION=PHASE +*SPHLITE EXPLOSIVE, MATERIAL=PBX, TYPE=PROGRAMMED_BURN, DETONATION_VELOCITY=7600.0, ENERGY=5.0E6, BURN_TIME=0.0, PRODUCT_MATERIAL=PRODUCTS_B, CONVERSION=PHASE +*SPHLITE IGNITION, MATERIAL=TNT, X=0.0, Y=0.0, Z=0.0, TIME=0.0 +*SPHLITE IGNITION, MATERIAL=PBX, X=0.3, 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_multimaterial_041.inp b/tests/data/explosive_multimaterial_041.inp new file mode 100644 index 0000000..b07f39e --- /dev/null +++ b/tests/data/explosive_multimaterial_041.inp @@ -0,0 +1,36 @@ +*NODE +1, 0.00, 0.0, 0.0 +2, 0.10, 0.0, 0.0 +3, 0.20, 0.0, 0.0 +4, 0.30, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=TNT_PARTICLES +1, 2 +*ELSET, ELSET=PBX_PARTICLES +3, 4 +*MATERIAL, NAME=TNT, TYPE=EXPLOSIVE +*DENSITY +1600.0 +*SECTION, ELSET=TNT_PARTICLES, MATERIAL=TNT +*MATERIAL, NAME=PBX, TYPE=EXPLOSIVE +*DENSITY +1750.0 +*SECTION, ELSET=PBX_PARTICLES, MATERIAL=PBX +*MATERIAL, NAME=TNT_GAS, TYPE=GAS +*DENSITY +1600.0 +*MATERIAL, NAME=PBX_GAS, TYPE=GAS +*DENSITY +1700.0 +*SPHLITE EOS, TYPE=JWL, MATERIAL=TNT_GAS, RHO0=1600.0, A=3.712E11, B=3.231E9, R1=4.15, R2=0.95, OMEGA=0.3, E0=4.2E6 +*SPHLITE EOS, TYPE=JWL, MATERIAL=PBX_GAS, RHO0=1700.0, A=4.000E11, B=3.500E9, R1=4.20, R2=1.00, OMEGA=0.32, E0=5.0E6 +*SPHLITE EXPLOSIVE, MATERIAL=TNT, TYPE=PROGRAMMED_BURN, DETONATION_VELOCITY=6900.0, ENERGY=4.2E6, BURN_TIME=1.0E-7, PRODUCT_MATERIAL=TNT_GAS, CONVERSION=SOURCE +*SPHLITE EXPLOSIVE, MATERIAL=PBX, TYPE=PROGRAMMED_BURN, DETONATION_VELOCITY=7600.0, ENERGY=5.0E6, BURN_TIME=2.0E-7, PRODUCT_MATERIAL=PBX_GAS, CONVERSION=PHASE +*SPHLITE IGNITION, MATERIAL=TNT, X=0.00, Y=0.0, Z=0.0, TIME=0.0 +*SPHLITE IGNITION, MATERIAL=PBX, X=0.30, 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_phase_refresh_041.inp b/tests/data/explosive_phase_refresh_041.inp new file mode 100644 index 0000000..5dda5a9 --- /dev/null +++ b/tests/data/explosive_phase_refresh_041.inp @@ -0,0 +1,24 @@ +*NODE +1, 0.00, 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 +1200.0 +*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=PRODUCTS, GAMMA=1.35, E0=4.2E6, P0=0.0 +*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_restart_040_compat_041.inp b/tests/data/explosive_restart_040_compat_041.inp new file mode 100644 index 0000000..6590580 --- /dev/null +++ b/tests/data/explosive_restart_040_compat_041.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_source_multi_target_041.inp b/tests/data/explosive_source_multi_target_041.inp new file mode 100644 index 0000000..209fc9a --- /dev/null +++ b/tests/data/explosive_source_multi_target_041.inp @@ -0,0 +1,38 @@ +*NODE +1, 0.00, 0.0, 0.0 +2, 0.05, 0.0, 0.0 +3, 0.20, 0.0, 0.0 +4, 0.25, 0.0, 0.0 +5, 0.40, 0.0, 0.0 +6, 0.45, 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 +*ELSET, ELSET=PRODUCT_A_PARTICLES +3, 4 +*ELSET, ELSET=PRODUCT_B_PARTICLES +5, 6 +*MATERIAL, NAME=TNT, TYPE=EXPLOSIVE +*DENSITY +1600.0 +*SECTION, ELSET=CHARGE_PARTICLES, MATERIAL=TNT +*MATERIAL, NAME=PRODUCTS_A, TYPE=GAS +*DENSITY +1600.0 +*SECTION, ELSET=PRODUCT_A_PARTICLES, MATERIAL=PRODUCTS_A +*MATERIAL, NAME=PRODUCTS_B, TYPE=GAS +*DENSITY +1700.0 +*SECTION, ELSET=PRODUCT_B_PARTICLES, MATERIAL=PRODUCTS_B +*SPHLITE EOS, TYPE=JWL, MATERIAL=PRODUCTS_A, RHO0=1600.0, A=3.712E11, B=3.231E9, R1=4.15, R2=0.95, OMEGA=0.3, E0=4.2E6 +*SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=PRODUCTS_B, GAMMA=1.35, E0=5.0E6, P0=0.0 +*SPHLITE EXPLOSIVE, MATERIAL=TNT, TYPE=PROGRAMMED_BURN, DETONATION_VELOCITY=6900.0, ENERGY=4.2E6, BURN_TIME=1.0E-7, PRODUCT_MATERIAL=PRODUCTS_A, 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=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/explosive_water_gas_mixed_041.inp b/tests/data/explosive_water_gas_mixed_041.inp new file mode 100644 index 0000000..27bae05 --- /dev/null +++ b/tests/data/explosive_water_gas_mixed_041.inp @@ -0,0 +1,39 @@ +*NODE +1, 0.00, 0.0, 0.0 +2, 0.08, 0.0, 0.0 +3, 0.40, 0.0, 0.0 +4, 0.48, 0.0, 0.0 +5, 0.80, 0.0, 0.0 +6, 0.88, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +5, 5 +6, 6 +*ELSET, ELSET=WATER_PARTICLES +1, 2 +*ELSET, ELSET=CHARGE_PARTICLES +3, 4 +*ELSET, ELSET=PRODUCT_PARTICLES +5, 6 +*MATERIAL, NAME=WATER, TYPE=WATER +*DENSITY +1000.0 +*SECTION, ELSET=WATER_PARTICLES, MATERIAL=WATER +*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=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=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.40, 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/interface/test_c_api.c b/tests/interface/test_c_api.c index c6365b3..ba7a2c5 100644 --- a/tests/interface/test_c_api.c +++ b/tests/interface/test_c_api.c @@ -142,7 +142,7 @@ int main(void) ierr = sphlite_get_version(&major, &minor, &patch); if (ierr != 0) return fail("get_version failed"); - if (major != 0 || minor != 4 || patch != 0) return fail("unexpected version"); + if (major != 0 || minor != 4 || 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 5fcc83d..57e4a4a 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 != 4 || version.patch != 0) { + if (version.major != 0 || version.minor != 4 || version.patch != 1) { return 1; } diff --git a/tests/unit/test_smoke.f90 b/tests/unit/test_smoke.f90 index c0ae734..3fb48e1 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 /= 4 .or. patch /= 0) call fail('unexpected version') + if (major /= 0 .or. minor /= 4 .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 84fbcd8..cb88e01 100644 --- a/todo.md +++ b/todo.md @@ -1,147 +1,147 @@ # SPHLite TODO -当前目标版本:0.4.0 +当前目标版本:0.4.1 -本文档依据 `docs/v4.0_development_plan.md` 拆分。0.4.0 定位为 `Explosive` 模块起步版本,目标是在 0.3.1 `Gas` 多材料、EOS 分派、源项缓存、扩展诊断和 restart 兼容基础上,建立炸药粒子的解析点火、爆轰到达时间、反应进度和向 `Gas` 释放质量、动量、能量的最小闭环。 +本文档依据 `docs/v4.1_development_plan.md` 拆分。0.4.1 定位为 0.4 `Explosive` 版本线的稳定化和加固版本,目标是在 0.4.0 已完成解析点火、programmed burn、Gas 源项注入、phase 转化、restart 和接口 gate 的基础上,加固多点点火、多炸药材料、释放量基准、release balance、Water/Gas/Explosive 混合 smoke 和 restart 兼容。 -所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.4.0 不实现 Solid、Shell、真实 FEM-SPH 耦合、工程级水下爆炸 benchmark、完整化学反应爆轰模型或球面经验载荷主模型。 +所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.4.1 不实现 Solid、Shell、真实 FEM-SPH 耦合、工程级水下爆炸 benchmark、完整化学反应爆轰模型或球面经验载荷主模型。 执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端。 ## 阶段 A:版本基线、范围声明与输入样例 -- [x] 确认当前 git 状态并记录 0.4.0 开发起点。 -- [x] 确认 0.3.1 最终提交可作为 0.4.0 开发基线。 -- [x] 将核心软件版本更新为 `0.4.0`。 -- [x] 将 CMake 项目版本更新为 `0.4.0`。 +- [x] 确认当前 git 状态并记录 0.4.1 开发起点。 +- [x] 确认 `v0.4.0` 标签和发布提交可作为 0.4.1 开发基线。 +- [x] 将核心软件版本更新为 `0.4.1`。 +- [x] 将 CMake 项目版本更新为 `0.4.1`。 - [x] 更新 Fortran smoke 测试中的版本期望。 - [x] 更新 C API 测试中的版本期望。 - [x] 更新 C++ API 测试中的版本期望。 - [x] 更新 Python debug 测试中的版本期望。 - [x] 更新 CLI `--version` 和 inspect 版本期望。 -- [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] 创建点火字段缺失或非法的错误输入样例。 +- [x] 在 README 中记录 0.4.1 Explosive 稳定化版本定位。 +- [x] 创建多点点火正向输入样例。 +- [x] 创建多点点火顺序反转输入样例。 +- [x] 创建多点点火跨 material 输入样例。 +- [x] 创建多 Explosive material 输入样例。 +- [x] 创建多个 product Gas material 输入样例。 +- [x] 创建 SOURCE 路径多 target Gas material 输入样例。 +- [x] 创建 PHASE 路径 Gas 状态刷新输入样例。 +- [x] 创建 Water/Gas/Explosive 混合 smoke 输入样例。 +- [x] 创建 `STATE_0_4` restart 兼容测试所需输入或夹具。 +- [x] 创建缺少匹配点火记录的错误输入样例。 -## 阶段 B:Explosive 输入解析、材料控制与校验 +## 阶段 B:多点点火、多材料输入与校验 -- [x] 为 `TYPE=EXPLOSIVE` material 增加输入识别路径。 -- [x] 为 explosive material 数量增加集中式统计字段。 -- [x] 为 explosive material 内部 id 增加存储字段。 -- [x] 为 explosive material 名称增加存储字段。 -- [x] 为 explosive 初始密度增加 material 级存储字段。 -- [x] 为 explosive 爆速增加 material 级存储字段。 -- [x] 为 explosive 单位质量能量增加 material 级存储字段。 -- [x] 为 explosive 反应时间窗口增加 material 级存储字段。 -- [x] 为 explosive product Gas material 映射增加存储字段。 -- [x] 为 explosive conversion mode 增加存储字段。 -- [x] 增加 explosive material 状态表初始化过程。 -- [x] 增加 explosive material 状态表清理过程。 -- [x] 增加按 material 名称查找 explosive material id 的过程。 -- [x] 将 `*SPHLITE EXPLOSIVE` 解析结果绑定到 explosive material。 -- [x] 将 `*SPHLITE IGNITION` 解析结果绑定到 explosive material。 -- [x] 对 explosive material 缺失 `*DENSITY` 的输入报 error。 -- [x] 对 explosive material 缺失 `*SPHLITE EXPLOSIVE` 的输入报 error。 -- [x] 对 explosive section 未绑定 active 粒子的输入报 warning。 -- [x] 对 product material 不是 Gas material 的输入报 error。 -- [x] 对 product Gas material 缺失 EOS 的输入报 error。 +- [ ] 复核 0.4.0 点火记录存储结构是否支持同一 material 多条记录。 +- [ ] 加固点火记录清理过程,确保重复初始化不会残留旧记录。 +- [ ] 加固点火记录 material 匹配逻辑。 +- [ ] 加固点火记录输入顺序无关逻辑。 +- [ ] 实现多点点火到达时间取最小值的显式测试路径。 +- [ ] 对缺少匹配点火记录的 explosive 粒子报 error。 +- [ ] 对点火时间为负值的输入保持 error。 +- [ ] 对点火坐标非法或缺失的输入保持 error。 +- [ ] 复核 Explosive material 注册过程支持多个炸药材料。 +- [ ] 复核 Explosive control 表支持每个 material 独立参数。 +- [ ] 复核 product Gas material 映射支持多个目标材料。 +- [ ] 校验不同 Explosive material 可使用不同爆速。 +- [ ] 校验不同 Explosive material 可使用不同单位质量能量。 +- [ ] 校验不同 Explosive material 可使用不同 burn time。 +- [ ] 校验不同 Explosive material 可使用不同 conversion mode。 +- [ ] 校验不同 Explosive material 可映射到相同 product Gas。 +- [ ] 校验不同 Explosive material 可映射到不同 product Gas。 +- [ ] 对 product Gas material 缺失 EOS 的多材料输入报 error。 +- [ ] 对无 active 粒子的 Explosive material 继续报 warning 而不阻止运行。 +- [ ] 新增多点点火和多材料输入模块测试并接入 CTest。 -## 阶段 C:Explosive 模块状态、点火与爆轰到达时间 +## 阶段 C:反应质量基准与释放量一致性 -- [x] 新增 `src/explosive` 模块目录和 Fortran 源文件骨架。 -- [x] 将 Explosive 源文件接入 CMake 构建列表。 -- [x] 增加 `sph_explosive_reset` 生命周期入口。 -- [x] 增加 `sph_explosive_build` 模型构建入口。 -- [x] 增加 `sph_explosive_finalize` 或清理入口。 -- [x] 为每粒子爆轰到达时间增加状态数组。 -- [x] 为每粒子反应进度 `lambda` 增加状态数组。 -- [x] 为每粒子累计释放质量增加状态数组。 -- [x] 为每粒子累计释放能量增加状态数组。 -- [x] 为每粒子累计释放动量增加状态数组。 -- [x] 为每粒子 ignition status 增加状态数组。 -- [x] 增加 Explosive 状态数组分配过程。 -- [x] 增加 Explosive 状态数组清零过程。 -- [x] 增加 Explosive active 粒子筛选过程。 -- [x] 增加单点点火记录的内部设置过程。 -- [x] 增加多点点火记录的状态预留和清理过程。 -- [x] 实现按初始坐标计算单点爆轰到达时间。 -- [x] 实现多点点火到达时间取最小值的预留路径。 -- [x] 增加爆轰到达时间范围诊断过程。 -- [x] 增加爆轰到达时间模块测试并接入 CTest。 +- [ ] 新增每粒子 Explosive 反应质量基准状态。 +- [ ] 在 Explosive 状态分配过程中分配反应质量基准数组。 +- [ ] 在 Explosive 状态清理过程中清零反应质量基准数组。 +- [ ] 在模型构建阶段从当前粒子质量冻结反应质量基准。 +- [ ] 确认无 Explosive 输入时反应质量基准不影响 Water/Gas 算例。 +- [ ] 将 SOURCE 路径释放质量改为使用冻结反应质量基准。 +- [ ] 将 PHASE 路径释放质量改为使用冻结反应质量基准。 +- [ ] 保持 `delta_lambda` 作为唯一释放增量来源。 +- [ ] 保持 `lambda` 单调不可逆并限制在 `[0,1]`。 +- [ ] 保持 `burn_time = 0` 的瞬时反应行为。 +- [ ] 保持 `burn_time > 0` 的线性反应窗口行为。 +- [ ] 计算每粒子剩余可反应质量。 +- [ ] 计算全局 Explosive 初始反应质量。 +- [ ] 计算全局 Explosive 累计释放质量。 +- [ ] 计算全局 Explosive 剩余可反应质量。 +- [ ] 计算释放质量闭合误差诊断。 +- [ ] 计算释放能量闭合误差诊断。 +- [ ] 计算三向释放动量合计诊断。 +- [ ] 新增初始质量释放一致性测试并接入 CTest。 +- [ ] 新增 release balance 模块测试并接入 CTest。 -## 阶段 D:反应进度、释放量、Gas 源项与 phase 转化 +## 阶段 D:SOURCE、PHASE、混合链路与输出 -- [x] 实现 programmed burn 反应进度目标值计算。 -- [x] 实现 `burn_time = 0` 的瞬时反应路径。 -- [x] 实现 `burn_time > 0` 的线性反应窗口路径。 -- [x] 保证 `lambda` 被限制在 `[0,1]` 范围内。 -- [x] 保证 `lambda` 单调不可逆增加。 -- [x] 计算每步 `delta_lambda` 反应增量。 -- [x] 按 `delta_lambda * mass_initial` 计算释放质量。 -- [x] 按释放质量和单位质量能量计算释放能量。 -- [x] 按释放质量和当前速度计算释放动量。 -- [x] 将释放质量累计到 Explosive 诊断状态。 -- [x] 将释放能量累计到 Explosive 诊断状态。 -- [x] 将释放动量累计到 Explosive 诊断状态。 -- [x] 实现 `CONVERSION=SOURCE` 到 Gas 源项缓存的注入路径。 -- [x] 实现 `CONVERSION=PHASE` 的完全反应后 phase 转化路径。 -- [x] 将完全反应粒子的 material 改为 product Gas material。 -- [x] 在 phase 转化后刷新 Gas 压力和 summary。 -- [x] 对无法确定目标 Gas 状态的 source 注入路径报 error。 -- [x] 将 Explosive 更新挂接到显式求解器步骤中。 -- [x] 增加反应时间步约束诊断或预留字段。 -- [x] 确认无 Explosive 输入时 Water/Gas 算例不进入 Explosive 更新路径。 +- [ ] 加固 SOURCE 路径 product Gas target 计数逻辑。 +- [ ] 确保 SOURCE 路径只选择匹配 product material 的 active Gas 粒子。 +- [ ] 确保 SOURCE 路径存在多个 Gas material 时不会跨 material 注入。 +- [ ] 对 SOURCE 路径无 active product Gas target 的输入保持 error。 +- [ ] 统计 SOURCE 路径参与接收的 Gas 粒子数。 +- [ ] 统计 SOURCE 路径注入的质量总量。 +- [ ] 统计 SOURCE 路径注入的能量总量。 +- [ ] 统计 SOURCE 路径注入的三向动量总量。 +- [ ] 加固 SOURCE 源项应用后的 Gas summary 刷新。 +- [ ] 加固 PHASE 转化后的 `particle_phase` 和 `material_id` 更新。 +- [ ] 加固 PHASE 转化后的 `rho`、`volume` 和 `internal_energy` 更新。 +- [ ] 加固 PHASE 转化后的 Gas pressure 刷新。 +- [ ] 加固 PHASE 转化后的 Gas summary 刷新。 +- [ ] 保持已转化 Gas 粒子的 Explosive 历史状态可追踪。 +- [ ] 新增 Water/Gas/Explosive 混合 smoke 显式推进测试。 +- [ ] 新增 SOURCE target material 测试并接入 CTest。 +- [ ] 新增 PHASE 状态刷新测试并接入 CTest。 +- [ ] 在 summary CSV 中追加 release balance 字段。 +- [ ] 在粒子 CSV 中追加 Explosive 反应质量和剩余质量字段。 +- [ ] 更新 output 测试以锁定 0.4.1 CSV header 和 summary 字段。 -## 阶段 E:Summary、Output、Restart、API、C++、Python 与 CLI +## 阶段 E:Restart、API、C++、Python 与 CLI -- [x] 增加 Explosive summary 内部统计过程。 -- [x] 统计 explosive 粒子总数和已反应粒子数。 -- [x] 统计 `lambda` 最小值、最大值和平均值。 -- [x] 统计累计释放质量、能量和三向动量。 -- [x] 统计爆轰到达时间最小值和最大值。 -- [x] 将 Explosive summary 字段写入 summary CSV。 -- [x] 将 Explosive 关键粒子状态写入粒子 CSV 输出。 -- [x] 将 0.4.0 restart 状态版本更新为 `STATE_0_4`。 -- [x] 将 Explosive material 表写入 0.4.0 restart。 -- [x] 将 product Gas material 映射写入 0.4.0 restart。 -- [x] 将点火记录写入 0.4.0 restart。 -- [x] 将每粒子爆轰到达时间写入 0.4.0 restart。 -- [x] 将每粒子反应进度和累计释放量写入 0.4.0 restart。 -- [x] 从 0.4.0 restart 读回 Explosive 状态并继续显式步。 -- [x] 从 0.3.1 restart 读回时初始化空 Explosive 状态。 -- [x] 增加 `sph_get_explosive_summary` Fortran API。 -- [x] 增加 `sph_set_ignition_point` Fortran API。 -- [x] 在 C ABI 中追加点火点设置和 Explosive summary 查询接口。 -- [x] 在 C++ wrapper 和 Python ctypes 中增加 Explosive 薄包装。 -- [x] 在 CLI inspect/run 中增加 Explosive 字段检查。 +- [ ] 将 restart 状态版本更新为 `STATE_0_4_1`。 +- [ ] 将 Explosive 反应质量基准写入 0.4.1 restart。 +- [ ] 将 release balance 相关状态写入 0.4.1 restart。 +- [ ] 将 SOURCE/PHASE 诊断计数写入 0.4.1 restart。 +- [ ] 从 0.4.1 restart 读回反应质量基准。 +- [ ] 从 0.4.1 restart 读回 release balance 相关状态。 +- [ ] 从 0.4.0 restart 读回时初始化新增 0.4.1 状态。 +- [ ] 从 0.3.1 restart 读回时保持空 Explosive 状态。 +- [ ] 新增 restart 后继续推进不重复释放测试。 +- [ ] 新增 `sph_get_explosive_release_balance` Fortran API。 +- [ ] 新增 `sphlite_get_explosive_release_balance` C ABI。 +- [ ] 在 C ABI 中补齐新增接口的空指针错误路径。 +- [ ] 在 C API 测试中覆盖 release balance 查询。 +- [ ] 在 C++ wrapper 中增加 release balance 薄包装。 +- [ ] 在 C++ API 测试中覆盖 release balance 薄包装。 +- [ ] 在 Python ctypes 中增加 release balance 薄包装。 +- [ ] 在 Python checker 中覆盖多点点火和 release balance。 +- [ ] 在 CLI inspect/run 中追加 release balance 字段。 +- [ ] 在 CLI checker 中覆盖多点点火、多材料和 release balance 字段。 +- [ ] 新增 0.4.1 restart/API/CLI/Python 专项 CTest 条目。 -## 阶段 F:测试接入、回归、文档同步与发布门禁 +## 阶段 F:回归、门禁、文档同步与发布准备 -- [x] 新增 `input_explosive` 测试并接入 CTest。 -- [x] 新增 `input_explosive_errors` 测试并接入 CTest。 -- [x] 新增 `explosive_detonation_time` 测试并接入 CTest。 -- [x] 新增 `explosive_reaction_progress` 测试并接入 CTest。 -- [x] 新增 `explosive_release_source` 测试并接入 CTest。 -- [x] 新增 `explosive_to_gas_phase` 测试并接入 CTest。 -- [x] 新增 `explosive_gas_coupling` 测试并接入 CTest。 -- [x] 新增 `explosive_summary` 测试并接入 CTest。 -- [x] 新增 `explosive_restart_040` 测试并接入 CTest。 -- [x] 新增 `explosive_restart_031_compat` 测试并接入 CTest。 -- [x] 新增 `explosive_c_api` 测试并接入 CTest。 -- [x] 新增 `explosive_python` 测试并接入 CTest。 -- [x] 新增 `explosive_cli` 测试并接入 CTest。 -- [x] 新增 `explosive_source_size` 测试或检查项并接入 CTest。 -- [x] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。 -- [x] 保持 0.3.1 默认 gate 全部通过。 -- [x] 单独运行 0.4.0 新增 Explosive gate。 -- [x] 运行 `source_size` 检查并确认无新增无理由例外。 -- [x] 运行 `git diff --check` 并清理空白问题。 -- [x] 更新 README、06、09 和 11 号文档的 0.4.0 测试和验收记录。 +- [ ] 新增 `input_explosive_multi_ignition` 测试并接入 CTest。 +- [ ] 新增 `input_explosive_multimaterial` 测试并接入 CTest。 +- [ ] 新增 `explosive_initial_mass_release` 测试并接入 CTest。 +- [ ] 新增 `explosive_release_balance` 测试并接入 CTest。 +- [ ] 新增 `explosive_source_targeting` 测试并接入 CTest。 +- [ ] 新增 `explosive_phase_refresh` 测试并接入 CTest。 +- [ ] 新增 `explosive_restart_041` 测试并接入 CTest。 +- [ ] 新增 `explosive_restart_040_compat` 测试并接入 CTest。 +- [ ] 新增 `explosive_restart_no_double_release` 测试并接入 CTest。 +- [ ] 新增 `explosive_water_gas_smoke` 测试并接入 CTest。 +- [ ] 新增 `explosive_release_c_api` 测试并接入 CTest。 +- [ ] 新增 `explosive_release_python` 测试并接入 CTest。 +- [ ] 新增 `explosive_release_cli` 测试并接入 CTest。 +- [ ] 新增 `explosive_041_source_size` 检查项并接入 CTest。 +- [ ] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。 +- [ ] 保持 0.4.0 完整 gate 全部通过。 +- [ ] 单独运行 0.4.1 新增 Explosive gate。 +- [ ] 运行 `source_size` 检查并确认无新增无理由例外。 +- [ ] 运行 `git diff --check` 并清理空白问题。 +- [ ] 更新 README、06、09 和 11 号文档的 0.4.1 测试和验收记录。 diff --git a/tools/testing/test_cli.py b/tools/testing/test_cli.py index 031b681..8113529 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.4.0" not in version.stdout: + if "0.4.1" not in version.stdout: raise AssertionError("CLI version mismatch") inspect = run_command([exe, model]) @@ -96,7 +96,7 @@ def main() -> int: ): require_field(inspect.stdout, field) inspect_fields = read_fields(inspect.stdout) - if inspect_fields["version"] != "0.4.0": + if inspect_fields["version"] != "0.4.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 48f1ca1..1b75be7 100644 --- a/tools/testing/test_python_debug.py +++ b/tools/testing/test_python_debug.py @@ -35,7 +35,7 @@ def main() -> int: raise AssertionError("Python wrapper is missing Explosive C ABI diagnostics") if not hasattr(solver.lib, "sphlite_set_ignition_point"): raise AssertionError("Python wrapper is missing Explosive ignition C ABI") - if solver.version() != (0, 4, 0): + if solver.version() != (0, 4, 1): raise AssertionError("Python version mismatch") solver.initialize()