Files
FemLite/docs/v3_acceptance_report.md
2026-06-24 17:29:36 +08:00

163 lines
7.2 KiB
Markdown
Raw Permalink 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 0.3.3 第三版阶段验收报告
日期:2026-06-24
## 1. 版本信息
- 软件名称:FemLite
- 软件版本:0.3.3
- 交付形态:静态库、命令行程序、C ABI 静态库、Python 调试脚本、测试程序和示例算例
- 语言标准:Fortran 95 核心代码,C ABI 包装层使用 C
- 默认平台:WSL Ubuntu + gfortran 13.3 + CMake
- 已验证平台:Windows GCC 16、WSL gfortran 13.3、Windows Intel oneAPI ifx 2026.0 + MSVC
- 发布分支:main
## 2. 验收口径
FemLite 0.3.3 是第三版阶段验收版,覆盖 0.3.0 基线能力及 0.3.1、0.3.2、0.3.3 的接触、验证和工程卫生增强。
本次验收依据 `docs/v3_development_plan.md` 的第三版完成准则,重点确认:
- 0.1.0 和 0.2.0 已验收能力无回退。
- 线性静力、非线性静力、壳静力、隐式 Newmark 和非线性 Newmark-Newton 主流程可编译、可测试、可由命令行进入。
- 实体和壳单元静力刚度、材料 trial/rollback、J2 算法切线、Robin/MPC/contact 切线、Rayleigh 阻尼、VTK/CSV 输出和示例算例进入阶段可用状态。
- 通用接触推进到刚性平面接触、面-面 contact pair force/tangent、mortar 形函数积分、Coulomb 粘滑历史变量、接触 CSV 输出、空间网格/BVH 候选搜索和 surface 输入子集。
- 源码规模硬阈值检查纳入 CTest,并且当前无 active hard-threshold exception。
本次验收不等价于完整工程级隐式非线性求解器或通用接触算法最终验收。完整 Abaqus surface 语义、工程级 mortar 约束求解、摩擦正则化参数体系、大规模接触收敛控制和更广泛长跑基准仍列入后续版本。
## 3. 验收环境
Windows GCC 验证:
- 工具链:C:\gcc-16.1.0-64,GNU C/GNU Fortran 16.1.0
- 构建系统:CMake
- 构建目录:build-win-gcc-16
- 测试结果:33/33 passed
WSL Linux 验证:
- 操作系统:WSL Ubuntu
- 编译器:GNU Fortran 13.3.0、GNU C 13.3.0
- 构建系统:CMake
- 构建目录:build-wsl
- 测试结果:33/33 passed
Windows Intel Fortran 验证:
- 工具链:Intel oneAPI ifx 2026.0 + MSVC cl 19.44
- 构建系统:CMake + NMake/MSVC 环境
- 构建目录:build-win-ifx-msvc-nowarn
- 测试结果:33/33 passed
## 4. 第三版范围
0.3.0 到 0.3.3 已实现或完善:
- `*STATIC`、`--static-linear` 和 `--static-nonlinear` 静力求解入口。
- C3D4、C3D8、C3D10、C3D20 实体单元线性静力刚度。
- S3、S4、S6、S8 壳单元线性静力刚度和基础壳静力测试。
- 非线性静力 Newton-Raphson 增量迭代。
- 隐式 Newmark 线性动力学和非线性 Newmark-Newton 骨架。
- 材料状态和单元删除状态 trial/restore/commit/abort。
- 实体 J2 算法切线,以及壳膜内 J2/J2_JC 算法切线路径。
- Newton 线搜索和可选步长缩减。
- Rayleigh 阻尼在隐式动力路径中的接入。
- Robin、MPC、刚性平面接触和面-面 contact pair 的非线性切线装配。
- 静力/隐式结果输出、反力和收敛状态接口。
- `*SURFACE, TYPE=ELEMENT` 输入子集、同名 surface `OP=ADD/NEW`、face label 筛选、壳 `SPOS`/`SNEG` 侧向语义和数据行式 `*CONTACT PAIR` 子集。
- 面-面 contact pair 的投影裁剪面积、多 master 面积分摊、mortar 形函数积分、Coulomb 粘滑历史、stick/slip/累计滑移输出、空间网格和可选 OpenMP BVH 候选搜索。
- `examples` 下的单轴拉伸、板壳拉伸、Scordelis-Lo、Kirsch、shell patch、压力脉冲和刚球冲击类示例。
- 源码规模门禁、轻量示例 smoke CTest 和多编译器兼容性检查。
## 5. 验收项结果
| 验收项 | 结果 | 覆盖说明 |
|---|---:|---|
| 第一版和第二版能力回归 | PASS | 显式、材料、二次单元、壳单元、VTK、restart、C ABI、Python debug 测试继续通过 |
| 线性静力实体单元 | PASS | C3D4/C3D8/C3D10/C3D20 静力 patch 和 CLI 流程测试通过 |
| 线性静力壳单元 | PASS | S3/S4/S6/S8 静力刚度和壳内部响应测试通过 |
| 非线性静力 | PASS | Newton、J2 状态更新、trial rollback、线搜索和 cutback 回滚测试通过 |
| 隐式 Newmark | PASS | 线性 Newmark、Rayleigh 阻尼和 CLI 流程测试通过 |
| 非线性 Newmark-Newton | PASS | 线弹性退化、Robin/MPC/contact 切线和失败回滚测试通过 |
| 通用接触增强 | PASS | 刚性平面接触、surface 输入子集、面-面 contact pair、mortar 权重、摩擦历史、BVH 分支和 contact CSV 测试通过 |
| 示例 smoke | PASS | shell patch、clamped square pressure pulse 和 rigid sphere impact 短步数回归通过 |
| 输出与接口 | PASS | VTK、CSV、restart、C ABI、Python debug 和静力/隐式 CLI 回归测试通过 |
| 源码规模门禁 | PASS | `source_size` 通过,当前无 active hard-threshold exception |
| 多编译器兼容性 | PASS | Windows GCC、WSL gfortran 和 Windows ifx/MSVC 均通过构建与 CTest |
| 版本号 | PASS | CMake 版本和 Fortran 版本常量均为 0.3.3 |
## 6. 回归测试
Windows GCC 最近一次本地结果:
```text
ctest --test-dir build-win-gcc-16 --output-on-failure
100% tests passed, 0 tests failed out of 33
```
WSL 最近一次本地结果:
```text
wsl bash -lc "cd /mnt/d/Codex/FemLite && ctest --test-dir build-wsl --output-on-failure"
100% tests passed, 0 tests failed out of 33
```
Windows Intel ifx 最近一次本地结果:
```text
ctest --test-dir build-win-ifx-msvc-nowarn --output-on-failure
100% tests passed, 0 tests failed out of 33
```
主要测试集合:
- smoke
- material_j2
- element_infrastructure
- facet_topology
- database_topology
- element_state
- sparse_csr
- linear_solver_cg
- assembly_csr
- element_stiffness
- quadratic_mass
- quadratic_internal
- shell_mass
- shell_pressure
- shell_internal
- solver_implicit
- contact
- vtk_output
- restart
- c_api
- source_size
- python_debug
- example_shell_patch_s3_smoke
- example_shell_patch_s4_smoke
- example_pressure_pulse_s4_smoke
- example_rigid_impact_s3_smoke
- example_rigid_impact_s4_smoke
- implicit_inp
- cli_implicit_linear
- cli_static_linear
- cli_static_nonlinear
- cli_implicit_newmark
- cli_implicit_newmark_nonlinear
## 7. 已知限制
- `*SURFACE` 当前为 element-target 子集,尚未实现完整 Abaqus surface 变体、复杂 surface 操作、node-based surface、analytic rigid surface 和更复杂的数据行变体。
- 面-面 contact pair 已具备 mortar 形函数积分、摩擦历史和 BVH 搜索,但仍不是完整工程级 mortar 约束求解器。
- 摩擦模型当前采用接触对级 Coulomb 粘滑历史,尚未形成完整摩擦正则化参数体系。
- 大规模接触收敛控制、接触域分解和负载均衡仍需后续版本推进。
- 壳塑性一致切线已推进到主要 section 路径,但仍需要更多壳弯曲/剪切塑性基准和长时间稳定性验证。
- 非线性 Newmark-Newton 已具备骨架和关键切线回归,但还需要更多工程基准和长时间稳定性验证。
## 8. 验收结论
FemLite 0.3.3 已达到第三版阶段验收标准,可作为 0.3.3 发布基线。
建议将当前 `main` 状态提交并打 `v0.3.3` 标签。后续版本重点推进完整 Abaqus surface 兼容、工程级 mortar/摩擦接触、大规模接触收敛控制、更多壳塑性基准和并行/性能优化。