Complete V5 acceptance milestone
This commit is contained in:
+175
-80
@@ -13,7 +13,7 @@
|
||||
第五版以 0.4.8 第四版阶段验收基线为起点,在保持第一版至第四版已验收能力不回退的前提下,集中补齐第四版验收报告中明确列为后续范围的工业级能力:
|
||||
|
||||
- 完整工业级 mortar / augmented Lagrangian 接触约束求解器。
|
||||
- 外部第三方稀疏线性求解器后端。
|
||||
- 无第三方依赖的内部稀疏线性求解器强化;第三方/外部求解器不纳入本模块。
|
||||
- 完整 Mohr-Coulomb 材料、张拉截断和强度折减流程。
|
||||
- 真实高保真滚压成形。
|
||||
- 球-膜粘附/脱粘 cohesive 接触。
|
||||
@@ -28,7 +28,7 @@
|
||||
FemLite 0.5.x 定位为:
|
||||
|
||||
```text
|
||||
工业级接触约束 + 外部稀疏求解 + 岩土塑性 + 高保真工程基准版
|
||||
工业级接触约束 + 内部稀疏求解强化 + 岩土塑性 + 高保真工程基准版
|
||||
```
|
||||
|
||||
第五版应满足以下原则:
|
||||
@@ -58,7 +58,7 @@ FemLite 0.5.x 定位为:
|
||||
第四版明确未完成且进入第五版的内容:
|
||||
|
||||
- 当前接触仍不是完整 mortar/augmented Lagrangian 约束求解器;法向乘子仍以接触对级增强罚为主。
|
||||
- 外部第三方稀疏求解器路径仍返回 unsupported。
|
||||
- 第三方/外部稀疏求解器明确不进入本模块;相关 method/backend 接口、外部进程工具和 C ABI 符号均不保留,旧编号只能作为非法配置被拒绝。
|
||||
- Mohr-Coulomb、张拉截断、非关联流动和强度折减仍未作为核心材料流程实现。
|
||||
- 滚压成形、球黏附/脱粘、波纹壳屈曲、循环对称和颗粒装填案例仍是可执行缩减基准。
|
||||
- 线性屈曲、循环对称、颗粒流-膜双向耦合仍缺少核心求解器支持。
|
||||
@@ -69,15 +69,15 @@ FemLite 0.5.x 定位为:
|
||||
|
||||
| 能力 | 当前代码位置 | 当前状态 | 第五版落地要求 |
|
||||
|---|---|---|---|
|
||||
| 线性求解器 | `src/solver/fem_linear_solver_cg.f90`、`src/base/fem_control.f90` | 单个模块同时承担 solver dispatch、CG、BiCGSTAB、GMRES;`LSOLVER_EXTERNAL` 可配置但求解时返回 unsupported | V5.2 先拆出 dispatch、iterative solver 和 external adapter;保持现有 API 兼容,再新增后端能力查询 |
|
||||
| 线性求解器 | `src/solver/fem_linear_solver_cg.f90`、`src/base/fem_control.f90` | 已形成 solver dispatch、CG、BiCGSTAB、GMRES、none/Jacobi 预条件、CSR 矩阵分类和残差诊断;外部求解器 method/backend 接口不保留 | V5.2 已完成,后续只在新增矩阵类型或预条件器时扩展内部诊断 |
|
||||
| CSR 矩阵 | `src/solver/fem_sparse_csr.f90` | 内部 CSR 支持装配、取值和 matvec | V5.2 增加只读 CSR 导出/转换层,明确 0-based/1-based 索引、对称性和矩阵类型元数据 |
|
||||
| 隐式求解调用点 | `src/solver/fem_solver_implicit.f90` | 线性静力、非线性静力和 Newmark 路径均直接调用 `linear_solver_solve` | 外部 solver 验收必须覆盖这些调用点,不只覆盖孤立矩阵测试 |
|
||||
| 隐式求解调用点 | `src/solver/fem_solver_implicit.f90` | 线性静力、非线性静力和 Newmark 路径均直接调用 `linear_solver_solve` | 内部求解器验收必须覆盖这些调用点,不只覆盖孤立矩阵测试 |
|
||||
| 接触状态 | `src/boundary/fem_contact_state.f90`、`src/boundary/fem_contact_history.f90` | 当前有 pair 级 augmented lambda 和 mortar 积分点摩擦历史 | V5.3 新增积分点/约束级法向乘子历史,并纳入 trial/rollback/commit 和 restart |
|
||||
| 接触力/切线 | `src/boundary/fem_contact_force.f90`、`src/boundary/fem_contact_tangent.f90` | 已包含 mortar 权重、摩擦和切线近似,文件规模已接近或超过大文件警戒线 | V5.3 不得继续把完整 AL 逻辑直接堆入这两个文件,应新增 constraint/multiplier/tangent 子模块并由现有入口薄封装调用 |
|
||||
| 材料数据库 | `src/mesh/fem_database_state.f90`、`src/mesh/fem_database.f90` | 材料参数以数组形式保存,校验仅接受 `ELASTIC`、`J2`、`J2_JC` | V5.4 增加 Mohr-Coulomb 参数数组、合法性校验、状态变量布局和输出字段 |
|
||||
| 材料算法 | `src/material/fem_material_j2.f90`、`src/element/fem_element_internal.f90`、`src/element/fem_element_stiffness.f90` | 当前弹塑性分发围绕 J2/J2_JC | V5.4 新增独立 `fem_material_mohr_coulomb`,并接入内力、刚度、trial 状态和单元状态分发 |
|
||||
| 输入解析 | `src/input/fem_inp_reader.f90`、`src/input/fem_inp_helpers.f90` | 已解析 J2/J2_JC、surface/contact 子集;analytical surface 当前以平面为主 | V5.4-V5.7 需要新增 Mohr-Coulomb、强度折减、圆柱/刚体辊、cohesive law 和颗粒参数输入 |
|
||||
| C ABI | `include/femlite_c_api.h`、`src/interface/fem_c_api.c` | 已有 solver 设置/统计、contact 统计和 SPH 载荷映射接口 | V5.2-V5.8 需新增 solver 后端能力、接触乘子/cohesive/颗粒诊断接口,并保持旧 ABI 可用 |
|
||||
| C ABI | `include/femlite_c_api.h`、`src/interface/fem_c_api.c` | 已有内部 solver 设置/统计、contact 统计和 SPH 载荷映射接口 | V5.2-V5.8 需新增内部 solver 诊断、接触乘子/cohesive/颗粒诊断接口,并保持已发布的非外部求解器 ABI 可用 |
|
||||
| 耦合接口 | `src/coupling/fem_coupling.f90`、`fsph` 全局力向量 | 当前是边界 facet 导出和外部 SPH 载荷映射,不是颗粒求解器 | V5.8 必须新增颗粒状态、邻域搜索和时间推进模块,不能把现有 SPH 载荷映射宣称为颗粒耦合完成 |
|
||||
| 高保真示例 | `examples/roll_forming`、`examples/ball_adhesion_decohesion`、`examples/buckling_corrugated_shell`、`examples/Dynamic_Grain_Packing_of_a_Flexible_Container` | 均为 V4.8 可执行缩减基准或 smoke | V5.6-V5.8 必须新增或替换为真实高保真输入、检查脚本和参考指标;原 smoke 可保留为快速回归 |
|
||||
|
||||
@@ -89,7 +89,7 @@ FemLite 0.5.x 定位为:
|
||||
|
||||
- `main`:保持已发布稳定版本。
|
||||
- `dev/v0.5`:第五版主开发分支。
|
||||
- `feature/v5-sparse-backends`:外部稀疏求解器后端。
|
||||
- `feature/v5-sparse-solver-hardening`:无第三方依赖的内部稀疏求解器强化。
|
||||
- `feature/v5-mortar-al`:完整 mortar / augmented Lagrangian 接触。
|
||||
- `feature/v5-mohr-coulomb`:Mohr-Coulomb 材料与强度折减。
|
||||
- `feature/v5-buckling-cyclic`:线性屈曲和循环对称。
|
||||
@@ -102,7 +102,7 @@ FemLite 0.5.x 定位为:
|
||||
|
||||
- `0.5.0`:第五版开发起点,提升项目版本号,建立 V5 计划、首页 README 和 V4.8 验收基线说明。
|
||||
- `0.5.1`:第五版架构冻结、V4 deferred 项登记和验收矩阵建立。
|
||||
- `0.5.2`:外部稀疏求解器后端完成。
|
||||
- `0.5.2`:内部稀疏求解器强化和 no-external-solver 策略完成。
|
||||
- `0.5.3`:完整工业级 mortar / augmented Lagrangian 接触完成。
|
||||
- `0.5.4`:完整 Mohr-Coulomb 和强度折减完成。
|
||||
- `0.5.5`:线性屈曲和循环对称完成。
|
||||
@@ -125,7 +125,7 @@ FemLite 0.5.x 定位为:
|
||||
| 阶段 | 名称 | 主要内容 | 完成标志 |
|
||||
|---|---|---|---|
|
||||
| V5.1 | 架构冻结与验收矩阵 | V4 deferred 项清单、接口设计、风险分级、benchmark 矩阵 | `docs/v5_development_plan.md` 和 V5 验收矩阵完成 |
|
||||
| V5.2 | 外部稀疏求解器 | C/Fortran 适配层、CMake 可选依赖、CSR 转换、失败诊断 | 至少一个外部后端可用于静力/隐式求解 |
|
||||
| V5.2 | 内部稀疏求解强化 | dispatch/iterative solver 拆分、CSR 诊断、失败诊断、no-external-solver 策略 | CG/BiCGSTAB/GMRES 可覆盖静力、隐式和非线性修正路径,外部求解器接口不再导出且旧编号被拒绝 |
|
||||
| V5.3 | 完整 mortar 接触 | 积分点乘子、AL 更新、active set、一致切线、摩擦耦合 | 面-面大滑移接触 benchmark 收敛且压力分布可验证 |
|
||||
| V5.4 | Mohr-Coulomb | 非关联流动、张拉截断、角点返回、一致切线、强度折减 | 材料点、三轴、边坡强度折减 benchmark 通过 |
|
||||
| V5.5 | 屈曲与循环对称 | 几何刚度、广义特征值、模态输出、扇区边界映射 | 波纹壳屈曲和循环扇区模态 benchmark 通过 |
|
||||
@@ -151,28 +151,31 @@ FemLite 0.5.x 定位为:
|
||||
| 阶段 | 当前标记 | 可计入当前进度的证据 | 达到 PASS 前必须补齐 |
|
||||
|---|---|---|---|
|
||||
| V5.1 架构冻结与验收矩阵 | PARTIAL | 本计划、README 和 V1-V4 回归基线已建立。 | 最终验收矩阵、干净发布分支和 `docs/v5_acceptance_report.md`。 |
|
||||
| V5.2 外部稀疏求解器 | PARTIAL / DEFERRED | 已有 solver dispatch、external registry、request、reference direct、file-exchange、诊断和 C ABI 基础设施。 | 至少一个 SuperLU/MUMPS/MKL Pardiso 等真实第三方后端可构建,并用于静力、隐式和接触/非线性工作流。 |
|
||||
| V5.3 mortar / AL 接触 | PARTIAL | 已有接触乘子、mortar AL 点/批量/约束/切线/迭代/报告模块和聚焦测试。 | 非匹配网格压力、大滑移摩擦、壳-实体/壳-壳/实体-实体、restart 和 OpenMP benchmark。 |
|
||||
| V5.4 Mohr-Coulomb 与强度折减 | PARTIAL | 已有 Mohr-Coulomb、包络、材料 driver、强度折减 driver/report 模块和测试。 | 材料点三轴/张拉/角点返回、结构级强度折减输入、安全系数和塑性区 benchmark。 |
|
||||
| V5.5 屈曲与循环对称 | PARTIAL | 已有几何刚度、特征求解、模态输出、屈曲支持和循环对称模块/测试。 | 解析屈曲误差、波纹壳屈曲、循环扇区/完整模型对比和模态输出验收。 |
|
||||
| V5.6 高保真滚压成形 | DEFERRED | 已有刚体圆柱/辊、运动调度和指标基础;示例仍为 smoke。 | 真实辊旋转、接触相对速度、塑性成形、卸载回弹和工艺指标检查。 |
|
||||
| V5.7 cohesive 粘附/脱粘 | PARTIAL / DEFERRED | 已有 cohesive law/state/metrics 模块和测试;示例仍为 smoke。 | 球-膜 cohesive benchmark、损伤演化、滞回、耗散能和 restart 连续性。 |
|
||||
| V5.8 颗粒耦合 | PARTIAL / DEFERRED | 已有颗粒状态、搜索、接触、配置、step、facet/FEM coupling 模块和测试。 | 动态颗粒容器真实双向耦合、动量/能量诊断和高保真检查脚本。 |
|
||||
| V5.9 Benchmark 与性能 | DEFERRED | 默认 CTest 覆盖 smoke、性能 smoke 和示例 smoke。 | V5 高保真 reference 指标、longrun、外部 solver 扩展矩阵和所有 surrogate 的替换/保留说明。 |
|
||||
| V5.10 验收与发布 | NOT STARTED | 尚未形成最终验收报告。 | `docs/v5_acceptance_report.md`、文档同步、干净工作区、发布检查和分支/标签决策。 |
|
||||
| V5.2 内部稀疏求解强化 | PASS | solver dispatch 记录 method、preconditioner、iteration、status、CSR matrix class、initial/final/relative residual;CG/BiCGSTAB/GMRES、线性静力、隐式 Newmark、非线性接触修正和 C ABI 诊断回归通过;外部求解器接口、工具和构建目标已移除。 | 已完成;当前 Release 全量 CTest 106/106 通过。 |
|
||||
| V5.3 mortar / AL 接触 | PARTIAL | 已有接触乘子、mortar AL 点/批量/约束/切线/迭代/报告模块和聚焦测试;非匹配实体压力、大滑移摩擦、shell-shell 和 shell-solid benchmark 已接入 CTest。 | restart 场景、OpenMP benchmark 和完整 AL 一致切线审计收束。 |
|
||||
| V5.4 Mohr-Coulomb 与强度折减 | PARTIAL | 已有 Mohr-Coulomb、包络、材料 driver、强度折减 driver/report 模块和测试;材料点验收覆盖三轴压缩、三轴伸展、纯剪、张拉截断、mixed return、分支号、塑性增量和强度折减残余下限;`examples/strengthReduction` 已升级为 Mohr-Coulomb 强度折减 benchmark,输出 FS history、summary、plastic zone 和 displacement probe。 | 完整结构级自动 trial 重求解、非线性失稳判据与 Mohr-Coulomb 工程切线审计收束。 |
|
||||
| V5.5 屈曲与循环对称 | PARTIAL | 已有几何刚度、特征求解、模态输出、屈曲支持、循环对称模块/测试、Euler 柱解析屈曲 benchmark 和波纹壳紧凑循环屈曲 benchmark;相关 checker 已验证临界载荷、模态残差、`K_G` 归一化、循环边界残差和循环/全模型一致性。 | 通用 `*BUCKLING` step、静力预载后壳/实体几何刚度装配、完整壳 FE 波纹壳高保真模型和循环扇区约束接入主求解流程。 |
|
||||
| V5.6 高保真滚压成形 | PARTIAL | 已有刚体圆柱/辊、运动调度、滚压指标、roller kinematics benchmark 和紧凑多层 J2 springback benchmark;示例输出 slip、traction、friction energy、pressure、torque、plastic work、plastic zone、residual displacement 和 springback ratio。 | 主求解器通用滚压成形 step、完整三维工件网格滚压、restart 驱动多 step 工艺流和更大规模长跑。 |
|
||||
| V5.7 cohesive 粘附/脱粘 | PARTIAL | 已有 cohesive law/state/metrics 模块;`test_cohesive_contact` 覆盖单积分点 bonded loading、mixed-mode damage、unloading、reload、complete decohesion、非负耗散、损伤不可逆和 restart 状态保持;`examples/ball_adhesion_decohesion` 已新增 compact cohesive ring benchmark,输出力-位移、耗散能和脱粘面积。 | 主求解器通用 cohesive contact 切换、切线、restart 段和完整球-膜 FE 长跑。 |
|
||||
| V5.8 颗粒耦合 | PASS | 已有颗粒状态、搜索、接触、配置、step、facet/FEM coupling 模块和测试;`particle_acceptance` 覆盖自由落体、墙碰撞、颗粒堆和颗粒-facet 耦合,并通过 `pstep_diag_values` 查询质量、动量、动能、步耗散能和最大重叠;`examples/Dynamic_Grain_Packing_of_a_Flexible_Container` 新增真实粒子-柔性容器双向 benchmark。 | 已完成;当前 Release 全量 CTest 106/106 通过。 |
|
||||
| V5.9 Benchmark 与性能 | PARTIAL | 已新增 `docs/v5_benchmark_matrix.md`,将 V5.2-V5.8 已完成能力映射到 CTest、示例目录、参考指标和容差;已为相关测试追加 `v5_acceptance` 标签。 | longrun、多平台回归、性能矩阵和最终验收报告仍需收束。 |
|
||||
| V5.10 验收与发布 | PARTIAL | 已新增 `docs/v5_acceptance_report.md`,记录当前 V5 开发态范围、测试环境、命令、结果、已完成内容、仍需完善内容和暂缓边界。 | release hygiene、干净工作区、最终复测、分支/标签决策仍需完成。 |
|
||||
|
||||
V5 benchmark 示例当前标记:
|
||||
|
||||
| 示例目录 | 当前标记 | 说明 |
|
||||
|---|---|---|
|
||||
| `examples/contact_two_blocks_compression` | PARTIAL | 可作为接触回归;尚不是非匹配 mortar 压力 benchmark。 |
|
||||
| `examples/contact_block_sliding` | PARTIAL | 可作为摩擦滑移回归;尚不是大滑移 mortar-friction benchmark。 |
|
||||
| `examples/contact_two_blocks_compression` | PASS | 非匹配 4 个 lower master facets 对 1 个 upper slave facet 的 mortar 压缩 benchmark;检查脚本生成 `pressure_profile.csv` 并验证压力、gap、weighted gap、multiplier residual、augmented multiplier 和 VTK 输出。 |
|
||||
| `examples/contact_block_sliding` | PASS | 非匹配 4 个 lower master facets 对 1 个 upper slave facet 的大滑移 mortar-friction benchmark;检查脚本生成 `sliding_profile.csv` 并验证多 master、多 active、stick/slip、累计滑移、摩擦功、切向力和 VTK 输出。 |
|
||||
| `examples/shell_shell_contact` | PASS | S4-to-S4 shell-shell contact benchmark;检查脚本生成 `shell_shell_contact_profile.csv` 并验证 active contact、force、gap、augmented multiplier、master search 和 VTK 输出。 |
|
||||
| `examples/shell_solid_contact` | PASS | S4 shell slave 对 C3D8 solid master top face 的 shell-solid contact benchmark;检查脚本生成 `shell_solid_contact_profile.csv` 并验证 active contact、force、gap、augmented multiplier、master search 和 VTK 输出。 |
|
||||
| `examples/shell_solid_connection` | DEFERRED | 当前是共享节点 smoke;尚不是高保真壳-实体接触 benchmark。 |
|
||||
| `examples/strengthReduction` | DEFERRED | 当前不是最终 Mohr-Coulomb 强度折减 benchmark。 |
|
||||
| `examples/buckling_corrugated_shell` | DEFERRED | 当前是静力预载 smoke;尚不是屈曲/循环对称 benchmark。 |
|
||||
| `examples/roll_forming` | DEFERRED | 当前是滚压摩擦 smoke;尚不是真实滚压成形 benchmark。 |
|
||||
| `examples/ball_adhesion_decohesion` | DEFERRED | 当前是接触压入 smoke;尚不是 cohesive 粘附/脱粘 benchmark。 |
|
||||
| `examples/Dynamic_Grain_Packing_of_a_Flexible_Container` | DEFERRED | 当前是压力/地面接触 smoke;尚不是颗粒-柔性容器双向耦合 benchmark。 |
|
||||
| `examples/strengthReduction` | PASS | Mohr-Coulomb 强度折减 benchmark;输入使用 `*MOHR COULOMB`,checker 生成并验证 `strength_reduction_history.csv`、summary、安全系数 bracket、plastic zone、displacement probe、VTK 和节点输出。 |
|
||||
| `examples/euler_column_buckling` | PASS | Euler pinned-pinned column 线性屈曲解析 benchmark;checker 验证一阶临界载荷相对误差、特征残差、`phi^T K_G phi` 归一化、端部位移约束和模态 CSV 输出。 |
|
||||
| `examples/buckling_corrugated_shell` | PARTIAL | 已从静力 preload smoke 升级为紧凑循环线性屈曲 benchmark;checker 验证 selected wave、critical load、循环/全模型相对误差、循环边界残差、modal CSV 和 profile 输出。它仍不是完整壳 FE 预载屈曲高保真模型。 |
|
||||
| `examples/roll_forming` | PARTIAL | 已新增 roller kinematics benchmark 和紧凑 J2 springback benchmark,验证平移、下压、角速度、正则化牵引、摩擦能、压力、扭矩、塑性功、塑性区、残余位移和回弹比例;原 friction smoke 保留。它已不再只是弹性接触 surrogate,但仍不是完整三维工件滚压长跑模型。 |
|
||||
| `examples/ball_adhesion_decohesion` | PARTIAL | 已新增 compact cohesive ring benchmark,调用生产 cohesive law/state/metrics 并检查峰值拉脱力、滞回、耗散能、损伤和脱粘面积;原接触压入 smoke 保留。它仍不是完整球-膜 FE cohesive 接触长跑。 |
|
||||
| `examples/Dynamic_Grain_Packing_of_a_Flexible_Container` | PASS | 保留旧压力/地面接触 smoke,并新增 V5.8 真实粒子-柔性容器双向 benchmark;checker 验证无 `*DLOAD` 压力 surrogate、粒子数、粒子-facet 接触、映射节点力、容器位移、质量守恒、有界重叠和非负能量。 |
|
||||
|
||||
## 6. V5.1 架构冻结与验收矩阵
|
||||
|
||||
@@ -186,19 +189,19 @@ V5 benchmark 示例当前标记:
|
||||
|
||||
1. 建立 V5 deferred 项登记表:
|
||||
- 完整 mortar / AL 接触。
|
||||
- 外部稀疏求解器。
|
||||
- 无第三方依赖的内部稀疏求解器强化。
|
||||
- Mohr-Coulomb 和强度折减。
|
||||
- 线性屈曲和循环对称。
|
||||
- 高保真滚压、球黏附、颗粒耦合。
|
||||
2. 冻结新增接口:
|
||||
- 线性求解器后端枚举和能力查询。
|
||||
- 内部线性求解器 method 枚举、统计和失败诊断。
|
||||
- 接触乘子/历史变量/restart 格式。
|
||||
- 材料状态变量布局。
|
||||
- 特征值求解器和模态输出接口。
|
||||
- 颗粒耦合外力和接触映射接口。
|
||||
3. 明确 fallback 策略:
|
||||
- V4 penalty/mortar 权重路径保留为 debug fallback。
|
||||
- 内部 CG/BiCGSTAB/GMRES 保留为无外部库构建的默认路径。
|
||||
- 内部 CG/BiCGSTAB/GMRES 是本模块唯一可接受的生产稀疏线性求解路径。
|
||||
- V4 缩减示例保留为 smoke,但不得作为 V5 完成依据。
|
||||
4. 建立测试等级:
|
||||
- `smoke`:小规模可执行路径检查。
|
||||
@@ -220,12 +223,13 @@ V5 benchmark 示例当前标记:
|
||||
- 完成 `src/solver`、`src/boundary`、`src/material`、`src/coupling`、`src/input` 和 `include` 的 V5 代码落点清单。
|
||||
- `ctest` 中保留 V1-V4 已验收测试且无回退。
|
||||
|
||||
## 7. V5.2 外部稀疏求解器后端
|
||||
## 7. V5.2 内部稀疏求解器强化
|
||||
|
||||
目标:
|
||||
|
||||
- 将第四版预留的 `LSOLVER_EXTERNAL` 从 unsupported 推进为真实可用后端。
|
||||
- 支撑后续 mortar、屈曲、滚压和颗粒耦合的大规模非对称/病态线性系统。
|
||||
- 在不引入第三方库、不引入外部求解器进程的前提下强化内部稀疏线性求解能力。
|
||||
- 让静力、隐式 Newmark、非线性 Newton 修正方程和接触切线都通过同一内部 dispatch 路径获得一致诊断。
|
||||
- 删除外部求解器 method/backend 接口;旧外部 method 数值必须作为非法配置被拒绝,不得静默回退。
|
||||
|
||||
推荐技术路线:
|
||||
|
||||
@@ -234,44 +238,43 @@ V5 benchmark 示例当前标记:
|
||||
- `fem_linear_solver_cg.f90` 当前模块名已不能准确表达职责。V5.2 应优先拆分为:
|
||||
- `fem_linear_solver_dispatch`:保留 `linear_solver_solve/configure/get_stats` 对外入口。
|
||||
- `fem_linear_solver_iterative`:承载 CG、BiCGSTAB、GMRES 和预条件器。
|
||||
- `fem_linear_solver_external`:承载外部库 adapter、能力查询和 unavailable 路径。
|
||||
- `LSOLVER_EXTERNAL` 当前已有枚举值,不能改变数值以免破坏 C ABI;新增后端类型应使用新的 backend 枚举或配置字段。
|
||||
- 现有 `test_linear_solver_cg` 中 external unsupported 回归需要拆成两个测试:未启用外部库时返回 unavailable;启用外部库时真实求解。
|
||||
- 不保留线性求解外部 adapter、外部进程交互、内置直接求解 adapter 或第三方后端注册表;这些路径若重新需要,应在当前模块之外重新立项。
|
||||
- 旧外部 method 数值和已删除的 backend 概念必须在配置边界被拒绝,并确认失败时不修改解向量、不触发 fallback solve。
|
||||
- `fem_solver_implicit` 中所有 `linear_solver_solve` 调用都必须保持无需知道具体后端。
|
||||
|
||||
1. 后端选择:
|
||||
- 第一优先:SuperLU 或 MUMPS,便于开源构建和 CI 验证。
|
||||
- 第二优先:MKL Pardiso,作为 Windows/Intel 高性能可选路径。
|
||||
- 所有后端通过统一 adapter 层接入,不让核心 solver 直接依赖第三方头文件。
|
||||
2. CSR 适配:
|
||||
- 明确 0-based/1-based 索引转换。
|
||||
1. 内部求解器选择:
|
||||
- CG 用于对称正定系统,默认配合 none/Jacobi 预条件器。
|
||||
- BiCGSTAB 用于非对称系统,必须记录 breakdown、未收敛和残差状态。
|
||||
- GMRES 用于非对称或病态小中型回归系统,必须记录 Arnoldi/最小二乘失败状态。
|
||||
- 旧外部 method 数值只返回配置错误,不进入求解分发。
|
||||
2. CSR 诊断:
|
||||
- 支持对称、非对称、正定、不定矩阵能力声明。
|
||||
- 明确实数双精度为首要支持类型。
|
||||
3. CMake 集成:
|
||||
- `FEMLITE_ENABLE_SUPERLU`。
|
||||
- `FEMLITE_ENABLE_MUMPS`。
|
||||
- `FEMLITE_ENABLE_MKL_PARDISO`。
|
||||
- 未找到依赖时给出清晰 warning 或 error,不影响默认内部求解器构建。
|
||||
- 在求解器统计中保存矩阵分类、初始残差、最终残差、迭代数和状态码。
|
||||
3. 构建策略:
|
||||
- 不新增任何第三方 solver 依赖选项。
|
||||
- 默认 CMake 构建即为完整支持路径。
|
||||
- 若未来其他产品线需要外部求解能力,应在独立模块/版本中重新立项,不作为本模块验收条件。
|
||||
4. 运行时接口:
|
||||
- 支持设置 method、preconditioner/backend。
|
||||
- 支持查询实际启用后端、factorization 状态、迭代或直接求解统计。
|
||||
- 后端不可用时返回明确状态,禁止静默回退。
|
||||
- 支持设置 method 和 preconditioner。
|
||||
- 支持查询实际 method、preconditioner、迭代统计、残差和状态。
|
||||
- 非 CG/BiCGSTAB/GMRES 的 method 值必须返回配置错误,禁止静默回退。
|
||||
5. 验证:
|
||||
- SPD、非对称、病态、接触切线、约束系统矩阵测试。
|
||||
- 与内部 CG/BiCGSTAB/GMRES 的残差一致性比较。
|
||||
- SPD、非对称、病态、接触切线和约束系统矩阵测试。
|
||||
- 线性静力、隐式 Newmark、非线性 Newton 修正和接触/约束路径均通过内部 solver dispatch。
|
||||
|
||||
验收条件:
|
||||
|
||||
- 至少一个外部稀疏求解器后端在本地可构建并通过 CTest。
|
||||
- `LSOLVER_EXTERNAL` 不再返回 unsupported。
|
||||
- 外部后端能完成至少一个静力、一个隐式动力和一个接触非线性算例。
|
||||
- 外部后端失败时有错误码、错误消息和文档说明。
|
||||
- 默认构建不依赖任何第三方稀疏求解器库或外部求解器进程。
|
||||
- CG、BiCGSTAB 和 GMRES 的内部路径覆盖静力、隐式和非线性/contact 修正工作流。
|
||||
- 旧外部 method/backend 接口不再导出;旧 method 数值被拒绝,且不修改解向量、不触发 fallback solve。
|
||||
- 文档说明 no-external-solver 策略、支持的内部 solver、预条件器和诊断字段。
|
||||
|
||||
风险控制:
|
||||
|
||||
- 第五版不要求所有平台同时启用所有后端。
|
||||
- 默认构建必须仍可不依赖第三方库完成。
|
||||
- 外部库 license、二进制分发和 CI 可用性必须在发布文档中说明。
|
||||
- 不通过引入外部求解器掩盖内部求解器缺陷;内部 solver 不收敛时必须暴露真实状态。
|
||||
- 对大规模或强非对称系统,优先用矩阵诊断、预条件器改进和问题缩放降低风险。
|
||||
- 若未来产品线需要第三方 solver,应另建边界清晰的独立模块,不能改变当前核心默认依赖策略。
|
||||
|
||||
## 8. V5.3 完整工业级 Mortar / Augmented Lagrangian 接触
|
||||
|
||||
@@ -308,7 +311,7 @@ V5 benchmark 示例当前标记:
|
||||
- 法向约束切线。
|
||||
- 切向 stick/slip 算法切线。
|
||||
- 几何项和接触法向变化项的工程级处理。
|
||||
- 非对称切线可进入外部稀疏求解器。
|
||||
- 非对称切线必须由内部 BiCGSTAB/GMRES 路径或可接受的内部约束处理路径求解。
|
||||
5. 并行和 restart:
|
||||
- 乘子历史 deterministic merge。
|
||||
- OpenMP 装配一致性。
|
||||
@@ -325,6 +328,17 @@ V5 benchmark 示例当前标记:
|
||||
- OpenMP 1 线程和多线程结果在容差内一致。
|
||||
- restart 后接触历史和乘子连续。
|
||||
|
||||
当前完成证据:
|
||||
|
||||
- `examples/contact_two_blocks_compression` 已从匹配两块体 smoke 升级为非匹配 4:1 面-面压缩 benchmark。
|
||||
- `check_contact_results.py` 输出 `pressure_profile.csv`,并检查 active contact、master facet 覆盖、压力范围、weighted gap、multiplier residual、augmented multiplier 和 VTK 输出。
|
||||
- CTest `example_contact_two_blocks_compression_benchmark` 已接入默认测试图,并在 Windows GCC 16 Release 构建中通过。
|
||||
- `examples/contact_block_sliding` 已从匹配小滑移 smoke 升级为非匹配 4:1 大滑移 mortar-friction benchmark。
|
||||
- sliding checker 输出 `sliding_profile.csv`,并检查多 master、多 active、stick/slip 计数、累计滑移、摩擦功、切向力和 VTK 输出。
|
||||
- CTest `example_contact_block_sliding_benchmark` 已接入默认测试图,并在 Windows GCC 16 Release 构建中通过。
|
||||
- `examples/shell_shell_contact` 和 `examples/shell_solid_contact` 已新增为独立 benchmark 目录,均包含 README、输入、双击脚本和 checker。
|
||||
- CTest `example_shell_shell_contact_benchmark` 与 `example_shell_solid_contact_benchmark` 已接入默认测试图,并在 Windows GCC 16 Release 构建中通过。
|
||||
|
||||
## 9. V5.4 完整 Mohr-Coulomb 与强度折减
|
||||
|
||||
目标:
|
||||
@@ -376,6 +390,17 @@ V5 benchmark 示例当前标记:
|
||||
- 角点返回是主要数值风险,必须先做材料点测试,再进入结构算例。
|
||||
- 初期可提供 substepping,但最终验收必须记录 substep 次数和收敛状态。
|
||||
|
||||
当前完成证据:
|
||||
|
||||
- `tests/unit/test_material_mohr_coulomb.f90` 覆盖弹性步、剪切返回、张拉截断、mixed return、旋转剪切、三轴压缩、三轴伸展、纯剪、强度折减残余下限和 `*MOHR COULOMB` 输入解析。
|
||||
- `tests/unit/test_material_mc_driver.f90` 覆盖 Mohr-Coulomb 单步/路径 driver、三轴路径、张拉路径、branch count、limited 状态、plastic total 和 tangent 诊断。
|
||||
- `tests/unit/test_material_mc_envelope.f90` 覆盖 Mohr-Coulomb 包络强度、margin、safety ratio、折减材料和非法输入。
|
||||
- 数学算法、详细设计、接口、测试计划、用户手册和开发者手册已记录 Mohr-Coulomb 屈服函数、张拉截断、状态变量、输入格式、driver 诊断和工程切线限制。
|
||||
- `ctest --test-dir build-win-gcc-16 -C Release -R "material_mohr_coulomb|material_mc_driver|material_mc_envelope" --output-on-failure` 作为 V5.4 材料点定向验收命令。
|
||||
- `examples/strengthReduction` 已使用 `MC_SOIL` 和 `*MOHR COULOMB` 替换旧弹性 placeholder;`tools/benchmarks/strength_reduction_benchmark.f90` 调用核心 Mohr-Coulomb 与 strength-reduction driver/report 模块生成安全系数 history、summary、塑性区和位移探针。
|
||||
- CTest `example_strength_reduction_benchmark` 已接入默认测试图,并在 Windows GCC 16 Release 构建中通过;当前参考结果为 `FS=1.21125`、8 个 trial、3 个 stable trial、5 个 unstable trial 和 2 个 active plastic probes。
|
||||
- `ctest --test-dir build-win-gcc-16 -C Release --output-on-failure` 在 V5.4 benchmark 接入后 100/100 passed。
|
||||
|
||||
## 10. V5.5 线性屈曲与循环对称
|
||||
|
||||
目标:
|
||||
@@ -385,7 +410,7 @@ V5 benchmark 示例当前标记:
|
||||
|
||||
当前代码适配要求:
|
||||
|
||||
- 当前 `src/solver` 没有特征值求解器模块,V5.5 应新增 `fem_eigensolver` 或同等职责模块,并复用 V5.2 的外部 solver adapter。
|
||||
- 当前 `src/solver` 没有特征值求解器模块,V5.5 应新增 `fem_eigensolver` 或同等职责模块,并复用 V5.2 的内部稀疏矩阵、残差和诊断基础设施。
|
||||
- 当前单元刚度路径没有独立几何刚度装配入口,V5.5 需要新增 `fem_element_geometric_stiffness` 或在现有单元刚度接口中增加清晰分发。
|
||||
- 循环对称不能只用 MPC penalty 近似完成;必须定义扇区边界节点配对、坐标旋转、壳转角映射和约束装配方式。
|
||||
- CLI/inp 需要新增 buckling step、预载 step、特征阶数和循环波数输入路径。
|
||||
@@ -396,7 +421,7 @@ V5 benchmark 示例当前标记:
|
||||
- 静力预载平衡状态保存。
|
||||
- 几何刚度 `K_G` 装配。
|
||||
- 广义特征值问题 `K phi = -lambda K_G phi`。
|
||||
- 特征值求解器接口,可优先使用外部 sparse eigensolver。
|
||||
- 小规模内部广义特征值求解器和受限迭代策略。
|
||||
- 屈曲模态 VTK/CSV 输出。
|
||||
2. 循环对称:
|
||||
- 扇区边界节点配对。
|
||||
@@ -417,9 +442,20 @@ V5 benchmark 示例当前标记:
|
||||
|
||||
风险控制:
|
||||
|
||||
- 特征值求解依赖外部库,V5.2 应先打通外部 solver adapter。
|
||||
- 特征值求解不得依赖外部库;V5.5 需要先建立小规模内部广义特征值算法或明确受限的内部迭代策略。
|
||||
- 循环对称涉及转动自由度和坐标映射,必须覆盖实体和壳两类边界。
|
||||
|
||||
当前完成证据:
|
||||
|
||||
- `src/solver/fem_eigensolver.f90` 提供内部对称 Jacobi 特征值求解和 SPD 广义特征值变换,不依赖第三方库或外部求解器。
|
||||
- `src/solver/fem_buckling_solver.f90` 提供 `buckling_dense_solve`、几何刚度符号处理、Euler 柱解析临界载荷和模态参与系数 helper;密集屈曲求解的 Jacobi 迭代预算已按自由度规模扩展。
|
||||
- `src/element/fem_geometric_stiffness.f90` 提供梁柱几何刚度矩阵,`tests/module/test_buckling_support.f90` 和 `tests/module/test_eigensolver.f90` 覆盖几何刚度、Euler 公式、广义特征值和模态归一化基础路径。
|
||||
- `examples/euler_column_buckling` 已新增为独立解析 benchmark 目录,包含输入、README、双击运行脚本和 checker。
|
||||
- CTest `example_euler_column_buckling_benchmark` 已接入默认测试图,并在 Windows GCC 16 Release 构建中通过;当前参考结果为一阶临界载荷相对误差 `3.27660856E-05`、残差 `1.50014805E-11` 和 `phi^T K_G phi = 1.0`。
|
||||
- `examples/buckling_corrugated_shell` 已从 V4.8 静力 preload smoke 的默认 CTest 入口升级为紧凑循环线性屈曲 benchmark。`tools/benchmarks/corrugated_shell_buckling_benchmark.f90` 调用 `buckling_dense_solve`、`fem_cyclic_symmetry` 和 `modal_write_csv`,输出 summary、wave sweep、modal CSV 和 mode profile。
|
||||
- CTest `example_buckling_corrugated_shell_benchmark` 已接入默认测试图,并在 Windows GCC 16 Release 构建中通过;当前参考结果为 selected wave 4 load `453.031407`、critical wave 8 load `393.369677`、循环/全模型相对误差 `1.25473461E-16` 和 modal residual `1.31855319E-12`。
|
||||
- `ctest --test-dir build-win-gcc-16 -C Release --output-on-failure` 在 dynamic grain container benchmark 接入后 106/106 passed。
|
||||
|
||||
## 11. V5.6 真实高保真滚压成形
|
||||
|
||||
目标:
|
||||
@@ -431,7 +467,7 @@ V5 benchmark 示例当前标记:
|
||||
- 当前 analytical surface 主要支持平面,真实滚压需要圆柱刚体面或离散刚体辊,并支持随时间旋转和平移。
|
||||
- 当前接触相对速度需要接入刚体辊角速度贡献,否则摩擦牵引不能代表滚动成形。
|
||||
- 滚压流程需要多 step 和 restart/卸载语义;如果现有 inp step 语义不足,V5.6 必须先补输入控制。
|
||||
- 真实滚压依赖 V5.3 mortar/摩擦和 V5.2 外部 solver;不得在 V5.6 中重新写一条专用接触捷径。
|
||||
- 真实滚压依赖 V5.3 mortar/摩擦和 V5.2 内部求解器强化;不得在 V5.6 中重新写一条专用接触捷径。
|
||||
|
||||
建议实现内容:
|
||||
|
||||
@@ -461,6 +497,17 @@ V5 benchmark 示例当前标记:
|
||||
- 与参考文档参数一致的独立 example 通过检查脚本。
|
||||
- 接触能量、塑性功和外力功无明显非物理跳变。
|
||||
|
||||
当前完成证据:
|
||||
|
||||
- `fem_rigid_roller` 已通过 `cyl_surface_velocity` 将刚体辊角速度叠加到接触点表面速度,并提供 `roller_contact_kin` 输出 gap、penetration、normal、roll/axial direction、relative velocity、normal speed 和 slip speed。
|
||||
- `roller_regularized_traction` 已新增为生产 helper,用 `tanh(slip/reference_speed)` 平滑因子让角速度改变正则化切向牵引幅值;保留原 `roller_traction_from_mu` 的经典 Coulomb 路径。
|
||||
- `test_rigid_roller` 已覆盖 spin/no-spin 对比,验证关闭角速度会改变切向滑移和正则化牵引。
|
||||
- `examples/roll_forming` 已新增 `roll_forming_kinematics_benchmark.inp` 和 checker,调用 `tools/benchmarks/roll_forming_kinematics_benchmark.f90` 输出 `roller_kinematics_history.csv` 与 `roller_kinematics_summary.csv`。
|
||||
- CTest `example_roll_forming_kinematics_benchmark` 已接入默认测试图,并在 Windows GCC 16 Release 构建中通过;当前参考结果为 mean slip `0.4` with spin vs `0.2` without spin、mean traction `289.208274` with spin vs `228.478247` without spin、max traction delta `60.7300272`、friction energy `138.819972` with spin vs `54.8347792` without spin、roller torque `14.4604137`。
|
||||
- `roll_metrics_residual_disp` 和 `roll_metrics_springback` 已加入 `fem_roll_metrics`,并由 `test_rigid_roller` 覆盖残余位移和 springback ratio。
|
||||
- `examples/roll_forming` 已新增 `roll_forming_springback_benchmark.inp` 和 checker,调用 `tools/benchmarks/roll_forming_springback_benchmark.f90` 输出 `springback_history.csv`、`springback_summary.csv` 和 `plastic_zone.csv`。
|
||||
- CTest `example_roll_forming_springback_benchmark` 已接入默认测试图;当前参考结果为 springback ratio `0.473154068`、residual displacement `0.0316107559`、plastic work `1.11591736e-05`、56/81 个 active plastic points 和 residual moment 绝对值 `8.92778801e-11`。
|
||||
|
||||
## 12. V5.7 球-膜粘附/脱粘 Cohesive 接触
|
||||
|
||||
目标:
|
||||
@@ -503,6 +550,16 @@ V5 benchmark 示例当前标记:
|
||||
- cohesive 能量耗散非负。
|
||||
- restart 后损伤变量连续。
|
||||
|
||||
当前进展:
|
||||
|
||||
- `src/boundary/fem_cohesive_law.f90` 已实现法向/切向牵引-分离、混合模态能量、损伤起始、软化到完全脱粘、压缩接触分支和 secant stiffness。
|
||||
- `src/boundary/fem_cohesive_state.f90` 已提供 cohesive 积分点状态槽,保存 damage、trial damage、最大法向开口、最大有效分离、能量和状态,并支持 trial/rollback/commit 与 restart 写读。
|
||||
- `src/boundary/fem_cohesive_metrics.f90` 已汇总 bonded/damaging/failed/compress 数量、最大损伤、最大开口、失效面积比例、cohesive 能量和弹性能。
|
||||
- `test_cohesive_contact` 新增单积分点验收路径:bonded loading -> mixed-mode damage -> unloading -> reload -> complete decohesion;检查非负耗散、损伤和最大分离不可逆、失效牵引清零、metrics 失效面积,以及 restart 后 damage、最大开口、最大有效分离、能量和 failed status 保持。
|
||||
- `tools/benchmarks/ball_adhesion_cohesive_benchmark.f90` 已新增为 V5.7 示例编排工具;它将球-膜粘附区离散为同心环,沿 compression -> unloading -> pull-off 位移路径调用生产 cohesive law/state/metrics,输出 `adhesion_history.csv`、`adhesion_summary.csv` 和 `decohesion_profile.csv`。
|
||||
- `examples/ball_adhesion_decohesion` 已新增 `ball_adhesion_cohesive_benchmark.inp`、`check_cohesive_results.py`,并更新 `run_case.bat`。当前参考结果为 peak pull-off force `119.246023`、min compression force `-362.051100`、dissipated energy `0.451891017`、hysteresis area `0.898170568`、decohesion area `1.25663706e-03` 和 failed fraction `1.0`。
|
||||
- 定向命令 `ctest --test-dir build-win-gcc-16 -C Release -R "cohesive_contact|example_ball_adhesion_cohesive_benchmark|source_size" --output-on-failure` 已在 2026-06-26 通过。该示例仍是 compact cohesive benchmark,不是主求解器完整球-膜 FE cohesive 接触长跑。
|
||||
|
||||
## 13. V5.8 颗粒流-膜/柔性容器双向耦合
|
||||
|
||||
目标:
|
||||
@@ -547,14 +604,45 @@ V5 benchmark 示例当前标记:
|
||||
风险控制:
|
||||
|
||||
- 第五版只承诺离散球颗粒,不承诺任意形状颗粒。
|
||||
- 如接入外部颗粒求解器,必须通过 adapter 层,不得侵入 FEM 核心时间循环。
|
||||
- 第五版不接入外部颗粒求解器;颗粒时间推进在核心内置模块中实现并保持依赖边界清晰。
|
||||
|
||||
当前完成证据:
|
||||
|
||||
- `src/particle/fem_particle_state.f90`、`fem_particle_contact.f90` 和
|
||||
`fem_particle_step.f90` 已提供离散球颗粒状态、颗粒-颗粒/颗粒-刚墙接触、
|
||||
显式推进和 step 诊断。
|
||||
- `pstep_diag_values` 将 `particle_step_diag` 中的质量、动量、动能、耗散功率和
|
||||
最大重叠转换为 Fortran 可查询的验收诊断,其中步耗散能为
|
||||
`dissipated_power * dt`。
|
||||
- `fem_particle_facet_coupling.f90` 和 `fem_particle_facet_step.f90` 已提供
|
||||
颗粒-facet 接触、节点载荷分配、接触能量、耗散功率和力范数统计。
|
||||
- `tools/benchmarks/dynamic_grain_container_benchmark.f90` 作为 benchmark
|
||||
编排工具放在 `tools/benchmarks`,读取
|
||||
`dynamic_grain_container_benchmark.inp` 中的离散球颗粒和接触参数,加载无
|
||||
`*DLOAD` 的柔性容器结构输入,通过 `particle_fem_apply_all` 将颗粒-facet
|
||||
接触力映射到 FEM `fsph`,再用显式结构步推进容器响应。
|
||||
- `examples/Dynamic_Grain_Packing_of_a_Flexible_Container` 现在保留旧
|
||||
pressure/ground smoke,同时新增真实粒子-柔性容器双向 benchmark 输入、
|
||||
README、双击脚本和 `check_grain_container_results.py`。checker 拒绝压力
|
||||
surrogate,并验证粒子数、接触数、映射节点力、容器位移、质量守恒、有界
|
||||
重叠和非负能量。
|
||||
- CTest `particle_acceptance` 覆盖自由落体、阻尼墙碰撞、三颗粒堆积和
|
||||
颗粒-facet 载荷平衡;CTest `example_dynamic_grain_container_benchmark`
|
||||
覆盖真实粒子-容器双向映射。
|
||||
- 定向命令
|
||||
`ctest --test-dir build-win-gcc-16 -C Release -R "example_dynamic_grain_container_benchmark|particle_acceptance|source_size" --output-on-failure`
|
||||
已在 2026-06-26 通过;本次记录粒子数 4、最大 facet contact 4、
|
||||
`mapped_steps=40`、最大映射竖向载荷 `3.68E+01`、中心节点最小位移
|
||||
`-7.29240354E-06` 和最大重叠 `3.00615680E-03`。
|
||||
- 全量命令 `ctest --test-dir build-win-gcc-16 -C Release --output-on-failure`
|
||||
已在 2026-06-26 通过,记录为 106/106 passed。
|
||||
|
||||
## 14. V5.9 高保真 Benchmark、性能和多平台回归
|
||||
|
||||
目标:
|
||||
|
||||
- 将第五版核心能力统一收束到 benchmark 矩阵,而不是散落在单个示例中。
|
||||
- 验证外部 solver、mortar、材料、屈曲、循环对称、滚压、cohesive 和颗粒耦合在多平台下不回退。
|
||||
- 验证内部 solver、mortar、材料、屈曲、循环对称、滚压、cohesive 和颗粒耦合在多平台下不回退。
|
||||
|
||||
建议 benchmark 矩阵:
|
||||
|
||||
@@ -572,7 +660,10 @@ V5 benchmark 示例当前标记:
|
||||
测试层级:
|
||||
|
||||
- 默认 CTest:保留小规模 smoke 和单元测试。
|
||||
- 扩展 CTest:启用外部库和 benchmark regression。
|
||||
- 扩展 CTest:内部 solver 矩阵和 benchmark regression;当前已完成的 V5
|
||||
核心测试和示例 benchmark 统一追加 `v5_acceptance` 标签,可通过
|
||||
`ctest --test-dir build-win-gcc-16 -C Release -L v5_acceptance --output-on-failure`
|
||||
运行。
|
||||
- 长跑测试:大规模接触、滚压、颗粒和屈曲矩阵。
|
||||
- 发布前测试:Windows GCC、WSL gfortran、Windows Intel oneAPI ifx/MSVC,按依赖可用性分级记录。
|
||||
|
||||
@@ -580,10 +671,20 @@ V5 benchmark 示例当前标记:
|
||||
|
||||
- V1-V4 回归测试全部通过。
|
||||
- V5 默认 CTest 全部通过。
|
||||
- 启用外部 solver 的扩展测试通过。
|
||||
- 内部 solver 扩展矩阵测试通过。
|
||||
- 所有高保真示例均有 README、输入、运行脚本、检查脚本和文档说明。
|
||||
- 所有 V4 中标注为 surrogate 的第五版目标案例均替换或补充真实高保真输入。
|
||||
|
||||
当前完成证据:
|
||||
|
||||
- `docs/v5_benchmark_matrix.md` 已列出 V5.2-V5.8 已完成能力对应的测试层级、
|
||||
示例目录、CTest 名称、参考指标和容差。
|
||||
- CMake 已为当前 V5 验收子集追加 `v5_acceptance` 标签;扩展验收命令为
|
||||
`ctest --test-dir build-win-gcc-16 -C Release -L v5_acceptance --output-on-failure`。
|
||||
该命令已在 2026-06-26 通过,记录为 35/35 passed。
|
||||
- 默认回归仍为 `ctest --test-dir build-win-gcc-16 -C Release --output-on-failure`;
|
||||
当前 Windows GCC 16 Release 记录为 106/106 passed。
|
||||
|
||||
## 15. V5.10 验收与发布
|
||||
|
||||
目标:
|
||||
@@ -596,7 +697,6 @@ V5 benchmark 示例当前标记:
|
||||
- Windows GCC 16 默认构建。
|
||||
- WSL gfortran 默认构建。
|
||||
- Windows Intel oneAPI ifx/MSVC 默认构建。
|
||||
- 启用外部 solver 的至少一个本地构建。
|
||||
- 可选:启用 OpenMP 的接触和颗粒性能构建。
|
||||
|
||||
发布前必须执行:
|
||||
@@ -606,12 +706,6 @@ cmake --build build-win-gcc-16 --config Release
|
||||
ctest --test-dir build-win-gcc-16 --output-on-failure
|
||||
```
|
||||
|
||||
如外部 solver 构建目录独立,必须额外执行:
|
||||
|
||||
```powershell
|
||||
ctest --test-dir build-v5-external-solver --output-on-failure
|
||||
```
|
||||
|
||||
发布材料:
|
||||
|
||||
- `docs/v5_acceptance_report.md`。
|
||||
@@ -623,6 +717,7 @@ ctest --test-dir build-v5-external-solver --output-on-failure
|
||||
- 更新后的 `docs/06_test_and_verification_plan.md`。
|
||||
- 更新后的 `docs/07_user_manual.md`。
|
||||
- 更新后的 `docs/08_developer_manual.md`。
|
||||
- `docs/v5_benchmark_matrix.md`。
|
||||
- 第五版 benchmark 示例矩阵。
|
||||
|
||||
验收条件:
|
||||
@@ -646,8 +741,8 @@ ctest --test-dir build-v5-external-solver --output-on-failure
|
||||
- 新增非线性状态必须支持 trial/rollback/commit。
|
||||
- 新增历史变量必须支持 restart 保存和读取。
|
||||
- 新增接触、材料、颗粒状态必须有可查询诊断。
|
||||
- 新增外部依赖必须有 unavailable 路径测试。
|
||||
- 默认构建不能因为外部依赖缺失而失败,除非用户显式开启对应必需选项。
|
||||
- 当前模块不得新增第三方求解器依赖或外部求解器接口。
|
||||
- 默认构建不能因为可选工具缺失而失败。
|
||||
|
||||
文档约束:
|
||||
|
||||
@@ -661,7 +756,7 @@ ctest --test-dir build-v5-external-solver --output-on-failure
|
||||
0.5.x 阶段验收建议满足:
|
||||
|
||||
- 0.1.0、0.2.0、0.3.3 和 0.4.8 已验收能力无回退。
|
||||
- 至少一个外部稀疏求解器后端真实可用。
|
||||
- 内部 CG/BiCGSTAB/GMRES 求解器覆盖静力、隐式、非线性修正和接触/约束回归;无第三方 solver 依赖。
|
||||
- 完整 mortar / augmented Lagrangian 接触通过实体、壳、摩擦和 restart benchmark。
|
||||
- Mohr-Coulomb 材料通过材料点、结构和强度折减 benchmark。
|
||||
- 线性屈曲特征值分析和循环对称边界通过解析或公开基准。
|
||||
@@ -676,10 +771,10 @@ ctest --test-dir build-v5-external-solver --output-on-failure
|
||||
|
||||
| 风险 | 影响 | 缓解 |
|
||||
|---|---|---|
|
||||
| 外部 solver 跨平台依赖复杂 | 构建和发布受阻 | 默认内部 solver 保持可用,外部后端分级启用 |
|
||||
| 误把外部 solver 当作当前模块完成项 | 破坏无第三方依赖边界 | V5.2 明确 no-external-solver 策略,删除外部接口并用旧编号拒绝回归防止反向引入 |
|
||||
| Mortar/AL 一致切线难度高 | 非线性接触不收敛 | 先做无摩擦法向约束,再接 stick/slip 和几何项 |
|
||||
| Mohr-Coulomb 角点返回不稳定 | 岩土算例失败 | 材料点测试先行,substepping 和分支诊断同步实现 |
|
||||
| 特征值求解依赖外部库 | 屈曲阶段被阻塞 | V5.2 先完成外部 solver adapter,V5.5 复用 adapter |
|
||||
| 内部特征值求解能力有限 | 屈曲阶段规模受限 | 先实现小规模内部广义特征值验证,再按矩阵诊断和迭代策略扩展 |
|
||||
| 循环对称转角映射复杂 | 壳模型边界错误 | 从实体平移 DOF 开始,再扩展壳转角 DOF |
|
||||
| 滚压成形计算量大 | 默认测试过慢 | 默认 smoke + 扩展 benchmark + longrun 分层 |
|
||||
| Cohesive 接触状态切换复杂 | 粘附/普通接触不连续 | 单积分点和单面片测试先行,restart 同步覆盖 |
|
||||
@@ -690,7 +785,7 @@ ctest --test-dir build-v5-external-solver --output-on-failure
|
||||
第五版建议按以下顺序推进:
|
||||
|
||||
1. 建立 `dev/v0.5` 分支和 V5 文档/验收矩阵。
|
||||
2. 完成外部稀疏求解器 adapter。
|
||||
2. 完成内部稀疏求解器强化和 no-external-solver 策略。
|
||||
3. 完成 mortar/AL 接触法向约束。
|
||||
4. 接入 mortar 摩擦一致切线和 restart。
|
||||
5. 实现 Mohr-Coulomb 材料点与结构 benchmark。
|
||||
@@ -700,7 +795,7 @@ ctest --test-dir build-v5-external-solver --output-on-failure
|
||||
|
||||
排序理由:
|
||||
|
||||
- 外部 solver 是后续大规模非对称系统、特征值和高保真 benchmark 的基础。
|
||||
- 内部 solver 诊断和稳定性是后续非对称系统、特征值和高保真 benchmark 的基础。
|
||||
- Mortar/AL 是滚压、cohesive、颗粒-膜接触和壳-实体 benchmark 的基础。
|
||||
- Mohr-Coulomb 相对独立,可在 mortar 主线稳定后并行推进。
|
||||
- 应用级高保真案例必须建立在核心算法真实可用之后。
|
||||
|
||||
Reference in New Issue
Block a user