106 lines
3.5 KiB
Markdown
106 lines
3.5 KiB
Markdown
# 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。
|