Files
FemLite/docs/03_detailed_design.md
T
shenw 3d009d021e
FemLite CI / build-test (push) Has been cancelled
Release FemLite 0.6.3
2026-07-02 12:40:31 +08:00

106 lines
3.5 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.
# 03 详细设计
文档状态:0.6.3 版整理稿
## 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。
- 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。