Files
FemLite/docs/03_detailed_design.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

3.6 KiB
Raw Blame History

03 详细设计

文档状态:0.6.5 版整理稿

1. 模型数据库

模型数据库保存:

  • 节点编号、参考坐标、当前坐标、速度和加速度。
  • 单元编号、单元类型、连接关系、材料和截面引用。
  • 节点集、单元集、边界条件、载荷和接触定义。
  • DOF 编号、质量、内力、外力、反力和状态变量。
  • 接触、cohesive、颗粒和生命周期诊断状态。

模型读取后必须经过数据库校验。缺失材料、错误节点数、非法集合引用、非正 Jacobian 等问题必须通过错误码报告。

2. 单元名称与拓扑

公开单元名称采用 Abaqus 风格。当前支持:

类型 名称
实体 C3D4、C3D8、C3D8R、C3D10、C3D20
壳 S3、S4、S4R、S6、S8

不支持的 Abaqus 名称必须明确报错,不得静默映射到相近单元。

S4R 是独立公开单元类型,不是 S4 的隐藏别名。它有 4 个节点、1 个 shell face 和 1 个积分点。

3. 积分规则设计

积分规则通过描述符表达:

维度 当前取值
family Gauss-Legendre、Gauss-Lobatto、closed Newton-Cotes、simplex symmetric
domain triangle、quadrilateral、tetrahedron、hexahedron
order 当前受测试覆盖的低阶规则

生产路径仍由单元类型选择默认积分规则。0.6.3 只提供内部规则库和查询能力,不提供用户 INP 侧任意积分选择。

4. S4R 与 C3D8R 小应变路径

S4R 使用当前小应变 shell 框架:

  • 5 个局部壳广义 DOF 列参与壳 B 矩阵导出。
  • 膜内、弯曲和横向剪切路径共享现有 shell section 机制。
  • 面内积分采用 1 点 reduced rule。
  • hourglass 控制使用小的交替模态刚度贡献,仅作用于 S4R。
  • S4 路径不受 S4R hourglass 项影响。

该路径用于 0.6.3 的受控验收,不声明完整有限变形 S4R 或复杂后屈曲精度。

C3D8R 使用当前小应变 solid 框架:

  • 拓扑、形函数和节点顺序与 Abaqus C3D8R 名称保持一致。
  • 体积分采用 1 点 hexahedron Gauss reduced rule。
  • 刚度和内力路径复用 C3D8 线性六面体形函数。
  • hourglass 控制使用小的四模态稳定项,仅作用于 C3D8R。
  • 当前不声明完整 reduced-integration solid 家族或高级 hourglass 参数体系。

5. 元素查询 API

元素查询采用小粒度 API:

  • 元素数量、类型、节点数。
  • 元素节点外部编号。
  • 参考坐标和当前坐标。
  • 积分点数量、自然坐标和权重。
  • 形函数和自然导数。
  • Jacobian 和 determinant。
  • B 矩阵尺寸和值。

所有 value-fill 查询必须先验证 id、积分点范围和缓冲区容量,再写输出。

6. 输出与诊断

主要输出包括:

  • history.csv、节点/单元 CSV、接触 CSV、path CSV。
  • 默认场变量输出 result_XXXXXXXX.vtu 和 results.pvd;legacy ASCII VTK 写入口保留为兼容路径。
  • restart 文件。
  • nonlinear_lifecycle.csv。
  • benchmark 专用 summary/profile CSV。

输出目录应自动创建;生成结果不得提交到 git。

7. 错误处理

错误处理统一通过 fem_error:

  • FEM_SUCCESS 表示成功。
  • 输入、网格、材料、求解、耦合、输出和内部错误使用稳定错误码分组。
  • API 调用失败后可通过 fem_get_last_error 或 C ABI 对应函数查询最近错误。

8. 设计边界

当前详细设计不包含:

  • 完整工业级接触一致切线。
  • 通用用户侧积分规则组合。
  • 完整有限变形 S4R。
  • 完整 reduced-integration solid 家族。
  • 大规模 DEM/FEM 子循环。
  • 生产级滚压工艺 step。