Files
FemLite/docs/07_user_manual.md
T
shenw a2126f360c
FemLite CI / build-test (push) Has been cancelled
Release 0.6.5 real IPC worker
2026-07-05 21:09:37 +08:00

159 lines
4.9 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.
# 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。