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

4.9 KiB
Raw Blame History

07 用户手册

文档状态:0.6.5 版整理稿

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。
  • VTU/PVD 文件。
  • 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. CCLite worker

FemLite 提供 CCLite worker mock 模式,用于验证命令状态机、空耦合推进和结果输出:

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:

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 可控退出。

能力查询:

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。