Files
FemLite/docs/v4_acceptance_report.md
T
shenw 240d2728fa
FemLite CI / build-test (push) Has been cancelled
Complete V4.8 example acceptance and scripts
2026-06-25 10:29:03 +08:00

90 lines
4.4 KiB
Markdown

# 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 线性求解器分发、预条件设置和统计接口保持可回归。
- 壳 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、Jacobi、unsupported external 占位和 C ABI 设置查询覆盖 |
| 壳稳定与壳塑性 | 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 均接入 smoke |
| 源码规模门禁 | 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` | 壳接触动力缩减案例,采用文档摩擦系数尺度 |
| 既有基准目录 | `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 -R "example_(elliptic_membrane|membrane_uniaxial|shell_solid_connection|strength_reduction|golf_ball_impact)_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 47
```
## 6. 后续限制
- 完整 Mohr-Coulomb 强度折减、完整高尔夫球多材料冲击和高保真 shell-solid benchmark 仍需核心求解器后续能力支持。
- pinched cylinder、hemisphere、twisted beam 和更密 Scordelis-Lo 收敛矩阵建议作为 0.5.x 或专项长跑基准推进。
- 外部稀疏求解器后端当前仍是显式 unsupported 占位,接口已预留但未绑定第三方库。