diff --git a/CMakeLists.txt b/CMakeLists.txt index eef1070..39c27e8 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,6 +1,6 @@ cmake_minimum_required(VERSION 3.20) -project(SPHLite VERSION 0.6.0 LANGUAGES C CXX Fortran) +project(SPHLite VERSION 0.6.1 LANGUAGES C CXX Fortran) set(CMAKE_C_STANDARD 99) set(CMAKE_C_STANDARD_REQUIRED ON) diff --git a/README.md b/README.md index c4589e3..e863e50 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。 -当前发布版本:0.6.0。该版本定位为 `Shell` 板壳粒子输入与状态基线版本,在 0.5.1 已完成 `Solid` 3D 实体结构粒子稳定化和结构算法加固的基础上,建立 Shell material/section 输入、厚度/积分点/剪切修正校验、粒子级状态数组、厚度积分点状态数组和小型输入 gate。不交付完整 Shell 动力学闭环、真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行或工程级船舱破坏 benchmark。 +当前开发版本:0.6.1。该版本定位为 `Shell` director、转动状态、参考面积/惯量、局部坐标系和 Mindlin-Reissner 小变形运动学基线版本,在 0.6.0 已发布的 Shell 输入与状态基线之上推进。不交付 Shell 材料点更新、Shell 内力、Shell 内力矩、完整显式推进生产路径、Shell restart、公开 C ABI/C++/Python/CLI 诊断字段、真实水-气-结构工程爆炸响应或真实 FEM-SPH 联合运行。 代码仓库地址: @@ -63,7 +63,7 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: ## 当前状态 -0.6.0 当前以 0.5.1 `Solid` 稳定化发布基线为起点,完成 `Shell` 板壳粒子输入与状态基线。0.5.0 以来已完成内容主要包括: +0.6.1 当前以 0.6.0 `Shell` 输入与状态基线发布版本为起点,进入 `Shell` director、局部坐标和小变形运动学开发。0.5.0 以来已完成内容主要包括: - CMake/CTest 工程骨架和 Fortran 95 核心库。 - C ABI、C++ 头文件薄包装和 Python `ctypes` 调试入口。 @@ -86,6 +86,8 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: - 0.6.0 新增 Shell material/section 输入、厚度/3 点和 5 点积分、剪切修正、Shell material 错误路径、未绑定 Shell material warning 和 active Shell 缺失 Shell section error。 - 0.6.0 新增 Shell 粒子级状态数组、厚度积分点状态数组、active Shell 默认初始化、非 Shell 安全默认值和 3/5 点厚度积分规则。 - `Shell` 在 0.6.0 只交付输入与状态基线,不交付 director/转动更新、Mindlin-Reissner 应变路径、Shell 材料点更新、内力、显式推进、restart、公开 API 或生产计算路径。 +- 0.6.1 进入 Shell director 输入/推断、局部基、角速度、参考面积/惯量和 Mindlin-Reissner 小变形运动学开发。 +- `Shell` 在 0.6.1 仍不交付材料点更新、内力、显式推进、restart、公开接口或生产计算路径。 - 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` 通过。 - 0.6.0 本地 gate 已通过:完整 CTest 103/103,Shell 输入/状态基线专项 gate 4/4,`source_size` 1/1,`git diff --check` 通过。 diff --git a/docs/v6.1_development_plan.md b/docs/v6.1_development_plan.md new file mode 100644 index 0000000..d35d7e1 --- /dev/null +++ b/docs/v6.1_development_plan.md @@ -0,0 +1,477 @@ +# SPHLite v6.1 开发计划 + +文档状态:0.6.1 开发计划草案 + +目标软件版本:SPHLite 0.6.1 + +## 1. 文档定位 + +本文档用于规划 SPHLite 0.6.1 版本的开发范围。0.6.1 继续沿 0.6 `Shell` 板壳粒子版本线推进,在 0.6.0 已完成 Shell material/section 输入、厚度积分规则、粒子级状态数组和厚度积分点状态数组的基础上,建立 Shell director、转动状态、参考面积/惯量、局部坐标系和 Mindlin-Reissner 小变形运动学的可验证基线。 + +0.6.1 不作为完整 Shell 结构动力学闭环版本,不交付 Shell 材料点更新、Shell 内力、Shell 内力矩、显式推进生产路径、Shell restart、公开 C ABI 或工程级船舶水下爆炸响应。0.6.1 的重点是让 0.6.0 已建立的 Shell 状态从“可分配、可初始化”推进到“可描述 director、局部转动和板壳应变局部量”,为后续 Shell 材料点、失效、内力和显式推进版本提供稳定运动学基础。 + +## 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.1 以已发布的 0.6.0 Shell 输入与状态基线版本为开发基线。 + +## 3. 版本定位 + +### 3.1 与 0.6.0 的关系 + +0.6.0 已完成以下 Shell 基线能力: + +- `TYPE=SHELL` material 识别。 +- `*SHELL SECTION` 输入解析。 +- Shell section 的厚度、3 点/5 点厚度积分和剪切修正校验。 +- Shell material 密度、弹性、Johnson-Cook flow/failure 和 softening 输入校验。 +- Shell 粒子级状态数组,包括 thickness、director、omega、膜应变、弯曲应变、剪切应变、damage、softening、内能和失效状态。 +- Shell 厚度积分点状态数组,包括积分点坐标、权重、应力、应变、塑性应变、温度、damage 和 softening。 +- `input_shell_section`、`input_shell_errors`、`shell_state_build` 和 `shell_section_integration` 专项 gate。 + +0.6.1 不重写 0.6.0 输入和状态基线。0.6.1 应保持 0.6.0 完整 gate 稳定,并在已有 Shell 状态数组之上补全 director 初始化、几何质量诊断、转动状态和小变形运动学。 + +### 3.2 与 0.6.2 的关系 + +0.6.2 建议作为 Shell 材料点和失效基线版本。0.6.1 不实现 Shell Johnson-Cook 材料点更新、积分点 damage 累积、softening 演化或 `PHASE_SHELL_FAILED` 生产路径。0.6.1 只应提供 0.6.2 所需的应变增量、厚度积分点应变状态和局部壳分量顺序。 + +### 3.3 与 0.7.0 的关系 + +0.7.0 建议作为水-气-结构局部爆炸 smoke 的起点。0.6.1 不实现 Water/Gas/Explosive 对 Shell 的真实爆炸载荷闭环,也不实现舱段破坏工程算例。0.6.1 的 Shell 运动学诊断可为后续载荷施加提供可观测状态,但不能宣传为水下爆炸结构响应能力。 + +### 3.4 与耦合版本的关系 + +真实 FEM-SPH 接触耦合和连续体耦合仍属于后续 0.8/0.9。0.6.1 只维护 SPHLite 内部 Shell director、局部坐标和应变状态,不直接依赖 FEMLite,不修改 FEMLite,也不引入外部 CouplingModule 作为依赖。 + +### 3.5 0.6.1 核心目标 + +0.6.1 的核心目标是建立 Shell 运动学基线: + +```text +0.6.0 Shell input and state baseline + -> Shell director initialization and validation + -> reference area and rotational inertia placeholders + -> local tangent frame construction + -> angular velocity and director update entry + -> Mindlin-Reissner small-strain membrane, bending and shear measures + -> through-thickness integration-point strain increment mapping + -> Shell kinematics diagnostics and focused CTest gate +``` + +## 4. 开发原则 + +### 4.1 保持求解器定位 + +SPHLite 仍是求解器,不负责几何建模、网格或粒子生成。0.6.1 可从输入中的节点、单元、section 和 orientation 子集推断 Shell director、参考面积和局部基,但不得新增几何生成或自动粒子生成功能。 + +### 4.2 复用 Abaqus 子集优先 + +0.6.1 如需显式给定 Shell director 或局部方向,应优先复用 Abaqus 可表达的关键词子集,例如 `*ORIENTATION` 或 section 上的 orientation 引用。只有 Abaqus 子集无法表达测试所需调试信息时,才允许使用 `*SPHLITE ...` 扩展关键词,并且必须标注为 SPHLite 调试扩展,不替代 Abaqus 风格输入主线。 + +### 4.3 保持 Fortran 95 和集中型数据管理 + +核心实现继续使用 Fortran 95。Shell 新增状态应纳入现有集中数据库或 Shell 模块状态管理,不采用面向对象粒子类设计。新增过程应控制文件和过程大小,必要时将 Shell 几何、运动学和诊断拆分到独立 Fortran 模块。 + +### 4.4 保持显式动力学主流程 + +时间推进继续只支持 Velocity-Verlet 显式动力学。0.6.1 可建立 director 更新入口和转动状态工作数组,但不交付完整 Shell 显式推进生产路径,不引入隐式求解、静力求解或非线性静力求解接口。 + +### 4.5 小型可测优先 + +Shell director、局部坐标系和 Mindlin-Reissner 局部量必须先通过小型、可重复测试验收。0.6.1 不追求复杂壳单元刚度、真实断裂、穿孔、接触或工程舱段破坏,只要求运动学状态方向、量级、有限性和非 Shell 安全默认值可测。 + +### 4.6 Shell 与 Solid 分离 + +`Solid` 和 `Shell` 分别处理实体结构粒子和板壳结构粒子。0.6.1 可以参考 Solid 的质量诊断、有限性检查和 source size 拆分经验,但不得将 Shell 粒子伪装为 Solid 粒子,也不得改变 0.5.1 Solid gate 的结果。 + +## 5. 0.6.1 交付目标 + +0.6.1 建议交付以下内容: + +1. 将软件版本更新为 `0.6.1`。 +2. 保持 0.6.0 完整 gate 全部通过。 +3. 明确 Shell director 初始化优先级。 +4. 支持从受控输入信息给定 Shell 初始 director 或局部 orientation。 +5. 支持从受控 Shell 参考面几何推断初始 director。 +6. 对无法推断 director 的 active Shell 粒子报 error。 +7. 检查 Shell director 有限性、非零长度和归一化质量。 +8. 新增 Shell director 退化数量、最大归一化偏差或等价质量诊断。 +9. 初始化 active Shell 粒子的参考面积或等效面积。 +10. 初始化 active Shell 粒子的转动惯量或等价面积/厚度惯量状态。 +11. 初始化 Shell angular velocity、angular acceleration 或等价力矩工作数组。 +12. 对非 Shell 粒子设置安全的 director、转动、面积和惯量默认值。 +13. 实现 Shell director 基于角速度的基础更新入口。 +14. 实现 director 更新后的归一化保护和有限性检查。 +15. 建立 Shell 局部切向基向量和局部分量顺序。 +16. 建立 Shell 局部基有限性、正交性和退化诊断。 +17. 实现刚体平动下膜应变为零的受控路径。 +18. 实现单轴拉伸和简单剪切下的膜应变计算。 +19. 实现受控曲率场下的弯曲应变计算。 +20. 实现受控横向剪切下的剪切应变计算。 +21. 将膜应变映射到局部 `11,22,12` 顺序。 +22. 将弯曲应变映射到局部 `11,22,12` 顺序。 +23. 将横向剪切应变映射到局部 `13,23` 顺序。 +24. 建立 Shell strain increment 工作数组。 +25. 将中面膜应变、弯曲应变和厚度坐标组合为厚度积分点应变增量。 +26. 确认未使用积分点不参与应变计算。 +27. 确认 failed Shell 粒子按受控策略跳过或保持状态。 +28. 确认 Shell 运动学路径不污染 Water/Gas/Explosive/Solid 粒子。 +29. 新增 Shell 0.6.1 专项 CTest gate。 +30. 更新 README、06、09 和 11 号文档中的 0.6.1 测试、验收和不交付范围。 +31. 不新增 FEMLite 直接依赖,不修改 SPHLite 文件夹之外的内容。 + +## 6. 非交付范围 + +0.6.1 不交付以下内容: + +1. 不交付完整 Shell 结构动力学闭环。 +2. 不交付 Shell Johnson-Cook 材料点更新。 +3. 不交付 Shell damage 累积、渐进 softening 演化或真实撕裂路径。 +4. 不交付 Shell 内力、内力矩或稳定时间步生产路径。 +5. 不将 Shell 接入完整 Velocity-Verlet 显式推进。 +6. 不交付 Shell output CSV 字段的生产级格式扩展,除非只作为测试诊断。 +7. 不交付 Shell restart 或 `STATE_0_6_1` 正式读写。 +8. 不交付 Shell C ABI、C++ wrapper、Python ctypes 或 CLI 公开诊断字段。 +9. 不交付真实水-气-结构工程爆炸响应。 +10. 不交付真实 FEM-SPH 接触耦合或连续体耦合。 +11. 不交付板壳穿孔、裂纹扩展、碎片云、焊缝失效库或壳-实体连接算法。 +12. 不新增几何、网格或粒子生成能力。 +13. 不实现大规模并行、GPU 后端或性能优化版本。 + +## 7. 输入、director 和局部方向 + +### 7.1 Director 初始化优先级 + +0.6.1 建议采用以下 Shell director 初始化优先级: + +1. 显式 orientation 或 director 输入。 +2. Shell section 引用的 orientation。 +3. 受控 Shell 参考面几何推断出的面法向。 +4. 无法安全推断时对 active Shell 粒子报 error。 + +不建议为 active Shell 粒子使用全局固定默认 director 作为生产路径。全局默认值可用于非 Shell 粒子的安全默认状态,或用于没有 active Shell 粒子的空模型路径。 + +### 7.2 Abaqus 子集约束 + +若实现 orientation 输入,0.6.1 应先支持受控、明确的小子集: + +- orientation 名称解析。 +- section 对 orientation 的引用。 +- 可归一化的方向向量或局部切向基。 +- 非有限向量、零向量和平行退化向量 error。 +- 未被 active Shell 使用的 orientation 可 warning。 + +0.6.1 不追求完整 Abaqus orientation 兼容,不支持复杂坐标系、随场变量变化的 orientation 或用户子程序。 + +### 7.3 几何推断边界 + +Shell 是 2D 几何,通过 section 识别厚度和板壳属性。0.6.1 可从输入中的受控三角形或四边形 Shell 面片推断: + +- 粒子所属参考面。 +- 参考面法向。 +- 局部切向方向。 +- 粒子参考面积或等效面积。 + +该推断只服务于求解器状态构建和小型测试,不是几何生成器。输入仍必须显式给出节点和元素,SPHLite 不生成新的几何或粒子。 + +## 8. Shell 几何状态设计 + +### 8.1 Director 状态 + +0.6.1 沿用 0.6.0 已建立的: + +```fortran +real(rk), allocatable :: shell_director(:,:) +real(rk), allocatable :: shell_omega(:,:) +``` + +建议补充或确认以下状态: + +```fortran +real(rk), allocatable :: shell_alpha(:,:) +real(rk), allocatable :: shell_reference_area(:) +real(rk), allocatable :: shell_rotational_inertia(:) +integer, allocatable :: shell_director_status(:) +``` + +其中: + +- `shell_alpha(3,npart)` 表示角加速度或等价转动工作量。 +- `shell_reference_area(npart)` 表示参考中面面积或等效面积。 +- `shell_rotational_inertia(npart)` 第一版可使用质量、厚度和面积推导的等效标量惯量。 +- `shell_director_status(npart)` 记录正常、由输入给定、由几何推断或退化状态。 + +### 8.2 局部坐标状态 + +0.6.1 建议建立局部基向量工作数组或持久数组: + +```fortran +real(rk), allocatable :: shell_local_e1(:,:) +real(rk), allocatable :: shell_local_e2(:,:) +real(rk), allocatable :: shell_local_e3(:,:) +integer, allocatable :: shell_local_frame_status(:) +``` + +约定: + +- `e3` 与 director 一致。 +- `e1` 和 `e2` 位于 Shell 中面切向平面。 +- `e1, e2, e3` 应构成右手正交基。 +- 局部基只用于 Shell 运动学、诊断和后续材料点分量映射,不改变数据库中的全局坐标。 + +### 8.3 参考面积和惯量 + +0.6.1 的参考面积和转动惯量先作为小型测试和后续内力版本的基础状态: + +- 对 active Shell 粒子必须为非负有限值。 +- 对参与运动学或转动测试的 active Shell 粒子应为正值。 +- 非 active Shell 粒子可为 0。 +- 质量为非正、厚度为非正或面积退化时应报 error 或设置退化诊断,不得静默进入运动学计算。 + +## 9. Shell 转动运动学 + +### 9.1 角速度状态 + +0.6.1 将 `shell_omega` 作为 Shell 局部转动状态的第一入口。默认值为 0。测试中可通过受控初始化或内部辅助过程设置角速度,不要求在 0.6.1 暴露 C ABI 或 CLI 设置接口。 + +### 9.2 Director 更新 + +0.6.1 可采用小转动更新入口: + +```text +director_new = normalize(director_old + dt * omega cross director_old) +``` + +该路径只作为受控小转动和有限性测试的运动学基础,不宣称为完整有限转动壳理论。后续版本可升级为更稳健的旋转张量或四元数路线,但不得影响 0.6.1 小型 gate 的方向和量级约定。 + +### 9.3 转动诊断 + +0.6.1 建议记录: + +- active Shell 粒子数。 +- 最大角速度。 +- 最大 director 长度偏差。 +- director 退化数量。 +- 局部基退化数量。 +- 参考面积退化数量。 +- 转动惯量退化数量。 + +这些诊断第一版可先保留在 Fortran 模块查询或测试辅助路径中,不要求进入公开 C ABI。 + +## 10. Mindlin-Reissner 小变形运动学 + +### 10.1 分量顺序 + +0.6.1 应锁定 Shell 局部分量顺序: + +- 膜应变:`11,22,12`。 +- 弯曲应变:`11,22,12`。 +- 横向剪切应变:`13,23`。 +- 厚度积分点应变可采用 `11,22,12,13,23` 顺序。 + +该顺序必须与 0.6.0 已建立的状态数组、后续材料点更新和测试期望保持一致。 + +### 10.2 膜应变 + +0.6.1 的膜应变目标是小变形、可测路径: + +- 刚体平动下膜应变为 0。 +- 单轴拉伸下对应方向膜应变为正且量级正确。 +- 简单剪切下 `12` 分量方向和量级可控。 +- 非 Shell 粒子不参与膜应变计算。 + +0.6.1 不要求处理大转动大应变壳理论。 + +### 10.3 弯曲应变 + +0.6.1 的弯曲应变目标是受控曲率场: + +- director 空间变化可产生弯曲应变。 +- 均匀 director 场弯曲应变为 0 或数值容差内为 0。 +- 受控线性曲率输入得到方向和量级可检查的 `11,22,12` 分量。 + +0.6.1 不要求完整壳单元曲率矩阵或工程级弯曲刚度。 + +### 10.4 横向剪切应变 + +0.6.1 的横向剪切目标是受控 Mindlin-Reissner 小变形量: + +- 中面法向位移梯度和 director/转角状态共同决定剪切应变诊断。 +- 纯刚体平动不产生剪切应变。 +- 受控横向剪切输入得到方向和量级可检查的 `13,23` 分量。 + +0.6.1 不要求剪切锁定控制、减缩积分或工程级壳单元修正。 + +### 10.5 厚度积分点应变增量 + +0.6.1 应将中面运动学量映射到厚度积分点: + +```text +ip_strain = membrane_strain + zeta * bending_strain + shear_strain +``` + +其中 `zeta` 使用 0.6.0 section 积分规则中的厚度方向坐标或等价归一化坐标。未使用积分点必须保持安全默认值,不参与计算、诊断或后续材料点更新。 + +## 11. 数据和模块拆分建议 + +0.6.1 实现时建议控制 `src/shell/sph_shell.f90` 膨胀。若新增过程较多,可考虑拆分: + +- `sph_shell_geometry`:director、局部基、参考面积和几何质量诊断。 +- `sph_shell_kinematics`:转动更新、膜应变、弯曲应变、剪切应变和积分点应变增量。 +- `sph_shell_diagnostics`:Shell 0.6.1 诊断汇总。 + +是否拆分以 source size gate 和实际代码复杂度为准。拆分不得改变现有 Fortran API 语义,不得引入循环依赖。 + +## 12. 测试计划 + +### 12.1 0.6.1 新增测试 + +建议新增或补强以下测试: + +- `shell_director_input`:显式 orientation/director 输入、归一化和错误路径。 +- `shell_reference_geometry`:由受控三角形或四边形参考面推断 director、面积和局部基。 +- `shell_director_update`:角速度驱动 director 更新、归一化保护和有限性检查。 +- `shell_rotation_kinematics`:角速度、角加速度或等价转动工作数组默认值和最大角速度诊断。 +- `shell_local_frame`:局部基正交性、右手性、退化向量 error 和非 Shell 默认值。 +- `shell_membrane_strain`:刚体平动、单轴拉伸和简单剪切膜应变。 +- `shell_bending_strain`:均匀 director 场和受控曲率场弯曲应变。 +- `shell_shear_strain`:刚体平动和受控横向剪切应变。 +- `shell_ip_strain_increment`:3 点/5 点厚度积分点应变增量映射和未使用积分点跳过。 +- `shell_061_source_size`:Shell 0.6.1 source size 和 stale exception 检查。 + +### 12.2 回归测试 + +0.6.1 必须继续通过 0.6.0 完整 gate,包括: + +- 0.6.0 Shell 输入与状态基线 gate。 +- 0.5.1 Solid 稳定化 gate。 +- 既有 Water/Gas/Explosive/Solid/接口/restart/output/source-size gate。 + +### 12.3 建议 0.6.1 Release Gate + +建议 0.6.1 默认 gate 为: + +```powershell +cmake --build build-codex-unix --parallel +ctest --test-dir build-codex-unix --output-on-failure +ctest --test-dir build-codex-unix -R "^(input_shell_section|input_shell_errors|shell_state_build|shell_section_integration)$" --output-on-failure +ctest --test-dir build-codex-unix -R "^(shell_director_input|shell_reference_geometry|shell_director_update|shell_rotation_kinematics|shell_local_frame|shell_membrane_strain|shell_bending_strain|shell_shear_strain|shell_ip_strain_increment|shell_061_source_size)$" --output-on-failure +ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure +git diff --check +``` + +实际测试名称可在实现阶段微调,但 0.6.1 release gate 必须覆盖 director、局部基、转动、三类应变、积分点应变增量和 source size。 + +## 13. 开发阶段建议 + +### 阶段 A:版本基线和 0.6.1 范围收敛 + +1. 更新软件版本为 `0.6.1`。 +2. 保持 0.6.0 gate 稳定。 +3. 更新 README 中 0.6.1 的开发定位。 +4. 准备 Shell director、局部基、应变和积分点应变增量测试输入样例。 +5. 明确 0.6.1 不交付材料点、内力、restart 和公开接口。 + +### 阶段 B:Director 输入、几何推断和质量诊断 + +1. 实现 director 初始化优先级。 +2. 支持受控 orientation/director 输入。 +3. 支持由受控 Shell 参考面推断 director。 +4. 初始化参考面积和等效转动惯量。 +5. 实现 director、面积和惯量退化 error/warning 路径。 +6. 新增 director 和参考几何测试。 + +### 阶段 C:局部坐标系和转动状态 + +1. 建立 Shell 局部基向量。 +2. 实现局部基正交性、右手性和有限性检查。 +3. 初始化角速度、角加速度或等价工作数组。 +4. 实现 director 小转动更新入口。 +5. 增加最大角速度、director 偏差和局部基退化诊断。 +6. 新增局部基和转动测试。 + +### 阶段 D:Mindlin-Reissner 小变形应变 + +1. 实现膜应变计算。 +2. 实现弯曲应变计算。 +3. 实现横向剪切应变计算。 +4. 锁定局部分量顺序。 +5. 确认刚体平动应变为零。 +6. 新增膜、弯曲和剪切应变测试。 + +### 阶段 E:厚度积分点应变增量和诊断 + +1. 建立 Shell strain increment 工作数组。 +2. 将膜、弯曲和剪切应变映射到积分点应变增量。 +3. 确认 3 点和 5 点积分规则均可用。 +4. 确认未使用积分点跳过。 +5. 汇总 Shell 0.6.1 运动学诊断。 +6. 新增积分点应变增量测试。 + +### 阶段 F:门禁、文档和发布记录 + +1. 新增 0.6.1 专项 CTest gate。 +2. 新增或更新 source size gate。 +3. 运行完整 CTest。 +4. 更新 README、06、09 和 11 号文档。 +5. 确认 `git diff --check` 通过。 +6. 准备 0.6.1 发布记录。 + +## 14. 验收标准 + +0.6.1 应满足以下验收标准: + +1. 软件版本为 `0.6.1`。 +2. 0.6.0 完整 gate 继续通过。 +3. active Shell 粒子可以从输入或受控参考几何获得有限、归一化的 director。 +4. 无法推断 director 的 active Shell 粒子报 error。 +5. Shell 局部基有限、正交、右手性可检查。 +6. active Shell 粒子的参考面积和等效惯量初始化受控。 +7. director 可通过角速度执行小转动更新并保持归一化。 +8. 刚体平动下膜应变、弯曲应变和剪切应变在容差内为零。 +9. 单轴拉伸、简单剪切、受控曲率和横向剪切测试的方向和量级可检查。 +10. 3 点和 5 点厚度积分点应变增量映射正确。 +11. 未使用积分点不参与应变计算。 +12. 非 Shell 粒子不被 Shell 运动学路径污染。 +13. failed Shell 粒子处理策略明确且测试覆盖。 +14. 0.6.1 专项 gate、完整 CTest、source size 和 `git diff --check` 通过。 +15. 文档明确 0.6.1 不交付 Shell 材料点、内力、显式推进、restart、公开接口、真实水-气-结构爆炸响应或真实 FEM-SPH 耦合。 + +## 15. 风险和控制 + +| 风险 | 表现 | 控制策略 | +|---|---|---| +| Shell 范围再次膨胀 | 0.6.1 试图同时实现材料、内力、restart 和接口 | 限定为 director、转动和运动学基线 | +| orientation 子集过宽 | 追求完整 Abaqus orientation 兼容 | 只支持受控子集,其他 warning 或 error | +| 几何推断被误解为网格生成 | 从参考面推断 director 被宣传为几何功能 | 文档明确 SPHLite 不生成几何或粒子 | +| 大转动理论过早进入 | 小转动更新被扩展为复杂有限转动壳 | 0.6.1 只验收小转动方向和有限性 | +| 壳状态污染 Solid | 共享数据库中 phase 过滤不严 | 新增混合 Shell/Solid 测试 | +| 文件膨胀 | `sph_shell.f90` 继续增长 | 必要时拆分 geometry/kinematics/diagnostics 模块 | +| 测试只检查存在性 | 应变测试没有方向和量级约束 | 每个应变测试必须有数值期望或容差 | + +## 16. 后续版本建议 + +0.6.1 完成后,建议后续版本按以下路线推进: + +1. 0.6.2:Shell 弹性材料点、Johnson-Cook flow/failure、damage、softening 和 `PHASE_SHELL_FAILED` 状态基线。 +2. 0.6.3:Shell 内力、内力矩、稳定时间步、Shell-only 显式 smoke、summary/output 和小型动力学闭环。 +3. 0.6.4 或 0.7.0 前置:Shell restart、C ABI、C++ wrapper、Python ctypes、CLI 字段和 Water/Gas/Explosive 对 Shell 的受控载荷入口。 +4. 0.7.0:水-气-结构局部爆炸 smoke,覆盖小型 Water/Gas/Explosive/Solid/Shell 链路。 + +## 17. 0.6.1 发布后进入 0.6.2 的条件 + +满足以下条件后,可以启动 0.6.2: + +1. Shell director、局部基、转动和 Mindlin-Reissner 小变形运动学 gate 稳定。 +2. Shell 厚度积分点应变增量状态可被后续材料点更新复用。 +3. 0.6.0 输入/状态 gate 和 0.6.1 运动学 gate 均纳入默认回归。 +4. 文档明确 0.6.1 仍不是完整 Shell 动力学版本。 +5. source size 受控,Shell 几何和运动学过程不形成新的大文件风险。 diff --git a/src/core/sph_precision.f90 b/src/core/sph_precision.f90 index eed414e..b0bf8a2 100644 --- a/src/core/sph_precision.f90 +++ b/src/core/sph_precision.f90 @@ -4,7 +4,7 @@ module sph_precision integer, parameter :: rk = selected_real_kind(12, 100) integer, parameter :: SPH_VERSION_MAJOR = 0 integer, parameter :: SPH_VERSION_MINOR = 6 - integer, parameter :: SPH_VERSION_PATCH = 0 + integer, parameter :: SPH_VERSION_PATCH = 1 integer, parameter :: SPH_NDIM = 3 integer, parameter :: SPH_ERROR_MESSAGE_LEN = 256 integer, parameter :: SPH_PATH_LEN = 1024 diff --git a/tests/data/shell_angular_velocity_update_061.inp b/tests/data/shell_angular_velocity_update_061.inp new file mode 100644 index 0000000..d250b46 --- /dev/null +++ b/tests/data/shell_angular_velocity_update_061.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 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +*ELSET, ELSET=SHELL_PARTICLES +1, 2, 3 +*MATERIAL, NAME=SHELL_ROTATE_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_ROTATE_061, 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 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_controlled_curvature_061.inp b/tests/data/shell_controlled_curvature_061.inp new file mode 100644 index 0000000..9be65c6 --- /dev/null +++ b/tests/data/shell_controlled_curvature_061.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_CURVATURE_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_CURVATURE_061, 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_input_061.inp b/tests/data/shell_director_input_061.inp new file mode 100644 index 0000000..d934c45 --- /dev/null +++ b/tests/data/shell_director_input_061.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_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_DIRECTOR_061, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*SPHLITE SHELL DIRECTOR, SET=SHELL_PARTICLES, NX=0.0, NY=0.0, NZ=2.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_nan_061.inp b/tests/data/shell_director_nan_061.inp new file mode 100644 index 0000000..9a2c4cf --- /dev/null +++ b/tests/data/shell_director_nan_061.inp @@ -0,0 +1,15 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=SHELL_PARTICLES +1 +*MATERIAL, NAME=SHELL_NAN_DIRECTOR_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_NAN_DIRECTOR_061, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*SPHLITE SHELL DIRECTOR, SET=SHELL_PARTICLES, NX=NaN, 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_director_zero_061.inp b/tests/data/shell_director_zero_061.inp new file mode 100644 index 0000000..7e19e5a --- /dev/null +++ b/tests/data/shell_director_zero_061.inp @@ -0,0 +1,15 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=SHELL_PARTICLES +1 +*MATERIAL, NAME=SHELL_ZERO_DIRECTOR_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_ZERO_DIRECTOR_061, 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_ip_strain_3pt_061.inp b/tests/data/shell_ip_strain_3pt_061.inp new file mode 100644 index 0000000..f1ef41e --- /dev/null +++ b/tests/data/shell_ip_strain_3pt_061.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 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +*ELSET, ELSET=SHELL_PARTICLES +1, 2, 3 +*MATERIAL, NAME=SHELL_IP3_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_IP3_061, THICKNESS=0.012, 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.25 +*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_ip_strain_5pt_061.inp b/tests/data/shell_ip_strain_5pt_061.inp new file mode 100644 index 0000000..f69cfb8 --- /dev/null +++ b/tests/data/shell_ip_strain_5pt_061.inp @@ -0,0 +1,23 @@ +*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_IP5_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_IP5_061, THICKNESS=0.012, 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=5.0, OZ=0.0 +*SPHLITE INITIAL VELOCITY, SET=SHELL_PARTICLES, VX=1.0, VY=0.0, VZ=0.25 +*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_local_frame_degenerate_061.inp b/tests/data/shell_local_frame_degenerate_061.inp new file mode 100644 index 0000000..a9c417b --- /dev/null +++ b/tests/data/shell_local_frame_degenerate_061.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 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +*ELSET, ELSET=SHELL_PARTICLES +1, 2, 3 +*ORIENTATION, NAME=SHELL_FRAME_BAD +0.0, 0.0, 1.0, 0.0, 0.0, 0.0 +*MATERIAL, NAME=SHELL_FRAME_BAD_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_FRAME_BAD_061, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333, ORIENTATION=SHELL_FRAME_BAD +*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_orientation_parallel_061.inp b/tests/data/shell_orientation_parallel_061.inp new file mode 100644 index 0000000..132bfe0 --- /dev/null +++ b/tests/data/shell_orientation_parallel_061.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 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +*ELSET, ELSET=SHELL_PARTICLES +1, 2, 3 +*ORIENTATION, NAME=SHELL_PARALLEL +0.0, 0.0, 1.0, 0.0, 0.0, 2.0 +*MATERIAL, NAME=SHELL_PARALLEL_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_PARALLEL_061, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333, ORIENTATION=SHELL_PARALLEL +*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_reference_area_degenerate_061.inp b/tests/data/shell_reference_area_degenerate_061.inp new file mode 100644 index 0000000..d8d222a --- /dev/null +++ b/tests/data/shell_reference_area_degenerate_061.inp @@ -0,0 +1,16 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.2, 0.0, 0.0 +*ELEMENT, TYPE=SHELL3 +1, 1, 2, 3 +*ELSET, ELSET=SHELL_FACE +1 +*MATERIAL, NAME=SHELL_AREA_BAD_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_FACE, MATERIAL=SHELL_AREA_BAD_061, 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_reference_quad_061.inp b/tests/data/shell_reference_quad_061.inp new file mode 100644 index 0000000..acebee1 --- /dev/null +++ b/tests/data/shell_reference_quad_061.inp @@ -0,0 +1,17 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.1, 0.1, 0.0 +4, 0.0, 0.1, 0.0 +*ELEMENT, TYPE=SHELL4 +1, 1, 2, 3, 4 +*ELSET, ELSET=SHELL_FACE +1 +*MATERIAL, NAME=SHELL_QUAD_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_FACE, MATERIAL=SHELL_QUAD_061, 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_reference_triangle_061.inp b/tests/data/shell_reference_triangle_061.inp new file mode 100644 index 0000000..e24b516 --- /dev/null +++ b/tests/data/shell_reference_triangle_061.inp @@ -0,0 +1,16 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +*ELEMENT, TYPE=SHELL3 +1, 1, 2, 3 +*ELSET, ELSET=SHELL_FACE +1 +*MATERIAL, NAME=SHELL_TRI_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_FACE, MATERIAL=SHELL_TRI_061, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*SPHLITE PARTICLE CONTROL, H=0.12, MASS=2.62, VOLUME=0.0003333333 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/shell_rigid_translation_strain_061.inp b/tests/data/shell_rigid_translation_strain_061.inp new file mode 100644 index 0000000..83d3ab1 --- /dev/null +++ b/tests/data/shell_rigid_translation_strain_061.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_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_RIGID_061, 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.5, 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/data/shell_section_orientation_061.inp b/tests/data/shell_section_orientation_061.inp new file mode 100644 index 0000000..ebd5f79 --- /dev/null +++ b/tests/data/shell_section_orientation_061.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 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +*ELSET, ELSET=SHELL_PARTICLES +1, 2, 3 +*ORIENTATION, NAME=SHELL_Z +0.0, 0.0, 1.0, 1.0, 0.0, 0.0 +*MATERIAL, NAME=SHELL_ORIENT_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_ORIENT_061, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333, ORIENTATION=SHELL_Z +*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_simple_shear_membrane_061.inp b/tests/data/shell_simple_shear_membrane_061.inp new file mode 100644 index 0000000..42f3c58 --- /dev/null +++ b/tests/data/shell_simple_shear_membrane_061.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_MEMBRANE_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_SHEAR_MEMBRANE_061, 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=1.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/data/shell_solid_kinematics_isolation_061.inp b/tests/data/shell_solid_kinematics_isolation_061.inp new file mode 100644 index 0000000..4b8a34f --- /dev/null +++ b/tests/data/shell_solid_kinematics_isolation_061.inp @@ -0,0 +1,30 @@ +*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 +*ELSET, ELSET=SOLID_PARTICLES +3, 4 +*MATERIAL, NAME=SHELL_ISO_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*MATERIAL, NAME=SOLID_ISO_061, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_ISO_061, THICKNESS=0.010, POINTS=3, SHEAR_CORRECTION=0.8333333333 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=SOLID_ISO_061 +*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_transverse_shear_061.inp b/tests/data/shell_transverse_shear_061.inp new file mode 100644 index 0000000..c1bd67e --- /dev/null +++ b/tests/data/shell_transverse_shear_061.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_TRANSVERSE_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_TRANSVERSE_061, 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_061.inp b/tests/data/shell_uniaxial_membrane_061.inp new file mode 100644 index 0000000..269c0c9 --- /dev/null +++ b/tests/data/shell_uniaxial_membrane_061.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_061, TYPE=SHELL +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SHELL SECTION, ELSET=SHELL_PARTICLES, MATERIAL=SHELL_MEMBRANE_061, 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 7d1b927..7b019ab 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 != 6 || patch != 0) return fail("unexpected version"); + if (major != 0 || minor != 6 || patch != 1) return fail("unexpected version"); snprintf(path, sizeof(path), "%s/minimal_particles_011.inp", SPHLITE_TEST_DATA_DIR); ierr = sphlite_read_inp(path); diff --git a/tests/interface/test_cpp_api.cpp b/tests/interface/test_cpp_api.cpp index 0234042..6ba33c8 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 != 6 || version.patch != 0) { + if (version.major != 0 || version.minor != 6 || version.patch != 1) { return 1; } diff --git a/tests/unit/test_smoke.f90 b/tests/unit/test_smoke.f90 index 5007f1d..053a70e 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 /= 6 .or. patch /= 0) call fail('unexpected version') + if (major /= 0 .or. minor /= 6 .or. patch /= 1) call fail('unexpected version') call sph_db_allocate(2, ierr) call assert_ok(ierr, 'database allocation failed') diff --git a/todo.md b/todo.md index 37344ea..80cdee4 100644 --- a/todo.md +++ b/todo.md @@ -1,173 +1,144 @@ # SPHLite TODO -当前目标版本:0.6.0 +当前目标版本:0.6.1 -本文档依据 `docs/v6.0_development_plan.md` 拆分。0.6.0 定位为 `Shell` 板壳粒子版本线的起点,目标是在 0.5.1 已完成 `Solid` 3D 实体结构粒子稳定化和结构算法加固的基础上,建立 `Shell` 输入、状态、Mindlin-Reissner 板壳运动学、厚度积分、材料点更新、显式推进、输出、restart、接口和测试 gate 的最小闭环。 +本文档依据 `docs/v6.1_development_plan.md` 拆分。0.6.1 定位为 `Shell` director、转动状态、参考面积/惯量、局部坐标系和 Mindlin-Reissner 小变形运动学基线版本,在 0.6.0 Shell 输入与状态基线之上推进。 -所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.6.0 不实现真实水-气-结构工程爆炸响应、真实 FEM-SPH 耦合、工程级结构破坏 benchmark、完整板壳撕裂路径追踪、裂纹扩展、穿孔判据库、碎片云、壳-实体连接、复杂接触、焊缝失效库、大规模并行或 GPU 后端。 +所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.6.1 不交付 Shell 材料点更新、Shell 内力、Shell 内力矩、完整显式推进生产路径、Shell restart、公开 C ABI/C++/Python/CLI 诊断字段、真实水-气-结构工程爆炸响应或真实 FEM-SPH 耦合。 执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端。 -## 阶段 A:版本基线、范围声明与 0.6.0 样例 +## 阶段 A:版本基线、范围声明与 0.6.1 样例 -- [x] 确认当前 git 状态干净或记录已有未提交内容。 -- [x] 确认 `v0.5.1` 标签和远端发布提交可作为 0.6.0 开发基线。 -- [x] 将核心软件版本更新为 `0.6.0`。 -- [x] 将 CMake 项目版本更新为 `0.6.0`。 +- [x] 确认当前 git 状态并记录已有未提交内容。 +- [x] 确认 `v0.6.0` 标签和远端发布提交可作为 0.6.1 开发基线。 +- [x] 将核心软件版本更新为 `0.6.1`。 +- [x] 将 CMake 项目版本更新为 `0.6.1`。 - [x] 更新 Fortran smoke 测试中的版本期望。 - [x] 更新 C API 测试中的版本期望。 - [x] 更新 C++ API 测试中的版本期望。 - [x] 更新 Python debug 测试中的版本期望。 - [x] 更新 CLI `--version` 和 inspect 版本期望。 -- [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 错误输入样例。 +- [x] 在 README 中记录 0.6.1 Shell 运动学基线开发定位。 +- [x] 明确 README 中 0.6.1 不交付材料点、内力、restart 和公开接口。 +- [x] 创建 Shell 显式 director 输入样例。 +- [x] 创建 Shell section 引用 orientation 输入样例。 +- [x] 创建 Shell director 零向量错误输入样例。 +- [x] 创建 Shell director 非有限值错误输入样例。 +- [x] 创建 Shell orientation 平行退化错误输入样例。 +- [x] 创建 Shell 三角形参考面 director 推断样例。 +- [x] 创建 Shell 四边形参考面 director 推断样例。 +- [x] 创建 Shell 参考面积退化错误输入样例。 +- [x] 创建 Shell 局部基退化错误输入样例。 +- [x] 创建 Shell 角速度更新测试样例。 +- [x] 创建 Shell 刚体平动应变测试样例。 +- [x] 创建 Shell 单轴拉伸膜应变测试样例。 +- [x] 创建 Shell 简单剪切膜应变测试样例。 +- [x] 创建 Shell 受控曲率弯曲应变测试样例。 +- [x] 创建 Shell 横向剪切应变测试样例。 +- [x] 创建 Shell 3 点积分点应变增量样例。 +- [x] 创建 Shell 5 点积分点应变增量样例。 +- [x] 创建 Shell/Solid 混合运动学隔离样例。 +- [x] 运行 0.6.0 Shell 输入与状态基线专项 gate 并记录基线结果。 -## 阶段 B:Shell 输入解析、section 校验与 warning/error 路径 +## 阶段 B:Director 输入、几何推断和质量诊断 -- [x] 复核现有 material 解析路径并保持 Water/Gas/Explosive/Solid 兼容。 -- [x] 支持 `TYPE=SHELL` material 识别。 -- [x] 支持 Shell material 密度读取和映射。 -- [x] 支持 Shell material 弹性参数读取和映射。 -- [x] 支持 Shell material Johnson-Cook flow 参数读取和映射。 -- [x] 支持 Shell material Johnson-Cook failure 参数读取和映射。 -- [x] 支持 Shell material softening 控制参数读取和映射。 -- [x] 对 Shell material 缺失密度路径报 error。 -- [x] 对 Shell material 非正密度路径报 error。 -- [x] 对 Shell material 缺失弹性参数路径报 error。 -- [x] 对 Shell material 非正弹性模量路径报 error。 -- [x] 对 Shell material 非法泊松比路径报 error。 -- [x] 对 Shell Johnson-Cook flow 非有限参数路径报 error。 -- [x] 对 Shell Johnson-Cook failure 非完整或非有限参数路径报 error。 -- [x] 对 Shell unsupported softening 类型路径报 error。 -- [x] 对未被 active Shell 粒子使用的 Shell material 保持 warning。 -- [x] 支持 `*SHELL SECTION` 或等价 section 子集解析。 -- [x] 解析 Shell section 的 material 参数。 -- [x] 解析 Shell section 的 thickness 参数。 -- [x] 解析 Shell section 的 integration point 数量。 -- [x] 解析 Shell section 的 shear correction 参数。 -- [x] 对 Shell section 缺失 material 参数路径报 error。 -- [x] 对 Shell section 指向不存在 material 路径报 error。 -- [x] 对 Shell section 指向非 Shell material 路径报 error。 -- [x] 对 Shell section 非正 thickness 路径报 error。 -- [x] 对 Shell section 非法 integration point 数量路径报 error。 -- [x] 对 Shell section 非法 shear correction 路径报 error。 -- [x] 对存在 active Shell 粒子但缺失 Shell section 的模型报 error。 -- [x] 确认 set 仍只表示集合,不参与 Shell 类型判断。 -- [x] 确认 phase/status 默认值不改变 Water/Gas/Explosive/Solid 路径。 -- [x] 新增 `input_shell_section` Fortran 输入测试。 -- [x] 新增 `input_shell_errors` Fortran 输入测试。 -- [x] 将 `input_shell_section` 接入 CTest。 -- [x] 将 `input_shell_errors` 接入 CTest。 - -## 阶段 C:Shell 状态数组、厚度积分点和默认值 - -- [x] 设计 Shell 粒子级状态常量和数组布局。 -- [x] 新增或补齐 Shell thickness 状态数组。 -- [x] 新增或补齐 Shell director 状态数组。 -- [x] 新增或补齐 Shell omega 状态数组。 -- [x] 新增或补齐 Shell membrane strain 状态数组。 -- [x] 新增或补齐 Shell bending strain 状态数组。 -- [x] 新增或补齐 Shell shear strain 状态数组。 -- [x] 新增或补齐 Shell damage 状态数组。 -- [x] 新增或补齐 Shell softening 状态数组。 -- [x] 新增或补齐 Shell internal energy 状态数组。 -- [x] 新增或补齐 Shell failure status 状态数组。 -- [x] 设计 Shell 厚度积分点状态常量和数组布局。 -- [x] 新增或补齐 Shell integration point count 状态数组。 -- [x] 新增或补齐 Shell integration point coordinate 状态数组。 -- [x] 新增或补齐 Shell integration point weight 状态数组。 -- [x] 新增或补齐 Shell integration point stress 状态数组。 -- [x] 新增或补齐 Shell integration point strain 状态数组。 -- [x] 新增或补齐 Shell integration point plastic strain 状态数组。 -- [x] 新增或补齐 Shell integration point temperature 状态数组。 -- [x] 新增或补齐 Shell integration point damage 状态数组。 -- [x] 新增或补齐 Shell integration point softening 状态数组。 -- [x] 在 Shell reset 路径初始化粒子级状态。 -- [x] 在 Shell reset 路径初始化积分点状态。 -- [x] 在 Shell allocate/build 路径分配粒子级状态。 -- [x] 在 Shell allocate/build 路径分配积分点状态。 -- [x] 在 Shell clear/finalize 路径释放粒子级状态。 -- [x] 在 Shell clear/finalize 路径释放积分点状态。 -- [x] 初始化 active Shell 粒子的 thickness。 -- [x] 初始化 active Shell 粒子的 integration point count。 -- [x] 初始化 active Shell 粒子的 integration point 坐标和权重。 -- [x] 初始化 active Shell 粒子的 damage、softening 和 failure status。 -- [x] 对非 Shell 粒子设置安全默认 Shell 状态。 -- [x] 新增 `shell_state_build` 测试。 -- [x] 新增 `shell_section_integration` 测试。 -- [x] 将 `shell_state_build` 接入 CTest。 -- [x] 将 `shell_section_integration` 接入 CTest。 - -## 阶段 D:Director、转动状态和参考面积/惯量 - -- [ ] 设计 Shell director 初始化优先级。 -- [ ] 支持由输入或 section 相关信息设置 Shell 初始 director。 -- [ ] 支持由受控小模型参考面几何推断 Shell 初始 director。 -- [ ] 对无法推断 director 的 active Shell 粒子报 error。 +- [ ] 设计 Shell director 初始化优先级常量或内部约定。 +- [ ] 复核现有 Shell section 数据结构是否可挂接 orientation 信息。 +- [ ] 支持受控 `*ORIENTATION` 名称解析。 +- [ ] 支持 section 引用 orientation 名称。 +- [ ] 支持 orientation 方向向量读取。 +- [ ] 支持 orientation 局部切向向量读取。 +- [ ] 对 orientation 非有限向量路径报 error。 +- [ ] 对 orientation 零向量路径报 error。 +- [ ] 对 orientation 平行退化向量路径报 error。 +- [ ] 对未被 active Shell 使用的 orientation 保持 warning。 +- [ ] 将显式 orientation 映射到 active Shell director。 +- [ ] 将 section orientation 映射到 active Shell director。 +- [ ] 支持由三角形参考面推断 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 director 初始化来源状态。 +- [ ] 记录 Shell director 最大长度偏差诊断。 +- [ ] 记录 Shell director 退化数量诊断。 +- [ ] 初始化 active Shell 粒子参考面积。 +- [ ] 初始化 active Shell 粒子等效转动惯量。 +- [ ] 对参考面积退化路径报 error 或记录退化诊断。 +- [ ] 对转动惯量退化路径报 error 或记录退化诊断。 +- [ ] 对非 Shell 粒子设置安全 director 默认值。 +- [ ] 对非 Shell 粒子设置安全参考面积默认值。 +- [ ] 对非 Shell 粒子设置安全转动惯量默认值。 +- [ ] 新增 `shell_director_input` 测试。 +- [ ] 新增 `shell_reference_geometry` 测试。 +- [ ] 将 `shell_director_input` 接入 CTest。 +- [ ] 将 `shell_reference_geometry` 接入 CTest。 + +## 阶段 C:局部坐标系、转动状态和 director 更新 + +- [ ] 设计 Shell 局部基向量数组布局。 +- [ ] 新增或补齐 `shell_local_e1` 状态或工作数组。 +- [ ] 新增或补齐 `shell_local_e2` 状态或工作数组。 +- [ ] 新增或补齐 `shell_local_e3` 状态或工作数组。 +- [ ] 新增 Shell local frame status 状态数组。 +- [ ] 在 Shell allocate/build 路径分配局部基状态。 +- [ ] 在 Shell reset 路径初始化局部基状态。 +- [ ] 在 Shell clear/finalize 路径释放局部基状态。 +- [ ] 由 director 构造 Shell 局部 `e3`。 +- [ ] 由 orientation 或参考面构造 Shell 局部 `e1`。 +- [ ] 由 `e3 cross e1` 构造 Shell 局部 `e2`。 +- [ ] 对 Shell 局部基执行有限性检查。 +- [ ] 对 Shell 局部基执行正交性检查。 +- [ ] 对 Shell 局部基执行右手性检查。 +- [ ] 记录局部基退化数量诊断。 +- [ ] 新增或补齐 Shell angular acceleration 工作数组。 +- [ ] 在 Shell reset 路径初始化 angular velocity 默认值。 +- [ ] 在 Shell reset 路径初始化 angular acceleration 默认值。 +- [ ] 对非 Shell 粒子设置安全转动状态默认值。 +- [ ] 新增 Shell 内部测试辅助过程以设置角速度。 +- [ ] 实现 Shell director 小转动更新入口。 +- [ ] 在 director 更新后执行归一化保护。 +- [ ] 在 director 更新后刷新局部基。 +- [ ] 对 Shell 转动状态执行有限性检查。 - [ ] 计算 Shell 最大角速度诊断。 -- [ ] 计算 Shell director 退化数量诊断。 -- [ ] 确认无 active Shell 粒子时跳过 director 和转动更新。 -- [ ] 确认 Shell director 和转动状态不污染 Solid 粒子。 +- [ ] 确认无 active Shell 粒子时跳过局部基和转动更新。 +- [ ] 确认局部基和转动状态不污染 Solid 粒子。 - [ ] 新增 `shell_director_update` 测试。 - [ ] 新增 `shell_rotation_kinematics` 测试。 +- [ ] 新增 `shell_local_frame` 测试。 - [ ] 将 `shell_director_update` 接入 CTest。 - [ ] 将 `shell_rotation_kinematics` 接入 CTest。 +- [ ] 将 `shell_local_frame` 接入 CTest。 -## 阶段 E:Mindlin-Reissner 运动学和应变计算 +## 阶段 D:Mindlin-Reissner 小变形膜、弯曲和剪切应变 -- [ ] 设计 Shell 局部坐标系或局部分量顺序。 -- [ ] 新增 Shell 局部基向量或等价工作数组。 -- [ ] 实现 Shell 局部基有限性检查。 +- [ ] 设计 Shell 运动学过程的输入输出约定。 +- [ ] 锁定 Shell 膜应变局部分量顺序 `11,22,12`。 +- [ ] 锁定 Shell 弯曲应变局部分量顺序 `11,22,12`。 +- [ ] 锁定 Shell 剪切应变局部分量顺序 `13,23`。 +- [ ] 新增 Shell strain increment 工作数组布局。 +- [ ] 在 Shell allocate/build 路径分配 strain increment 工作数组。 +- [ ] 在 Shell reset 路径初始化 strain increment 工作数组。 +- [ ] 在 Shell clear/finalize 路径释放 strain increment 工作数组。 - [ ] 实现 Shell 刚体平动下膜应变为零的路径。 -- [ ] 实现 Shell 刚体转动下膜应变受控路径。 - [ ] 实现 Shell 单轴拉伸膜应变计算。 - [ ] 实现 Shell 简单剪切膜应变计算。 -- [ ] 实现 Shell 受控曲率场弯曲应变计算。 -- [ ] 实现 Shell 横向剪切应变计算。 -- [ ] 将膜应变转换为局部 `11,22,12` 顺序。 -- [ ] 将弯曲应变转换为局部 `11,22,12` 顺序。 -- [ ] 将剪切应变转换为局部 `13,23` 顺序。 -- [ ] 新增 Shell strain increment 工作数组。 -- [ ] 由 Shell 运动学计算厚度积分点应变增量。 -- [ ] 将厚度位置对弯曲应变的贡献加入积分点应变。 -- [ ] 确认未使用积分点不参与应变计算。 -- [ ] 确认非 Shell 粒子不污染 Shell 应变状态。 +- [ ] 将膜应变写入 `shell_membrane_strain`。 +- [ ] 实现均匀 director 场下弯曲应变为零的路径。 +- [ ] 实现受控曲率场弯曲应变计算。 +- [ ] 将弯曲应变写入 `shell_bending_strain`。 +- [ ] 实现刚体平动下横向剪切应变为零的路径。 +- [ ] 实现受控横向剪切应变计算。 +- [ ] 将横向剪切应变写入 `shell_shear_strain`。 +- [ ] 对 Shell 应变计算执行有限性检查。 +- [ ] 确认非 Shell 粒子不参与应变计算。 - [ ] 确认 failed Shell 粒子按受控策略跳过或保持状态。 +- [ ] 确认未建立局部基时应变计算报 error。 +- [ ] 记录 Shell 最大膜应变诊断。 +- [ ] 记录 Shell 最大弯曲应变诊断。 +- [ ] 记录 Shell 最大剪切应变诊断。 - [ ] 新增 `shell_membrane_strain` 测试。 - [ ] 新增 `shell_bending_strain` 测试。 - [ ] 新增 `shell_shear_strain` 测试。 @@ -175,224 +146,53 @@ - [ ] 将 `shell_bending_strain` 接入 CTest。 - [ ] 将 `shell_shear_strain` 接入 CTest。 -## 阶段 F:Shell 材料点、Johnson-Cook 失效和渐进软化 +## 阶段 E:厚度积分点应变增量、诊断和隔离检查 -- [ ] 复核 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。 +- [ ] 设计 Shell 厚度积分点应变增量分量顺序。 +- [ ] 确认厚度积分点应变增量使用 `11,22,12,13,23` 顺序。 +- [ ] 将膜应变贡献映射到 active 积分点应变增量。 +- [ ] 将厚度坐标乘弯曲应变贡献映射到 active 积分点应变增量。 +- [ ] 将横向剪切应变贡献映射到 active 积分点应变增量。 +- [ ] 确认 3 点厚度积分规则参与应变增量映射。 +- [ ] 确认 5 点厚度积分规则参与应变增量映射。 +- [ ] 确认未使用积分点保持安全默认值。 +- [ ] 确认未使用积分点不参与诊断统计。 +- [ ] 将积分点应变增量写入 Shell integration point strain 状态。 +- [ ] 对积分点应变增量执行有限性检查。 +- [ ] 记录 Shell 最大积分点应变增量诊断。 +- [ ] 记录 Shell active 积分点数量诊断。 +- [ ] 汇总 Shell 0.6.1 运动学诊断查询入口。 +- [ ] 确认 Shell 运动学诊断无 active Shell 粒子时返回安全默认值。 +- [ ] 确认 Shell/Solid 混合模型中 Solid 状态不被修改。 +- [ ] 确认 Water/Gas/Explosive 粒子不被 Shell 运动学路径修改。 +- [ ] 确认 0.6.0 Shell state build 测试仍通过。 +- [ ] 确认 0.6.0 Shell section integration 测试仍通过。 +- [ ] 新增 `shell_ip_strain_increment` 测试。 +- [ ] 将 `shell_ip_strain_increment` 接入 CTest。 -## 阶段 G:Shell 内力、内力矩、稳定时间步和显式推进 +## 阶段 F:门禁、source size、文档和发布准备 -- [ ] 新增 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:CSV 输出、`STATE_0_6` restart 与兼容读入 - -- [ ] 在 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:Fortran API、C ABI、C++、Python 与 CLI - -- [ ] 新增 `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 发布前本地提交记录。 +- [ ] 复核 `src/shell/sph_shell.f90` 文件规模。 +- [ ] 判断是否需要拆分 Shell geometry 模块。 +- [ ] 判断是否需要拆分 Shell kinematics 模块。 +- [ ] 判断是否需要拆分 Shell diagnostics 模块。 +- [ ] 如需拆分,新增 Shell 模块并保持 Fortran API 语义不变。 +- [ ] 如需拆分,更新 CMake 中 Shell 源文件列表。 +- [ ] 新增 `shell_061_source_size` 检查。 +- [ ] 将 `shell_061_source_size` 接入 CTest。 +- [ ] 更新 `tests/source_size_exceptions.txt` 中必要的 Shell 说明性例外。 +- [ ] 运行完整 CTest。 +- [ ] 运行 0.6.0 Shell 输入与状态基线专项 gate。 +- [ ] 运行 0.6.1 Shell 运动学专项 gate。 +- [ ] 运行 source size 相关 gate。 +- [ ] 运行 `git diff --check`。 +- [ ] 更新 README 中 0.6.1 当前状态和不交付范围。 +- [ ] 更新 `docs/06_test_and_verification_plan.md` 的 0.6.1 release gate。 +- [ ] 更新 `docs/09_release_history.md` 的 0.6.1 本地验收记录。 +- [ ] 更新 `docs/11_benchmark_matrix.md` 的 0.6.1 gate 矩阵。 +- [ ] 确认 0.6.1 文档不宣称完整 Shell 动力学闭环。 +- [ ] 确认 0.6.1 文档不宣称真实水-气-结构工程爆炸响应。 +- [ ] 确认 0.6.1 文档不宣称真实 FEM-SPH 联合运行。 +- [ ] 确认输出目录、CSV、VTK、restart 和临时结果未提交。 +- [ ] 确认代码、构建脚本、测试和工具目录未新增 FEMLite 直接依赖。 +- [ ] 准备 0.6.1 发布提交说明。 diff --git a/tools/testing/test_cli.py b/tools/testing/test_cli.py index 62994e4..ae52f7d 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.6.0" not in version.stdout: + if "0.6.1" 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.6.0": + if inspect_fields["version"] != "0.6.1": raise AssertionError("inspect version field mismatch") if Path(inspect_fields["input"]) != Path(model): raise AssertionError("inspect input field mismatch") diff --git a/tools/testing/test_python_debug.py b/tools/testing/test_python_debug.py index 8e0021d..1506068 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, 6, 0): + if solver.version() != (0, 6, 1): raise AssertionError("Python version mismatch") solver.initialize()