Skip to content

建模顺序与依赖

model-build-order适用于 create / edit约 510 token

本页与桌面端 AI 读到的是同一份文件。AI 在对话里引用📖 guide · model-build-order时,指向的就是这里。

一句话

先材料 → 再截面 → 再几何 → 再单元 → 再边界 → 再荷载 → 最后建分析步。

为什么

这不是风格问题,是数据模型决定的。每个对象都持有上游对象的引用,反向创建只能得到一个指向空值的引用——要么当场报错,要么更糟:静默建出一个「看起来对、算起来全错」的模型。

具体依赖链:

材料 ──┐
├─→ 截面 ──→ 单元 ──→ 荷载(单元荷载依赖单元)
几何 ──┘ │
├─→ 边界条件(节点依赖几何)
└─→ 分析步(步骤依赖单元与约束)

最常见的三个坑

坑 1:先建几何,后改材料

用户说「把这些梁换成 Q355」,实际做法是先建了 20 根梁并赋了 Q235,再回头改。改材料本身没问题,但单元上缓存的刚度矩阵不会自动失效。Kavvo 会在 edit 动作里标记受影响单元为 dirty,下一次求解前重算。自己写 TCL 脚本绕过 Kavvo 的 edit 通道时,必须手动调用重算,否则算的是旧刚度。

坑 2:先建分析步,再建约束

OpenSees 的 analyze 会读当前模型的约束状态。如果分析步在约束之前创建,步骤的 DOF 编号在创建时就固化了——后加的约束会指向已废弃的编号,表现为「约束加了但位移还是自由」。

这就是为什么 Kavvo 把「先建分析步」列为需要显式确认的反常操作:它只在一种情况下正确,就是你已经把所有逐步行为都建完了。

坑 3:荷载在单元之前

节点荷载没问题(只依赖节点)。单元荷载(分布荷载、温度梯度)依赖单元存在。在单元之前建单元荷载,Kavvo 会拒绝并提示「找不到目标单元」,但如果你是用脚本直接调 eleLoad,OpenSees 不会报错,它会在求解时忽略这条荷载——结果偏小,且没有任何警告。

正确的顺序(推荐直接照做)

步 动作 校验点
1 定义材料(名称、E、ν、ρ、fy) 单位制是否与项目一致
2 定义截面(引用材料) 截面属性是否算得出来(A、I、Z)
3 建几何(点 → 线 → 面) 是否有重复点、是否有悬空点
4 划分单元(引用截面) 单元数与自由度总数
5 加边界条件(引用节点) 约束是否让结构成为几何不变体系
6 加荷载(节点荷载 / 单元荷载) 荷载总量是否与手算一致
7 建分析步 这一步之前,模型必须已经自洽

第 7 步放最后,是因为分析步是唯一「读取全模型」的对象。前面任何一步改动,都要让它重建。

逆向操作的唯一合法形式

用户经常需要「回头改」。合法路径是通过 edit 动作修改,而不是删了重建:

  • 改材料参数 → 引用该材料的所有截面自动失效 → 引用这些截面的单元自动失效 → 求解前重算
  • 改截面尺寸 → 同上
  • 改几何坐标 → 单元长度变化 → 自重、质量自动更新

不要为了改一个参数而删掉整个子结构重建。那会丢掉所有手工加的荷载和边界条件,而且用户看不出丢了什么。

与 AI 的关系

模型提出「帮我建一个三层框架」时,按上表顺序调 execute_script,一次脚本里完成 1–4 步,第二步脚本完成 5–7 步。不要一次脚本做完七步——中间出错时无法定位是哪一步的问题,而且用户看不到中间结果,无法在早期纠正方向。

建模依赖组件顺序