Files
FemLite/docs/v1_acceptance_report.md
T
2026-06-22 17:52:59 +08:00

110 lines
3.0 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.1.0 第一版验收报告
日期:2026-06-22
## 1. 版本信息
- 软件名称:FemLite
- 软件版本:0.1.0
- 交付形态:静态库、命令行程序、测试程序
- 语言标准:Fortran 95
- 默认平台:WSL Ubuntu + gfortran + CMake
## 2. 验收环境
- 操作系统:Linux 6.6.87.2-microsoft-standard-WSL2 x86_64 GNU/Linux
- 编译器:GNU Fortran 13.3.0
- CMake:3.28.3
- 构建目录:build-wsl-debug
## 3. 第一版范围
第一版目标为:
- 显式瞬态求解。
- 实体单元 C3D4、C3D8。
- 第一版有限能力 S4 壳单元。
- 线弹性、小应变 J2 弹塑性、Johnson-Cook 率效应、温度软化、绝热塑性温升、Johnson-Cook 损伤。
- Abaqus inp 子集读取。
- Dirichlet、CLOAD、S4 压力 DLOAD、SPH 节点力、SPH facet 压力和剪切力接口。
- CSV 历史量、节点快照、单元状态快照输出。
## 4. 验收项结果
| 验收项 | 结果 | 覆盖说明 |
|---|---:|---|
| 单元 patch test | PASS | C3D4、C3D8、S4 基础应变/应力/内力回归 |
| 单轴拉伸 | PASS | 线弹性和 J2 单轴应力更新 |
| 弹塑性加载卸载 | PASS | J2 加载、卸载、理想/线性/多段硬化 |
| 弹性波传播 | PASS | C3D8 两单元杆、C3D4 两单元对的显式传播测试 |
| 板受压力脉冲 | PASS | S4 压力载荷、集中质量、恢复内力和显式响应 |
| 简化 SPH-FEM 边界力传递 | PASS | 节点力、facet 压力、facet 压力加剪切力 |
## 5. 回归测试
执行命令:
```sh
cmake --build build-wsl-debug -j2
ctest --test-dir build-wsl-debug --output-on-failure
```
结果:
```text
100% tests passed, 0 tests failed out of 2
```
测试程序:
- smoke
- material_j2
## 6. P1 性能测试
P1 性能目标:
- 10000 节点
- 10000 单元
- 100 步
- 不要求并行
执行命令:
```sh
python3 tests/performance/generate_p1_c3d4.py build-wsl-debug/p1_10000_c3d4.inp
./build-wsl-debug/perf_p1 build-wsl-debug/p1_10000_c3d4.inp
```
结果:
```text
FemLite P1 performance
version: 0.1.0
nodes: 10000
elements: 10000
dofs: 29838
steps: 100
time: 1.00000E-04
cpu_sec: 1.577621
result: PASS
```
性能测试说明:
- 单元类型:C3D4。
- 输出:关闭全场输出,只测试读入、建模、质量计算和显式步进。
- 临时输入文件位于 build-wsl-debug,不纳入 git。
## 7. 已知限制
- S4 为第一版有限能力实现,后续仍需完善壳塑性、hourglass 控制和更完整的壳状态输出。
- 第一版不装配全局刚度矩阵,不支持隐式非线性求解。
- 接触、MPC、Robin、restart、VTK 输出属于第二版或后续范围。
- C3D10、C3D20、S3、S6、S8 属于第二版范围。
- 当前 P1 性能测试为本地 WSL 单机结果,不代表跨平台性能基线。
## 8. 验收结论
FemLite 0.1.0 已达到第一版功能验收标准。建议将当前状态标记为第一版基线,并在后续版本中推进壳单元完善、隐式求解、接触和 VTK/restart 输出。