Complete V5 acceptance milestone

This commit is contained in:
shenw
2026-06-26 12:54:40 +08:00
parent 26639d8dc2
commit a01a4fda24
105 changed files with 8694 additions and 8922 deletions
+32 -9
View File
@@ -40,7 +40,7 @@
- 动态库
- C/C++/Python 包装层
- 更完整后处理工具链
- 外部求解器适配层
- 内部稀疏求解器扩展层
第三版交付应补充:
@@ -61,6 +61,7 @@ src/material 材料模型与状态变量更新
src/element 实体单元、壳单元、形函数、积分规则
src/solver 显式求解器、静力求解器、隐式动力求解器、稀疏矩阵
src/boundary 边界条件、载荷、约束、接触
src/particle 离散球颗粒状态、搜索、接触、step 和 facet/FEM 映射
src/coupling FEM 外部耦合接口和 SPH 力映射
src/output 日志、CSV、VTK 预留、restart 预留
src/app femlite 命令行程序
@@ -111,6 +112,7 @@ Solver Layer
nonlinear static solver
implicit Newmark solver
CSR matrix layer
dense eigensolver and small-scale buckling support
Input/Output Layer
Abaqus inp reader
@@ -202,6 +204,12 @@ Input/Output Layer
- 输出应包含新应力、新状态变量、失效标志和可选算法切线。
- 材料例程不得依赖全局节点、单元或求解器状态。
第五版材料层增加 Mohr-Coulomb 专线。`fem_material_mohr_coulomb` 负责材料点
返回映射、张拉截断、分支号和工程算法切线;`fem_material_mc_driver` 只做
材料点路径执行和诊断汇总;`fem_material_mc_envelope` 只做包络 margin 和
safety ratio 计算。结构级强度折减通过 `fem_strength_reduction_driver`
接收求解器 trial 指标并维护 bracket,不反向污染材料点更新。
## 10. 单元调度架构
Fortran95 下直接使用 Abaqus 单元类型字符串作为内部主标识。
@@ -302,8 +310,14 @@ write output
`fem_control` 中的 method/preconditioner 设置,当前内部支持 CG、
BiCGSTAB 和 GMRES,支持 none/Jacobi 预条件,并把最近一次 method、
preconditioner、迭代数、残差和状态码写回控制模块供 Fortran API、C ABI
和测试查询。外部 MUMPS/SuperLU/MKL Pardiso 等后端只作为后续适配层,
不得让隐式求解器直接依赖第三方库。
和测试查询。分发层不包含外部求解器 adapter;非 CG/BiCGSTAB/GMRES 的
method 值在配置阶段返回错误,并保持当前设置不变。
第五版起,solver 层增加小规模内部特征值和线性屈曲支撑。`fem_eigensolver`
负责 dense 对称 Jacobi 和 SPD 广义特征值求解,`fem_buckling_solver` 负责
屈曲问题入口、几何刚度符号约定、Euler 解析临界载荷和模态 helper,
`fem_geometric_stiffness` 生成单元级几何刚度。该路径用于解析 benchmark 和
小规模工程验收,不接入第三方特征值库或外部求解器进程。
第三版非线性静力控制流:
@@ -380,6 +394,15 @@ coupling 层职责:
- 每个时间步可执行一次双向交换。
- 时间步由 SPH 或外部耦合驱动器控制。
V5.8 颗粒层职责:
- particle 层保存内置离散球颗粒状态,不依赖外部颗粒求解器。
- particle step 负责颗粒显式推进、颗粒-颗粒/颗粒-墙接触和诊断输出。
- particle facet coupling 负责把颗粒-facet 接触力分配到 facet 节点,并提供力平衡残差。
- coupling 层可收集和应用颗粒-facet 节点载荷,但不负责颗粒时间积分。
- 颗粒质量、动量、动能、耗散能和最大重叠通过 Fortran 诊断接口查询。
- 动态颗粒柔性容器验收由 `tools/benchmarks/dynamic_grain_container_benchmark.f90` 编排:读取 `examples/Dynamic_Grain_Packing_of_a_Flexible_Container` 的颗粒和压力-free 容器输入,调用生产 particle/FEM coupling 路径,将节点载荷写入 `fsph`,并输出 history/summary CSV 供 checker 验证。
## 14. 输出架构
第一版输出:
@@ -472,12 +495,12 @@ coupling 层职责:
- 增加错误诊断
- 增加输入回归测试
接入外部线性求解器:
内部线性求解器扩展:
- 通过 CSR 层提供矩阵和向量接口
- 隐式求解器不得直接绑定具体第三方库
- 外部库适配应单独放在 solver 或 external 子层
- 外部库不可用时必须保留内部 CG/BiCGSTAB/GMRES 路径,构建和 CTest 不应受影响
- 通过 CSR 层提供矩阵、向量、残差和矩阵分类诊断。
- 隐式求解器不得绑定第三方库或外部求解器进程。
- 线性求解能力应优先扩展内部 iterative/diagnostics 子层。
- 新增 method 或 preconditioner 必须保持默认构建无第三方依赖,并覆盖配置失败不改变既有设置的回归测试。
## 17. 构建与部署架构
@@ -501,4 +524,4 @@ coupling 层职责:
- OpenMP
- MPI
- 动态库
- 外部求解器强依赖
- 第三方求解器强依赖