3.5 KiB
3.5 KiB
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路径不受S4Rhourglass 项影响。
该路径用于 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。