Record 0.6.0 release
This commit is contained in:
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。
|
SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。
|
||||||
|
|
||||||
当前开发版本:0.6.0。该版本定位为 `Shell` 板壳粒子最小闭环开发版本,在 0.5.1 已完成 `Solid` 3D 实体结构粒子稳定化和结构算法加固的基础上,建立 Shell material/section 输入、状态数组、Mindlin-Reissner 板壳运动学、厚度积分、材料点、显式推进、输出、restart、接口和测试 gate 的可验证路径。不交付真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行或工程级船舱破坏 benchmark。
|
当前发布版本:0.6.0。该版本定位为 `Shell` 板壳粒子输入与状态基线版本,在 0.5.1 已完成 `Solid` 3D 实体结构粒子稳定化和结构算法加固的基础上,建立 Shell material/section 输入、厚度/积分点/剪切修正校验、粒子级状态数组、厚度积分点状态数组和小型输入 gate。不交付完整 Shell 动力学闭环、真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行或工程级船舱破坏 benchmark。
|
||||||
|
|
||||||
代码仓库地址:
|
代码仓库地址:
|
||||||
|
|
||||||
@@ -63,7 +63,7 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格:
|
|||||||
|
|
||||||
## 当前状态
|
## 当前状态
|
||||||
|
|
||||||
0.6.0 当前以 0.5.1 `Solid` 稳定化发布基线为起点,进入 `Shell` 板壳粒子最小闭环开发。0.5.0 以来已完成内容主要包括:
|
0.6.0 当前以 0.5.1 `Solid` 稳定化发布基线为起点,完成 `Shell` 板壳粒子输入与状态基线。0.5.0 以来已完成内容主要包括:
|
||||||
|
|
||||||
- CMake/CTest 工程骨架和 Fortran 95 核心库。
|
- CMake/CTest 工程骨架和 Fortran 95 核心库。
|
||||||
- C ABI、C++ 头文件薄包装和 Python `ctypes` 调试入口。
|
- C ABI、C++ 头文件薄包装和 Python `ctypes` 调试入口。
|
||||||
@@ -83,6 +83,9 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格:
|
|||||||
- 0.5.1 兼容读入 `STATE_0_5` Solid restart,并在读入时初始化 0.5.1 新增状态。
|
- 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 登记说明性例外。
|
- 0.5.1 为 source size 门禁拆分 Solid C ABI、Python Solid 调试包装和 Solid API 查询模块;`src/solid/sph_solid.f90` 作为 Solid 输入/material 表 owner 登记说明性例外。
|
||||||
- CouplingInterface 的中立数据导出、外部粒子力导入和诊断占位保持可用;真实 FEM-SPH 联合运行仍由外部 CouplingModule 后续实现。
|
- CouplingInterface 的中立数据导出、外部粒子力导入和诊断占位保持可用;真实 FEM-SPH 联合运行仍由外部 CouplingModule 后续实现。
|
||||||
- `Shell` 在 0.6.0 进入开发闭环,目标是先完成小型可验证模型,不作为真实船舶水下爆炸生产计算路径。
|
- 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.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.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.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` 通过。
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# 06 测试与验证计划
|
# 06 测试与验证计划
|
||||||
|
|
||||||
文档状态:0.5.1 gate 记录
|
文档状态:0.6.0 gate 记录
|
||||||
|
|
||||||
## 1. 测试原则
|
## 1. 测试原则
|
||||||
|
|
||||||
@@ -273,6 +273,29 @@ git diff --check
|
|||||||
|
|
||||||
0.5.1 不验收 `Shell` 生产路径,不验收真实水-气-结构工程爆炸响应,不验收真实 FEM-SPH 联合运行,也不验收工程级结构破坏 benchmark。0.5.1 的 Solid gate 只证明参考构型、速度梯度、应变率、最小内力、诊断、restart 和接口可观测性在小型模型内闭合。
|
0.5.1 不验收 `Shell` 生产路径,不验收真实水-气-结构工程爆炸响应,不验收真实 FEM-SPH 联合运行,也不验收工程级结构破坏 benchmark。0.5.1 的 Solid gate 只证明参考构型、速度梯度、应变率、最小内力、诊断、restart 和接口可观测性在小型模型内闭合。
|
||||||
|
|
||||||
|
## 7.6 0.6.0 Release Gate
|
||||||
|
|
||||||
|
0.6.0 在 0.5.1 `Solid` 稳定化 gate 基础上启动 `Shell` 板壳粒子版本线。当前发布范围限定为 Shell 输入解析、Shell section 校验、粒子级状态数组和厚度积分点状态数组的基线验收;不把尚未完成的 director/转动更新、Mindlin-Reissner 应变路径、Shell 材料点更新、Shell 内力、显式推进、restart 或公开 API 纳入本次验收。
|
||||||
|
|
||||||
|
0.6.0 Shell 输入与状态基线专项 gate 包含:
|
||||||
|
- `input_shell_section`
|
||||||
|
- `input_shell_errors`
|
||||||
|
- `shell_state_build`
|
||||||
|
- `shell_section_integration`
|
||||||
|
|
||||||
|
0.6.0 本地 release 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 "^source_size$" --output-on-failure
|
||||||
|
git diff --check
|
||||||
|
```
|
||||||
|
|
||||||
|
2026-07-03 本地结果:完整 CTest 103/103 通过,0.6.0 Shell 输入/状态基线专项 gate 4/4 通过,`source_size` 1/1 通过,`git diff --check` 通过。
|
||||||
|
|
||||||
|
0.6.0 不验收完整 `Shell` 动力学闭环,不验收真实水-气-结构工程爆炸响应,不验收真实 FEM-SPH 联合运行,也不验收工程级船舱破坏 benchmark。0.6.0 的 Shell gate 只证明 Shell material/section 输入、厚度/积分点/剪切修正校验、Shell 粒子状态数组和厚度积分点状态数组在小型模型内可构建、可检查。
|
||||||
|
|
||||||
## 8. Source Size 门禁
|
## 8. Source Size 门禁
|
||||||
|
|
||||||
从第一版开始设置 source size 门禁。建议沿用 FEMLite 风格:
|
从第一版开始设置 source size 门禁。建议沿用 FEMLite 风格:
|
||||||
@@ -282,7 +305,7 @@ git diff --check
|
|||||||
- 必要例外登记到例外清单。
|
- 必要例外登记到例外清单。
|
||||||
- stale exception 应被检查。
|
- stale exception 应被检查。
|
||||||
|
|
||||||
0.5.1 为控制新增接口膨胀,已拆分 Solid C ABI、Python Solid 调试包装和 Solid API 查询模块。`src/solid/sph_solid.f90` 继续作为 Solid 输入/material 表 owner,并在例外清单中登记说明,后续若拆分 Solid material ownership 应同步移除此例外。
|
0.6.0 当前只新增 Shell 输入与状态基线测试,尚未新增 Shell 接口层膨胀。`src/solid/sph_solid.f90` 继续作为 Solid 输入/material 表 owner,并在例外清单中登记说明;后续若拆分 Solid material ownership 应同步移除此例外。Shell 后续进入 director、材料点、内力、restart 和接口层时,应按实际膨胀情况拆分模块并追加专门 source size gate。
|
||||||
|
|
||||||
具体阈值可在实现阶段与 FEMLite 保持一致或按 SPHLite 文件结构微调。
|
具体阈值可在实现阶段与 FEMLite 保持一致或按 SPHLite 文件结构微调。
|
||||||
|
|
||||||
|
|||||||
@@ -1,10 +1,10 @@
|
|||||||
# 09 版本历史与验收记录
|
# 09 版本历史与验收记录
|
||||||
|
|
||||||
文档状态:0.5.1 本地验收记录
|
文档状态:0.6.0 本地验收记录
|
||||||
|
|
||||||
## 1. 当前状态
|
## 1. 当前状态
|
||||||
|
|
||||||
SPHLite 当前进入 0.5.1 `Solid` 稳定化和结构算法加固版本。本版本在 0.5.0 已建立的 Solid 起步闭环基础上,补强参考构型、修正矩阵、速度梯度、应变率、最小内力、softening 力学作用、能量诊断、`STATE_0_5_1` restart、`STATE_0_5` 兼容读入、粒子级状态接口和 Solid 0.5.1 专项 gate;`Shell` 生产路径、真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行和工程级结构破坏 benchmark 仍不在本版本交付范围内。
|
SPHLite 当前发布 0.6.0 `Shell` 输入与状态基线版本。本版本在 0.5.1 已完成的 Solid 稳定化和结构算法加固基础上,新增 Shell material/section 输入、厚度/积分点/剪切修正校验、Shell 粒子级状态数组和厚度积分点状态数组。0.6.0 不交付完整 Shell 动力学闭环、真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行或工程级船舱破坏 benchmark。
|
||||||
|
|
||||||
## 2. 规划版本线
|
## 2. 规划版本线
|
||||||
|
|
||||||
@@ -388,6 +388,54 @@ cmake --build build-codex-unix
|
|||||||
|
|
||||||
- 0.5.1 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.5.1`。
|
- 0.5.1 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.5.1`。
|
||||||
|
|
||||||
|
### 0.6.0 本地验收记录
|
||||||
|
|
||||||
|
记录日期:2026-07-03
|
||||||
|
|
||||||
|
本地构建目录:`build-codex-unix`
|
||||||
|
|
||||||
|
版本定位:
|
||||||
|
|
||||||
|
- 0.6.0 是 0.6 `Shell` 板壳粒子版本线的起点。
|
||||||
|
- 0.6.0 在 0.5.1 `Solid` 稳定化基线之上新增 `TYPE=SHELL` material 识别、`*SHELL SECTION` 输入解析、Shell section 映射、厚度、3 点/5 点积分规则和剪切修正校验。
|
||||||
|
- 0.6.0 新增 Shell 粒子级状态数组,包括 active、section/material 映射、厚度、积分点数、剪切修正、director/转动占位、应变、曲率、剪切应变、合力/合力矩和失效状态默认值。
|
||||||
|
- 0.6.0 新增 Shell 厚度积分点状态数组,包括积分点坐标、权重、应力、应变、塑性应变、等效塑性应变、damage、softening、温度、内能和失效状态默认值。
|
||||||
|
- 0.6.0 的 Shell 发布范围是输入与状态基线,不是完整 Shell 结构动力学闭环。
|
||||||
|
|
||||||
|
验收结果:
|
||||||
|
|
||||||
|
- `cmake --build build-codex-unix --parallel` 通过。
|
||||||
|
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:103/103。
|
||||||
|
- 0.6.0 Shell 输入/状态基线专项 gate 通过:4/4。
|
||||||
|
- `ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure` 通过:1/1。
|
||||||
|
- `git diff --check` 通过。
|
||||||
|
- 代码、构建脚本、测试和工具目录中未新增 FEMLite 直接依赖。
|
||||||
|
|
||||||
|
不交付范围:
|
||||||
|
|
||||||
|
- 0.6.0 不交付 director 或法向的真实更新。
|
||||||
|
- 0.6.0 不交付转动惯量、角速度、角加速度或转动显式推进。
|
||||||
|
- 0.6.0 不交付 Mindlin-Reissner 应变计算路径。
|
||||||
|
- 0.6.0 不交付 Shell Johnson-Cook 材料点更新、Shell 内力、Shell 内力矩或 Shell 稳定时间步。
|
||||||
|
- 0.6.0 不交付 Shell restart、公开 API、C ABI、C++ wrapper、Python ctypes 或 CLI 诊断字段。
|
||||||
|
- 0.6.0 不交付真实水-气-结构工程爆炸响应、真实 FEM-SPH 接触耦合或连续体耦合。
|
||||||
|
- 0.6.0 不交付工程级船舱破坏 benchmark、复杂撕裂面追踪、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。
|
||||||
|
|
||||||
|
已知限制:
|
||||||
|
|
||||||
|
- Shell 状态数组中的 director、转动、应变、曲率、剪切应变、内力和合力矩当前为初始化占位,不参与生产计算。
|
||||||
|
- Shell section 支持 3 点和 5 点厚度积分规则,但尚未用于真实厚度积分材料更新。
|
||||||
|
- 当前 Shell gate 只证明输入解析和状态构建可用,不代表工程级板壳变形、损伤或撕裂预测能力。
|
||||||
|
|
||||||
|
发布建议:
|
||||||
|
|
||||||
|
- 建议将 0.6.0 作为 Shell 输入与状态基线版本发布。
|
||||||
|
- 0.6.0 发布后,后续主线应继续完成 Shell director/转动、Mindlin-Reissner 应变、材料点、内力、显式推进、restart 和接口层。
|
||||||
|
|
||||||
|
发布记录:
|
||||||
|
|
||||||
|
- 0.6.0 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.6.0`。
|
||||||
|
|
||||||
后续每个版本应记录:
|
后续每个版本应记录:
|
||||||
|
|
||||||
- 完成能力。
|
- 完成能力。
|
||||||
|
|||||||
@@ -1,10 +1,10 @@
|
|||||||
# 11 Benchmark 与验收矩阵
|
# 11 Benchmark 与验收矩阵
|
||||||
|
|
||||||
文档状态:0.5.1 gate 记录
|
文档状态:0.6.0 gate 记录
|
||||||
|
|
||||||
## 1. 当前状态
|
## 1. 当前状态
|
||||||
|
|
||||||
0.5.1 在 0.5.0 `Solid` 起步闭环 gate 基础上新增 Solid 稳定化和结构算法加固 gate,并继续保留工程 benchmark 矩阵作为长期规划。本版本的 Solid 参考邻域、修正矩阵、速度梯度、应变率、最小内力、damage、softening、显式 smoke、pressure wave smoke、Explosive programmed burn、Gas 源项注入和 Gas bubble metrics 只用于小规模数值链路检查,不作为工程精度 benchmark。
|
0.6.0 在 0.5.1 `Solid` 稳定化 gate 基础上新增 Shell 输入与状态基线 gate,并继续保留工程 benchmark 矩阵作为长期规划。本版本的 Shell material/section 输入、厚度/积分点/剪切修正校验、粒子级状态数组和厚度积分点状态数组只用于小规模链路检查,不作为工程精度 benchmark。
|
||||||
|
|
||||||
## 2. 0.1.0 Release Gate
|
## 2. 0.1.0 Release Gate
|
||||||
|
|
||||||
@@ -328,6 +328,26 @@
|
|||||||
|---|---|---|
|
|---|---|---|
|
||||||
| 2026-07-03 | `build-codex-unix` | 完整 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` 通过 |
|
| 2026-07-03 | `build-codex-unix` | 完整 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` 通过 |
|
||||||
|
|
||||||
|
## 2.11 0.6.0 Release Gate
|
||||||
|
|
||||||
|
0.6.0 默认 gate 在 0.5.1 Solid gate 基础上新增 Shell material/section 输入、厚度积分规则和 Shell 状态分配验收。当前 gate 只覆盖 Shell 输入与状态基线,不验收完整 Shell 动力学闭环。
|
||||||
|
|
||||||
|
| 测试名 | 类型 | 验收点 |
|
||||||
|
|---|---|---|
|
||||||
|
| `input_shell_section` | Fortran input | Shell material、`*SHELL SECTION`、厚度、3 点/5 点积分、剪切修正、section/material 映射和未绑定 material warning |
|
||||||
|
| `input_shell_errors` | Fortran input | 缺密度、缺弹性、Johnson-Cook 非有限参数、failure 非法参数、缺失 Shell section 和非法积分点错误路径 |
|
||||||
|
| `shell_state_build` | Fortran module | Shell 粒子级状态数组分配、默认值、active Shell 计数、section/material 映射和非 Shell 安全默认值 |
|
||||||
|
| `shell_section_integration` | Fortran module | 3 点/5 点厚度积分坐标、权重、积分点状态数组和 Shell section 规则 |
|
||||||
|
| `source_size` | 工具门禁 | Fortran/C/C++/Python 文件和 stale exception 检查 |
|
||||||
|
|
||||||
|
0.6.0 不验收 director/转动更新、Mindlin-Reissner 应变路径、Shell 材料点更新、Shell 内力、Shell 内力矩、显式推进、restart、接口层或生产计算路径,也不验收真实水-气-结构工程爆炸响应和真实 FEM-SPH 联合运行。
|
||||||
|
|
||||||
|
本地验收记录:
|
||||||
|
|
||||||
|
| 日期 | 构建目录 | 结果 |
|
||||||
|
|---|---|---|
|
||||||
|
| 2026-07-03 | `build-codex-unix` | 完整 CTest 103/103 通过,0.6.0 Shell 输入/状态基线 gate 4/4 通过,`source_size` 1/1 通过,`git diff --check` 通过 |
|
||||||
|
|
||||||
## 3. 基础数值矩阵
|
## 3. 基础数值矩阵
|
||||||
|
|
||||||
| 领域 | 测试或 benchmark | 验收点 |
|
| 领域 | 测试或 benchmark | 验收点 |
|
||||||
|
|||||||
Reference in New Issue
Block a user