# 07 用户手册 文档状态:0.6.3 版整理稿 ## 1. 构建 Windows GCC 示例: ```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 cmake --build build-codex-gcc --parallel ctest --test-dir build-codex-gcc --output-on-failure ``` ## 2. 命令行运行 常用入口: ```powershell 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 元素查询示例 ```c 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 矩阵元素位置为: ```text 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 子循环。 - 生产级滚压成形流程。