From 7e24ea2697496a2937b3ad8cbd428583b59911d3 Mon Sep 17 00:00:00 2001 From: Codex Date: Fri, 3 Jul 2026 19:14:31 +0800 Subject: [PATCH] Start Shell 0.6.0 development baseline --- CMakeLists.txt | 2 +- README.md | 6 +- docs/v6.0_development_plan.md | 634 ++++++++++++++++++ src/core/sph_precision.f90 | 4 +- .../data/shell_bad_integration_points_060.inp | 14 + tests/data/shell_bad_thickness_060.inp | 14 + tests/data/shell_controlled_bending_060.inp | 22 + tests/data/shell_director_degenerate_060.inp | 19 + tests/data/shell_director_explicit_060.inp | 19 + tests/data/shell_elastic_material_060.inp | 20 + tests/data/shell_explicit_smoke_060.inp | 22 + tests/data/shell_internal_force_smoke_060.inp | 21 + tests/data/shell_johnson_cook_060.inp | 22 + tests/data/shell_johnson_cook_failure_060.inp | 25 + tests/data/shell_minimal_060.inp | 20 + tests/data/shell_missing_density_060.inp | 12 + tests/data/shell_missing_section_060.inp | 13 + .../data/shell_progressive_softening_060.inp | 21 + tests/data/shell_restart_051_compat_060.inp | 20 + tests/data/shell_restart_060.inp | 26 + tests/data/shell_rigid_translation_060.inp | 22 + tests/data/shell_section_3pt_060.inp | 18 + tests/data/shell_section_5pt_060.inp | 20 + tests/data/shell_section_non_shell_060.inp | 13 + tests/data/shell_transverse_shear_060.inp | 22 + tests/data/shell_uniaxial_membrane_060.inp | 22 + tests/interface/test_c_api.c | 2 +- tests/interface/test_cpp_api.cpp | 2 +- tests/unit/test_smoke.f90 | 2 +- todo.md | 616 ++++++++++------- tools/testing/test_cli.py | 4 +- tools/testing/test_python_debug.py | 2 +- 32 files changed, 1441 insertions(+), 260 deletions(-) create mode 100644 docs/v6.0_development_plan.md create mode 100644 tests/data/shell_bad_integration_points_060.inp create mode 100644 tests/data/shell_bad_thickness_060.inp create mode 100644 tests/data/shell_controlled_bending_060.inp create mode 100644 tests/data/shell_director_degenerate_060.inp create mode 100644 tests/data/shell_director_explicit_060.inp create mode 100644 tests/data/shell_elastic_material_060.inp create mode 100644 tests/data/shell_explicit_smoke_060.inp create mode 100644 tests/data/shell_internal_force_smoke_060.inp create mode 100644 tests/data/shell_johnson_cook_060.inp create mode 100644 tests/data/shell_johnson_cook_failure_060.inp create mode 100644 tests/data/shell_minimal_060.inp create mode 100644 tests/data/shell_missing_density_060.inp create mode 100644 tests/data/shell_missing_section_060.inp create mode 100644 tests/data/shell_progressive_softening_060.inp create mode 100644 tests/data/shell_restart_051_compat_060.inp create mode 100644 tests/data/shell_restart_060.inp create mode 100644 tests/data/shell_rigid_translation_060.inp create mode 100644 tests/data/shell_section_3pt_060.inp create mode 100644 tests/data/shell_section_5pt_060.inp create mode 100644 tests/data/shell_section_non_shell_060.inp create mode 100644 tests/data/shell_transverse_shear_060.inp create mode 100644 tests/data/shell_uniaxial_membrane_060.inp diff --git a/CMakeLists.txt b/CMakeLists.txt index 61b5f30..803637f 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,6 +1,6 @@ cmake_minimum_required(VERSION 3.20) -project(SPHLite VERSION 0.5.1 LANGUAGES C CXX Fortran) +project(SPHLite VERSION 0.6.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 d03e614..8a7aa13 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。 -当前开发版本:0.5.1。该版本定位为 `Solid` 3D 实体结构粒子稳定化和结构算法加固版本,在 0.5.0 已建立 Solid 最小闭环的基础上,补强参考构型、速度梯度、应变率、最小内力、能量诊断、restart 兼容和接口可观测性。不交付 `Shell` 的生产路径,也不交付真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行或工程级结构破坏 benchmark。 +当前开发版本:0.6.0。该版本定位为 `Shell` 板壳粒子最小闭环开发版本,在 0.5.1 已完成 `Solid` 3D 实体结构粒子稳定化和结构算法加固的基础上,建立 Shell material/section 输入、状态数组、Mindlin-Reissner 板壳运动学、厚度积分、材料点、显式推进、输出、restart、接口和测试 gate 的可验证路径。不交付真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行或工程级船舱破坏 benchmark。 代码仓库地址: @@ -63,7 +63,7 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: ## 当前状态 -0.5.1 当前已在 0.5.0 `Solid` 起步闭环基线之上完成 `Solid` 稳定化和结构算法加固。0.5.0 以来已完成内容主要包括: +0.6.0 当前以 0.5.1 `Solid` 稳定化发布基线为起点,进入 `Shell` 板壳粒子最小闭环开发。0.5.0 以来已完成内容主要包括: - CMake/CTest 工程骨架和 Fortran 95 核心库。 - C ABI、C++ 头文件薄包装和 Python `ctypes` 调试入口。 @@ -83,6 +83,6 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: - 0.5.1 兼容读入 `STATE_0_5` Solid restart,并在读入时初始化 0.5.1 新增状态。 - 0.5.1 为 source size 门禁拆分 Solid C ABI、Python Solid 调试包装和 Solid API 查询模块;`src/solid/sph_solid.f90` 作为 Solid 输入/material 表 owner 登记说明性例外。 - CouplingInterface 的中立数据导出、外部粒子力导入和诊断占位保持可用;真实 FEM-SPH 联合运行仍由外部 CouplingModule 后续实现。 -- `Shell` 仍为后续阶段,不在 0.5.1 交付生产计算路径。 +- `Shell` 在 0.6.0 进入开发闭环,目标是先完成小型可验证模型,不作为真实船舶水下爆炸生产计算路径。 - 0.5.0 本地 gate 已通过:完整 CTest 83/83,0.4.1 Explosive 回归 gate 14/14,0.5.0 Solid 专项 gate 17/17,`source_size` 1/1,`git diff --check` 通过。 - 0.5.1 本地 gate 已通过:完整 CTest 99/99,0.5.0 Solid 回归 gate 17/17,0.5.1 Solid 专项 gate 16/16,`source_size`/`solid_source_size`/`solid_051_source_size` 3/3,`git diff --check` 通过。 diff --git a/docs/v6.0_development_plan.md b/docs/v6.0_development_plan.md new file mode 100644 index 0000000..cf91106 --- /dev/null +++ b/docs/v6.0_development_plan.md @@ -0,0 +1,634 @@ +# SPHLite v6.0 开发计划 + +文档状态:0.6.0 开发计划草案 + +目标软件版本:SPHLite 0.6.0 + +## 1. 文档定位 + +本文档用于规划 SPHLite 0.6.0 版本的开发范围。0.6.0 是 `Shell` 板壳粒子版本线的起点,目标是在 0.5.1 已完成 `Solid` 3D 实体结构粒子稳定化和结构算法加固的基础上,建立 `Shell` 输入、状态、Mindlin-Reissner 板壳运动学、厚度积分、材料点更新、显式推进、输出、restart、接口和测试 gate 的最小闭环。 + +0.6.0 不作为真实水-气-结构工程爆炸响应版本,也不作为 FEM-SPH 耦合版本。0.6.0 的重点是让板壳粒子从占位进入可独立验证的小型结构动力学路径,为后续水-气-结构 smoke、板壳撕裂/穿孔加固和 `Shell`-FEMLite 壳连续体耦合提供稳定状态和接口基础。 + +## 2. 依据文件 + +本计划依据以下 01-06 号文档制定: + +- `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` + +同时,0.6.0 以已发布的 0.5.1 Solid 稳定化版本为开发基线。 + +## 3. 版本定位 + +### 3.1 与 0.5.1 的关系 + +0.5.1 已完成以下 Solid 稳定化能力: + +- Solid material/section 输入、Johnson-Cook flow/failure、damage、softening 和显式推进闭环。 +- Solid 参考邻域、修正矩阵、变形梯度、速度梯度、应变率和最小内力路径。 +- Solid 能量、动量、最大应变率、最大加速度、内力残差和参考质量诊断。 +- Solid CSV 输出、`STATE_0_5_1` restart、`STATE_0_5` 兼容读入和粒子级状态接口。 +- Fortran API、C ABI、C++ wrapper、Python ctypes、CLI 和 0.5.1 专项 CTest gate。 + +0.6.0 不重写 0.5.1 的 Solid 结构算法。0.6.0 应保持 0.5.1 完整 gate 稳定,并在此基础上建立 Shell 独立状态和计算路径。 + +### 3.2 与 0.7.0 的关系 + +0.7.0 建议作为水-气-结构局部爆炸 smoke 的起点。0.6.0 不实现真实水-气-结构耦合载荷闭环,不实现舱段破坏工程算例。0.6.0 只需要保证 Shell 的状态、输出、restart 和接口足够稳定,使 0.7.0 可以将 Water/Gas/Explosive 的载荷路径施加到 Solid/Shell 结构粒子上。 + +### 3.3 与耦合版本的关系 + +真实 FEM-SPH 接触耦合和连续体耦合仍属于后续 0.8/0.9。0.6.0 只维护 SPHLite 内部 `Shell` 粒子状态和中立 `CouplingInterface` 边界,不直接依赖 FEMLite,不修改 FEMLite,也不引入外部 CouplingModule 作为依赖。 + +### 3.4 0.6.0 核心目标 + +0.6.0 的核心目标是形成 `Shell` 板壳粒子小型结构动力学闭环: + +```text +0.5.1 Solid and common infrastructure baseline + -> Shell material and section input + -> Shell state arrays and thickness integration layout + -> director, angular velocity and shell kinematics + -> membrane, bending and transverse shear strain measures + -> through-thickness material point update + -> minimal shell internal force and moment diagnostics + -> Velocity-Verlet explicit smoke + -> STATE_0_6 restart and STATE_0_5_1 compatibility + -> Shell API, C ABI, C++ wrapper, Python ctypes and CLI fields +``` + +## 4. 开发原则 + +### 4.1 保持 0.6 版本线边界 + +0.6.0 只交付 `Shell` 板壳粒子的最小闭环,不进入真实水-气-结构爆炸响应、真实 FEM-SPH 耦合、工程级船舱破坏 benchmark、复杂撕裂面追踪或碎片云。 + +### 4.2 保持求解器定位 + +SPHLite 仍是求解器,不负责几何建模、网格生成或粒子生成。新增 `.inp` 样例和 Python checker 只能作为测试、示例或验收辅助工具,不作为求解器几何、网格或粒子生成功能宣传。 + +### 4.3 保持 Fortran 95 和集中型数据管理 + +核心实现继续使用 Fortran 95。Shell 新状态应纳入集中数据库或 Shell 模块级状态管理,不采用面向对象粒子类设计。C ABI、C++ wrapper、Python ctypes 和 CLI 继续作为薄接口层。 + +### 4.4 保持显式动力学主流程 + +时间推进继续只支持 Velocity-Verlet 显式动力学。0.6.0 可新增 Shell 平动、转动、内力、内力矩和稳定时间步约束,但不引入隐式求解、静力求解、非线性静力求解或隐式-显式混合接口。 + +### 4.5 小型可测优先 + +Shell 结构算法必须先通过小型、可重复测试验收。0.6.0 不追求复杂撕裂、穿孔、接触、焊缝失效或工程舱段破坏,只要求板壳状态、运动学、厚度积分、材料更新和显式推进链路可测。 + +### 4.6 Shell 与 Solid 分离 + +`Solid` 和 `Shell` 分别处理实体结构粒子和板壳结构粒子,不互相伪装。Shell 可以复用通用材料模型或数学辅助过程,但必须拥有独立的 section、状态数组、诊断字段、restart 块和 API 语义。 + +## 5. 0.6.0 交付目标 + +0.6.0 建议交付以下内容: + +1. 将软件版本更新为 `0.6.0`。 +2. 保持 0.5.1 默认 gate 全部通过。 +3. 建立 `Shell` material/section 输入识别和校验路径。 +4. 支持 `*SHELL SECTION` 或等价 Abaqus section 子集,识别厚度、积分点数量和材料映射。 +5. 支持 3 点和 5 点厚度积分,默认 3 点。 +6. 建立 Shell 状态数组,包括厚度、director、角速度、膜应变、弯曲应变、横向剪切应变、damage、softening 和失效状态。 +7. 建立 Shell 厚度积分点状态,包括积分点应力、应变、塑性应变、温度或等效温升、damage 和 softening。 +8. 初始化 active Shell 粒子的厚度、director、积分点权重和参考面积或等效面积。 +9. 实现 director 或法向的安全初始化和归一化检查。 +10. 实现 Shell 平动和转动运动学入口。 +11. 实现 Mindlin-Reissner 小变形膜应变、弯曲应变和横向剪切应变的受控计算路径。 +12. 实现厚度积分点材料更新入口,优先复用 Johnson-Cook 路线,允许弹性退化路径作为测试基础。 +13. 实现 Shell damage、softening 和 `PHASE_SHELL_FAILED` 不可逆状态切换。 +14. 实现最小 Shell 内力和内力矩贡献路径,至少支持小型对称或简化布置 smoke。 +15. 实现 Shell 动量、角动量或等价转动诊断、动能、内能、damage/softening 范围和最大应变诊断。 +16. 将 Shell 平动和转动稳定时间步纳入全局 dt 估计。 +17. 将 Shell 接入 Velocity-Verlet 显式推进,形成 Shell-only 小模型 smoke。 +18. 在 summary CSV 和粒子 CSV 中追加必要的 Shell 调试字段。 +19. 将 restart 状态版本更新为 `STATE_0_6`,保存 Shell 持久状态和诊断。 +20. 保持 `STATE_0_5_1` 和更早可支持 restart 兼容读入,并初始化空 Shell 状态。 +21. 新增 Shell summary、particle state 和 integration point state 的 Fortran API 和 C ABI。 +22. 在 C++ wrapper、Python ctypes 和 CLI 中追加 Shell 0.6.0 诊断字段。 +23. 新增 Shell 0.6.0 专项 CTest gate,并保持 source size 受控。 +24. 更新 README、06、09 和 11 号文档中的 0.6.0 测试、验收和不交付范围。 +25. 不新增 FEMLite 直接依赖,不修改 SPHLite 文件夹之外的内容。 + +## 6. 非交付范围 + +0.6.0 不交付以下内容: + +1. 不实现真实水-气-结构工程爆炸响应。 +2. 不实现爆炸载荷作用下的船舱破坏工程 benchmark。 +3. 不实现真实 FEM-SPH 接触耦合或连续体耦合。 +4. 不实现完整板壳撕裂路径追踪、裂纹扩展、穿孔判据库或碎片云。 +5. 不实现壳-实体连接、壳-实体过渡或局部壳/实体混合结构连接算法。 +6. 不实现复杂接触、碰撞、摩擦或碎片-流体相互作用。 +7. 不实现焊缝失效库、多层复合板壳或材料分层脱粘。 +8. 不实现热传导、熔化、相变或完整热-力耦合。 +9. 不实现大规模并行、GPU 后端或性能优化版本。 +10. 不新增几何、网格或粒子生成能力。 + +## 7. 输入和校验 + +### 7.1 Shell material 识别 + +Shell 结构材料通过 `*MATERIAL` 的 type 或等价字段识别。0.6.0 应支持 `TYPE=SHELL` 或与 01-06 文档一致的 Shell material 识别方式,并保持 material 作为物理类型判断来源。 + +Shell material 校验建议包括: + +- Shell material 必须有正密度。 +- 弹性模量必须为正值。 +- 泊松比必须处于受控范围。 +- Johnson-Cook flow 参数必须完整且有限。 +- 请求 failure 时 Johnson-Cook failure 参数必须完整且有限。 +- softening 类型必须为已支持类型;不支持类型报 error。 +- 未被 active Shell 粒子使用的 Shell material 可 warning,不阻断其他路径运行。 + +### 7.2 Shell section 识别 + +`*SHELL SECTION` 或等价 Abaqus section 子集作为板壳 section 入口。0.6.0 应确认: + +- Shell section 必须指向存在的 Shell material。 +- Shell section 指向非 Shell material 时应报 error。 +- Shell section 必须有正厚度。 +- 厚度积分点数量只接受 3 或 5,未给定时默认 3。 +- 剪切修正系数若给定必须为正有限值;未给定时使用受控默认值。 +- 存在 active Shell 粒子但缺失 Shell section 时应报 error。 +- set 仍只表示集合,不作为 Shell 类型判断依据。 + +### 7.3 Shell 粒子和 2D 几何 + +Shell 面向 2D 几何板壳粒子,通过 section 识别厚度和板壳属性。0.6.0 不新增几何生成器或网格生成器。测试输入可以手写或由 Python 辅助脚本生成 `.inp`,但该脚本只属于测试辅助。 + +0.6.0 若需要从输入元素推断 Shell 粒子的局部面积、邻接或法向,应限于已有 Abaqus 子集和测试小模型,并在文档中说明其近似范围。 + +## 8. Shell 状态设计 + +### 8.1 粒子级状态 + +0.6.0 建议建立以下粒子级状态: + +```fortran +real(rk), allocatable :: shell_thickness(:) +real(rk), allocatable :: shell_director(:,:) +real(rk), allocatable :: shell_omega(:,:) +real(rk), allocatable :: shell_membrane_strain(:,:) +real(rk), allocatable :: shell_bending_strain(:,:) +real(rk), allocatable :: shell_shear_strain(:,:) +real(rk), allocatable :: shell_softening(:) +real(rk), allocatable :: shell_damage(:) +real(rk), allocatable :: shell_internal_energy(:) +integer, allocatable :: shell_failure_status(:) +``` + +数组约定: + +- `shell_director(3,npart)` 表示 Shell director 或法向。 +- `shell_omega(3,npart)` 表示角速度或转动相关状态。 +- `shell_membrane_strain(3,npart)` 使用局部顺序 `11,22,12`。 +- `shell_bending_strain(3,npart)` 使用局部顺序 `11,22,12`。 +- `shell_shear_strain(2,npart)` 使用局部顺序 `13,23`。 + +### 8.2 厚度积分点状态 + +0.6.0 建议建立厚度积分点状态。若固定最大积分点数为 5,可采用压缩数组或三维数组: + +```fortran +real(rk), allocatable :: shell_ip_stress(:,:,:) +real(rk), allocatable :: shell_ip_strain(:,:,:) +real(rk), allocatable :: shell_ip_plastic_strain(:,:) +real(rk), allocatable :: shell_ip_temperature(:,:) +real(rk), allocatable :: shell_ip_damage(:,:) +real(rk), allocatable :: shell_ip_softening(:,:) +integer, allocatable :: shell_ip_count(:) +``` + +建议约定: + +- `shell_ip_stress(component,ip,particle)`。 +- `component` 第一版可使用局部壳应力顺序 `11,22,12,13,23`。 +- `ip` 最大为 5,实际积分点数量由 section 决定。 +- 未使用积分点应设置安全默认值,不参与计算和输出诊断。 + +### 8.3 诊断状态 + +Shell 诊断建议包括: + +- active Shell 粒子数。 +- failed Shell 粒子数。 +- Shell 总质量。 +- Shell 总动量。 +- Shell 转动诊断或角速度最大值。 +- Shell 动能和内能。 +- Shell 最大膜应变、最大弯曲应变、最大剪切应变。 +- Shell 最大 von Mises 或等效应力。 +- Shell damage 和 softening 范围。 +- Shell dt 限制。 +- Shell 内力和内力矩残差。 + +## 9. Mindlin-Reissner 运动学 + +### 9.1 Director 初始化和更新 + +0.6.0 应实现 director 或法向状态的初始化和基础更新: + +- 输入或几何推断得到初始 director。 +- 未给定 director 时,可从受控小模型的参考面几何推断,无法推断时报 error。 +- director 必须有限且非零。 +- director 初始化后归一化。 +- 显式步中由角速度或转动增量更新 director。 +- 更新后继续归一化,避免长度漂移。 + +### 9.2 平动和转动自由度 + +Shell 粒子共享通用粒子数据库中的 `x`、`v`、`a` 平动状态。Shell 模块额外维护转动相关状态: + +- 角速度 `omega`。 +- 角加速度或等价转动力矩贡献。 +- 转动惯量或等价面积/厚度惯量。 + +0.6.0 可先实现简化转动路径,用小型模型验证方向、量级和有限性,不要求完整生产级壳单元刚度矩阵。 + +### 9.3 膜、弯曲和横向剪切应变 + +Mindlin-Reissner 路线下,0.6.0 应建立以下应变量: + +- 膜应变:由中面位移或速度梯度得到。 +- 弯曲应变:由 director/转角梯度得到。 +- 横向剪切应变:由 director 与中面法向或位移梯度组合得到。 + +第一版测试应覆盖: + +- 刚体平动下 Shell 应变为零。 +- 刚体转动或受控转动下膜应变为零或受控。 +- 简单单轴拉伸下膜应变方向正确。 +- 简单曲率场下弯曲应变方向正确。 +- director 非有限或退化路径受控报错。 + +## 10. 厚度积分和材料更新 + +### 10.1 厚度积分点 + +0.6.0 支持 3 点和 5 点厚度积分: + +- 默认 3 点。 +- 5 点用于更高精度或强非线性板壳响应的预留路径。 +- 积分点坐标和权重由 Shell section 或内部默认表确定。 +- 积分点状态必须写入 restart。 + +### 10.2 壳材料点更新 + +0.6.0 Shell 材料路线与结构长期目标保持一致,优先使用 Johnson-Cook flow/failure 路线。弹性材料点可作为退化路径和单元测试基础。 + +材料更新建议路径: + +```text +membrane/bending/shear strain increment + -> through-thickness integration point strain + -> elastic trial or Johnson-Cook flow correction + -> Johnson-Cook damage update + -> progressive softening + -> stress resultants and shell diagnostics +``` + +第一版可采用局部平面应力或受控近似,但必须在文档和测试中明确其小型 smoke 范围。 + +### 10.3 失效和撕裂初步状态 + +0.6.0 应建立 Shell 失效和撕裂初步状态,但不交付完整撕裂路径追踪: + +- damage 单调不减。 +- softening 单调不增。 +- `PHASE_SHELL_FAILED` 不可逆。 +- 失效不删除粒子,不改变质量。 +- restart 后 damage、softening 和 failure status 不被重置。 +- 可以统计撕裂候选或 failed Shell 数量,但不生成裂纹面、碎片云或穿孔形态。 + +## 11. Shell 内力、内力矩和时间步 + +### 11.1 最小 Shell 内力路径 + +0.6.0 建议实现最小 Shell 内力和内力矩贡献路径。第一版目标是形成可测链路: + +- 零应力和零应变时内力为零。 +- 刚体平动不产生虚假内力。 +- 受控小模型下膜力方向和量级有限。 +- 受控小模型下弯曲力矩方向和量级有限。 +- softening 可降低失效粒子的承载贡献。 +- 无 active Shell 粒子时跳过 Shell 内力路径,不影响 Water/Gas/Explosive/Solid。 + +### 11.2 稳定时间步 + +0.6.0 继续使用 Velocity-Verlet 显式推进。Shell dt 约束建议包括: + +```text +dt_shell_wave = cfl * h / (c_shell + |v|) +dt_shell_rot = cfl_rot * sqrt(I / (|M| + eps)) +dt_shell_acc = cfl_acc * sqrt(h / (|a_shell| + eps)) +dt_shell = min(dt_shell_wave, dt_shell_rot, dt_shell_acc) +``` + +默认 gate 应验证: + +- 无 active Shell 时不影响全局 dt。 +- 有 active Shell 时 Shell dt 有限且为正。 +- 转动或内力矩增大时转动约束可收紧。 +- restart 后 Shell dt 诊断一致。 + +### 11.3 与既有模块隔离 + +Shell 内力、转动力矩和诊断不得改变 Water-only、Gas-only、Explosive-Gas-Water 和 Solid-only 既有算例结果。0.6.0 必须保留 0.5.1 完整回归。 + +## 12. 输出和 Restart + +### 12.1 CSV 输出 + +0.6.0 建议在 summary CSV 中追加或确认以下字段: + +- `shell_particles` +- `shell_failed_particles` +- `shell_mass` +- `shell_momentum` +- `shell_kinetic_energy` +- `shell_internal_energy` +- `shell_max_membrane_strain` +- `shell_max_bending_strain` +- `shell_max_shear_strain` +- `shell_max_von_mises` +- `shell_damage_min` +- `shell_damage_max` +- `shell_softening_min` +- `shell_softening_max` +- `shell_dt_wave` +- `shell_dt_rot` +- `shell_dt_accel` +- `shell_dtcrit` + +粒子 CSV 可追加: + +- `shell_thickness` +- `shell_director_x` +- `shell_director_y` +- `shell_director_z` +- `shell_omega_norm` +- `shell_damage` +- `shell_softening` +- `shell_failure_status` + +如果字段过多,0.6.0 可优先将完整积分点状态放入 API 和 module tests,CSV 只保留 release gate 最有价值的字段。 + +### 12.2 Restart + +0.6.0 建议写入 `STATE_0_6`。必须保存或可恢复: + +- 0.5.1 已有粒子通用状态。 +- Velocity-Verlet 所需 `v`、`a` 和 `vhalf`。 +- Water、Gas、Explosive 和 Solid 既有模块状态。 +- Shell material/section 表或可恢复映射。 +- Shell per-particle 厚度、director、角速度、应变、damage、softening、内能和失效状态。 +- Shell 厚度积分点应力、应变、塑性、温度、damage 和 softening。 +- Shell dt、能量、动量、转动和失效诊断。 +- 输出计数和时间控制状态。 + +兼容读入: + +- `STATE_0_6`:完整读回。 +- `STATE_0_5_1`:读回 0.5.1 状态,并初始化空 Shell 状态。 +- `STATE_0_5` 及更早可支持状态:初始化空 Shell 状态。 + +restart 后继续显式步不得重复初始化 Shell thickness、director、omega、积分点状态、damage、softening 或 failure status。 + +## 13. API、C ABI、C++、Python 和 CLI + +### 13.1 Fortran API + +0.6.0 建议新增或补强: + +- `sph_get_shell_counts` +- `sph_get_shell_summary` +- `sph_get_shell_state` +- `sph_get_shell_integration_state` +- `sph_get_shell_dt_limits` + +若积分点状态查询过大,Fortran API 可拆分为计数查询、summary 查询、粒子级 caller-allocated buffer 查询和积分点 caller-allocated buffer 查询。 + +### 13.2 C ABI + +C ABI 应保持追加式扩展。建议新增: + +```c +int sphlite_get_shell_summary(int *active_count, + int *failed_count, + double *values, + int value_capacity); + +int sphlite_get_shell_particle_state(int max_particles, + double *values, + int value_capacity, + int *failure_status, + int *integration_point_count, + int *count); + +int sphlite_get_shell_integration_state(int max_particles, + int max_integration_points, + double *values, + int value_capacity, + int *count); +``` + +建议 Shell 粒子级 `values` 至少包含: + +- 厚度。 +- director 3 分量。 +- omega 3 分量。 +- membrane strain 3 分量。 +- bending strain 3 分量。 +- shear strain 2 分量。 +- damage。 +- softening。 + +积分点状态展开顺序应明确锁定,例如: + +- `values[component + ncomp * (ip + max_ip * particle)]` + +空指针、非正容量、未初始化状态和小容量必须走既有错误路径。 + +### 13.3 C++ wrapper 和 Python ctypes + +C++ 和 Python 继续做 C ABI 薄包装,不重新定义 Shell 物理语义。Python checker 应覆盖: + +- Shell summary 查询。 +- Shell particle state 查询。 +- Shell integration point state 查询。 +- Shell 小模型 inspect/run。 +- `STATE_0_6` restart 读回。 +- `STATE_0_5_1` restart 兼容读入后的空 Shell 默认状态。 + +### 13.4 CLI + +CLI inspect/run 可追加: + +- `shell_particles` +- `shell_failed_particles` +- `shell_mass` +- `shell_max_membrane_strain` +- `shell_max_bending_strain` +- `shell_max_shear_strain` +- `shell_max_von_mises` +- `shell_damage_range` +- `shell_softening_range` +- `shell_dt_limits` + +CLI 测试应覆盖: + +- Shell 0.6.0 输入 inspect。 +- Shell-only 小模型 run。 +- Shell restart 读回 inspect 或 run。 +- Shell 错误输入。 + +## 14. 测试计划 + +### 14.1 新增 0.6.0 测试 + +建议新增以下测试: + +- `input_shell_section`:Shell material、Shell section、厚度、积分点和剪切修正参数读取。 +- `input_shell_errors`:缺密度、非法厚度、非法积分点、非 Shell material section 和缺 Shell section error 路径。 +- `shell_state_build`:Shell 状态数组分配、默认值、active/failed 计数和非 Shell 安全默认值。 +- `shell_section_integration`:3 点和 5 点厚度积分坐标、权重和默认选择。 +- `shell_director_update`:director 初始化、归一化、退化错误和受控更新。 +- `shell_rotation_kinematics`:角速度、转动惯量或等价转动状态。 +- `shell_membrane_strain`:刚体平动零膜应变和单轴拉伸膜应变。 +- `shell_bending_strain`:受控曲率场下弯曲应变。 +- `shell_shear_strain`:Mindlin-Reissner 横向剪切应变方向和量级。 +- `shell_elastic_material`:Shell 积分点弹性退化路径。 +- `shell_johnson_cook_flow`:Shell 积分点 Johnson-Cook flow 路径。 +- `shell_johnson_cook_failure`:Shell 积分点 damage 和 failure status。 +- `shell_progressive_softening`:Shell damage/softening 单调性和范围限制。 +- `shell_internal_force_smoke`:Shell 最小内力和内力矩有限性。 +- `shell_stable_dt`:Shell 平动、转动和加速度 dt 约束。 +- `shell_explicit_smoke`:Shell-only 小模型 Velocity-Verlet 显式推进。 +- `shell_output`:summary CSV 和粒子 CSV 的 Shell 字段。 +- `shell_restart_060`:`STATE_0_6` 写入读回并继续显式步。 +- `shell_restart_051_compat`:`STATE_0_5_1` 兼容读入并初始化空 Shell 状态。 +- `shell_api`:Fortran API 的 Shell summary、state 和 integration state 查询。 +- `shell_c_api`:C ABI 的 Shell summary、state、空指针和小容量错误路径。 +- `shell_python`:Python ctypes 的 Shell 0.6.0 诊断和 restart 读回。 +- `shell_cli`:CLI 的 Shell inspect/run/restart 字段。 +- `shell_source_size`:Shell 0.6.0 source size 和 stale exception 检查。 + +### 14.2 既有回归测试 + +0.6.0 必须继续通过 0.5.1 完整 gate,包括: + +- Water gate。 +- Gas gate。 +- Explosive gate。 +- Solid 0.5.0 gate。 +- Solid 0.5.1 gate。 +- output/restart gate。 +- C API/C++/Python/CLI gate。 +- source size gate。 + +### 14.3 建议 0.6.0 Release Gate + +建议 0.6.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 "^(solid_051_input_validation|solid_reference_neighbor|solid_correction_matrix|solid_velocity_gradient|solid_strain_increment|solid_internal_force_pair|solid_uniform_stress_balance|solid_softening_force|solid_energy_diagnostics|solid_dt_acceleration|solid_restart_051|solid_restart_050_compat|solid_state_api|solid_python_051|solid_cli_051|solid_051_source_size)$" --output-on-failure +ctest --test-dir build-codex-unix -R "^(input_shell_section|input_shell_errors|shell_state_build|shell_section_integration|shell_director_update|shell_rotation_kinematics|shell_membrane_strain|shell_bending_strain|shell_shear_strain|shell_elastic_material|shell_johnson_cook_flow|shell_johnson_cook_failure|shell_progressive_softening|shell_internal_force_smoke|shell_stable_dt|shell_explicit_smoke|shell_output|shell_restart_060|shell_restart_051_compat|shell_api|shell_c_api|shell_python|shell_cli|shell_source_size)$" --output-on-failure +ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure +git diff --check +``` + +## 15. 建议开发阶段 + +若后续根据本计划生成 `todo.md`,建议按以下阶段拆分: + +1. 0.6.0 版本号、0.5.1 发布基线和文档范围确认。 +2. Shell 0.6.0 输入样例、错误输入样例和小型 smoke 样例准备。 +3. Shell material 和 Shell section 输入解析。 +4. Shell 输入校验、warning/error 和 set/material/section 边界。 +5. Shell 粒子级状态数组分配、初始化和释放。 +6. Shell 厚度积分点状态数组分配、初始化和释放。 +7. Shell section 厚度、3/5 积分点和剪切修正参数。 +8. director 初始化、归一化、退化检查和基础更新。 +9. Shell 角速度、转动惯量和转动诊断状态。 +10. Shell 参考面积或等效面积、质量和惯量初始化。 +11. 膜应变计算和刚体平动回归。 +12. 弯曲应变计算和受控曲率测试。 +13. 横向剪切应变计算和退化测试。 +14. 厚度积分点弹性材料点路径。 +15. 厚度积分点 Johnson-Cook flow 路径。 +16. 厚度积分点 Johnson-Cook failure、damage 和 softening 路径。 +17. Shell 失效不可逆、`PHASE_SHELL_FAILED` 和不删除粒子策略。 +18. Shell 最小内力和内力矩贡献。 +19. Shell 能量、动量、转动、damage/softening 和应变诊断。 +20. Shell 平动、转动和加速度稳定时间步。 +21. Shell 接入 Velocity-Verlet 显式推进。 +22. Shell summary CSV 和粒子 CSV 字段扩展。 +23. `STATE_0_6` restart 写入。 +24. `STATE_0_6` restart 读回。 +25. `STATE_0_5_1` 和更早 restart 兼容读入。 +26. Fortran API 和 C ABI 的 Shell summary/state/integration state 查询。 +27. C++ wrapper、Python ctypes 和 CLI 扩展。 +28. source size 复核和必要拆分。 +29. 0.5.1 全量回归和 0.6.0 新增 gate。 +30. README、06、09 和 11 号文档同步。 + +## 16. 验收标准 + +0.6.0 应满足以下验收标准: + +1. 软件版本为 `0.6.0`。 +2. 0.5.1 release gate 继续通过。 +3. Shell material 和 Shell section 输入校验路径清晰。 +4. Shell 厚度、director、omega、膜/弯/剪应变、积分点状态、damage、softening 和 failure status 可初始化和查询。 +5. 3 点和 5 点厚度积分可用,默认 3 点。 +6. director 在受控小模型中初始化、归一化和更新正确。 +7. 膜应变、弯曲应变和横向剪切应变在受控小算例中与预期一致。 +8. Shell 积分点材料更新可走弹性和 Johnson-Cook 路线。 +9. Shell damage、softening 和 `PHASE_SHELL_FAILED` 不可逆,且不删除粒子、不改变质量。 +10. 最小 Shell 内力和内力矩路径可运行,并通过零应力、刚体平动和受控小模型测试。 +11. Shell 能量、动量、转动、最大应变、damage/softening 和 dt 诊断可用。 +12. Shell dt 约束有限为正,并可进入全局 dt 估计。 +13. `STATE_0_6` restart 可恢复 Shell 0.6.0 状态并继续显式步。 +14. `STATE_0_5_1` restart 可兼容读入,并初始化空 Shell 状态。 +15. Shell summary、particle state 和 integration state 的 Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 字段可用。 +16. 默认 gate、0.5.1 回归 gate、0.6.0 Shell gate、source size 和 `git diff --check` 通过。 +17. 文档不宣称 0.6.0 已实现真实水-气-结构爆炸响应、真实 FEM-SPH 耦合或工程级结构破坏 benchmark。 +18. 文档明确 0.6.0 只交付 Shell 最小闭环,不交付完整撕裂路径追踪、穿孔或碎片云。 +19. 不新增 FEMLite 直接依赖。 +20. 不修改 SPHLite 文件夹之外的内容。 + +## 17. 风险与控制 + +| 风险 | 表现 | 控制方式 | +| --- | --- | --- | +| 0.6.0 范围膨胀 | 试图进入水-气-结构工程爆炸、FEM-SPH 耦合或完整穿孔撕裂 | 限定为 Shell 小型结构算法闭环 | +| Shell 与 Solid 边界混淆 | Shell 复用 Solid 状态或 API 语义导致接口不清 | Shell 独立 section、状态、restart 和 API;只复用通用数学/材料辅助 | +| director 退化 | 法向无法推断、长度为零或非有限 | 输入校验、几何推断失败报 error、更新后归一化 | +| 厚度积分状态膨胀 | 积分点状态堆入单个大文件,source size 失败 | 按 shell_state、shell_section、shell_kinematics、shell_material、shell_restart、shell_api 拆分 | +| Mindlin-Reissner 运动学错误 | 膜/弯/剪应变方向或量级错误 | 刚体平动、单轴拉伸、受控曲率和剪切小模型 gate | +| 内力和内力矩不稳 | 小模型中出现非物理加速度或转动漂移 | 先做零应力、刚体平动、对称布置和有限性测试 | +| Shell 更新影响既有算例 | 无 Shell 输入时仍进入 Shell 路径 | 无 active Shell 时直接跳过,并保持 0.5.1 全量回归 | +| restart 不完整 | 读回后 director、积分点状态或 failure status 丢失 | `STATE_0_6` 保存完整 Shell 持久状态 | +| API 兼容破坏 | 修改既有 C ABI 字段或数组约定 | 新增 Shell API,不改变既有 Water/Gas/Explosive/Solid 接口含义 | + +## 18. 0.7.0 启动条件 + +满足以下条件后,可以启动 0.7.0 水-气-结构局部爆炸 smoke: + +1. 0.6.0 Shell 输入、状态、运动学、厚度积分、材料点和显式推进 gate 稳定。 +2. Shell output、restart、API、CLI 和 Python 诊断稳定。 +3. 0.5.1 Water/Gas/Explosive/Solid gate 仍可重复通过。 +4. Shell 和 Solid 的失效/softening 状态不删除粒子、不改变质量,并可在 restart 后恢复。 +5. 文档明确 0.6.0 尚未实现真实 FEM-SPH 耦合、工程级水下爆炸结构破坏 benchmark、完整撕裂路径追踪和碎片云。 diff --git a/src/core/sph_precision.f90 b/src/core/sph_precision.f90 index 61fd422..eed414e 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 = 5 - integer, parameter :: SPH_VERSION_PATCH = 1 + integer, parameter :: SPH_VERSION_MINOR = 6 + 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/shell_bad_integration_points_060.inp b/tests/data/shell_bad_integration_points_060.inp new file mode 100644 index 0000000..3b31478 --- /dev/null +++ b/tests/data/shell_bad_integration_points_060.inp @@ -0,0 +1,14 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=SHELL_PARTICLES +1 +*MATERIAL, NAME=SHELL_BAD_POINTS, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_BAD_POINTS, THICKNESS=0.010, POINTS=4, SHEAR_CORRECTION=0.8333333333 +*SPHLITE PARTICLE CONTROL, H=0.12, 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/shell_bad_thickness_060.inp b/tests/data/shell_bad_thickness_060.inp new file mode 100644 index 0000000..7a96b01 --- /dev/null +++ b/tests/data/shell_bad_thickness_060.inp @@ -0,0 +1,14 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=SHELL_PARTICLES +1 +*MATERIAL, NAME=SHELL_BAD_THICKNESS, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_BAD_THICKNESS, THICKNESS=0.0, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*SPHLITE PARTICLE CONTROL, H=0.12, 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/shell_controlled_bending_060.inp b/tests/data/shell_controlled_bending_060.inp new file mode 100644 index 0000000..70a0311 --- /dev/null +++ b/tests/data/shell_controlled_bending_060.inp @@ -0,0 +1,22 @@ +*NODE +1, -0.1, 0.0, 0.0 +2, 0.0, 0.0, 0.0 +3, 0.1, 0.0, 0.0 +4, 0.2, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=SHELL_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=SHELL_BENDING, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_BENDING, THICKNESS=0.010, POINTS=5, SHEAR_CORRECTION=0.8333333333 +*SPHLITE SHELL DIRECTOR, SET=SHELL_PARTICLES, NX=0.0, NY=0.0, NZ=1.0 +*SPHLITE SHELL ROTATION, SET=SHELL_PARTICLES, OX=0.0, OY=10.0, OZ=0.0 +*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/shell_director_degenerate_060.inp b/tests/data/shell_director_degenerate_060.inp new file mode 100644 index 0000000..7802e52 --- /dev/null +++ b/tests/data/shell_director_degenerate_060.inp @@ -0,0 +1,19 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +*ELSET, ELSET=SHELL_PARTICLES +1, 2, 3 +*MATERIAL, NAME=SHELL_BAD_DIRECTOR, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_BAD_DIRECTOR, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*SPHLITE SHELL DIRECTOR, SET=SHELL_PARTICLES, NX=0.0, NY=0.0, NZ=0.0 +*SPHLITE PARTICLE CONTROL, H=0.12, 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/shell_director_explicit_060.inp b/tests/data/shell_director_explicit_060.inp new file mode 100644 index 0000000..4dd1bac --- /dev/null +++ b/tests/data/shell_director_explicit_060.inp @@ -0,0 +1,19 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +*ELSET, ELSET=SHELL_PARTICLES +1, 2, 3 +*MATERIAL, NAME=SHELL_DIRECTOR, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_DIRECTOR, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*SPHLITE SHELL DIRECTOR, SET=SHELL_PARTICLES, NX=0.0, NY=0.0, NZ=1.0 +*SPHLITE PARTICLE CONTROL, H=0.12, 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/shell_elastic_material_060.inp b/tests/data/shell_elastic_material_060.inp new file mode 100644 index 0000000..65dca10 --- /dev/null +++ b/tests/data/shell_elastic_material_060.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.1, 0.1, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=SHELL_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=SHELL_ELASTIC, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_ELASTIC, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*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/shell_explicit_smoke_060.inp b/tests/data/shell_explicit_smoke_060.inp new file mode 100644 index 0000000..a00f47d --- /dev/null +++ b/tests/data/shell_explicit_smoke_060.inp @@ -0,0 +1,22 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +4, 0.1, 0.1, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=SHELL_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=SHELL_SMOKE, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_SMOKE, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*SPHLITE SHELL DIRECTOR, SET=SHELL_PARTICLES, NX=0.0, NY=0.0, NZ=1.0 +*SPHLITE INITIAL VELOCITY, SET=SHELL_PARTICLES, VX=0.1, 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/shell_internal_force_smoke_060.inp b/tests/data/shell_internal_force_smoke_060.inp new file mode 100644 index 0000000..9f33e9b --- /dev/null +++ b/tests/data/shell_internal_force_smoke_060.inp @@ -0,0 +1,21 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +4, 0.1, 0.1, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=SHELL_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=SHELL_FORCE, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_FORCE, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*SPHLITE SHELL DIRECTOR, SET=SHELL_PARTICLES, NX=0.0, NY=0.0, NZ=1.0 +*SPHLITE PARTICLE CONTROL, H=0.12, 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/shell_johnson_cook_060.inp b/tests/data/shell_johnson_cook_060.inp new file mode 100644 index 0000000..2a0825d --- /dev/null +++ b/tests/data/shell_johnson_cook_060.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=SHELL_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=SHELL_JC, TYPE=SHELL +*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 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_JC, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*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/shell_johnson_cook_failure_060.inp b/tests/data/shell_johnson_cook_failure_060.inp new file mode 100644 index 0000000..7cf630b --- /dev/null +++ b/tests/data/shell_johnson_cook_failure_060.inp @@ -0,0 +1,25 @@ +*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=SHELL_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=SHELL_DAMAGE, TYPE=SHELL +*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 SHELL CONTROL, MATERIAL=SHELL_DAMAGE, SOFTENING=LINEAR, WIDTH=0.25 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_DAMAGE, THICKNESS=0.010, POINTS=5, SHEAR_CORRECTION=0.8333333333 +*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/shell_minimal_060.inp b/tests/data/shell_minimal_060.inp new file mode 100644 index 0000000..72c316d --- /dev/null +++ b/tests/data/shell_minimal_060.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.1, 0.1, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=SHELL_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=SHELL_STEEL, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_STEEL, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*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/shell_missing_density_060.inp b/tests/data/shell_missing_density_060.inp new file mode 100644 index 0000000..c589b4e --- /dev/null +++ b/tests/data/shell_missing_density_060.inp @@ -0,0 +1,12 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=SHELL_PARTICLES +1 +*MATERIAL, NAME=SHELL_NO_DENSITY, TYPE=SHELL +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_NO_DENSITY, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*SPHLITE PARTICLE CONTROL, H=0.12, 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/shell_missing_section_060.inp b/tests/data/shell_missing_section_060.inp new file mode 100644 index 0000000..a2ab574 --- /dev/null +++ b/tests/data/shell_missing_section_060.inp @@ -0,0 +1,13 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=SHELL_PARTICLES +1 +*MATERIAL, NAME=SHELL_MISSING_SECTION, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SPHLITE PARTICLE CONTROL, H=0.12, 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/shell_progressive_softening_060.inp b/tests/data/shell_progressive_softening_060.inp new file mode 100644 index 0000000..f4ef14e --- /dev/null +++ b/tests/data/shell_progressive_softening_060.inp @@ -0,0 +1,21 @@ +*NODE +1, -0.05, 0.0, 0.0 +2, 0.05, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +*ELSET, ELSET=SHELL_PARTICLES +1, 2 +*MATERIAL, NAME=SHELL_SOFTENING, TYPE=SHELL +*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 SHELL CONTROL, MATERIAL=SHELL_SOFTENING, SOFTENING=LINEAR, WIDTH=0.25 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_SOFTENING, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*SPHLITE PARTICLE CONTROL, H=0.12, 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/shell_restart_051_compat_060.inp b/tests/data/shell_restart_051_compat_060.inp new file mode 100644 index 0000000..728cfe1 --- /dev/null +++ b/tests/data/shell_restart_051_compat_060.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.1, 0.1, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=SOLID_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=STEEL_RESTART_051_COMPAT, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_RESTART_051_COMPAT +*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/shell_restart_060.inp b/tests/data/shell_restart_060.inp new file mode 100644 index 0000000..e53ed54 --- /dev/null +++ b/tests/data/shell_restart_060.inp @@ -0,0 +1,26 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +4, 0.1, 0.1, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=SHELL_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=SHELL_RESTART_060, TYPE=SHELL +*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 SHELL CONTROL, MATERIAL=SHELL_RESTART_060, SOFTENING=LINEAR, WIDTH=0.25 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_RESTART_060, THICKNESS=0.010, POINTS=5, SHEAR_CORRECTION=0.8333333333 +*SPHLITE SHELL DIRECTOR, SET=SHELL_PARTICLES, NX=0.0, NY=0.0, NZ=1.0 +*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/shell_rigid_translation_060.inp b/tests/data/shell_rigid_translation_060.inp new file mode 100644 index 0000000..6a5506f --- /dev/null +++ b/tests/data/shell_rigid_translation_060.inp @@ -0,0 +1,22 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +4, 0.1, 0.1, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=SHELL_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=SHELL_RIGID_TRANSLATION, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_RIGID_TRANSLATION, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*SPHLITE SHELL DIRECTOR, SET=SHELL_PARTICLES, NX=0.0, NY=0.0, NZ=1.0 +*SPHLITE INITIAL VELOCITY, SET=SHELL_PARTICLES, VX=1.0, VY=2.0, VZ=3.0 +*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/shell_section_3pt_060.inp b/tests/data/shell_section_3pt_060.inp new file mode 100644 index 0000000..d77675f --- /dev/null +++ b/tests/data/shell_section_3pt_060.inp @@ -0,0 +1,18 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +*ELSET, ELSET=SHELL_PARTICLES +1, 2, 3 +*MATERIAL, NAME=SHELL_THREE_POINT, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_THREE_POINT, THICKNESS=0.012, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*SPHLITE PARTICLE CONTROL, H=0.12, 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/shell_section_5pt_060.inp b/tests/data/shell_section_5pt_060.inp new file mode 100644 index 0000000..b5d7662 --- /dev/null +++ b/tests/data/shell_section_5pt_060.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.1, 0.1, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=SHELL_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=SHELL_FIVE_POINT, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_FIVE_POINT, THICKNESS=0.012, POINTS=5, SHEAR_CORRECTION=0.8333333333 +*SPHLITE PARTICLE CONTROL, H=0.12, 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/shell_section_non_shell_060.inp b/tests/data/shell_section_non_shell_060.inp new file mode 100644 index 0000000..6d34e74 --- /dev/null +++ b/tests/data/shell_section_non_shell_060.inp @@ -0,0 +1,13 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=SHELL_PARTICLES +1 +*MATERIAL, NAME=WATER_MAT_FOR_SHELL, TYPE=WATER +*DENSITY +1000.0 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=WATER_MAT_FOR_SHELL, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*SPHLITE EOS, TYPE=TAIT, MATERIAL=WATER_MAT_FOR_SHELL, RHO0=1000.0, C0=1480.0, GAMMA=7.0, P0=0.0 +*SPHLITE PARTICLE CONTROL, H=0.12, 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/data/shell_transverse_shear_060.inp b/tests/data/shell_transverse_shear_060.inp new file mode 100644 index 0000000..93c364b --- /dev/null +++ b/tests/data/shell_transverse_shear_060.inp @@ -0,0 +1,22 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +4, 0.1, 0.1, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=SHELL_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=SHELL_SHEAR, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_SHEAR, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*SPHLITE SHELL DIRECTOR, SET=SHELL_PARTICLES, NX=0.0, NY=0.0, NZ=1.0 +*SPHLITE INITIAL VELOCITY, SET=SHELL_PARTICLES, VX=0.0, VY=0.0, VZ=0.5 +*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/shell_uniaxial_membrane_060.inp b/tests/data/shell_uniaxial_membrane_060.inp new file mode 100644 index 0000000..77d0041 --- /dev/null +++ b/tests/data/shell_uniaxial_membrane_060.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=SHELL_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=SHELL_MEMBRANE, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_MEMBRANE, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*SPHLITE SHELL DIRECTOR, SET=SHELL_PARTICLES, NX=0.0, NY=0.0, NZ=1.0 +*SPHLITE INITIAL VELOCITY, SET=SHELL_PARTICLES, 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=2.0E-7, STEPS=2, SAFETY=0.5 diff --git a/tests/interface/test_c_api.c b/tests/interface/test_c_api.c index b2fef3b..7d1b927 100644 --- a/tests/interface/test_c_api.c +++ b/tests/interface/test_c_api.c @@ -238,7 +238,7 @@ int main(void) ierr = sphlite_get_version(&major, &minor, &patch); if (ierr != 0) return fail("get_version failed"); - if (major != 0 || minor != 5 || patch != 1) return fail("unexpected version"); + if (major != 0 || minor != 6 || 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 9f328fa..0234042 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 != 5 || version.patch != 1) { + if (version.major != 0 || version.minor != 6 || version.patch != 0) { return 1; } diff --git a/tests/unit/test_smoke.f90 b/tests/unit/test_smoke.f90 index f9b75be..5007f1d 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 /= 5 .or. patch /= 1) call fail('unexpected version') + if (major /= 0 .or. minor /= 6 .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 e0e32b1..209cc73 100644 --- a/todo.md +++ b/todo.md @@ -1,278 +1,398 @@ # SPHLite TODO -当前目标版本:0.5.1 +当前目标版本:0.6.0 -本文档依据 `docs/v5.1_development_plan.md` 拆分。0.5.1 定位为 `Solid` 版本线的稳定化和结构算法加固版本,目标是在 0.5.0 已完成 Solid 输入、状态、本构、失效、显式推进、restart、接口和 gate 最小闭环的基础上,补强参考构型、速度梯度、应变率、最小内力、能量诊断、`STATE_0_5_1` restart、`STATE_0_5` 兼容读入和接口可观测性。 +本文档依据 `docs/v6.0_development_plan.md` 拆分。0.6.0 定位为 `Shell` 板壳粒子版本线的起点,目标是在 0.5.1 已完成 `Solid` 3D 实体结构粒子稳定化和结构算法加固的基础上,建立 `Shell` 输入、状态、Mindlin-Reissner 板壳运动学、厚度积分、材料点更新、显式推进、输出、restart、接口和测试 gate 的最小闭环。 -所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.5.1 不实现 `Shell`、真实水-气-结构工程爆炸响应、真实 FEM-SPH 耦合、工程级结构破坏 benchmark、复杂断裂面追踪、碎片云、焊缝失效库、大规模并行或 GPU 后端。 +所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.6.0 不实现真实水-气-结构工程爆炸响应、真实 FEM-SPH 耦合、工程级结构破坏 benchmark、完整板壳撕裂路径追踪、裂纹扩展、穿孔判据库、碎片云、壳-实体连接、复杂接触、焊缝失效库、大规模并行或 GPU 后端。 执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端。 -## 阶段 A:版本基线、范围声明与 0.5.1 样例 +## 阶段 A:版本基线、范围声明与 0.6.0 样例 - [x] 确认当前 git 状态干净或记录已有未提交内容。 -- [x] 确认 `v0.5.0` 标签和远端发布提交可作为 0.5.1 开发基线。 -- [x] 将核心软件版本更新为 `0.5.1`。 -- [x] 将 CMake 项目版本更新为 `0.5.1`。 +- [x] 确认 `v0.5.1` 标签和远端发布提交可作为 0.6.0 开发基线。 +- [x] 将核心软件版本更新为 `0.6.0`。 +- [x] 将 CMake 项目版本更新为 `0.6.0`。 - [x] 更新 Fortran smoke 测试中的版本期望。 - [x] 更新 C API 测试中的版本期望。 - [x] 更新 C++ API 测试中的版本期望。 - [x] 更新 Python debug 测试中的版本期望。 - [x] 更新 CLI `--version` 和 inspect 版本期望。 -- [x] 在 README 中记录 0.5.1 Solid 稳定化开发定位。 -- [x] 创建 Solid 0.5.1 正常参考邻域输入样例。 -- [x] 创建 Solid 0.5.1 退化参考邻域输入样例。 -- [x] 创建 Solid 均匀平动速度场输入样例。 -- [x] 创建 Solid 单轴拉伸速度场输入样例。 -- [x] 创建 Solid 成对内力平衡输入样例。 -- [x] 创建 Solid 对称均匀应力输入样例。 -- [x] 创建 Solid softening 内力折减输入样例。 -- [x] 创建 Solid 0.5.1 显式推进 smoke 输入样例。 -- [x] 创建 `STATE_0_5_1` restart 测试输入样例。 -- [x] 准备 `STATE_0_5` restart 兼容读入测试夹具。 -- [x] 创建 Solid material 非法泊松比错误输入样例。 -- [x] 创建 Solid material 非有限 Johnson-Cook 参数错误输入样例。 -- [x] 创建 Solid 非法 softening 类型错误输入样例。 -- [x] 创建 Solid section 指向非 Solid material 错误输入样例。 -- [x] 创建 active Solid 粒子缺失 Solid section 错误输入样例。 +- [x] 在 README 中记录 0.6.0 Shell 起步闭环开发定位。 +- [x] 创建 Shell 0.6.0 最小 section 输入样例。 +- [x] 创建 Shell 3 点厚度积分输入样例。 +- [x] 创建 Shell 5 点厚度积分输入样例。 +- [x] 创建 Shell director 显式给定输入样例。 +- [x] 创建 Shell director 退化错误输入样例。 +- [x] 创建 Shell 刚体平动输入样例。 +- [x] 创建 Shell 单轴膜拉伸输入样例。 +- [x] 创建 Shell 受控弯曲输入样例。 +- [x] 创建 Shell 横向剪切输入样例。 +- [x] 创建 Shell 弹性材料点输入样例。 +- [x] 创建 Shell Johnson-Cook flow 输入样例。 +- [x] 创建 Shell Johnson-Cook failure 输入样例。 +- [x] 创建 Shell progressive softening 输入样例。 +- [x] 创建 Shell 最小内力 smoke 输入样例。 +- [x] 创建 Shell 0.6.0 显式推进 smoke 输入样例。 +- [x] 创建 `STATE_0_6` restart 测试输入样例。 +- [x] 准备 `STATE_0_5_1` restart 兼容读入测试夹具。 +- [x] 创建 Shell material 缺失密度错误输入样例。 +- [x] 创建 Shell section 非法厚度错误输入样例。 +- [x] 创建 Shell section 非法积分点数量错误输入样例。 +- [x] 创建 Shell section 指向非 Shell material 错误输入样例。 +- [x] 创建 active Shell 粒子缺失 Shell section 错误输入样例。 -## 阶段 B:Solid 输入校验、section 校验与 warning/error 路径 +## 阶段 B:Shell 输入解析、section 校验与 warning/error 路径 -- [x] 复核 0.5.0 Solid material 解析路径并保持语法兼容。 -- [x] 对 Solid material 缺失密度路径保持 error。 -- [x] 对 Solid material 非正密度路径保持 error。 -- [x] 对 Solid material 缺失弹性参数路径保持 error。 -- [x] 对 Solid material 非正弹性模量路径保持 error。 -- [x] 对 Solid material 非法泊松比路径新增或加固 error。 -- [x] 对 Johnson-Cook flow 参数非有限路径新增或加固 error。 -- [x] 对 Johnson-Cook failure 参数非完整路径保持 error。 -- [x] 对 Johnson-Cook failure 参数非有限路径新增或加固 error。 -- [x] 对 unsupported softening 类型新增或加固 error。 -- [x] 对未被 active Solid 粒子使用的 Solid material 保持 warning。 -- [x] 对 `*SOLID SECTION` 缺失 material 参数路径保持 error。 -- [x] 对 `*SOLID SECTION` 指向不存在 material 路径保持 error。 -- [x] 对 `*SOLID SECTION` 指向非 Solid material 路径新增或加固 error。 -- [x] 对存在 active Solid 粒子但缺失 Solid section 的模型给出 error。 -- [x] 确认 set 仍只表示集合,不参与 Solid 类型判断。 -- [x] 确认 phase/status 默认值不改变 Water/Gas/Explosive 路径。 -- [x] 新增 `solid_051_input_validation` Fortran 输入测试。 -- [x] 将 `solid_051_input_validation` 接入 CTest。 -- [x] 确认 0.5.0 `input_solid_material` 和 `input_solid_errors` 仍通过。 +- [ ] 复核现有 material 解析路径并保持 Water/Gas/Explosive/Solid 兼容。 +- [ ] 支持 `TYPE=SHELL` material 识别。 +- [ ] 支持 Shell material 密度读取和映射。 +- [ ] 支持 Shell material 弹性参数读取和映射。 +- [ ] 支持 Shell material Johnson-Cook flow 参数读取和映射。 +- [ ] 支持 Shell material Johnson-Cook failure 参数读取和映射。 +- [ ] 支持 Shell material softening 控制参数读取和映射。 +- [ ] 对 Shell material 缺失密度路径报 error。 +- [ ] 对 Shell material 非正密度路径报 error。 +- [ ] 对 Shell material 缺失弹性参数路径报 error。 +- [ ] 对 Shell material 非正弹性模量路径报 error。 +- [ ] 对 Shell material 非法泊松比路径报 error。 +- [ ] 对 Shell Johnson-Cook flow 非有限参数路径报 error。 +- [ ] 对 Shell Johnson-Cook failure 非完整或非有限参数路径报 error。 +- [ ] 对 Shell unsupported softening 类型路径报 error。 +- [ ] 对未被 active Shell 粒子使用的 Shell material 保持 warning。 +- [ ] 支持 `*SHELL SECTION` 或等价 section 子集解析。 +- [ ] 解析 Shell section 的 material 参数。 +- [ ] 解析 Shell section 的 thickness 参数。 +- [ ] 解析 Shell section 的 integration point 数量。 +- [ ] 解析 Shell section 的 shear correction 参数。 +- [ ] 对 Shell section 缺失 material 参数路径报 error。 +- [ ] 对 Shell section 指向不存在 material 路径报 error。 +- [ ] 对 Shell section 指向非 Shell material 路径报 error。 +- [ ] 对 Shell section 非正 thickness 路径报 error。 +- [ ] 对 Shell section 非法 integration point 数量路径报 error。 +- [ ] 对 Shell section 非法 shear correction 路径报 error。 +- [ ] 对存在 active Shell 粒子但缺失 Shell section 的模型报 error。 +- [ ] 确认 set 仍只表示集合,不参与 Shell 类型判断。 +- [ ] 确认 phase/status 默认值不改变 Water/Gas/Explosive/Solid 路径。 +- [ ] 新增 `input_shell_section` Fortran 输入测试。 +- [ ] 新增 `input_shell_errors` Fortran 输入测试。 +- [ ] 将 `input_shell_section` 接入 CTest。 +- [ ] 将 `input_shell_errors` 接入 CTest。 -## 阶段 C:参考邻域、修正矩阵与变形梯度状态 +## 阶段 C:Shell 状态数组、厚度积分点和默认值 -- [x] 复核 Solid 参考坐标、参考体积和参考邻域现有状态。 -- [x] 新增或补齐 Solid 每粒子参考邻居数状态。 -- [x] 新增或补齐 Solid 参考邻域退化状态。 -- [x] 新增或补齐 Solid 修正矩阵状态码。 -- [x] 新增或补齐 Solid 修正矩阵行列式诊断。 -- [x] 在 Solid reset 路径初始化参考邻域诊断状态。 -- [x] 在 Solid allocate/build 路径分配参考邻域诊断状态。 -- [x] 在 Solid clear/finalize 路径释放参考邻域诊断状态。 -- [x] 构建 active Solid 粒子的参考邻域计数。 -- [x] 在参考邻域计数中排除非 Solid 粒子污染。 -- [x] 计算 active Solid 粒子的最小参考邻居数诊断。 -- [x] 识别参考邻域不足的退化 Solid 粒子。 -- [x] 对退化参考邻域给出受控 warning 或 error。 -- [x] 构建 Solid 参考梯度矩阵或等价矩阵。 -- [x] 计算 Solid 修正矩阵行列式。 -- [x] 检查 Solid 修正矩阵有限性。 -- [x] 检查 Solid 修正矩阵近奇异状态。 -- [x] 为不可逆修正矩阵提供受控 fallback。 -- [x] 将修正矩阵质量诊断写入 Solid summary。 -- [x] 将变形梯度初始值设置为单位阵。 -- [x] 对非 active Solid 粒子设置安全变形梯度默认值。 -- [x] 新增 `solid_reference_neighbor` 测试。 -- [x] 新增 `solid_correction_matrix` 测试。 -- [x] 将 `solid_reference_neighbor` 接入 CTest。 -- [x] 将 `solid_correction_matrix` 接入 CTest。 +- [ ] 设计 Shell 粒子级状态常量和数组布局。 +- [ ] 新增或补齐 Shell thickness 状态数组。 +- [ ] 新增或补齐 Shell director 状态数组。 +- [ ] 新增或补齐 Shell omega 状态数组。 +- [ ] 新增或补齐 Shell membrane strain 状态数组。 +- [ ] 新增或补齐 Shell bending strain 状态数组。 +- [ ] 新增或补齐 Shell shear strain 状态数组。 +- [ ] 新增或补齐 Shell damage 状态数组。 +- [ ] 新增或补齐 Shell softening 状态数组。 +- [ ] 新增或补齐 Shell internal energy 状态数组。 +- [ ] 新增或补齐 Shell failure status 状态数组。 +- [ ] 设计 Shell 厚度积分点状态常量和数组布局。 +- [ ] 新增或补齐 Shell integration point count 状态数组。 +- [ ] 新增或补齐 Shell integration point coordinate 状态数组。 +- [ ] 新增或补齐 Shell integration point weight 状态数组。 +- [ ] 新增或补齐 Shell integration point stress 状态数组。 +- [ ] 新增或补齐 Shell integration point strain 状态数组。 +- [ ] 新增或补齐 Shell integration point plastic strain 状态数组。 +- [ ] 新增或补齐 Shell integration point temperature 状态数组。 +- [ ] 新增或补齐 Shell integration point damage 状态数组。 +- [ ] 新增或补齐 Shell integration point softening 状态数组。 +- [ ] 在 Shell reset 路径初始化粒子级状态。 +- [ ] 在 Shell reset 路径初始化积分点状态。 +- [ ] 在 Shell allocate/build 路径分配粒子级状态。 +- [ ] 在 Shell allocate/build 路径分配积分点状态。 +- [ ] 在 Shell clear/finalize 路径释放粒子级状态。 +- [ ] 在 Shell clear/finalize 路径释放积分点状态。 +- [ ] 初始化 active Shell 粒子的 thickness。 +- [ ] 初始化 active Shell 粒子的 integration point count。 +- [ ] 初始化 active Shell 粒子的 integration point 坐标和权重。 +- [ ] 初始化 active Shell 粒子的 damage、softening 和 failure status。 +- [ ] 对非 Shell 粒子设置安全默认 Shell 状态。 +- [ ] 新增 `shell_state_build` 测试。 +- [ ] 新增 `shell_section_integration` 测试。 +- [ ] 将 `shell_state_build` 接入 CTest。 +- [ ] 将 `shell_section_integration` 接入 CTest。 -## 阶段 D:速度梯度、应变率和运动学驱动本构 +## 阶段 D:Director、转动状态和参考面积/惯量 -- [x] 新增或补齐 Solid 速度梯度工作数组。 -- [x] 新增或补齐 Solid 应变率状态数组。 -- [x] 新增或补齐 Solid 等效应变率状态数组。 -- [x] 在 Solid reset 路径初始化速度梯度和应变率状态。 -- [x] 在 Solid allocate/build 路径分配速度梯度和应变率状态。 -- [x] 在 Solid clear/finalize 路径释放速度梯度和应变率状态。 -- [x] 实现 active Solid 粒子的速度梯度计算入口。 -- [x] 确认无 active Solid 粒子时跳过速度梯度计算。 -- [x] 确认非 Solid 粒子不污染 Solid 速度梯度。 -- [x] 实现均匀平动下速度梯度为零的路径。 -- [x] 实现单轴拉伸速度场下速度梯度计算。 -- [x] 由速度梯度计算对称应变率。 -- [x] 将应变率转换为 Voigt 顺序。 -- [x] 由应变率和 dt 更新 Solid 应变增量。 -- [x] 更新 Solid 总应变状态。 -- [x] 由应变率计算等效塑性应变率的安全默认值。 -- [x] 将变形梯度更新挂接到速度梯度路径。 -- [x] 让弹性材料点更新接受运动学应变增量。 -- [x] 让 Johnson-Cook flow 更新接受运动学应变增量。 -- [x] 让 Johnson-Cook failure 更新接受运动学应变增量。 -- [x] 保持等温退化测试下温度状态可恢复。 -- [x] 确认 damage 单调不减。 -- [x] 确认 softening 单调不增。 -- [x] 确认 `PHASE_SOLID_FAILED` 不可逆。 -- [x] 新增 `solid_velocity_gradient` 测试。 -- [x] 新增 `solid_strain_increment` 测试。 -- [x] 将 `solid_velocity_gradient` 接入 CTest。 -- [x] 将 `solid_strain_increment` 接入 CTest。 +- [ ] 设计 Shell director 初始化优先级。 +- [ ] 支持由输入或 section 相关信息设置 Shell 初始 director。 +- [ ] 支持由受控小模型参考面几何推断 Shell 初始 director。 +- [ ] 对无法推断 director 的 active Shell 粒子报 error。 +- [ ] 检查 Shell director 有限性。 +- [ ] 检查 Shell director 非零长度。 +- [ ] 对 Shell director 执行归一化。 +- [ ] 在归一化后记录 director 质量诊断。 +- [ ] 新增 Shell director 退化状态或诊断字段。 +- [ ] 新增 Shell angular velocity 状态默认值。 +- [ ] 新增 Shell angular acceleration 或等价力矩工作数组。 +- [ ] 新增 Shell rotational inertia 或等价面积/厚度惯量状态。 +- [ ] 初始化 active Shell 粒子的参考面积或等效面积。 +- [ ] 初始化 active Shell 粒子的转动惯量。 +- [ ] 对非 active Shell 粒子设置安全转动默认值。 +- [ ] 实现 Shell director 基于角速度的基础更新入口。 +- [ ] 实现 director 更新后的归一化保护。 +- [ ] 实现 Shell 转动状态有限性检查。 +- [ ] 计算 Shell 最大角速度诊断。 +- [ ] 计算 Shell director 退化数量诊断。 +- [ ] 确认无 active Shell 粒子时跳过 director 和转动更新。 +- [ ] 确认 Shell director 和转动状态不污染 Solid 粒子。 +- [ ] 新增 `shell_director_update` 测试。 +- [ ] 新增 `shell_rotation_kinematics` 测试。 +- [ ] 将 `shell_director_update` 接入 CTest。 +- [ ] 将 `shell_rotation_kinematics` 接入 CTest。 -## 阶段 E:最小 Solid 内力、softening 作用与动力学诊断 +## 阶段 E:Mindlin-Reissner 运动学和应变计算 -- [x] 复核 Solid 加速度清零和累加顺序。 -- [x] 新增或补齐 Solid 内力贡献工作数组。 -- [x] 新增或补齐 Solid 内力动量残差诊断状态。 -- [x] 新增或补齐 Solid 最大加速度诊断状态。 -- [x] 实现零应力时 Solid 内力为零。 -- [x] 实现均匀平动时 Solid 内力为零。 -- [x] 实现成对 Solid 粒子的对称内力贡献。 -- [x] 实现对称布置下均匀应力残差受控路径。 -- [x] 将 Solid 应力散度或等价力贡献累加到加速度。 -- [x] 确认 Solid 内力不污染 Water-only 算例。 -- [x] 确认 Solid 内力不污染 Gas-only 算例。 -- [x] 确认 Solid 内力不污染 Explosive-Gas-Water 算例。 -- [x] 将 softening 因子作用到应力或内力贡献。 -- [x] 确认 failed Solid 粒子不被删除。 -- [x] 确认 failed Solid 粒子质量不改变。 -- [x] 计算 Solid 总动量诊断。 -- [x] 计算 Solid 动能诊断。 -- [x] 计算 Solid 内能诊断。 -- [x] 计算 Solid 塑性功或等价内能增量诊断。 -- [x] 计算 Solid 最大 von Mises 应力诊断。 -- [x] 计算 Solid 最大应变率诊断。 -- [x] 计算 Solid 最大加速度诊断。 -- [x] 计算 Solid damage 范围诊断。 -- [x] 计算 Solid softening 范围诊断。 -- [x] 计算 Solid 内力动量残差诊断。 -- [x] 将 Solid 诊断更新挂接到显式推进流程。 -- [x] 新增 `solid_internal_force_pair` 测试。 -- [x] 新增 `solid_uniform_stress_balance` 测试。 -- [x] 新增 `solid_softening_force` 测试。 -- [x] 新增 `solid_energy_diagnostics` 测试。 -- [x] 将 `solid_internal_force_pair` 接入 CTest。 -- [x] 将 `solid_uniform_stress_balance` 接入 CTest。 -- [x] 将 `solid_softening_force` 接入 CTest。 -- [x] 将 `solid_energy_diagnostics` 接入 CTest。 +- [ ] 设计 Shell 局部坐标系或局部分量顺序。 +- [ ] 新增 Shell 局部基向量或等价工作数组。 +- [ ] 实现 Shell 局部基有限性检查。 +- [ ] 实现 Shell 刚体平动下膜应变为零的路径。 +- [ ] 实现 Shell 刚体转动下膜应变受控路径。 +- [ ] 实现 Shell 单轴拉伸膜应变计算。 +- [ ] 实现 Shell 简单剪切膜应变计算。 +- [ ] 实现 Shell 受控曲率场弯曲应变计算。 +- [ ] 实现 Shell 横向剪切应变计算。 +- [ ] 将膜应变转换为局部 `11,22,12` 顺序。 +- [ ] 将弯曲应变转换为局部 `11,22,12` 顺序。 +- [ ] 将剪切应变转换为局部 `13,23` 顺序。 +- [ ] 新增 Shell strain increment 工作数组。 +- [ ] 由 Shell 运动学计算厚度积分点应变增量。 +- [ ] 将厚度位置对弯曲应变的贡献加入积分点应变。 +- [ ] 确认未使用积分点不参与应变计算。 +- [ ] 确认非 Shell 粒子不污染 Shell 应变状态。 +- [ ] 确认 failed Shell 粒子按受控策略跳过或保持状态。 +- [ ] 新增 `shell_membrane_strain` 测试。 +- [ ] 新增 `shell_bending_strain` 测试。 +- [ ] 新增 `shell_shear_strain` 测试。 +- [ ] 将 `shell_membrane_strain` 接入 CTest。 +- [ ] 将 `shell_bending_strain` 接入 CTest。 +- [ ] 将 `shell_shear_strain` 接入 CTest。 -## 阶段 F:Solid 稳定时间步、显式推进和 0.5.0 回归隔离 +## 阶段 F:Shell 材料点、Johnson-Cook 失效和渐进软化 -- [x] 复核 0.5.0 Solid 结构波速 dt 估计。 -- [x] 新增或补齐 Solid 加速度 dt 约束诊断。 -- [x] 实现 `dt_solid_acc` 的有限正值保护。 -- [x] 将 Solid wave dt 和 acceleration dt 合并为 Solid dt。 -- [x] 将 Solid dt 继续纳入全局 dt 估计。 -- [x] 确认无 active Solid 粒子时全局 dt 与 0.5.0 路径一致。 -- [x] 确认 active Solid 粒子存在时 Solid dt 有限且为正。 -- [x] 确认体力增大时加速度 dt 约束可收紧。 -- [x] 确认内力增大时加速度 dt 约束可收紧。 -- [x] 确认 restart 后 Solid dt 诊断一致。 -- [x] 将 Solid 速度梯度、本构、内力和诊断挂接到 Velocity-Verlet 步。 -- [x] 确认 Solid-only 小模型可连续推进多步。 -- [x] 确认 Water-only smoke 仍通过。 -- [x] 确认 Gas-only smoke 仍通过。 -- [x] 确认 Explosive-Gas-Water smoke 仍通过。 -- [x] 新增 `solid_dt_acceleration` 测试。 -- [x] 更新 `solid_explicit_smoke` 覆盖 0.5.1 诊断。 -- [x] 将 `solid_dt_acceleration` 接入 CTest。 -- [x] 确认 0.5.0 `solid_stable_dt` 仍通过。 -- [x] 确认 0.5.0 `solid_explicit_smoke` 仍通过。 +- [ ] 复核 Solid Johnson-Cook 材料辅助过程的可复用边界。 +- [ ] 为 Shell 建立独立 material table 或映射状态。 +- [ ] 计算 Shell material 的弹性常数和结构波速。 +- [ ] 初始化 Shell integration point stress。 +- [ ] 初始化 Shell integration point strain。 +- [ ] 初始化 Shell integration point plastic strain。 +- [ ] 初始化 Shell integration point temperature。 +- [ ] 初始化 Shell integration point damage。 +- [ ] 初始化 Shell integration point softening。 +- [ ] 实现 Shell 积分点弹性 trial 更新。 +- [ ] 实现 Shell 局部平面应力或受控近似路径。 +- [ ] 实现 Shell Johnson-Cook flow 更新入口。 +- [ ] 实现 Shell Johnson-Cook failure strain 计算入口。 +- [ ] 实现 Shell integration point damage 单调累积。 +- [ ] 实现 Shell integration point softening 单调降低。 +- [ ] 实现 Shell 粒子级 damage 聚合。 +- [ ] 实现 Shell 粒子级 softening 聚合。 +- [ ] 实现 Shell 内能或等价塑性功增量。 +- [ ] 保持 Shell 温度状态可写入和可恢复。 +- [ ] 实现 Shell failure status 更新。 +- [ ] 实现 `PHASE_SHELL_FAILED` 不可逆切换。 +- [ ] 确认 failed Shell 粒子不被删除。 +- [ ] 确认 failed Shell 粒子质量不改变。 +- [ ] 确认 restart 后 Shell damage 不被重置。 +- [ ] 确认 restart 后 Shell softening 不被重置。 +- [ ] 新增 `shell_elastic_material` 测试。 +- [ ] 新增 `shell_johnson_cook_flow` 测试。 +- [ ] 新增 `shell_johnson_cook_failure` 测试。 +- [ ] 新增 `shell_progressive_softening` 测试。 +- [ ] 将 `shell_elastic_material` 接入 CTest。 +- [ ] 将 `shell_johnson_cook_flow` 接入 CTest。 +- [ ] 将 `shell_johnson_cook_failure` 接入 CTest。 +- [ ] 将 `shell_progressive_softening` 接入 CTest。 -## 阶段 G:CSV 输出、`STATE_0_5_1` restart 与兼容读入 +## 阶段 G:Shell 内力、内力矩、稳定时间步和显式推进 -- [x] 在 summary CSV 中追加 `solid_max_strain_rate` 字段。 -- [x] 在 summary CSV 中追加 `solid_max_acceleration` 字段。 -- [x] 在 summary CSV 中追加 `solid_internal_force_residual` 字段。 -- [x] 在 summary CSV 中追加 `solid_reference_neighbor_min` 字段。 -- [x] 在 summary CSV 中追加 `solid_correction_det_min` 字段。 -- [x] 在 summary CSV 中追加 `solid_correction_status` 字段。 -- [x] 在粒子 CSV 中追加 `solid_strain_rate_eq` 字段。 -- [x] 在粒子 CSV 中追加 `solid_acceleration_norm` 字段。 -- [x] 在粒子 CSV 中追加 `solid_reference_neighbor_count` 字段。 -- [x] 在粒子 CSV 中追加 `solid_correction_status` 字段。 -- [x] 更新 output 测试锁定 0.5.1 CSV header。 -- [x] 将 restart 状态版本更新为 `STATE_0_5_1`。 -- [x] 将 Solid 参考邻居数写入 0.5.1 restart。 -- [x] 将 Solid 修正矩阵状态写入 0.5.1 restart。 -- [x] 将 Solid 修正矩阵行列式诊断写入 0.5.1 restart。 -- [x] 将 Solid 变形梯度写入 0.5.1 restart。 -- [x] 将 Solid 应变率状态写入 0.5.1 restart。 -- [x] 将 Solid 0.5.1 新增诊断写入 restart。 -- [x] 从 `STATE_0_5_1` restart 读回新增 Solid 状态。 -- [x] 从 `STATE_0_5_1` restart 读回后继续显式步。 -- [x] 从 `STATE_0_5` restart 兼容读入 Solid 0.5.0 状态。 -- [x] 从 `STATE_0_5` restart 读入时初始化 0.5.1 新状态。 -- [x] 从 `STATE_0_4_1` restart 读入时初始化空 Solid 0.5.1 状态。 -- [x] 确认 restart 后不重复初始化 Solid 应力。 -- [x] 确认 restart 后不重复初始化 Solid 塑性应变。 -- [x] 确认 restart 后不重复初始化 Solid damage。 -- [x] 确认 restart 后不重复初始化 Solid softening。 -- [x] 确认 restart 后不重复初始化 Solid 变形梯度。 -- [x] 新增 `solid_restart_051` 测试。 -- [x] 新增 `solid_restart_050_compat` 测试。 -- [x] 将 `solid_restart_051` 接入 CTest。 -- [x] 将 `solid_restart_050_compat` 接入 CTest。 +- [ ] 新增 Shell 内力贡献工作数组。 +- [ ] 新增 Shell 内力矩贡献工作数组。 +- [ ] 新增 Shell internal force residual 诊断状态。 +- [ ] 新增 Shell internal moment residual 诊断状态。 +- [ ] 新增 Shell 最大加速度诊断状态。 +- [ ] 新增 Shell 最大角加速度或力矩诊断状态。 +- [ ] 实现零应力时 Shell 内力为零。 +- [ ] 实现零弯矩时 Shell 内力矩为零。 +- [ ] 实现刚体平动时 Shell 内力为零。 +- [ ] 实现刚体转动受控小模型下力矩有限路径。 +- [ ] 实现膜力对平动加速度的最小贡献路径。 +- [ ] 实现弯曲力矩对转动状态的最小贡献路径。 +- [ ] 实现横向剪切贡献的受控路径或明确跳过策略。 +- [ ] 将 Shell softening 作用到内力或应力结果量。 +- [ ] 确认 Shell 内力不污染 Water-only 算例。 +- [ ] 确认 Shell 内力不污染 Gas-only 算例。 +- [ ] 确认 Shell 内力不污染 Explosive-Gas-Water 算例。 +- [ ] 确认 Shell 内力不污染 Solid-only 算例。 +- [ ] 计算 Shell 总质量诊断。 +- [ ] 计算 Shell 总动量诊断。 +- [ ] 计算 Shell 转动诊断或角速度最大值。 +- [ ] 计算 Shell 动能诊断。 +- [ ] 计算 Shell 内能诊断。 +- [ ] 计算 Shell 最大膜应变诊断。 +- [ ] 计算 Shell 最大弯曲应变诊断。 +- [ ] 计算 Shell 最大剪切应变诊断。 +- [ ] 计算 Shell 最大 von Mises 或等效应力诊断。 +- [ ] 计算 Shell damage 范围诊断。 +- [ ] 计算 Shell softening 范围诊断。 +- [ ] 实现 `dt_shell_wave` 估计。 +- [ ] 实现 `dt_shell_rot` 估计。 +- [ ] 实现 `dt_shell_acc` 估计。 +- [ ] 将 Shell dt 合并为 Shell dtcrit。 +- [ ] 将 Shell dt 纳入全局 dt 估计。 +- [ ] 确认无 active Shell 时全局 dt 与 0.5.1 路径一致。 +- [ ] 将 Shell 运动学、材料更新、内力和诊断挂接到 Velocity-Verlet 步。 +- [ ] 确认 Shell-only 小模型可连续推进多步。 +- [ ] 新增 `shell_internal_force_smoke` 测试。 +- [ ] 新增 `shell_stable_dt` 测试。 +- [ ] 新增 `shell_explicit_smoke` 测试。 +- [ ] 将 `shell_internal_force_smoke` 接入 CTest。 +- [ ] 将 `shell_stable_dt` 接入 CTest。 +- [ ] 将 `shell_explicit_smoke` 接入 CTest。 -## 阶段 H:Fortran API、C ABI、C++、Python 与 CLI +## 阶段 H:CSV 输出、`STATE_0_6` restart 与兼容读入 -- [x] 新增 `sph_get_solid_state` Fortran API。 -- [x] 新增 `sph_get_solid_diagnostics` Fortran API。 -- [x] 新增 `sph_get_solid_reference_quality` Fortran API。 -- [x] 为 Solid 0.5.1 Fortran API 补齐未初始化错误路径。 -- [x] 为 Solid 0.5.1 Fortran API 补齐小容量错误路径。 -- [x] 在 C 头文件中声明 `sphlite_get_solid_particle_state`。 -- [x] 在 C ABI 中实现 Solid 粒子级状态查询。 -- [x] 在 C ABI 中校验空指针错误路径。 -- [x] 在 C ABI 中校验非正容量错误路径。 -- [x] 在 C ABI 中校验小容量错误路径。 -- [x] 在 C ABI 中锁定 stress 展开顺序。 -- [x] 在 C ABI 中锁定 strain 展开顺序。 -- [x] 在 C ABI 中锁定 strain-rate 展开顺序。 -- [x] 在 C API 测试中覆盖 Solid 粒子级状态查询。 -- [x] 在 C API 测试中覆盖 Solid 0.5.1 错误路径。 -- [x] 在 C++ wrapper 中新增 Solid particle state 薄包装。 -- [x] 在 C++ API 测试中覆盖 Solid particle state 薄包装。 -- [x] 在 Python ctypes 中新增 Solid particle state 薄包装。 -- [x] 在 Python inspect 中追加 Solid 0.5.1 诊断字段。 -- [x] 在 Python run/checker 中覆盖 Solid 0.5.1 小模型。 -- [x] 在 Python checker 中覆盖 `STATE_0_5_1` restart 读回。 -- [x] 在 Python checker 中覆盖 `STATE_0_5` restart 兼容读入。 -- [x] 在 CLI inspect 中追加 `solid_max_strain_rate` 字段。 -- [x] 在 CLI inspect 中追加 `solid_max_acceleration` 字段。 -- [x] 在 CLI inspect 中追加 `solid_internal_force_residual` 字段。 -- [x] 在 CLI inspect 中追加 `solid_correction_status` 字段。 -- [x] 在 CLI inspect 中追加 `solid_reference_neighbor_min` 字段。 -- [x] 在 CLI run 中追加 Solid 0.5.1 诊断字段。 -- [x] 在 CLI checker 中覆盖 Solid 0.5.1 输入、run 和 restart。 -- [x] 确认新增 API 不改变 0.5.0 已有接口语义。 -- [x] 新增 `solid_state_api` 测试并接入 CTest。 -- [x] 新增 `solid_python_051` 测试并接入 CTest。 -- [x] 新增 `solid_cli_051` 测试并接入 CTest。 +- [ ] 在 summary CSV 中追加 `shell_particles` 字段。 +- [ ] 在 summary CSV 中追加 `shell_failed_particles` 字段。 +- [ ] 在 summary CSV 中追加 `shell_mass` 字段。 +- [ ] 在 summary CSV 中追加 `shell_momentum` 字段。 +- [ ] 在 summary CSV 中追加 `shell_kinetic_energy` 字段。 +- [ ] 在 summary CSV 中追加 `shell_internal_energy` 字段。 +- [ ] 在 summary CSV 中追加 `shell_max_membrane_strain` 字段。 +- [ ] 在 summary CSV 中追加 `shell_max_bending_strain` 字段。 +- [ ] 在 summary CSV 中追加 `shell_max_shear_strain` 字段。 +- [ ] 在 summary CSV 中追加 `shell_max_von_mises` 字段。 +- [ ] 在 summary CSV 中追加 `shell_damage_min` 字段。 +- [ ] 在 summary CSV 中追加 `shell_damage_max` 字段。 +- [ ] 在 summary CSV 中追加 `shell_softening_min` 字段。 +- [ ] 在 summary CSV 中追加 `shell_softening_max` 字段。 +- [ ] 在 summary CSV 中追加 `shell_dt_wave` 字段。 +- [ ] 在 summary CSV 中追加 `shell_dt_rot` 字段。 +- [ ] 在 summary CSV 中追加 `shell_dt_accel` 字段。 +- [ ] 在 summary CSV 中追加 `shell_dtcrit` 字段。 +- [ ] 在粒子 CSV 中追加 `shell_thickness` 字段。 +- [ ] 在粒子 CSV 中追加 `shell_director_x` 字段。 +- [ ] 在粒子 CSV 中追加 `shell_director_y` 字段。 +- [ ] 在粒子 CSV 中追加 `shell_director_z` 字段。 +- [ ] 在粒子 CSV 中追加 `shell_omega_norm` 字段。 +- [ ] 在粒子 CSV 中追加 `shell_damage` 字段。 +- [ ] 在粒子 CSV 中追加 `shell_softening` 字段。 +- [ ] 在粒子 CSV 中追加 `shell_failure_status` 字段。 +- [ ] 更新 output 测试锁定 0.6.0 CSV header。 +- [ ] 将 restart 状态版本更新为 `STATE_0_6`。 +- [ ] 将 Shell 粒子级状态写入 0.6.0 restart。 +- [ ] 将 Shell 积分点状态写入 0.6.0 restart。 +- [ ] 将 Shell material/section 映射写入或恢复到 0.6.0 restart。 +- [ ] 将 Shell 诊断和 dt 状态写入 0.6.0 restart。 +- [ ] 从 `STATE_0_6` restart 读回 Shell 粒子级状态。 +- [ ] 从 `STATE_0_6` restart 读回 Shell 积分点状态。 +- [ ] 从 `STATE_0_6` restart 读回后继续显式步。 +- [ ] 从 `STATE_0_5_1` restart 兼容读入并初始化空 Shell 状态。 +- [ ] 从 `STATE_0_5` restart 兼容读入并初始化空 Shell 状态。 +- [ ] 从更早可支持 restart 读入时初始化空 Shell 状态。 +- [ ] 确认 restart 后不重复初始化 Shell thickness。 +- [ ] 确认 restart 后不重复初始化 Shell director。 +- [ ] 确认 restart 后不重复初始化 Shell omega。 +- [ ] 确认 restart 后不重复初始化 Shell 积分点状态。 +- [ ] 确认 restart 后不重复初始化 Shell damage。 +- [ ] 确认 restart 后不重复初始化 Shell softening。 +- [ ] 确认 restart 后不重复初始化 Shell failure status。 +- [ ] 新增 `shell_output` 测试。 +- [ ] 新增 `shell_restart_060` 测试。 +- [ ] 新增 `shell_restart_051_compat` 测试。 +- [ ] 将 `shell_output` 接入 CTest。 +- [ ] 将 `shell_restart_060` 接入 CTest。 +- [ ] 将 `shell_restart_051_compat` 接入 CTest。 -## 阶段 I:源码尺寸、回归门禁、文档同步与发布准备 +## 阶段 I:Fortran API、C ABI、C++、Python 与 CLI -- [x] 新增 `solid_051_source_size` 检查项并接入 CTest。 -- [x] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。 -- [x] 拆分过大的 Solid reference 源文件或过长过程。 -- [x] 拆分过大的 Solid kinematics 源文件或过长过程。 -- [x] 拆分过大的 Solid force 源文件或过长过程。 -- [x] 拆分过大的 Solid restart 源文件或过长过程。 -- [x] 保持 0.5.0 完整 gate 全部通过。 -- [x] 单独运行 0.5.0 Solid 专项 gate。 -- [x] 单独运行 0.5.1 Solid 专项 gate。 -- [x] 运行 `source_size` 检查并确认无新增无理由例外。 -- [x] 运行 `git diff --check` 并清理空白问题。 -- [x] 更新 README 的 0.5.1 当前状态和不交付范围。 -- [x] 更新 06 号文档的 0.5.1 release gate。 -- [x] 更新 09 号文档的 0.5.1 验收记录占位。 -- [x] 更新 11 号文档的 0.5.1 benchmark/gate 矩阵。 -- [x] 确认文档不宣称已实现 `Shell`。 -- [x] 确认文档不宣称已实现真实水-气-结构工程爆炸响应。 -- [x] 确认文档不宣称已实现真实 FEM-SPH 耦合。 -- [x] 确认文档不宣称已实现工程级结构破坏 benchmark。 -- [x] 确认未新增几何、网格或粒子生成能力。 -- [x] 确认未新增 FEMLite 直接依赖。 -- [x] 确认未修改 SPHLite 文件夹之外的内容。 -- [x] 确认默认 gate、0.5.0 Solid gate、0.5.1 Solid gate、source size 和 `git diff --check` 全部通过。 -- [x] 汇总 0.5.1 已完成能力、未交付范围和已知限制。 -- [x] 准备 0.5.1 发布前本地提交记录。 +- [ ] 新增 `sph_get_shell_counts` Fortran API。 +- [ ] 新增 `sph_get_shell_summary` Fortran API。 +- [ ] 新增 `sph_get_shell_state` Fortran API。 +- [ ] 新增 `sph_get_shell_integration_state` Fortran API。 +- [ ] 新增 `sph_get_shell_dt_limits` Fortran API。 +- [ ] 为 Shell Fortran API 补齐未初始化错误路径。 +- [ ] 为 Shell Fortran API 补齐未 build 错误路径。 +- [ ] 为 Shell Fortran API 补齐小容量错误路径。 +- [ ] 在 C 头文件中声明 Shell summary 查询函数。 +- [ ] 在 C 头文件中声明 Shell particle state 查询函数。 +- [ ] 在 C 头文件中声明 Shell integration state 查询函数。 +- [ ] 在 C ABI 中实现 Shell summary 查询。 +- [ ] 在 C ABI 中实现 Shell particle state 查询。 +- [ ] 在 C ABI 中实现 Shell integration state 查询。 +- [ ] 在 C ABI 中校验 Shell API 空指针错误路径。 +- [ ] 在 C ABI 中校验 Shell API 非正容量错误路径。 +- [ ] 在 C ABI 中校验 Shell API 小容量错误路径。 +- [ ] 在 C ABI 中锁定 Shell particle state 展开顺序。 +- [ ] 在 C ABI 中锁定 Shell integration state 展开顺序。 +- [ ] 在 C API 测试中覆盖 Shell summary 查询。 +- [ ] 在 C API 测试中覆盖 Shell particle state 查询。 +- [ ] 在 C API 测试中覆盖 Shell integration state 查询。 +- [ ] 在 C++ wrapper 中新增 Shell summary 薄包装。 +- [ ] 在 C++ wrapper 中新增 Shell particle state 薄包装。 +- [ ] 在 C++ wrapper 中新增 Shell integration state 薄包装。 +- [ ] 在 C++ API 测试中覆盖 Shell wrapper。 +- [ ] 在 Python ctypes 中新增 Shell summary 薄包装。 +- [ ] 在 Python ctypes 中新增 Shell particle state 薄包装。 +- [ ] 在 Python ctypes 中新增 Shell integration state 薄包装。 +- [ ] 在 Python inspect 中追加 Shell 0.6.0 诊断字段。 +- [ ] 在 Python checker 中覆盖 Shell 0.6.0 小模型。 +- [ ] 在 Python checker 中覆盖 `STATE_0_6` restart 读回。 +- [ ] 在 Python checker 中覆盖 `STATE_0_5_1` restart 兼容读入。 +- [ ] 在 CLI inspect 中追加 `shell_particles` 字段。 +- [ ] 在 CLI inspect 中追加 `shell_failed_particles` 字段。 +- [ ] 在 CLI inspect 中追加 `shell_mass` 字段。 +- [ ] 在 CLI inspect 中追加 `shell_max_membrane_strain` 字段。 +- [ ] 在 CLI inspect 中追加 `shell_max_bending_strain` 字段。 +- [ ] 在 CLI inspect 中追加 `shell_max_shear_strain` 字段。 +- [ ] 在 CLI inspect 中追加 `shell_max_von_mises` 字段。 +- [ ] 在 CLI inspect 中追加 `shell_damage_range` 字段。 +- [ ] 在 CLI inspect 中追加 `shell_softening_range` 字段。 +- [ ] 在 CLI inspect 中追加 `shell_dt_limits` 字段。 +- [ ] 在 CLI checker 中覆盖 Shell inspect、run 和 restart。 +- [ ] 确认新增 Shell API 不改变既有 Water/Gas/Explosive/Solid 接口语义。 +- [ ] 新增 `shell_api` 测试并接入 CTest。 +- [ ] 新增 `shell_c_api` 测试并接入 CTest。 +- [ ] 新增 `shell_python` 测试并接入 CTest。 +- [ ] 新增 `shell_cli` 测试并接入 CTest。 + +## 阶段 J:源码尺寸、回归门禁、文档同步与发布准备 + +- [ ] 新增 `shell_source_size` 检查项并接入 CTest。 +- [ ] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。 +- [ ] 拆分过大的 Shell state 源文件或过长过程。 +- [ ] 拆分过大的 Shell section 源文件或过长过程。 +- [ ] 拆分过大的 Shell kinematics 源文件或过长过程。 +- [ ] 拆分过大的 Shell material 源文件或过长过程。 +- [ ] 拆分过大的 Shell force 源文件或过长过程。 +- [ ] 拆分过大的 Shell restart 源文件或过长过程。 +- [ ] 拆分过大的 Shell API 源文件或过长过程。 +- [ ] 保持 0.5.1 完整 gate 全部通过。 +- [ ] 单独运行 0.5.0 Solid 专项 gate。 +- [ ] 单独运行 0.5.1 Solid 专项 gate。 +- [ ] 单独运行 0.6.0 Shell 专项 gate。 +- [ ] 运行 `source_size` 检查并确认无新增无理由例外。 +- [ ] 运行 `git diff --check` 并清理空白问题。 +- [ ] 更新 README 的 0.6.0 当前状态和不交付范围。 +- [ ] 更新 06 号文档的 0.6.0 release gate。 +- [ ] 更新 09 号文档的 0.6.0 验收记录占位。 +- [ ] 更新 11 号文档的 0.6.0 benchmark/gate 矩阵。 +- [ ] 确认文档不宣称已实现真实水-气-结构工程爆炸响应。 +- [ ] 确认文档不宣称已实现真实 FEM-SPH 耦合。 +- [ ] 确认文档不宣称已实现工程级结构破坏 benchmark。 +- [ ] 确认文档不宣称已实现完整板壳撕裂路径追踪。 +- [ ] 确认文档不宣称已实现穿孔判据库或碎片云。 +- [ ] 确认未新增壳-实体连接或局部壳/实体混合结构连接算法。 +- [ ] 确认未新增几何、网格或粒子生成能力。 +- [ ] 确认未新增 FEMLite 直接依赖。 +- [ ] 确认未修改 SPHLite 文件夹之外的内容。 +- [ ] 确认默认 gate、0.5.1 回归 gate、0.6.0 Shell gate、source size 和 `git diff --check` 全部通过。 +- [ ] 汇总 0.6.0 已完成能力、未交付范围和已知限制。 +- [ ] 准备 0.6.0 发布前本地提交记录。 diff --git a/tools/testing/test_cli.py b/tools/testing/test_cli.py index 1676105..62994e4 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.5.1" not in version.stdout: + if "0.6.0" not in version.stdout: raise AssertionError("CLI version mismatch") inspect = run_command([exe, model]) @@ -127,7 +127,7 @@ def main() -> int: ): require_field(inspect.stdout, field) inspect_fields = read_fields(inspect.stdout) - if inspect_fields["version"] != "0.5.1": + if inspect_fields["version"] != "0.6.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 56aa701..8e0021d 100644 --- a/tools/testing/test_python_debug.py +++ b/tools/testing/test_python_debug.py @@ -71,7 +71,7 @@ def main() -> int: raise AssertionError("Python wrapper is missing Solid particle state C ABI") if not hasattr(solver.lib, "sphlite_get_solid_diagnostics"): raise AssertionError("Python wrapper is missing Solid 0.5.1 diagnostics C ABI") - if solver.version() != (0, 5, 1): + if solver.version() != (0, 6, 0): raise AssertionError("Python version mismatch") solver.initialize()