diff --git a/CMakeLists.txt b/CMakeLists.txt index 1b3e580..697d823 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,6 +1,6 @@ cmake_minimum_required(VERSION 3.20) -project(SPHLite VERSION 0.4.1 LANGUAGES C CXX Fortran) +project(SPHLite VERSION 0.5.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 b87ed4a..b1647f1 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。 -当前开发版本: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。 +当前开发版本:0.5.0。该版本定位为 `Solid` 3D 实体结构粒子起步版本,在 0.4.1 已建立 Water/Gas/Explosive 稳定闭环的基础上,开展 Solid 输入、状态、本构、失效、显式推进、restart、接口和测试 gate 开发。不交付 `Shell` 的生产路径,也不交付真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行或工程级结构破坏 benchmark。 代码仓库地址: @@ -63,7 +63,7 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: ## 当前状态 -0.4.1 当前已完成 `Explosive` 起步闭环后的稳定化加固。0.4.0 已完成内容主要包括: +0.5.0 当前在 0.4.1 `Explosive` 稳定化基线之上启动 `Solid` 起步开发。0.4.1 已完成内容主要包括: - CMake/CTest 工程骨架和 Fortran 95 核心库。 - C ABI、C++ 头文件薄包装和 Python `ctypes` 调试入口。 @@ -75,6 +75,7 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: - `Explosive` summary、CSV 输出字段、`STATE_0_4` restart、0.3.1 restart 兼容读入、Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 字段。 - 0.4.1 在 0.4.0 基础上加固多点点火、多炸药材料、冻结反应质量、release balance、SOURCE/PHASE 诊断、Water/Gas/Explosive 混合 smoke、`STATE_0_4_1` restart 和 `STATE_0_4` 兼容读入。 - 0.4.1 追加 release balance 的 Fortran API、C ABI、C++ wrapper、Python ctypes、CLI 和专项 CTest gate。 +- 0.5.0 将围绕 `Solid` 3D 实体结构粒子的 material/section 输入、Johnson-Cook 材料与失效、渐进软化、Solid-only 显式 smoke、`STATE_0_5` restart 和接口诊断开展。 - CouplingInterface 的中立数据导出、外部粒子力导入和诊断占位;0.2.2 不暴露 CouplingInterface C ABI,真实 FEM-SPH 联合运行仍由外部 CouplingModule 后续实现。 -- `Solid`、`Shell` 仍为后续阶段,不在 0.4.1 交付生产计算路径。 +- `Shell` 仍为后续阶段,不在 0.5.0 交付生产计算路径。 - 0.4.1 本地 gate 已通过:完整 CTest 66/66,Explosive 专项 gate 14/14,`source_size` 通过。 diff --git a/docs/v5.0_development_plan.md b/docs/v5.0_development_plan.md new file mode 100644 index 0000000..053c0f0 --- /dev/null +++ b/docs/v5.0_development_plan.md @@ -0,0 +1,629 @@ +# SPHLite v5.0 开发计划 + +文档状态:0.5.0 开发计划草案 + +目标软件版本:SPHLite 0.5.0 + +## 1. 文档定位 + +本文档用于规划 SPHLite 0.5.0 版本的开发范围。0.5.0 是 `Solid` 版本线的起步版本,目标是在 0.4.1 已完成 `Water`、`Gas`、`Explosive` 最小稳定闭环的基础上,建立 3D 实体结构 SPH 粒子的输入、状态、本构、失效、显式推进、restart、接口和测试 gate。 + +0.5.0 不作为完整水-气-结构爆炸响应版本,也不作为 `Shell` 或 FEM-SPH 耦合版本。0.5.0 的重点是让 `Solid` 具备可独立验证的结构材料和显式动力学最小闭环,使后续 0.6 `Shell`、0.7 水-气-结构 smoke 和 0.8/0.9 耦合版本能够依赖稳定的结构粒子状态与接口。 + +## 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.1_development_plan.md` +- `docs/09_release_history.md` +- `docs/10_development_roadmap.md` +- `docs/11_benchmark_matrix.md` + +## 3. 版本定位 + +### 3.1 与 0.4.1 的关系 + +0.4.1 已完成 `Explosive` 稳定化: + +- 多点点火和多炸药 material 输入。 +- 基于冻结反应质量的释放量统计。 +- release balance、SOURCE/PHASE 诊断。 +- Water/Gas/Explosive 混合 smoke。 +- `STATE_0_4_1` restart 和 `STATE_0_4` 兼容读入。 +- release balance 的 Fortran API、C ABI、C++ wrapper、Python ctypes、CLI 和专项 gate。 +- 完整 CTest、Explosive 专项 gate、source size 和 `git diff --check` 均已通过。 + +0.5.0 不重写 `Water`、`Gas` 或 `Explosive` 路线。0.5.0 必须保持 0.4.1 全量 gate 稳定,并在此基础上新增 `Solid` 能力。`Solid` 加入后不得改变 Water-only、Gas-only、Explosive-Gas-Water 算例的既有结果和接口语义。 + +### 3.2 与 0.6.0 的关系 + +0.6.0 建议作为 `Shell` 版本线起点。0.5.0 不实现 Mindlin-Reissner 板壳、厚度积分、director/角速度或板壳撕裂。0.5.0 可以在 material、section、phase/status 和 restart 中保留 `Shell` 已有占位,但不得宣称已实现板壳结构响应。 + +### 3.3 与耦合版本的关系 + +真实 FEM-SPH 接触耦合和连续体耦合仍属于后续 0.8/0.9。0.5.0 只维护 SPHLite 内部 `Solid` 粒子状态和中立 `CouplingInterface` 既有边界,不直接依赖 FEMLite,不修改 FEMLite,也不引入外部 CouplingModule 作为依赖。 + +### 3.4 0.5.0 核心目标 + +0.5.0 的核心目标是形成 3D `Solid` 最小闭环: + +```text +Solid input/material/section + -> Solid particle state allocation + -> reference configuration and neighbor/correction state + -> elastic and Johnson-Cook material-point update + -> Johnson-Cook damage and progressive softening + -> Solid explicit step and stable dt contribution + -> Solid output/restart/API/CLI/Python diagnostics + -> 0.4.1 full regression remains stable +``` + +## 4. 开发原则 + +### 4.1 保持 0.5 版本线边界 + +0.5.0 只交付 3D `Solid` 实体结构粒子的最小闭环,不进入 `Shell`、真实水-气-结构耦合、真实 FEM-SPH 耦合或工程级船舱破坏 benchmark。 + +### 4.2 保持求解器定位 + +SPHLite 仍是求解器,不负责几何建模、网格生成或粒子生成。新增 `.inp` 样例和 Python 脚本只能作为测试/示例辅助工具,不作为求解器功能宣传。 + +### 4.3 保持 Fortran 95 和集中型数据管理 + +核心实现继续使用 Fortran 95。`Solid` 状态应纳入集中数据库和模块级状态管理,不采用面向对象粒子类设计。C ABI、C++ wrapper、Python ctypes 和 CLI 继续作为薄接口层。 + +### 4.4 保持显式动力学主流程 + +时间推进继续只支持 Velocity-Verlet 显式动力学。0.5.0 可新增 `Solid` 结构波速稳定时间步约束和结构内力更新,但不引入隐式求解、静力求解、非线性静力求解或隐式-显式混合接口。 + +### 4.5 先材料点和小型结构闭环,再工程破坏 + +Johnson-Cook 材料模型和失效模型必须先通过材料点、小型均匀变形和小型结构 smoke 验收。0.5.0 不追求复杂断裂路径、碎片云、焊缝失效或工程级舱段破坏。 + +### 4.6 不破坏既有接口 + +C ABI 必须追加式扩展。不得改变 0.4.1 已有函数的字段含义、数组长度约定或错误码语义。新增 `Solid` 诊断应优先使用新增函数和新增 CLI/Python 字段。 + +## 5. 0.5.0 交付目标 + +0.5.0 建议交付以下内容: + +1. 将软件版本更新为 `0.5.0`。 +2. 保持 0.4.1 默认 gate 全部通过。 +3. 新增 `TYPE=SOLID` material 输入识别和 Solid section 识别。 +4. 支持 Solid material 的密度、弹性参数和 Johnson-Cook 参数读取。 +5. 支持 Johnson-Cook 失效参数读取,并为渐进软化保留输入或默认策略。 +6. 新增 `Solid` 模块生命周期:reset、allocate/build、advance、finalize。 +7. 新增 Solid per-particle 状态数组,包括应力、应变、塑性应变、塑性应变率、温度、损伤、软化和失效状态。 +8. 建立参考构型相关状态,包括参考坐标、参考体积、参考邻域或修正梯度所需矩阵。 +9. 实现弹性材料点更新,作为 Johnson-Cook 调试和回归退化路径。 +10. 实现 Johnson-Cook 流动应力材料点计算。 +11. 实现 Johnson-Cook 损伤累积和失效判据的最小闭环。 +12. 实现失效后的渐进软化,不删除粒子,使用 `PHASE_SOLID_FAILED` 和 status 表达失效。 +13. 实现小型 Solid 显式推进路径,至少能处理 Solid-only 小模型的内力、体力或受控均匀变形 smoke。 +14. 将 Solid 结构波速或等价稳定时间步约束纳入 `sph_estimate_stable_dt`。 +15. 新增 Solid summary,包括质量、动量、动能、内能、最大应力、塑性应变范围、损伤范围和失效粒子数。 +16. 在粒子 CSV 和 summary CSV 中追加 Solid 诊断字段。 +17. 将 0.5.0 restart 状态版本更新为 `STATE_0_5`,保存 Solid material 表、Solid 状态和诊断。 +18. 保持 `STATE_0_4_1`、`STATE_0_4` 和 `STATE_0_3_1` 等既有 restart 兼容读入,并初始化空 Solid 状态。 +19. 新增 Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 的 Solid summary 查询。 +20. 新增 0.5.0 Solid 专项 CTest gate,并保持 source size 受控。 +21. 更新 README、06、09 和 11 号文档中的 0.5.0 测试和验收记录。 +22. 不新增 FEMLite 直接依赖,不修改 SPHLite 文件夹之外的内容。 + +## 6. 非交付范围 + +0.5.0 不交付以下内容: + +1. 不实现 `Shell` Mindlin-Reissner 生产求解路径。 +2. 不实现板壳厚度积分、director 更新、板壳撕裂或穿孔。 +3. 不实现真实水-气-结构耦合载荷闭环。 +4. 不实现爆炸载荷作用下的船体破坏工程 benchmark。 +5. 不实现真实 FEM-SPH 接触耦合或连续体耦合。 +6. 不实现生产级断裂面追踪、裂纹扩展、碎片云或焊缝失效库。 +7. 不实现复杂接触、碰撞、摩擦或碎片-流体相互作用。 +8. 不实现热传导、熔化、相变或完整热-力耦合。 +9. 不实现大规模并行、GPU 后端或性能优化版本。 +10. 不新增几何、网格或粒子生成能力。 + +## 7. 输入范围 + +### 7.1 Solid material 识别 + +0.5.0 应复用 Abaqus 风格 `.inp` 子集。能复用 Abaqus 关键词时不新增关键词;Abaqus 难以表达的 SPHLite 专有行为才使用 `*SPHLITE ...` 扩展。 + +建议最小输入形式: + +```text +*MATERIAL, NAME=STEEL, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*PLASTIC, HARDENING=JOHNSON COOK +A, B, N, C, M, EPSDOT0, TROOM, TMELT +*DAMAGE INITIATION, CRITERION=JOHNSON COOK +D1, D2, D3, D4, D5 +*SPHLITE SOLID CONTROL, MATERIAL=STEEL, SOFTENING=LINEAR +``` + +如果现有输入层更适合使用已建立的 `*SPHLITE ...` material/control 风格,0.5.0 可在实现阶段收敛语法,但必须满足: + +- material 可明确识别为 `Solid`。 +- 密度缺失时报 error。 +- 弹性参数缺失时报 error。 +- Johnson-Cook 参数缺失或非法时报 error。 +- Johnson-Cook 失效参数缺失时,若本算例请求失效,则报 error。 +- 不影响运行的 Abaqus 未支持关键词继续 warning。 + +### 7.2 Solid section + +3D 实体结构粒子通过 material 识别为 `Solid`,通过 section 识别实体 section 属性。建议支持 Abaqus 风格 `*SOLID SECTION` 或既有等价 section 关键词: + +```text +*SOLID SECTION, ELSET=HULL_SOLID, MATERIAL=STEEL +``` + +set 仍只表示集合,不作为类型判断依据。`Solid` 的计算行为必须由 phase、material 和 section 共同确定。 + +### 7.3 初始条件和边界 + +0.5.0 可复用既有粒子位置、速度、体力和时间控制输入。结构专项测试可使用: + +- 初始速度或体力驱动。 +- 小型均匀拉伸/压缩速度场。 +- 简化约束或固定粒子 status。 + +0.5.0 不要求实现完整边界条件库、接触边界或 FEM 驱动边界。 + +## 8. Solid 状态设计 + +### 8.1 模块级 material 状态 + +建议新增 Solid material 表,至少保存: + +- material id 和名称映射。 +- 密度 `rho0`。 +- 弹性模量 `E`。 +- 泊松比 `nu`。 +- 剪切模量 `G`。 +- 体积模量 `K`。 +- 参考声速或结构波速。 +- Johnson-Cook 流动参数 `A`、`B`、`n`、`C`、`m`。 +- 参考应变率 `epsdot0`。 +- 室温 `Troom` 和熔化温度 `Tmelt`。 +- 比热或等效温升参数。 +- Taylor-Quinney 系数或等效塑性功转温升系数。 +- Johnson-Cook 失效参数 `D1` 到 `D5`。 +- 软化模型类型和软化参数。 + +### 8.2 每粒子 Solid 状态 + +建议第一阶段保存: + +```fortran +real(rk), allocatable :: solid_stress(:,:) +real(rk), allocatable :: solid_strain(:,:) +real(rk), allocatable :: solid_plastic_strain(:) +real(rk), allocatable :: solid_plastic_strain_rate(:) +real(rk), allocatable :: solid_temperature(:) +real(rk), allocatable :: solid_damage(:) +real(rk), allocatable :: solid_softening(:) +real(rk), allocatable :: solid_internal_energy(:) +real(rk), allocatable :: solid_deformation_gradient(:,:,:) +real(rk), allocatable :: solid_correction_matrix(:,:,:) +integer, allocatable :: solid_failure_status(:) +``` + +其中: + +- `solid_stress(6,npart)` 使用 Voigt 顺序,建议为 `xx, yy, zz, xy, yz, zx`。 +- `solid_strain(6,npart)` 保存可恢复的总应变或等价应变状态。 +- `solid_deformation_gradient(3,3,npart)` 保存变形梯度或等价 Total Lagrangian 状态。 +- `solid_correction_matrix(3,3,npart)` 保存参考构型梯度修正或其占位。 +- `solid_damage(i)` 范围为 `[0,1]`。 +- `solid_softening(i)` 表示承载能力折减因子,范围为 `[0,1]`。 +- `solid_failure_status(i)` 表达未失效、软化中、已失效等状态。 + +如果实现阶段为了保持 Fortran 95 和 source size 控制而拆分数组,语义必须保持可恢复、可诊断和可测试。 + +### 8.3 phase 和 status + +0.5.0 应使用已规划的 phase/status: + +- active Solid 粒子:`PHASE_SOLID`。 +- 失效 Solid 粒子:`PHASE_SOLID_FAILED`。 +- 失效不删除粒子。 +- phase/status 改变是不可逆历史过程。 + +失效粒子在 0.5.0 中可以继续保留质量、动量和输出状态。其后续接触、碎片或流体相互作用留给后续版本。 + +## 9. 本构与失效模型 + +### 9.1 弹性退化路径 + +0.5.0 应先实现弹性退化路径,用于材料点和 Solid-only smoke: + +- 读取 `E` 和 `nu`。 +- 计算 `G`、`K` 或 Lamé 参数。 +- 由应变增量更新 Cauchy 应力或等价应力。 +- 输出应力、应变、内能和稳定时间步诊断。 + +弹性路径是调试和回归工具,不替代 Johnson-Cook 主路线。 + +### 9.2 Johnson-Cook 流动应力 + +Johnson-Cook 流动应力建议采用: + +```text +sigma_y = (A + B * eps_p^n) + * (1 + C * ln(epsdot_p / epsdot0)) + * (1 - Tstar^m) +``` + +其中: + +```text +Tstar = clamp((T - Troom) / (Tmelt - Troom), 0, 1) +``` + +0.5.0 可允许等温退化测试,此时 `T = Troom`,热软化项为 1。即使第一版采用等温退化,数据库和 restart 仍必须保存温度状态。 + +### 9.3 塑性更新 + +0.5.0 建议采用小步显式返回映射或等价稳定的材料点更新: + +- 计算试应力。 +- 计算 von Mises 等效应力。 +- 判断屈服。 +- 更新等效塑性应变和等效塑性应变率。 +- 更新应力和塑性功。 +- 更新温度或等效温升占位。 + +第一版测试应覆盖弹性区、屈服后硬化区和应变率项。 + +### 9.4 Johnson-Cook 失效 + +Johnson-Cook 损伤累积建议采用: + +```text +D = D + delta_eps_p / eps_f +``` + +失效应变 `eps_f` 由 Johnson-Cook 失效参数、应力三轴度、应变率和温度项计算。0.5.0 可先实现最小可测路径: + +- 对单轴拉伸或给定三轴度材料点计算 `eps_f`。 +- 损伤 `D` 单调增加。 +- `D >= 1` 时进入失效或软化状态。 +- 非法 `eps_f <= 0` 或非有限值时报 error 或受控保护。 + +### 9.5 渐进软化 + +失效后采用渐进软化,不瞬时删除粒子。0.5.0 建议第一版使用线性软化: + +```text +softening = max(0, 1 - (D - 1) / softening_width) +effective_stress = softening * stress +``` + +具体公式可在实现阶段微调,但必须满足: + +- 软化因子单调不增。 +- 软化因子限制在 `[0,1]`。 +- 失效状态不可逆。 +- 输出和 restart 可恢复软化状态。 + +## 10. Solid SPH 算法范围 + +### 10.1 Total/Corrected Lagrangian 路线 + +0.5.0 应沿用 04 号文档的 Total Lagrangian / corrected Lagrangian SPH 路线。建议第一版至少建立: + +- 参考邻域或参考构型权重。 +- 梯度修正矩阵或其稳定占位。 +- 变形梯度或速度梯度计算入口。 +- 内力和能量诊断入口。 + +如果第一版完整 TL-SPH 内力实现风险过大,可以采用小型、受控的 corrected gradient smoke 作为最小闭环,但必须保留状态和测试边界,避免文档宣称工程级结构响应。 + +### 10.2 Solid 显式步 + +0.5.0 的显式步建议顺序: + +```text +Velocity-Verlet predictor +Water/Gas/Explosive updates when active +Solid kinematic gradient update +Solid constitutive update +Solid internal force and acceleration contribution +External body force contribution +Velocity-Verlet corrector +Diagnostics/output/restart hooks +``` + +Water-only、Gas-only、Explosive-only 算例不应进入 Solid 更新路径。Solid-only 算例应可在无 Water/Gas/Explosive 输入时单独推进。 + +### 10.3 Solid 稳定时间步 + +Solid 结构波速约束建议为: + +```text +dt_solid = cfl * h / (c_solid + |v|) +``` + +其中 `c_solid` 可由弹性参数估计。0.5.0 gate 应验证: + +- 无 Solid 粒子时不影响既有 dt。 +- Solid 粒子存在时 dt 为有限正值。 +- 不同材料参数可改变 Solid dt 限制。 + +### 10.4 Solid 诊断 + +Solid summary 建议包括: + +- active Solid 粒子数。 +- failed Solid 粒子数。 +- Solid 总质量。 +- Solid 总动量。 +- Solid 动能。 +- Solid 内能。 +- 最大 von Mises 应力。 +- 等效塑性应变最小值和最大值。 +- 损伤最小值和最大值。 +- 最小 softening 因子。 +- Solid dt 限制。 + +## 11. API、C ABI、C++、Python 和 CLI + +### 11.1 Fortran API + +建议新增: + +- `sph_get_solid_summary` +- `sph_get_solid_material_summary` +- `sph_get_solid_state` +- `sph_solid_get_failure_counts` + +若实现阶段认为完整 state 查询会导致接口过大,0.5.0 可先交付 summary 和 failure counts,粒子级详细状态通过 CSV 和 restart 验收。 + +### 11.2 C ABI + +C ABI 应保持追加式扩展。建议新增: + +```c +int sphlite_get_solid_summary(int *active_count, + int *failed_count, + double *mass, + double *momentum, + double *energy_values, + double *stress_values, + double *damage_values); +``` + +建议字段: + +- `momentum[0..2]`:Solid 总动量。 +- `energy_values[0]`:动能。 +- `energy_values[1]`:内能。 +- `stress_values[0]`:最大 von Mises 应力。 +- `stress_values[1]`:最大压力或平均等效应力。 +- `damage_values[0]`:最小 damage。 +- `damage_values[1]`:最大 damage。 +- `damage_values[2]`:最小 softening。 + +所有输出数组由调用方分配。空指针、非正容量或未初始化状态必须走既有错误路径。 + +### 11.3 C++ wrapper 和 Python ctypes + +C++ 和 Python 继续做 C ABI 薄包装,不重新定义 Solid 物理语义。Python checker 应覆盖: + +- Solid material inspect。 +- Solid summary 查询。 +- Solid run 后 damage/stress 字段。 +- Solid restart 读回后的 summary 一致性。 + +### 11.4 CLI + +CLI inspect/run 应追加 Solid 字段: + +- `solid_active_particles` +- `solid_failed_particles` +- `solid_mass` +- `solid_max_von_mises` +- `solid_plastic_strain_max` +- `solid_damage_max` +- `solid_dt_limit` + +CLI 测试应覆盖: + +- Solid 输入 inspect。 +- Solid-only 小模型 run。 +- Solid 错误输入。 +- Solid restart 读回 inspect 或 run。 + +## 12. 输出和 Restart + +### 12.1 CSV 输出 + +0.5.0 建议在 summary CSV 中追加 Solid 字段: + +- `solid_active_particles` +- `solid_failed_particles` +- `solid_mass` +- `solid_momentum_x` +- `solid_momentum_y` +- `solid_momentum_z` +- `solid_kinetic_energy` +- `solid_internal_energy` +- `solid_max_von_mises` +- `solid_plastic_strain_min` +- `solid_plastic_strain_max` +- `solid_damage_min` +- `solid_damage_max` +- `solid_softening_min` +- `solid_dt_limit` + +粒子 CSV 可追加: + +- `solid_stress_xx` +- `solid_stress_yy` +- `solid_stress_zz` +- `solid_stress_xy` +- `solid_stress_yz` +- `solid_stress_zx` +- `solid_plastic_strain` +- `solid_damage` +- `solid_softening` +- `solid_failure_status` + +如果粒子 CSV 字段过多,0.5.0 可先输出关键字段,并通过 restart/module test 覆盖完整内部状态。 + +### 12.2 Restart + +0.5.0 restart 建议写入 `STATE_0_5`。必须保存: + +- 粒子通用状态。 +- Velocity-Verlet 所需 `v`、`a`、`vhalf`。 +- Water、Gas、Explosive 既有状态。 +- Solid material 表。 +- Solid per-particle 状态。 +- Solid 诊断和 dt 状态。 +- 未来 Shell/CouplingInterface 已有占位状态。 + +兼容读入: + +- `STATE_0_5`:完整读回。 +- `STATE_0_4_1`:初始化空 Solid 状态。 +- `STATE_0_4`:初始化空 Solid 状态,并保持 Explosive 兼容读入。 +- `STATE_0_3_1` 及更早可支持状态:初始化空 Solid 状态。 + +restart 后继续显式步不得重复初始化 Solid 应力、塑性应变、损伤或失败状态。 + +## 13. 测试计划 + +### 13.1 新增 0.5.0 测试 + +建议新增以下测试: + +- `input_solid_material`:Solid material、elastic、Johnson-Cook 和 Solid section 输入。 +- `input_solid_errors`:缺密度、缺弹性参数、非法 Johnson-Cook 参数、非法 section。 +- `solid_state_build`:Solid 状态分配、phase/material/section 识别和默认值。 +- `solid_elastic_material`:弹性材料点应力更新。 +- `solid_johnson_cook_flow`:Johnson-Cook 流动应力、硬化、应变率项和热项退化。 +- `solid_johnson_cook_failure`:Johnson-Cook 损伤累积和失效阈值。 +- `solid_progressive_softening`:失效后软化单调、不可逆且不删除粒子。 +- `solid_gradient_correction`:参考构型梯度修正或等价占位状态可构建。 +- `solid_stable_dt`:Solid 结构波速 dt 约束。 +- `solid_explicit_smoke`:Solid-only 小模型可显式推进。 +- `solid_output`:summary CSV 和粒子 CSV 的 Solid 字段。 +- `solid_restart_050`:`STATE_0_5` 写入读回并继续显式步。 +- `solid_restart_041_compat`:`STATE_0_4_1` 兼容读入并初始化空 Solid 状态。 +- `solid_c_api`:C ABI Solid summary 查询和错误路径。 +- `solid_python`:Python ctypes Solid summary 和 run/inspect 字段。 +- `solid_cli`:CLI inspect/run 输出 Solid 字段。 +- `solid_source_size`:Solid 模块 source size 和 stale exception 检查。 + +### 13.2 既有回归测试 + +0.5.0 必须继续通过 0.4.1 完整 gate,包括: + +- Water gate。 +- Gas gate。 +- Explosive 0.4.0 gate。 +- Explosive 0.4.1 gate。 +- output/restart gate。 +- C API/C++/Python/CLI gate。 +- source size gate。 + +### 13.3 建议 0.5.0 Release Gate + +建议 0.5.0 默认 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_solid_material|input_solid_errors|solid_state_build|solid_elastic_material|solid_johnson_cook_flow|solid_johnson_cook_failure|solid_progressive_softening|solid_gradient_correction|solid_stable_dt|solid_explicit_smoke|solid_output|solid_restart_050|solid_restart_041_compat|solid_c_api|solid_python|solid_cli|solid_source_size)$" --output-on-failure +ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure +git diff --check +``` + +## 14. 建议开发阶段 + +若后续根据本计划生成 `todo.md`,建议按以下阶段拆分: + +1. 0.5.0 版本号和 0.4.1 发布基线确认。 +2. Solid 输入样例和错误输入样例准备。 +3. Solid material/section 输入解析。 +4. Solid material 表和 Johnson-Cook 参数存储。 +5. Solid per-particle 状态数组和生命周期。 +6. Solid phase/status 默认值和失效状态枚举复核。 +7. 弹性材料点更新和单测。 +8. Johnson-Cook 流动应力材料点和单测。 +9. Johnson-Cook 损伤/失效材料点和单测。 +10. 渐进软化状态和单测。 +11. 参考构型、梯度修正或等价 TL-SPH 状态构建。 +12. Solid 内力/体力/显式推进最小 smoke。 +13. Solid 稳定时间步估计。 +14. Solid summary 和 diagnostics。 +15. summary CSV 和粒子 CSV 字段扩展。 +16. `STATE_0_5` restart 写入。 +17. `STATE_0_5` restart 读回。 +18. `STATE_0_4_1` 和更早 restart 兼容读入。 +19. Fortran API 和 C ABI 追加接口。 +20. C++ wrapper、Python ctypes 和 CLI 扩展。 +21. source size 复核和必要拆分。 +22. 0.4.1 全量回归和 0.5.0 新增 gate。 +23. README、06、09 和 11 号文档同步。 + +## 15. 验收标准 + +0.5.0 应满足以下验收标准: + +1. 软件版本为 `0.5.0`。 +2. 0.4.1 release gate 继续通过。 +3. Solid material 和 Solid section 可从 `.inp` 明确识别。 +4. 密度、弹性参数、Johnson-Cook 参数和失效参数校验路径清晰。 +5. Solid 状态可分配、初始化、清理和重复 build。 +6. 弹性材料点测试通过。 +7. Johnson-Cook 流动应力测试覆盖硬化、应变率项和热项退化。 +8. Johnson-Cook 损伤单调累积,并在达到阈值后触发失效状态。 +9. 渐进软化单调、不可逆,且不删除粒子。 +10. Solid-only 小模型可执行 Velocity-Verlet 显式推进。 +11. Solid 结构波速 dt 约束为有限正值,并可进入全局 dt 估计。 +12. Solid summary、CSV output、Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 字段可用。 +13. `STATE_0_5` restart 可恢复 Solid 状态并继续显式步。 +14. `STATE_0_4_1` restart 可兼容读入,并初始化空 Solid 状态。 +15. 默认 gate、0.5.0 Solid 专项 gate、source size 和 `git diff --check` 通过。 +16. 文档不宣称 0.5.0 已实现 Shell、真实水-气-结构爆炸响应、真实 FEM-SPH 耦合或工程级结构破坏 benchmark。 +17. 不新增 FEMLite 直接依赖。 +18. 不修改 SPHLite 文件夹之外的内容。 + +## 16. 风险与控制 + +| 风险 | 表现 | 控制方式 | +| --- | --- | --- | +| 0.5.0 范围膨胀 | 试图同时实现 Shell、水-气-结构工程爆炸或 FEM-SPH 耦合 | 限定为 Solid 最小闭环和 Solid-only gate | +| Johnson-Cook 参数语义不稳 | 输入字段顺序、单位或温度项解释不清 | 使用明确输入样例和材料点测试锁定语义 | +| TL-SPH 内力实现过大 | 一次性实现完整结构算法导致 source size 和测试风险 | 先材料点、梯度状态和小型 smoke,逐步扩大 | +| 失效处理破坏质量守恒 | 删除粒子或改变粒子质量导致诊断跳变 | 失效不删除粒子,仅 phase/status 和 softening 改变 | +| Solid 更新影响既有算例 | 无 Solid 输入时仍进入 Solid 路径 | 无 active Solid 时直接跳过,并保持 0.4.1 全量回归 | +| API 兼容破坏 | 修改已有 summary 字段或数组约定 | 新增 Solid API,不改变 0.4.1 接口含义 | +| restart 不完整 | 读回后应力、塑性、损伤或 softening 丢失 | `STATE_0_5` 保存完整 Solid 模块级状态 | +| source size 债务扩大 | Solid 本构、状态和 restart 堆入单个大文件 | 按 state/material/reaction 或 state/material/solid/restart/helper 拆分 | + +## 17. 0.6.0 启动条件 + +满足以下条件后,可以启动 0.6.0 `Shell`: + +1. 0.5.0 Solid material、Johnson-Cook 和失效材料点 gate 稳定。 +2. Solid 状态、output、restart、API、CLI 和 Python 诊断稳定。 +3. Solid-only 显式 smoke 可重复通过。 +4. 0.4.1 Water/Gas/Explosive gate 仍可重复通过。 +5. 0.5.0 文档明确尚未实现 Shell、真实 FEM-SPH 耦合和工程级水下爆炸结构破坏 benchmark。 diff --git a/src/core/sph_precision.f90 b/src/core/sph_precision.f90 index 7e9f148..328b807 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 = 4 - integer, parameter :: SPH_VERSION_PATCH = 1 + integer, parameter :: SPH_VERSION_MINOR = 5 + 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/solid_bad_johnson_cook_050.inp b/tests/data/solid_bad_johnson_cook_050.inp new file mode 100644 index 0000000..24f1551 --- /dev/null +++ b/tests/data/solid_bad_johnson_cook_050.inp @@ -0,0 +1,16 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=SOLID_PARTICLES +1 +*MATERIAL, NAME=STEEL_BAD_JC, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*PLASTIC, HARDENING=JOHNSON COOK +-792.0E6, 510.0E6, 0.26, 0.014, 1.03, 1.0, 293.0, 1793.0 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_BAD_JC +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/solid_bad_section_050.inp b/tests/data/solid_bad_section_050.inp new file mode 100644 index 0000000..c005326 --- /dev/null +++ b/tests/data/solid_bad_section_050.inp @@ -0,0 +1,14 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=SOLID_PARTICLES +1 +*MATERIAL, NAME=STEEL_BAD_SECTION, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SOLID SECTION, ELSET=MISSING_SOLID_SET, MATERIAL=STEEL_BAD_SECTION +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/solid_body_force_050.inp b/tests/data/solid_body_force_050.inp new file mode 100644 index 0000000..0cf381b --- /dev/null +++ b/tests/data/solid_body_force_050.inp @@ -0,0 +1,17 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +*ELSET, ELSET=SOLID_PARTICLES +1, 2 +*MATERIAL, NAME=STEEL_FORCE, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_FORCE +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE BODY FORCE, X=0.0, Y=0.0, Z=-9.81 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/solid_elastic_minimal_050.inp b/tests/data/solid_elastic_minimal_050.inp new file mode 100644 index 0000000..d1e60d1 --- /dev/null +++ b/tests/data/solid_elastic_minimal_050.inp @@ -0,0 +1,20 @@ +*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=SOLID_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=STEEL, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=2.0E-7, STEPS=2, SAFETY=0.5 diff --git a/tests/data/solid_explicit_smoke_050.inp b/tests/data/solid_explicit_smoke_050.inp new file mode 100644 index 0000000..5552807 --- /dev/null +++ b/tests/data/solid_explicit_smoke_050.inp @@ -0,0 +1,26 @@ +*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=SOLID_BAR +1, 2, 3, 4 +*MATERIAL, NAME=STEEL_SMOKE, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*PLASTIC, HARDENING=JOHNSON COOK +792.0E6, 510.0E6, 0.26, 0.014, 1.03, 1.0, 293.0, 1793.0 +*DAMAGE INITIATION, CRITERION=JOHNSON COOK +0.05, 3.44, -2.12, 0.002, 0.61 +*SPHLITE SOLID CONTROL, MATERIAL=STEEL_SMOKE, SOFTENING=LINEAR, WIDTH=0.25 +*SOLID SECTION, ELSET=SOLID_BAR, MATERIAL=STEEL_SMOKE +*SPHLITE INITIAL VELOCITY, SET=SOLID_BAR, VX=1.0, VY=0.0, VZ=0.0 +*SPHLITE PARTICLE CONTROL, H=0.12, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=3.0E-7, STEPS=3, SAFETY=0.5 diff --git a/tests/data/solid_johnson_cook_050.inp b/tests/data/solid_johnson_cook_050.inp new file mode 100644 index 0000000..e42d6e7 --- /dev/null +++ b/tests/data/solid_johnson_cook_050.inp @@ -0,0 +1,22 @@ +*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=SOLID_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=STEEL_JC, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*PLASTIC, HARDENING=JOHNSON COOK +792.0E6, 510.0E6, 0.26, 0.014, 1.03, 1.0, 293.0, 1793.0 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_JC +*SPHLITE PARTICLE CONTROL, H=0.12, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=2.0E-7, STEPS=2, SAFETY=0.5 diff --git a/tests/data/solid_johnson_cook_failure_050.inp b/tests/data/solid_johnson_cook_failure_050.inp new file mode 100644 index 0000000..c85b210 --- /dev/null +++ b/tests/data/solid_johnson_cook_failure_050.inp @@ -0,0 +1,25 @@ +*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=SOLID_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=STEEL_DAMAGE, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*PLASTIC, HARDENING=JOHNSON COOK +792.0E6, 510.0E6, 0.26, 0.014, 1.03, 1.0, 293.0, 1793.0 +*DAMAGE INITIATION, CRITERION=JOHNSON COOK +0.05, 3.44, -2.12, 0.002, 0.61 +*SPHLITE SOLID CONTROL, MATERIAL=STEEL_DAMAGE, SOFTENING=LINEAR, WIDTH=0.25 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_DAMAGE +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=2.0E-7, STEPS=2, SAFETY=0.5 diff --git a/tests/data/solid_missing_density_050.inp b/tests/data/solid_missing_density_050.inp new file mode 100644 index 0000000..c61e88c --- /dev/null +++ b/tests/data/solid_missing_density_050.inp @@ -0,0 +1,12 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=SOLID_PARTICLES +1 +*MATERIAL, NAME=STEEL_NO_DENSITY, TYPE=SOLID +*ELASTIC +210.0E9, 0.30 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_NO_DENSITY +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/solid_missing_elastic_050.inp b/tests/data/solid_missing_elastic_050.inp new file mode 100644 index 0000000..569076f --- /dev/null +++ b/tests/data/solid_missing_elastic_050.inp @@ -0,0 +1,12 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=SOLID_PARTICLES +1 +*MATERIAL, NAME=STEEL_NO_ELASTIC, TYPE=SOLID +*DENSITY +7850.0 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_NO_ELASTIC +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/solid_restart_041_compat_050.inp b/tests/data/solid_restart_041_compat_050.inp new file mode 100644 index 0000000..6590580 --- /dev/null +++ b/tests/data/solid_restart_041_compat_050.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/solid_restart_050.inp b/tests/data/solid_restart_050.inp new file mode 100644 index 0000000..0466ebf --- /dev/null +++ b/tests/data/solid_restart_050.inp @@ -0,0 +1,25 @@ +*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=SOLID_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=STEEL_RESTART, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*PLASTIC, HARDENING=JOHNSON COOK +792.0E6, 510.0E6, 0.26, 0.014, 1.03, 1.0, 293.0, 1793.0 +*DAMAGE INITIATION, CRITERION=JOHNSON COOK +0.05, 3.44, -2.12, 0.002, 0.61 +*SPHLITE SOLID CONTROL, MATERIAL=STEEL_RESTART, SOFTENING=LINEAR, WIDTH=0.25 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_RESTART +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=2.0E-7, STEPS=2, SAFETY=0.5 diff --git a/tests/data/solid_section_050.inp b/tests/data/solid_section_050.inp new file mode 100644 index 0000000..bfb840b --- /dev/null +++ b/tests/data/solid_section_050.inp @@ -0,0 +1,32 @@ +*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.2, 0.0, 0.0 +6, 0.2, 0.1, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +5, 5 +6, 6 +*ELSET, ELSET=SOLID_A +1, 2, 3 +*ELSET, ELSET=SOLID_B +4, 5, 6 +*MATERIAL, NAME=STEEL_A, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*MATERIAL, NAME=ALLOY_B, TYPE=SOLID +*DENSITY +2700.0 +*ELASTIC +70.0E9, 0.33 +*SOLID SECTION, ELSET=SOLID_A, MATERIAL=STEEL_A +*SOLID SECTION, ELSET=SOLID_B, MATERIAL=ALLOY_B +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=1.0, VOLUME=0.001 +*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 09ea140..c59402c 100644 --- a/tests/interface/test_c_api.c +++ b/tests/interface/test_c_api.c @@ -157,7 +157,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 != 1) return fail("unexpected version"); + if (major != 0 || minor != 5 || 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 9c21ca4..002b7b5 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 != 1) { + if (version.major != 0 || version.minor != 5 || version.patch != 0) { return 1; } diff --git a/tests/unit/test_smoke.f90 b/tests/unit/test_smoke.f90 index 3fb48e1..310ec1a 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 /= 1) call fail('unexpected version') + if (major /= 0 .or. minor /= 5 .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 47618b7..78fc1e0 100644 --- a/todo.md +++ b/todo.md @@ -1,147 +1,224 @@ # SPHLite TODO -当前目标版本:0.4.1 +当前目标版本:0.5.0 -本文档依据 `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 兼容。 +本文档依据 `docs/v5.0_development_plan.md` 拆分。0.5.0 定位为 `Solid` 版本线的起步版本,目标是在 0.4.1 已完成 `Water`、`Gas`、`Explosive` 稳定闭环的基础上,建立 3D 实体结构 SPH 粒子的输入、状态、本构、失效、显式推进、restart、接口和测试 gate。 -所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.4.1 不实现 Solid、Shell、真实 FEM-SPH 耦合、工程级水下爆炸 benchmark、完整化学反应爆轰模型或球面经验载荷主模型。 +所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.5.0 不实现 `Shell`、真实水-气-结构工程爆炸响应、真实 FEM-SPH 耦合、复杂断裂面追踪、碎片云、焊缝失效库、大规模并行或 GPU 后端。 执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端。 ## 阶段 A:版本基线、范围声明与输入样例 -- [x] 确认当前 git 状态并记录 0.4.1 开发起点。 -- [x] 确认 `v0.4.0` 标签和发布提交可作为 0.4.1 开发基线。 -- [x] 将核心软件版本更新为 `0.4.1`。 -- [x] 将 CMake 项目版本更新为 `0.4.1`。 +- [x] 确认当前 git 状态并记录 0.5.0 开发起点。 +- [x] 确认 `v0.4.1` 标签和发布提交可作为 0.5.0 开发基线。 +- [x] 将核心软件版本更新为 `0.5.0`。 +- [x] 将 CMake 项目版本更新为 `0.5.0`。 - [x] 更新 Fortran smoke 测试中的版本期望。 - [x] 更新 C API 测试中的版本期望。 - [x] 更新 C++ API 测试中的版本期望。 - [x] 更新 Python debug 测试中的版本期望。 - [x] 更新 CLI `--version` 和 inspect 版本期望。 -- [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] 创建缺少匹配点火记录的错误输入样例。 +- [x] 在 README 中记录 0.5.0 `Solid` 起步版本定位。 +- [x] 创建最小 Solid 弹性材料输入样例。 +- [x] 创建 Johnson-Cook Solid material 输入样例。 +- [x] 创建 Johnson-Cook failure 输入样例。 +- [x] 创建 Solid section 输入样例。 +- [x] 创建 Solid-only 显式推进 smoke 输入样例。 +- [x] 创建 Solid 初始速度或体力驱动输入样例。 +- [x] 创建 Solid restart 0.5.0 测试输入样例。 +- [x] 创建 `STATE_0_4_1` restart 兼容测试所需输入或夹具。 +- [x] 创建缺失密度的 Solid 错误输入样例。 +- [x] 创建缺失弹性参数的 Solid 错误输入样例。 +- [x] 创建非法 Johnson-Cook 参数错误输入样例。 +- [x] 创建非法 Solid section 错误输入样例。 -## 阶段 B:多点点火、多材料输入与校验 +## 阶段 B:Solid 输入解析、material 表与 section 识别 -- [x] 复核 0.4.0 点火记录存储结构是否支持同一 material 多条记录。 -- [x] 加固点火记录清理过程,确保重复初始化不会残留旧记录。 -- [x] 加固点火记录 material 匹配逻辑。 -- [x] 加固点火记录输入顺序无关逻辑。 -- [x] 实现多点点火到达时间取最小值的显式测试路径。 -- [x] 对缺少匹配点火记录的 explosive 粒子报 error。 -- [x] 对点火时间为负值的输入保持 error。 -- [x] 对点火坐标非法或缺失的输入保持 error。 -- [x] 复核 Explosive material 注册过程支持多个炸药材料。 -- [x] 复核 Explosive control 表支持每个 material 独立参数。 -- [x] 复核 product Gas material 映射支持多个目标材料。 -- [x] 校验不同 Explosive material 可使用不同爆速。 -- [x] 校验不同 Explosive material 可使用不同单位质量能量。 -- [x] 校验不同 Explosive material 可使用不同 burn time。 -- [x] 校验不同 Explosive material 可使用不同 conversion mode。 -- [x] 校验不同 Explosive material 可映射到相同 product Gas。 -- [x] 校验不同 Explosive material 可映射到不同 product Gas。 -- [x] 对 product Gas material 缺失 EOS 的多材料输入报 error。 -- [x] 对无 active 粒子的 Explosive material 继续报 warning 而不阻止运行。 -- [x] 新增多点点火和多材料输入模块测试并接入 CTest。 +- [ ] 复核现有 material 类型枚举是否包含 `Solid`。 +- [ ] 复核 phase 常量是否包含 `PHASE_SOLID` 和 `PHASE_SOLID_FAILED`。 +- [ ] 复核 C 头文件和 Python 常量中的 Solid phase/status 命名。 +- [ ] 新增或加固 `TYPE=SOLID` material 识别。 +- [ ] 支持 Solid material 的 `*DENSITY` 读取。 +- [ ] 支持 Solid material 的 `*ELASTIC` 读取。 +- [ ] 支持 Johnson-Cook flow 参数读取。 +- [ ] 支持 Johnson-Cook failure 参数读取。 +- [ ] 支持 Solid control 中的 softening 类型读取。 +- [ ] 支持 Solid control 中的 softening 参数读取。 +- [ ] 支持 `*SOLID SECTION` 或既有等价 section 关键词。 +- [ ] 将 Solid section 与 material 映射到内部 section/material id。 +- [ ] 确认 set 仍只表示集合,不参与 Solid 类型判断。 +- [ ] 对缺失密度的 Solid material 报 error。 +- [ ] 对缺失弹性参数的 Solid material 报 error。 +- [ ] 对非法弹性参数报 error。 +- [ ] 对非法 Johnson-Cook flow 参数报 error。 +- [ ] 对非法 Johnson-Cook failure 参数报 error。 +- [ ] 对非法 Solid section 或缺失 material 的 section 报 error。 +- [ ] 对无 active Solid 粒子的 Solid material 报 warning 而不阻止其他路径运行。 +- [ ] 新增 `input_solid_material` 测试并接入 CTest。 +- [ ] 新增 `input_solid_errors` 测试并接入 CTest。 -## 阶段 C:反应质量基准与释放量一致性 +## 阶段 C:Solid 状态、生命周期与数据库集成 -- [x] 新增每粒子 Explosive 反应质量基准状态。 -- [x] 在 Explosive 状态分配过程中分配反应质量基准数组。 -- [x] 在 Explosive 状态清理过程中清零反应质量基准数组。 -- [x] 在模型构建阶段从当前粒子质量冻结反应质量基准。 -- [x] 确认无 Explosive 输入时反应质量基准不影响 Water/Gas 算例。 -- [x] 将 SOURCE 路径释放质量改为使用冻结反应质量基准。 -- [x] 将 PHASE 路径释放质量改为使用冻结反应质量基准。 -- [x] 保持 `delta_lambda` 作为唯一释放增量来源。 -- [x] 保持 `lambda` 单调不可逆并限制在 `[0,1]`。 -- [x] 保持 `burn_time = 0` 的瞬时反应行为。 -- [x] 保持 `burn_time > 0` 的线性反应窗口行为。 -- [x] 计算每粒子剩余可反应质量。 -- [x] 计算全局 Explosive 初始反应质量。 -- [x] 计算全局 Explosive 累计释放质量。 -- [x] 计算全局 Explosive 剩余可反应质量。 -- [x] 计算释放质量闭合误差诊断。 -- [x] 计算释放能量闭合误差诊断。 -- [x] 计算三向释放动量合计诊断。 -- [x] 新增初始质量释放一致性测试并接入 CTest。 -- [x] 新增 release balance 模块测试并接入 CTest。 +- [ ] 新增 Solid material 表的模块级存储。 +- [ ] 存储 Solid 密度、弹性模量和泊松比。 +- [ ] 派生并存储剪切模量、体积模量和结构波速。 +- [ ] 存储 Johnson-Cook `A`、`B`、`n`、`C`、`m` 参数。 +- [ ] 存储 Johnson-Cook 参考应变率、室温和熔化温度。 +- [ ] 存储温升或等效塑性功转温升参数。 +- [ ] 存储 Johnson-Cook failure `D1` 到 `D5` 参数。 +- [ ] 存储 softening 类型和 softening 参数。 +- [ ] 新增 Solid 状态 reset 过程。 +- [ ] 新增 Solid 状态 allocate/build 过程。 +- [ ] 新增 Solid 状态 clear/finalize 过程。 +- [ ] 分配 `solid_stress(6,npart)` 状态。 +- [ ] 分配 `solid_strain(6,npart)` 状态。 +- [ ] 分配 `solid_plastic_strain(npart)` 状态。 +- [ ] 分配 `solid_plastic_strain_rate(npart)` 状态。 +- [ ] 分配 `solid_temperature(npart)` 状态。 +- [ ] 分配 `solid_damage(npart)` 状态。 +- [ ] 分配 `solid_softening(npart)` 状态。 +- [ ] 分配 `solid_internal_energy(npart)` 状态。 +- [ ] 分配 Solid 变形梯度或等价状态。 +- [ ] 分配 Solid 梯度修正矩阵或等价占位状态。 +- [ ] 分配 `solid_failure_status(npart)` 状态。 +- [ ] 初始化 active Solid 粒子的 Solid 状态默认值。 +- [ ] 初始化非 Solid 粒子的 Solid 状态为安全默认值。 +- [ ] 新增 `solid_state_build` 测试并接入 CTest。 -## 阶段 D:SOURCE、PHASE、混合链路与输出 +## 阶段 D:弹性、Johnson-Cook 本构与失效材料点 -- [x] 加固 SOURCE 路径 product Gas target 计数逻辑。 -- [x] 确保 SOURCE 路径只选择匹配 product material 的 active Gas 粒子。 -- [x] 确保 SOURCE 路径存在多个 Gas material 时不会跨 material 注入。 -- [x] 对 SOURCE 路径无 active product Gas target 的输入保持 error。 -- [x] 统计 SOURCE 路径参与接收的 Gas 粒子数。 -- [x] 统计 SOURCE 路径注入的质量总量。 -- [x] 统计 SOURCE 路径注入的能量总量。 -- [x] 统计 SOURCE 路径注入的三向动量总量。 -- [x] 加固 SOURCE 源项应用后的 Gas summary 刷新。 -- [x] 加固 PHASE 转化后的 `particle_phase` 和 `material_id` 更新。 -- [x] 加固 PHASE 转化后的 `rho`、`volume` 和 `internal_energy` 更新。 -- [x] 加固 PHASE 转化后的 Gas pressure 刷新。 -- [x] 加固 PHASE 转化后的 Gas summary 刷新。 -- [x] 保持已转化 Gas 粒子的 Explosive 历史状态可追踪。 -- [x] 新增 Water/Gas/Explosive 混合 smoke 显式推进测试。 -- [x] 新增 SOURCE target material 测试并接入 CTest。 -- [x] 新增 PHASE 状态刷新测试并接入 CTest。 -- [x] 在 summary CSV 中追加 release balance 字段。 -- [x] 在粒子 CSV 中追加 Explosive 反应质量和剩余质量字段。 -- [x] 更新 output 测试以锁定 0.4.1 CSV header 和 summary 字段。 +- [ ] 新增 Solid 弹性常数计算 helper。 +- [ ] 新增 Voigt 应力应变工具函数。 +- [ ] 新增 von Mises 等效应力计算。 +- [ ] 新增等效塑性应变率安全计算。 +- [ ] 实现弹性材料点试应力更新。 +- [ ] 实现弹性材料点内能更新。 +- [ ] 新增弹性区材料点单测。 +- [ ] 实现 Johnson-Cook 热软化温度归一化。 +- [ ] 实现 Johnson-Cook 应变率项计算。 +- [ ] 实现 Johnson-Cook 硬化项计算。 +- [ ] 实现 Johnson-Cook 流动应力计算。 +- [ ] 对非正参考应变率或非法温度参数报 error。 +- [ ] 实现塑性屈服判断。 +- [ ] 实现简化显式返回映射或等价塑性修正。 +- [ ] 更新等效塑性应变和等效塑性应变率。 +- [ ] 更新塑性功和等效温升状态。 +- [ ] 新增 Johnson-Cook flow 单测。 +- [ ] 实现 Johnson-Cook failure 应变计算。 +- [ ] 实现 Johnson-Cook damage 单调累积。 +- [ ] 对非法 failure 应变进行受控 error 或保护。 +- [ ] 实现 damage 达到阈值后的失效状态切换。 +- [ ] 实现线性渐进软化因子更新。 +- [ ] 限制 damage 和 softening 在合法范围。 +- [ ] 确认失效后不删除粒子、不改变质量。 +- [ ] 新增 `solid_elastic_material` 测试并接入 CTest。 +- [ ] 新增 `solid_johnson_cook_flow` 测试并接入 CTest。 +- [ ] 新增 `solid_johnson_cook_failure` 测试并接入 CTest。 +- [ ] 新增 `solid_progressive_softening` 测试并接入 CTest。 -## 阶段 E:Restart、API、C++、Python 与 CLI +## 阶段 E:Solid SPH 结构状态、显式推进与稳定时间步 -- [x] 将 restart 状态版本更新为 `STATE_0_4_1`。 -- [x] 将 Explosive 反应质量基准写入 0.4.1 restart。 -- [x] 将 release balance 相关状态写入 0.4.1 restart。 -- [x] 将 SOURCE/PHASE 诊断计数写入 0.4.1 restart。 -- [x] 从 0.4.1 restart 读回反应质量基准。 -- [x] 从 0.4.1 restart 读回 release balance 相关状态。 -- [x] 从 0.4.0 restart 读回时初始化新增 0.4.1 状态。 -- [x] 从 0.3.1 restart 读回时保持空 Explosive 状态。 -- [x] 新增 restart 后继续推进不重复释放测试。 -- [x] 新增 `sph_get_explosive_release_balance` Fortran API。 -- [x] 新增 `sphlite_get_explosive_release_balance` C ABI。 -- [x] 在 C ABI 中补齐新增接口的空指针错误路径。 -- [x] 在 C API 测试中覆盖 release balance 查询。 -- [x] 在 C++ wrapper 中增加 release balance 薄包装。 -- [x] 在 C++ API 测试中覆盖 release balance 薄包装。 -- [x] 在 Python ctypes 中增加 release balance 薄包装。 -- [x] 在 Python checker 中覆盖多点点火和 release balance。 -- [x] 在 CLI inspect/run 中追加 release balance 字段。 -- [x] 在 CLI checker 中覆盖多点点火、多材料和 release balance 字段。 -- [x] 新增 0.4.1 restart/API/CLI/Python 专项 CTest 条目。 +- [ ] 建立 Solid active 粒子计数逻辑。 +- [ ] 建立 Solid failed 粒子计数逻辑。 +- [ ] 构建 Solid 参考构型邻域或参考邻域占位。 +- [ ] 构建 Solid 参考体积或参考权重状态。 +- [ ] 构建 Solid 梯度修正矩阵计算或稳定占位。 +- [ ] 对退化梯度修正矩阵给出受控 warning 或 error。 +- [ ] 新增 `solid_gradient_correction` 测试并接入 CTest。 +- [ ] 将 Solid 更新挂接到显式求解器流程。 +- [ ] 确保无 active Solid 粒子时跳过 Solid 更新。 +- [ ] 实现 Solid 速度梯度或应变率计算入口。 +- [ ] 实现 Solid 本构更新入口。 +- [ ] 实现 Solid 内力或等价加速度贡献的最小路径。 +- [ ] 实现 Solid 体力贡献路径。 +- [ ] 确保 Solid 加速度贡献不污染 Water/Gas/Explosive-only 算例。 +- [ ] 实现 Solid 动能诊断。 +- [ ] 实现 Solid 内能诊断。 +- [ ] 实现 Solid 总动量诊断。 +- [ ] 实现 Solid 最大 von Mises 应力诊断。 +- [ ] 实现 Solid 塑性应变范围诊断。 +- [ ] 实现 Solid damage 和 softening 范围诊断。 +- [ ] 实现 Solid 结构波速稳定时间步估计。 +- [ ] 将 Solid dt 约束纳入全局 dt 估计。 +- [ ] 确认无 Solid 粒子时全局 dt 与 0.4.1 路径一致。 +- [ ] 新增 `solid_stable_dt` 测试并接入 CTest。 +- [ ] 新增 `solid_explicit_smoke` 测试并接入 CTest。 -## 阶段 F:回归、门禁、文档同步与发布准备 +## 阶段 F:输出、restart 与模块级持久化 -- [x] 新增 `input_explosive_multi_ignition` 测试并接入 CTest。 -- [x] 新增 `input_explosive_multimaterial` 测试并接入 CTest。 -- [x] 新增 `explosive_initial_mass_release` 测试并接入 CTest。 -- [x] 新增 `explosive_release_balance` 测试并接入 CTest。 -- [x] 新增 `explosive_source_targeting` 测试并接入 CTest。 -- [x] 新增 `explosive_phase_refresh` 测试并接入 CTest。 -- [x] 新增 `explosive_restart_041` 测试并接入 CTest。 -- [x] 新增 `explosive_restart_040_compat` 测试并接入 CTest。 -- [x] 新增 `explosive_restart_no_double_release` 测试并接入 CTest。 -- [x] 新增 `explosive_water_gas_smoke` 测试并接入 CTest。 -- [x] 新增 `explosive_release_c_api` 测试并接入 CTest。 -- [x] 新增 `explosive_release_python` 测试并接入 CTest。 -- [x] 新增 `explosive_release_cli` 测试并接入 CTest。 -- [x] 新增 `explosive_041_source_size` 检查项并接入 CTest。 -- [x] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。 -- [x] 保持 0.4.0 完整 gate 全部通过。 -- [x] 单独运行 0.4.1 新增 Explosive gate。 -- [x] 运行 `source_size` 检查并确认无新增无理由例外。 -- [x] 运行 `git diff --check` 并清理空白问题。 -- [x] 更新 README、06、09 和 11 号文档的 0.4.1 测试和验收记录。 +- [ ] 在 summary CSV 中追加 Solid active/failed 粒子数字段。 +- [ ] 在 summary CSV 中追加 Solid 质量和动量字段。 +- [ ] 在 summary CSV 中追加 Solid 动能和内能字段。 +- [ ] 在 summary CSV 中追加 Solid 最大 von Mises 应力字段。 +- [ ] 在 summary CSV 中追加 Solid 塑性应变范围字段。 +- [ ] 在 summary CSV 中追加 Solid damage 范围字段。 +- [ ] 在 summary CSV 中追加 Solid softening 和 dt 字段。 +- [ ] 在粒子 CSV 中追加 Solid stress 关键字段。 +- [ ] 在粒子 CSV 中追加 Solid plastic strain 字段。 +- [ ] 在粒子 CSV 中追加 Solid damage 字段。 +- [ ] 在粒子 CSV 中追加 Solid softening 字段。 +- [ ] 在粒子 CSV 中追加 Solid failure status 字段。 +- [ ] 更新 output 测试以锁定 0.5.0 CSV header。 +- [ ] 新增 `solid_output` 测试并接入 CTest。 +- [ ] 将 restart 状态版本更新为 `STATE_0_5`。 +- [ ] 将 Solid material 表写入 0.5.0 restart。 +- [ ] 将 Solid per-particle 状态写入 0.5.0 restart。 +- [ ] 将 Solid summary 和 dt 诊断写入或可恢复于 0.5.0 restart。 +- [ ] 从 0.5.0 restart 读回 Solid material 表。 +- [ ] 从 0.5.0 restart 读回 Solid per-particle 状态。 +- [ ] 从 0.5.0 restart 读回后继续显式步。 +- [ ] 从 `STATE_0_4_1` restart 读回时初始化空 Solid 状态。 +- [ ] 从 `STATE_0_4` restart 读回时初始化空 Solid 状态。 +- [ ] 从 `STATE_0_3_1` 或更早兼容状态读回时初始化空 Solid 状态。 +- [ ] 确认 restart 后不会重复初始化 Solid 应力、塑性应变、damage 或 softening。 +- [ ] 新增 `solid_restart_050` 测试并接入 CTest。 +- [ ] 新增 `solid_restart_041_compat` 测试并接入 CTest。 + +## 阶段 G:Fortran API、C ABI、C++、Python 与 CLI + +- [ ] 新增 `sph_get_solid_summary` Fortran API。 +- [ ] 新增 Solid failure counts Fortran API。 +- [ ] 新增 Solid material summary Fortran API 或确认暂不对外暴露。 +- [ ] 为 Solid Fortran API 补齐未初始化错误路径。 +- [ ] 新增 `sphlite_get_solid_summary` C ABI。 +- [ ] 为 Solid C ABI 补齐空指针错误路径。 +- [ ] 为 Solid C ABI 补齐小容量或非法参数错误路径。 +- [ ] 在 C API 测试中覆盖 Solid summary 查询。 +- [ ] 在 C API 测试中覆盖 Solid API 错误路径。 +- [ ] 在 C++ wrapper 中增加 Solid summary 薄包装。 +- [ ] 在 C++ API 测试中覆盖 Solid summary 薄包装。 +- [ ] 在 Python ctypes 中增加 Solid summary 薄包装。 +- [ ] 在 Python inspect 中追加 Solid 字段。 +- [ ] 在 Python run/checker 中覆盖 Solid-only smoke。 +- [ ] 在 Python checker 中覆盖 Solid restart 读回 summary。 +- [ ] 在 CLI inspect 中追加 Solid 字段。 +- [ ] 在 CLI run 中追加 Solid 字段。 +- [ ] 在 CLI checker 中覆盖 Solid 输入、run 和 restart。 +- [ ] 确认新增 API 不改变 0.4.1 既有接口语义。 +- [ ] 新增 `solid_c_api` 测试并接入 CTest。 +- [ ] 新增 `solid_python` 测试并接入 CTest。 +- [ ] 新增 `solid_cli` 测试并接入 CTest。 + +## 阶段 H:回归、门禁、文档同步与发布准备 + +- [ ] 新增 `solid_source_size` 检查项并接入 CTest。 +- [ ] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。 +- [ ] 拆分过大的 Solid 源文件或过长过程。 +- [ ] 保持 0.4.1 完整 gate 全部通过。 +- [ ] 单独运行 0.5.0 新增 Solid gate。 +- [ ] 运行 `source_size` 检查并确认无新增无理由例外。 +- [ ] 运行 `git diff --check` 并清理空白问题。 +- [ ] 更新 README 的 0.5.0 当前状态和不交付范围。 +- [ ] 更新 06 号文档的 0.5.0 release gate。 +- [ ] 更新 09 号文档的 0.5.0 验收记录占位。 +- [ ] 更新 11 号文档的 0.5.0 benchmark/gate 矩阵。 +- [ ] 确认文档不宣称已实现 `Shell`。 +- [ ] 确认文档不宣称已实现真实水-气-结构工程爆炸响应。 +- [ ] 确认文档不宣称已实现真实 FEM-SPH 耦合。 +- [ ] 确认文档不宣称已实现工程级结构破坏 benchmark。 +- [ ] 确认未新增 FEMLite 直接依赖。 +- [ ] 确认未修改 SPHLite 文件夹之外的内容。 +- [ ] 确认默认 gate、Solid 专项 gate、source size 和 `git diff --check` 全部通过。 +- [ ] 汇总 0.5.0 已完成能力、未交付范围和已知限制。 +- [ ] 准备 0.5.0 发布前本地提交记录。 diff --git a/tools/testing/test_cli.py b/tools/testing/test_cli.py index 285ae56..b90f10a 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.1" not in version.stdout: + if "0.5.0" not in version.stdout: raise AssertionError("CLI version mismatch") inspect = run_command([exe, model]) @@ -103,7 +103,7 @@ def main() -> int: ): require_field(inspect.stdout, field) inspect_fields = read_fields(inspect.stdout) - if inspect_fields["version"] != "0.4.1": + if inspect_fields["version"] != "0.5.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 585df63..a6032e9 100644 --- a/tools/testing/test_python_debug.py +++ b/tools/testing/test_python_debug.py @@ -37,7 +37,7 @@ def main() -> int: raise AssertionError("Python wrapper is missing Explosive release C ABI") if not hasattr(solver.lib, "sphlite_set_ignition_point"): raise AssertionError("Python wrapper is missing Explosive ignition C ABI") - if solver.version() != (0, 4, 1): + if solver.version() != (0, 5, 0): raise AssertionError("Python version mismatch") solver.initialize()