建模顺序与依赖
本页与桌面端 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 步。不要一次脚本做完七步——中间出错时无法定位是哪一步的问题,而且用户看不到中间结果,无法在早期纠正方向。