Files
FemLite/docs/v4_acceptance_report.md
T

108 lines
6.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# FemLite 第四版 V4.8 阶段验收报告
日期:2026-06-25
## 1. 版本信息
- 软件名称:FemLite
- 阶段范围:第四版 V4.1 至 V4.8
- 开发分支:`dev/v0.4`
- 交付形态:静态库、命令行程序、C ABI 静态库、测试程序、Python 检查脚本和示例算例
- 默认验收构建:Windows GCC 16,构建目录 `build-win-gcc-16`
## 2. 验收口径
V4.8 是第四版阶段验收收束版,重点确认 0.4.x 开发期新增的接触、隐式、壳稳定、线性求解器、示例和发布检查能力可以作为下一阶段基线。
本次验收覆盖:
- 第一版、第二版、第三版已验收能力无回退。
- surface/contact 输入子集、contact pair active-set、augmented penalty、摩擦历史、BVH 搜索、候选缓存和性能统计保持可回归。
- 非线性静力和非线性 Newmark 收敛诊断、cutback 诊断和 C ABI 查询接口保持可回归。
- CG/BiCGSTAB/GMRES 线性求解器分发、预条件设置和统计接口保持可回归。
- 壳 drilling 稳定、S3 剪切锁定诊断、壳 J2 剪切/弯曲代表性塑性和 Scordelis-Lo smoke 保持可回归。
- `examples/` 下文档型目录均有可执行 `.inp`,包含 `.inp` 的目录均有 `run_case.bat`。
本报告不声称 FemLite 已具备完整 Abaqus 兼容、完整工程级 mortar 约束求解、完整 Mohr-Coulomb 强度折减、完整高尔夫球多层超弹/黏弹模型或完整 shell-solid benchmark 保真能力。相关文档派生案例在 V4.8 中作为可执行缩减基准和回归入口。
## 3. 验收项结果
| 验收项 | 结果 | 覆盖说明 |
|---|---:|---|
| 基础回归 | PASS | smoke、材料、单元、数据库、稀疏矩阵、线性求解、输出和 restart 测试保留 |
| 接触与摩擦 | PASS | contact、OMP 1/4、contact block sliding、rigid impact 和接触统计回归覆盖 |
| 隐式与收敛诊断 | PASS | implicit inp、solver implicit、cutback 和收敛状态接口回归覆盖 |
| 线性求解器 | PASS | CG/BiCGSTAB/GMRES、Jacobi 和 C ABI 设置查询覆盖;external 仅为后续第三方库适配项 |
| 壳稳定与壳塑性 | PASS | drilling、S3 剪切锁定、S4 J2 剪切/弯曲、trial rollback 和 Scordelis-Lo smoke 覆盖 |
| 示例目录结构 | PASS | `examples_layout` 检查文档目录和双击脚本约定 |
| 文档派生示例 | PASS | elliptic membrane、membrane uniaxial、shell-solid connection、strength reduction、golf ball impact,以及 block-on-arch、roller contact、sliding wedge、airbag membrane、blasting rock、nonlinear harmonic、layered shell、pinched hemisphere、roll forming、falling objects、ball adhesion contact、corrugated shell buckling preload、dynamic grain container 接入 smoke;two arches 接入参考几何 benchmark;thick plate 接入 NAFEMS LE10 benchmark;spherical cap 接入位移控制壳 benchmark;stress dependent elasticity 接入应力相关弹性 benchmark |
| 源码规模门禁 | PASS | `source_size` 保持通过 |
## 4. 示例矩阵
V4.8 期间补齐或确认的示例目录:
| 目录 | 运行入口 | 验收说明 |
|---|---|---|
| `examples/elliptic_membrane` | `run_case.bat` | NAFEMS LE1 椭圆膜文档派生 S4 静力缩减案例 |
| `examples/membrane_uniaxial_stretching` | `run_case.bat` | 各向同性膜单轴拉伸静力案例 |
| `examples/shell_solid_connection` | `run_case.bat` | C3D8 与 S4 共享节点接口静力案例 |
| `examples/strengthReduction` | `run_case.bat` | 强度折减文档派生线弹性坡体案例 |
| `examples/golfBallImpact` | `run_case.bat` | 壳接触动力缩减案例,采用文档摩擦系数尺度 |
| `examples/node_analytical_plane_contact` | `run_case.bat` | node-based slave surface 到 analytical rigid plane 的接触 smoke |
| `examples/block_on_arch` | `run_case.bat` | 浅拱与解析刚体面接触代表性 smoke |
| `examples/cylinder_roller_contact` | `run_case.bat` | 滚子-基础法向接触代表性 smoke |
| `examples/sliding_wedge` | `run_case.bat` | 倾斜接触面摩擦滑移 smoke |
| `examples/membrane_airbag_inflation` | `run_case.bat` | S4 膜片压力载荷回归入口 |
| `examples/spherical_cap_with_central_point_load` | `run_case.bat` | 球冠中心载荷位移控制壳 benchmark |
| `examples/two_arches` | `run_case.bat` | 双拱壳-壳接触参考几何 benchmark |
| `examples/blasting_rock` | `run_case.bat` | C3D8 花岗岩块爆破脉冲动力 smoke |
| `examples/nonlinear_harmonic` | `run_case.bat` | 薄膜谐波压力显式动力 smoke |
| `examples/failure_prediction_in_a_layered_shell` | `run_case.bat` | 四层共享节点壳拉伸回归入口 |
| `examples/pinched_hemispherical_shell` | `run_case.bat` | pinched hemisphere S4 壳动力 smoke |
| `examples/stress_dependent_elasticity` | `run_case.bat` | 应力相关弹性悬臂梁纯弯矩 benchmark |
| `examples/roll_forming` | `run_case.bat` | 滚压成形文档派生的压紧-摩擦牵引 smoke |
| `examples/falling_objects` | `run_case.bat` | 多物体显式接触与刚性箱底代表性 smoke |
| `examples/ball_adhesion_decohesion` | `run_case.bat` | 球-膜接触压入 smoke,粘附/脱粘本构为后续能力 |
| `examples/buckling_corrugated_shell` | `run_case.bat` | 波纹锥壳屈曲文档派生的静力预载 smoke |
| `examples/Dynamic_Grain_Packing_of_a_Flexible_Container` | `run_case.bat` | 动态颗粒装填文档派生的柔性容器压力-地面接触 smoke |
| `examples/thick_plate` | `run_case.bat` | NAFEMS LE10 厚板压力静力回归入口 |
| 既有基准目录 | `run_case.bat` | Kirsch、Scordelis-Lo、shell patch、压力脉冲、刚球冲击、2D/3D 拉伸等均补齐双击入口 |
## 5. 测试命令
V4.8 发布前建议执行:
```powershell
cmake --build build-win-gcc-16 --config Release
ctest --test-dir build-win-gcc-16 --output-on-failure
```
示例结构专项检查:
```powershell
ctest --test-dir build-win-gcc-16 -R examples_layout --output-on-failure
```
示例 smoke 专项检查:
```powershell
ctest --test-dir build-win-gcc-16 -L example_smoke --output-on-failure
```
本轮 Windows GCC 16 验证结果:
```text
cmake --build build-win-gcc-16 --config Release
completed successfully
ctest --test-dir build-win-gcc-16 --output-on-failure
100% tests passed, 0 tests failed out of 66
```
## 6. 后续限制
- 完整 Mohr-Coulomb 强度折减、完整高尔夫球多材料冲击、高保真 shell-solid benchmark、几何非线性 pinched hemisphere 载荷曲线、复合材料失效准则、应力相关弹性弱式映射、低反射边界、频域-时域谐波初值流程、完整滚压成形刚体辊旋转/塑性过程、球-膜粘附/脱粘 cohesive law、线性屈曲特征值、循环对称边界和颗粒流-膜双向耦合仍需核心求解器后续能力支持。
- pinched cylinder、hemisphere、twisted beam 和更密 Scordelis-Lo 收敛矩阵建议作为 0.5.x 或专项长跑基准推进。
- 第三方稀疏求解器后端不作为第四版完成范围;当前第四版完成范围以内置 CG、BiCGSTAB 和 GMRES 为准。