159 lines
4.9 KiB
Markdown
159 lines
4.9 KiB
Markdown
# 07 用户手册
|
||
|
||
文档状态:0.6.5 版整理稿
|
||
|
||
## 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`。
|
||
- VTU/PVD 文件。
|
||
- 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. CCLite worker
|
||
|
||
FemLite 提供 CCLite worker mock 模式,用于验证命令状态机、空耦合推进和结果输出:
|
||
|
||
```powershell
|
||
femlite --cclite-worker --case input.inp --ipc-name mock `
|
||
--log worker_mock.log --output-dir worker_output --mock-steps 100
|
||
```
|
||
|
||
该模式会顺序执行 `INIT`、`READ_INPUT`、`BUILD_MODEL`、`EXPORT_INTERFACE`、`IMPORT_LOADS`、`ADVANCE`、`WRITE_OUTPUT` 和 `STOP`,并写出 worker 日志。它仍不是 Windows shared memory/named event IPC。
|
||
|
||
真实 IPC worker 使用 CCLite 创建的 command block、data block 和 named event:
|
||
|
||
```powershell
|
||
femlite --cclite-worker --worker-backend ipc --solver-id FEM `
|
||
--case input.inp --ipc-name CCLITE_CASE001 `
|
||
--data-prefix CCLITE_CASE001 --timeout-ms 30000 `
|
||
--log femlite_cclite_worker.log
|
||
```
|
||
|
||
`--mock-steps` 存在时会强制进入 mock 模式;真实 IPC 模式应显式使用 `--worker-backend ipc`。FemLite 只 open/wait/signal CCLite 创建的 IPC 对象,不 reset event。当前真实 IPC worker 已支持 READY、INIT 到 STOP、`FEM_TO_CCL_FACET` 的 `AOR_V1` facet 导出、`CCL_TO_FEM_LOAD` 的 `AOR_V1` 节点力导入、1 step/100 step 空耦合 smoke、异常输入和 timeout 可控退出。
|
||
|
||
能力查询:
|
||
|
||
```powershell
|
||
femlite --cclite-capabilities
|
||
```
|
||
|
||
输出是稳定 `key=value` 文本,包含 worker mock、Windows IPC、`AOR_V1` data block、facet 导出和节点力导入能力。
|
||
|
||
`WRITE_OUTPUT` 会把 VTU/PVD 结果和 coupling 诊断表写到同一输出目录:
|
||
|
||
- `results.pvd` 与 `result_XXXXXXXX.vtu`
|
||
- `femlite_cclite_load_report.csv`
|
||
- `femlite_cclite_surface_report.csv`
|
||
|
||
当前 CCLite 载荷导入是基础节点力闭环:FemLite 接收 `node_id + force[3] + source_id + load_mode + valid_flags`,并将其叠加到显式动力外力和静力/隐式 RHS。真实 SPH-FEM penalty contact、FSI 和强耦合 rollback 仍由后续 CCLite 联调阶段处理。
|
||
|
||
## 8. 常见问题
|
||
|
||
### 输入 keyword 被跳过
|
||
|
||
FemLite 支持 Abaqus INP 子集。非关键 keyword 可能 warning 后跳过;关键数据缺失会报错。
|
||
|
||
### 静力求解不收敛
|
||
|
||
先用 `--static-linear` 检查边界、载荷和材料,再检查约束不足、接触 penalty、材料非线性和增量设置。
|
||
|
||
### 接触结果异常
|
||
|
||
检查 slave/master surface、face label、法向、搜索距离、penalty 和初始穿透。
|
||
|
||
### 没有输出文件
|
||
|
||
检查输出间隔、输出目录、命令行模式和输入控制块。
|
||
|
||
## 9. 当前限制
|
||
|
||
当前不声明:
|
||
|
||
- 完整 Abaqus keyword 兼容。
|
||
- 完整工业级 mortar/AL 接触求解器。
|
||
- 完整 reduced-integration solid 家族和完整有限变形 `S4R`。
|
||
- 用户自定义任意积分规则。
|
||
- 完整 cohesive 主线接触 step。
|
||
- DEM/FEM 子循环。
|
||
- 生产级滚压成形流程。
|
||
- 真实 SPH-FEM penalty contact、FSI 和强耦合 rollback。
|