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

5.1 KiB
Raw Permalink Blame History

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 最近一次本地结果:

ctest --test-dir build-win-gcc-16 -C Release --output-on-failure
100% tests passed, 0 tests failed out of 27

WSL 最近一次本地结果:

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 标签并推送到远端仓库。后续版本重点推进完整接触算法、壳塑性切线完善、更多工程基准和并行/性能优化。