Files
FemLite/docs/v2_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.7 KiB
Raw Permalink Blame History

FemLite 0.2.0 第二版验收报告

日期:2026-06-23

1. 版本信息

  • 软件名称:FemLite
  • 软件版本:0.2.0
  • 交付形态:静态库、命令行程序、C ABI 静态库、Python 调试脚本、测试程序
  • 语言标准:Fortran 95 核心代码,C ABI 包装层使用 C
  • 默认平台:WSL Ubuntu + gfortran + CMake
  • 开发分支:dev/v0.2

2. 验收口径

FemLite 0.2.0 定位为第二版最小可用/阶段验收版。

本次验收依据 docs/v2_development_plan.md 的第二版完成准则,重点确认:

  • 0.1.0 第一版验收能力无回退。
  • 第二版关键框架能力已经进入可编译、可测试、可扩展状态。
  • C3D10、C3D20、S3、S6、S8、CSR、隐式线弹性、Robin、MPC、基础接触、VTK、restart、C ABI、Python 调试接口和 CI 均具备最小可用能力。

本次验收不等价于完整工程级隐式非线性求解器或通用接触算法验收。 本次验收也不等价于完整静力学能力验收;壳单元静力刚度、非线性静力和工程级静力输出列入 0.3.0。

3. 验收环境

  • 操作系统:WSL Ubuntu
  • 编译器:GNU Fortran 13.3.0、GNU C 13.3.0
  • Python:3.12.3
  • 构建系统:CMake
  • 构建目录:build-wsl-debug

Windows 本地补充验证:

  • 工具链:C:\gcc-16.1.0-64,GNU C/GNU Fortran 16.1.0
  • 生成器:MinGW Makefiles
  • 构建目录:build-win-gcc-16
  • 测试结果:23/23 passed

4. 第二版范围

0.2.0 已实现或完善:

  • 单元拓扑、积分规则、形函数和状态变量基础设施。
  • CSR 稀疏矩阵基础操作、装配接口和 CG 线性求解器。
  • 隐式线弹性小变形求解最小流程。
  • C3D10、C3D20 二次实体单元基础能力。
  • S3、S6、S8 壳单元基础能力,S4 壳单元膜、弯曲、横向剪切和压力路径增强。
  • Robin 边界条件。
  • penalty MPC 约束方程基础能力。
  • 基础刚性平面 penalty 接触。
  • legacy ASCII VTK 结果输出。
  • 显式 restart 写入与读取。
  • C ABI 包装层。
  • Python 调试 runner。
  • Gitea CI 工作流。

5. 验收项结果

验收项 结果 覆盖说明
第一版能力回归 PASS smoke、material、显式、SPH 力接口、CSV 输出等回归继续通过
V2.1 基础设施 PASS 单元拓扑、facet、状态变量、高斯点映射测试通过
V2.2 CSR 与隐式线弹性 PASS CSR、装配、CG、Dirichlet、隐式线弹性小算例通过
V2.3 二次实体单元 PASS C3D10、C3D20 质量、内力、基础 patch 测试通过
V2.4 壳单元扩展 PASS S3、S4、S6、S8 质量、压力、膜、弯曲、横向剪切测试通过
V2.5 约束与接触 PASS Robin、MPC、基础刚性平面接触测试通过
V2.6 外部接口与输出 PASS C ABI、Python 调试接口、VTK、restart 测试通过
版本号 PASS 代码版本常量和 CMake 版本均为 0.2.0
CI 配置 PASS 已增加 Gitea workflow,覆盖 Linux gfortran + CMake + CTest

6. 回归测试

执行命令:

cmake -S . -B build-wsl-debug -DCMAKE_BUILD_TYPE=Debug
cmake --build build-wsl-debug -j2
ctest --test-dir build-wsl-debug --output-on-failure

最近一次本地结果:

100% tests passed, 0 tests failed out of 23

主要测试集合:

  • 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

7. 第二版新增交付物

  • src/output/fem_output_vtk.f90
  • src/output/fem_restart.f90
  • include/femlite_c_api.h
  • src/interface/fem_c_api.c
  • src/interface/fem_fortran_bridge.f90
  • Python/femlite_debug.py
  • .gitea/workflows/ci.yml
  • 第二版新增 CTest 测试程序和 Python 测试脚本

8. 已知限制

  • 隐式求解当前为线性静力/准静力最小流程,不是完整 Newmark + Newton 非线性瞬态框架。
  • 当前线性静力最小流程主要覆盖实体单元;壳单元静力刚度和 Scordelis-Lo 静力基准列入 0.3.0。
  • 接触当前为基础 penalty 刚性平面接触,不是通用面-面接触,也未实现完整接触搜索优化。
  • VTK 输出为 legacy ASCII 格式,已覆盖字段生成测试;正式工程可视化仍建议补充 ParaView 人工检查记录。
  • restart 当前恢复同一模型上的显式状态,不保存完整 inp 模型数据库。
  • Python 接口为调试 runner,不是高性能二进制 Python 扩展。
  • CI 已配置 Linux gfortran 路径;Windows GCC 16.1.0 已完成本地构建和 CTest 验证,Intel Fortran 仍需作为后续兼容性验证项。

9. 0.3.0 建议范围

0.3.0 建议重点推进:

  • 正式静力学计算支持,包括 *STATIC、--static-linear 和 --static-nonlinear。
  • 实体单元和壳单元线性静力刚度,重点补齐 S3、S4、S6、S8 壳静力。
  • Scordelis-Lo 屋面壳体静力基准和板壳弯曲静力基准。
  • 非线性静力 Newton-Raphson 增量迭代。
  • 完整隐式 Newmark + Newton 非线性增量迭代。
  • 一致切线或有效切线策略。
  • 通用接触搜索和面-面接触。
  • 更完整接触输出,包括接触力、接触功和接触状态。
  • 壳单元 hourglass 控制和更完整壳塑性路径。
  • 静力学反力、收敛历史、VTK 和 CSV 输出。
  • Windows、Linux、Intel Fortran 多平台持续验证。
  • ParaView VTK 可视化人工验收记录。

10. 验收结论

FemLite 0.2.0 已达到第二版最小可用/阶段验收版标准。

建议将当前 dev/v0.2 状态作为 0.2.0 阶段验收基线,并将静力学计算、壳静力基准、完整隐式非线性求解和通用接触能力列入 FemLite 0.3.0。