Files
FemLite/docs/v3_acceptance_report.md
T
shenw be02684827
FemLite CI / build-test (push) Has been cancelled
Release FemLite 0.3.0
2026-06-23 19:28:44 +08:00

134 lines
5.1 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 0.3.0 第三版验收报告
日期:2026-06-23
## 1. 版本信息
- 软件名称:FemLite
- 软件版本:0.3.0
- 交付形态:静态库、命令行程序、C ABI 静态库、Python 调试脚本、测试程序和示例算例
- 语言标准:Fortran 95 核心代码,C ABI 包装层使用 C
- 默认平台:WSL Ubuntu + gfortran 13.3 + CMake
- 发布分支:main
## 2. 验收口径
FemLite 0.3.0 定位为第三版阶段验收版。
本次验收依据 `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/摩擦接触、空间加速搜索、壳弯曲/剪切塑性一致切线和更完整接触输出仍列入后续版本。
## 3. 验收环境
Windows 本地验证:
- 工具链:C:\gcc-16.1.0-64,GNU C/GNU Fortran 16.1.0
- 构建系统:CMake
- 构建目录:build-win-gcc-16
- 测试结果:27/27 passed
WSL Linux 验证:
- 操作系统:WSL Ubuntu
- 编译器:GNU Fortran 13.3.0、GNU C 13.3.0
- 构建系统:CMake
- 构建目录:build-wsl
- 测试结果:27/27 passed
## 4. 第三版范围
0.3.0 已实现或完善:
- `*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 的非线性切线装配。
- 静力/隐式结果输出、反力和收敛状态接口。
- `examples` 下的单轴拉伸、板壳拉伸、Scordelis-Lo、Kirsch、强度折减和冲击类示例。
## 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 | 刚性平面接触和面-面 contact pair 法向力/切线测试通过 |
| 输出与接口 | PASS | VTK、CSV、restart、C ABI、Python debug 和静力/隐式 CLI 回归测试通过 |
| 版本号 | PASS | CMake 版本和 Fortran 版本常量均为 0.3.0 |
## 6. 回归测试
Windows 最近一次本地结果:
```text
ctest --test-dir build-win-gcc-16 -C Release --output-on-failure
100% tests passed, 0 tests failed out of 27
```
WSL 最近一次本地结果:
```text
wsl ctest --test-dir /mnt/d/Codex/FemLite/build-wsl --output-on-failure
100% tests passed, 0 tests failed out of 27
```
主要测试集合:
- 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
- python_debug
- implicit_inp
- cli_implicit_linear
- cli_static_linear
- cli_static_nonlinear
- cli_implicit_newmark
- cli_implicit_newmark_nonlinear
## 7. 已知限制
- 面-面 contact pair 当前为朴素 facet-centroid penalty 框架,尚未实现 mortar 接触、摩擦、空间加速搜索和工程级接触收敛控制。
- 壳塑性一致切线当前推进到膜内项,壳弯曲和横向剪切塑性切线仍采用弹性近似。
- 非线性 Newmark-Newton 已具备骨架和关键切线回归,但还需要更多工程基准和长时间稳定性验证。
- 接触状态、最大穿透、接触功和接触历史输出仍需在后续输出阶段继续完善。
- Intel Fortran 兼容性仍建议作为后续发布前补充验证项。
## 8. 验收结论
FemLite 0.3.0 已达到第三版阶段验收标准,可作为 0.3.0 发布基线。
建议将当前 `main` 状态打 `v0.3.0` 标签并推送到远端仓库。后续版本重点推进完整接触算法、壳塑性切线完善、更多工程基准和并行/性能优化。