3.0 KiB
3.0 KiB
07 用户手册
文档状态:0.6.3 版整理稿
1. 构建
Windows GCC 示例:
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
当前本地开发目录常用命令:
cmake --build build-codex-gcc --parallel
ctest --test-dir build-codex-gcc --output-on-failure
2. 命令行运行
常用入口:
femlite input.inp --run
femlite input.inp --static-linear
femlite input.inp --static-nonlinear
femlite input.inp --implicit-newmark
femlite input.inp --implicit-newmark-nonlinear
femlite input.inp --buckling
3. 支持单元
当前公开支持:
- 实体:
C3D4、C3D8、C3D8R、C3D10、C3D20。 - 壳:
S3、S4、S4R、S6、S8。
单元名称按 Abaqus 风格识别。不支持的名称会报错,不会静默替换。
S4R 是 0.6.3 新增的小应变减缩积分壳单元,带紧凑 hourglass 稳定性检查。它不是完整有限变形 S4R。
C3D8R 是小应变八节点减缩积分实体单元,采用 1 点积分和紧凑 hourglass 稳定项。当前仅声明受控子集,不等同于完整 reduced-integration solid 家族。
4. 积分方式
内部支持:
- Gauss-Legendre。
- Gauss-Lobatto。
- 闭型 Newton-Cotes。
- simplex symmetric。
当前没有用户关键字用于任意指定单元积分规则。
5. 输出
常见输出:
history.csv。nodes_step_xxxxx.csv。elements_step_xxxxx.csv。contact_XXXXXXXX.csv。continuation_path.csv。nonlinear_lifecycle.csv。- VTK 文件。
- restart 文件。
输出目录会自动创建。生成结果通常不应提交。
6. C API 元素查询示例
int rows = 0;
int cols = 0;
int ierr = femlite_get_element_b_matrix_size(elem_id, &rows, &cols);
/* 分配 rows * cols 个 double */
ierr = femlite_get_element_b_matrix(elem_id, ip_index, rows, cols,
bmat, &rows, &cols);
C 数组为 Fortran 顺序展开。例如 B 矩阵元素位置为:
bmat[row + row_count * col]
7. 常见问题
输入 keyword 被跳过
FemLite 支持 Abaqus INP 子集。非关键 keyword 可能 warning 后跳过;关键数据缺失会报错。
静力求解不收敛
先用 --static-linear 检查边界、载荷和材料,再检查约束不足、接触 penalty、材料非线性和增量设置。
接触结果异常
检查 slave/master surface、face label、法向、搜索距离、penalty 和初始穿透。
没有输出文件
检查输出间隔、输出目录、命令行模式和输入控制块。
8. 当前限制
当前不声明:
- 完整 Abaqus keyword 兼容。
- 完整工业级 mortar/AL 接触求解器。
- 完整 reduced-integration solid 家族和完整有限变形
S4R。 - 用户自定义任意积分规则。
- 完整 cohesive 主线接触 step。
- DEM/FEM 子循环。
- 生产级滚压成形流程。