From 1fb0fa5bebb4b74bfa43a76f84714511ec90c9c8 Mon Sep 17 00:00:00 2001 From: shenw Date: Tue, 23 Jun 2026 00:21:05 +0800 Subject: [PATCH] Add v0.2.0 acceptance report --- docs/v2_acceptance_report.md | 144 +++++++++++++++++++++++++++++++++++ 1 file changed, 144 insertions(+) create mode 100644 docs/v2_acceptance_report.md diff --git a/docs/v2_acceptance_report.md b/docs/v2_acceptance_report.md new file mode 100644 index 0000000..e3037b4 --- /dev/null +++ b/docs/v2_acceptance_report.md @@ -0,0 +1,144 @@ +# 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/07_v2_development_plan.md` 的第二版完成准则,重点确认: + +- 0.1.0 第一版验收能力无回退。 +- 第二版关键框架能力已经进入可编译、可测试、可扩展状态。 +- C3D10、C3D20、S3、S6、S8、CSR、隐式线弹性、Robin、MPC、基础接触、VTK、restart、C ABI、Python 调试接口和 CI 均具备最小可用能力。 + +本次验收不等价于完整工程级隐式非线性求解器或通用接触算法验收。 + +## 3. 验收环境 + +- 操作系统:WSL Ubuntu +- 编译器:GNU Fortran 13.3.0、GNU C 13.3.0 +- Python:3.12.3 +- 构建系统:CMake +- 构建目录:build-wsl-debug + +## 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. 回归测试 + +执行命令: + +```sh +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 +``` + +最近一次本地结果: + +```text +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 非线性瞬态框架。 +- 接触当前为基础 penalty 刚性平面接触,不是通用面-面接触,也未实现完整接触搜索优化。 +- VTK 输出为 legacy ASCII 格式,已覆盖字段生成测试;正式工程可视化仍建议补充 ParaView 人工检查记录。 +- restart 当前恢复同一模型上的显式状态,不保存完整 inp 模型数据库。 +- Python 接口为调试 runner,不是高性能二进制 Python 扩展。 +- CI 已配置 Linux gfortran 路径;Windows、Intel Fortran 仍需作为后续兼容性验证项。 + +## 9. 0.3.0 建议范围 + +0.3.0 建议重点推进: + +- 完整隐式 Newmark + Newton 非线性增量迭代。 +- 一致切线或有效切线策略。 +- 通用接触搜索和面-面接触。 +- 更完整接触输出,包括接触力、接触功和接触状态。 +- 壳单元 hourglass 控制和更完整壳塑性路径。 +- Windows、Linux、Intel Fortran 多平台持续验证。 +- ParaView VTK 可视化人工验收记录。 + +## 10. 验收结论 + +FemLite 0.2.0 已达到第二版最小可用/阶段验收版标准。 + +建议将当前 `dev/v0.2` 状态作为 0.2.0 阶段验收基线,并将完整隐式非线性求解和通用接触能力列入 FemLite 0.3.0。