Files
FemLite/README.md
T
shenw 5e081806fb
FemLite CI / build-test (push) Has been cancelled
Release FemLite 0.6.1
2026-07-01 22:41:16 +08:00

76 lines
4.5 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
FemLite 是一个以 Fortran 95 为核心实现的轻量级有限元求解器,面向结构动力学、静力学、壳/实体单元、接触、材料非线性和外部耦合接口的工程验证与算法开发。
当前项目版本为 **0.6.1**。`v0.5.0` 已作为第五版阶段验收发布标签推送;第四版 `0.4.8` 已完成阶段验收并作为稳定基线;第五版 `0.5.x` 已收束 nonlinear/contact diagnostic hardening;0.6.0 交付统一非线性 lifecycle foundation、rollback audit、生命周期输出字段和 restart 诊断回读,0.6.1 继续加固 lifecycle/contact/Riks/solver 诊断报告与回归证据。完整工业级 mortar/AL 一致切线、mixed-control continuation、cohesive contact mainline、DEM/FEM subcycling 和生产级滚压流程仍作为后续版本工作。
## 当前基线
`0.4.8` 第四版验收基线已具备:
- 显式动力学、线性/非线性静力和隐式 Newmark 主流程。
- C3D4、C3D8、C3D10、C3D20 实体单元。
- S3、S4、S6、S8 壳单元基础动力、静力和输出能力。
- 线弹性、J2/J2_JC 小应变弹塑性和壳代表性 section plasticity。
- 面-面 contact pair、analytical rigid plane、mortar 权重、Coulomb/正则化 Coulomb 摩擦历史、接触输出和 restart。
- 内部 CG、BiCGSTAB、GMRES、dense pivoting fallback 线性求解器和
none/Jacobi/Gauss-Seidel/ILU0 预条件器。
- CSV、VTK、restart、C ABI 和外部 SPH/载荷映射接口。
- `examples/` 下的可运行示例矩阵和 Windows GCC 16 本地 CTest 基线。
第五版已接入内部 solver 诊断、no-external-solver 回归、非匹配 contact benchmark、Mohr-Coulomb 材料点和强度折减 benchmark、Euler/波纹壳屈曲 benchmark、滚压 kinematics/springback benchmark、cohesive ball adhesion benchmark,以及真实粒子-柔性容器耦合 benchmark。0.6.x 在此基础上补齐非线性增量生命周期、材料/接触/cohesive/particle 审计适配、`continuation_path.csv` 生命周期与 Riks/arc 诊断列、`nonlinear_lifecycle.csv`、contact state/AL/friction 诊断和 restart version 5 可选 `LIFECYCLE_DIAGNOSTICS` 块。详细计划和剩余项见 [docs/v6.0_development_plan.md](docs/v6.0_development_plan.md)、[docs/v6.1_development_plan.md](docs/v6.1_development_plan.md)、[docs/v6_benchmark_matrix.md](docs/v6_benchmark_matrix.md)、[docs/v6_acceptance_report.md](docs/v6_acceptance_report.md) 与 [todo.md](todo.md)。
## 快速构建
```powershell
cmake -S . -B build-win-gcc-16 -G "MinGW Makefiles" -DCMAKE_BUILD_TYPE=Release
cmake --build build-win-gcc-16 --config Release
ctest --test-dir build-win-gcc-16 --output-on-failure
```
如果使用已有构建目录,可直接执行:
```powershell
ctest --test-dir build-win-gcc-16 --output-on-failure
```
## 运行示例
示例统一放在 `examples/` 下。每个案例使用独立文件夹,并提供 README、输入文件和 Windows 双击运行脚本。
例如:
```powershell
examples\contact_two_blocks_compression\run_case.bat
examples\contact_block_sliding\run_case.bat
examples\roll_forming\run_case.bat
examples\Dynamic_Grain_Packing_of_a_Flexible_Container\run_case.bat
```
部分第五版目标案例仍保留第四版 smoke 作为快速回归,同时新增独立 benchmark 输入和 checker。每个案例 README 会标明当前覆盖范围、输出指标和限制。
## 文档入口
- [第四版验收报告](docs/v4_acceptance_report.md)
- [第五版开发计划](docs/v5_development_plan.md)
- [第五版验收报告](docs/v5_acceptance_report.md)
- [第五版 benchmark 矩阵](docs/v5_benchmark_matrix.md)
- [用户手册](docs/07_user_manual.md)
- [开发者手册](docs/08_developer_manual.md)
- [数学模型与算法](docs/04_mathematical_model_and_algorithms.md)
- [测试与验证计划](docs/06_test_and_verification_plan.md)
## 开发约束
- 新增算法必须同步更新需求、架构、详细设计、算法、接口、测试、用户和开发者文档。
- 第五版不接受 mini/demo/smoke 替代核心能力验收。
- 如果同一算法同时存在前期遗留简化版和后期补强完整版,必须删除简化版或隔离到非生产调试入口,不能继续作为生产 fallback。
- 大型结果文件不直接提交到 git,只提交小型参考指标、检查脚本和生成说明。
- 已验收的 V1-V4 能力必须保持回归通过。
## 联系方式
这是用CODEX开发的软件,实现了一些有趣的功能,大部分功能已经推进到稳定的工程级别。如果有什么问题或者想法,可以通过邮箱联系我:
```wenhao.shen@pkuncii.cn```