全部文章

当结果发生变化:结果版本、重新验算与公告

Stabileo 如何告知您某项修复涉及哪些项目,如何在修复发布之前暂不提供已知可能有误的结果,以及修复如何发布,并附 11 月 4 日和 5 日合并的十四个结果版本。

对结构求解器的每一项修复,都会改变某个人可能已经用过的数值。原先偏高的屈曲系数现在变低了;原先可以求解的模型现在被拒绝求解。如果修复悄无声息地进入应用,已经交付的计算中仍留着旧的数值,而做出这些计算的工程师没有理由再去查看。

本文介绍 Stabileo 对此所做的事情,从发现缺陷的那一刻,到其修复发布的那一刻。示例都是真实的:2026 年 11 月 4 日和 5 日,十四个结果版本(16 至 29)上线了 stabileo.com。

什么是结果版本

结果版本是一个整数,独立于应用版本。每当有改动上线到网站,使同一个已保存的模型得到不同的数值,或使原先可以求解的模型被拒绝求解,它就加一。每一项这类改动都会登记以下内容:

  • 它所属的版本、日期和相关的拉取请求;
  • 它涉及哪些模型,以模型特征来描述:带约束的平面模型、杆件上带荷载的 2D 屈曲分析、按 CIRSOC 201 验算的混凝土构件;
  • 应用六种语言各一份的标题和面向工程师的说明,其中写明需要重新验算什么;
  • 指向完整说明的链接:公告、结果变更说明或更新日志。

每次求解都会在项目上盖上产生该结果的结果版本的戳记,同时记录应用版本、提交、引擎版本、引擎二进制文件的哈希值以及所运行的分析。这个戳记随项目流转:已保存的文件、自动保存、打开的标签页或共享链接都带有它。

版本为什么会变化

多数变化是修复:原先错误的结果现在正确了。有些是拒绝求解:原先能给出数值的模型,现在改为给出明确的提示,因为那个数值没有意义。版本还可以撤销改动:版本 15 撤回了版本 14 中的三项改动,因为它们的评审修复没有随之一起上线;版本 27 至 29 又把它们带了回来,这次已经过评审。用版本 14 求解过的项目会收到关于这两者的通知。

版本变更类型
16铝合金:验算弱轴剪力修复
17钢结构节点:不再忽略弱轴弯矩拒绝求解
18ACI 318 和 EN 1992:有扭矩作用的混凝土构件标为未验算拒绝求解
19钢筋混凝土柱还会在其最小压力下进行验算(SA-2026-041)修复
20荷载生成器:部分处于低矮屋面结构之下的楼面保留其面荷载(SA-2026-033)修复
21导出的壳图形采用屏幕上的场量和比例修复
222D:刚性连接或刚性隔板之后的机构会被拒绝求解拒绝求解
23沿杆件轴力变化的杆件的 2D 屈曲(SA-2026-042)修复
24绕多个轴发生大转动的 3D 共旋分析(SA-2026-037)修复
25从 Y–Z 或 X–Y 平面截取的 2D 模型的约束(SA-2026-036)修复
26杆件的控制值和 2D 包络读取真实峰值修复
27–29版本 15 撤回的三项基础模式改动经评审后回归:塑性倒塌、P-Δ 和弯矩影响线的符号修复
结果版本 16 至 29,合并于 2026 年 11 月 4 日和 5 日。

重新验算通知

打开项目时,应用会把项目的戳记与登记册对比,并列出自那时以来涉及该模型的变更。带屈曲分析的平面框架会收到 2D 屈曲修复的通知;不含混凝土的钢框架则不会收到钢筋混凝土柱验算的通知。这份列表不是会消失的提示:通知没有关闭按钮,不响应 Esc 键,也不响应点击其外部,只有勾选“我已阅读这些变更”,并选择继续或重新运行,才会关闭。

Stabileo 基础模式打开示例中的一个平面框架,该框架以结果版本 15 保存为已求解。一个标题为“自上次求解该项目以来,结果已发生变化”的对话框列出涉及它的变更,其中有轴力沿杆件变化的杆件的 2D 屈曲修复,以及在真实峰值处读取的控制值,每项都附有说明,并要求先勾选“我已阅读这些变更”,再继续或重新运行分析。
以版本 15 求解的平面框架,今天打开:只列出涉及这个模型的变更,每项都附有需要重新验算的内容。

在模型重新求解之前,其结果会被标记为已过期:页面上有横幅说明,其间导出的每一份报告、工作簿和 CSV 在其来源信息中都会打印 STALE 警告。“重新运行分析和设计”会再次求解,并且在 PRO 中,会用已经选定的配筋重新验算混凝土构件;它不会重新设计这些构件,因为那会覆盖工程师选定的钢筋。

自 11 月 4 日起(#1406),通知会以读者的语言解释每一项变更,应用的六种语言全部覆盖。在此之前,德语、法语和土耳其语的读者看到的标题和说明是英文:已登记的 72 项变更中,有 66 项在这些语言中没有文本。每一份译文都经过检查:不看原文,把它翻译回英文,再比较含义,包括数值、符号、哪一种荷载、哪一项验算、偏安全还是偏不安全。这一检查纠正了三种语言中的句子,还发现有四条英文说明在源头上就有歧义;这些都已在六种语言中修正。

修复之前:警告或拒绝求解

缺陷通常是在修复之前被发现的,有时早几天。在这段时间里,受它影响的结果仍显示在屏幕上。我们遵循的规则是先遏制,后修复(issue #447):每一个可能给出错误结果的未解决缺陷,在它影响的每一个入口处,都要有警告或拒绝求解。

  • 警告保留结果,并在旁边显示哪个已知问题可能影响它,以及需要手工检查什么。
  • 当数值可能错出很大倍数,而又无法从输出中察觉时,拒绝求解会暂不提供结果并说明原因,例如系数会随杆件编号而变化数倍的情形。
Stabileo 基础模式中的隐藏机构示例:一根两跨梁支承在三个支座上,三个支座在水平方向都可滚动,承受 10 kN/m 的均布荷载。点击求解后,不绘制任何图;角落里的红色提示写着“不稳定结构(机构):任何支座都没有水平约束。”,并带有一个查看几何组成分析的按钮。
登记册之外的同一条规则:属于机构的模型会得到说明原因的提示,而没有任何数值。

遏制措施记录在一份登记册中,列出每一个未解决的安全问题、它的警告或拒绝求解、触发它的条件,以及证明它会触发的测试,或者说明无需遏制的依据。一项测试保证登记册与引擎的已知问题清单保持一致,一个定时任务则把登记册与 GitHub 上未关闭的 issue 对比。条件是有意收得很窄的:在结果语料库的 39 个模型中,每条警告最多只对其中两个触发。为每一个未解决的 issue 补全这份登记册的拉取请求(#807)已于 11 月 5 日合入,早于 0.5.0 版本发布。

遏制在其修复合入时结束,并且在同一个拉取请求中结束。本周,#1295 取消了对 3D 转 2D 截取的拒绝求解,该拒绝求解针对的是使杆件绕错误轴弯曲的情形,因为现在截取已经正确;#1301 把对每一次 3D 共旋求解都出现的警告,换成只在杆端相对其弦线转动超过 0.02 rad 时才触发的警告,因为剩余的近似只有在此时才可能产生影响。

本周的修复

杆件上带轴向荷载的 2D 屈曲(#1324,版本 23)。每根杆件的几何刚度使用的是其平均轴力。当压力朝转动最大的一端增大时,例如斜梁承受重力,或跨内有轴向集中荷载,得出的屈曲系数偏高,而没有任何警告。现在每根杆件都对其变化的轴力进行积分。

算例精确值修复前现在
悬臂,压力由支座处的 0 增大到端部的 P3.4774.972 (+43 %)3.542 (+1.9 %)
悬臂,端部有推力 P,跨中有反向的轴向荷载 P:只有从跨中到端部才有压力 P2.9614.972 (+68 %)3.056 (+3.2 %)
欧拉重力柱,压力在支座处最大7.8374.972 (−37 %)7.889 (+0.7 %)
一根杆件,λP·L²/EI。来源:SA-2026-042。

剩下的百分之几是每根杆件一个单元的通常离散误差,随着杆件被划分得更细而减小。P-Δ 分析仍使用平均轴力,而杆件上带荷载的 3D 屈曲在其自身修复完成之前仍保留警告。

3D 共旋分析(#1301,版本 24)。杆端转角此前是作为转动向量相减的,只有当所有转动共轴时这才是精确的。Bathe–Bolourchi 的 45° 弯曲算例与其已发表的解相差 1.3 %,而且加密网格会使其远离参考解,而不是趋近。现在转动按旋转矩阵复合:同一个弯曲算例与两个独立的已发表解相差都在 0.4 % 以内,并在二者之间收敛。两端相对转动超过 0.9π 的杆件会被拒绝求解,因为结果无法说明所指的是转了整整几圈。

2D 中的隐藏机构(#1298,版本 22)。从一个所有杆件都为铰接的节点引出的刚性连接或刚性隔板,连到桁架杆件的端部,就构成机构,但求解器用一个很小的人工弹簧把它约束住,返回了数百公里的位移,而证书还对其作了认证。现在这样的模型会被拒绝求解。这次修复没有提出公告:在所发现的算例中,位移荒谬,约为 10⁵ m,并且伴有应用给出的可能存在机构的警告。这是对那些算例的判断,而不是没有任何受影响的结果看起来合理的证明。错的是证书的声明,而版本条目会告知它所涉及的项目。之后又发现了一个类似的案例,是通过连接件而不是刚性连接出现的(#1414);其修复(#1415)已于 11 月 5 日合入。

把 3D 模型截取为 2D(#1295)。截取时对每根杆件都使用了各截面的强轴惯性矩,因此 Y–Z 截取中的柱、X–Y 截取中的梁以及旋转 90° 的杆件都绕错误的轴弯曲:一个立在 Y–Z 平面中的 IPN 300 门式刚架,2D 下侧移 0.96 mm,而 3D 下为 13.0 mm。现在每根杆件在 2D 中绕其在 3D 中弯曲所绕的轴弯曲,平面模型无法表示的截取会被拒绝求解。这项修复没有结果版本,这是有意为之:已保存的 2D 模型的求解结果与之前完全一致,因为错的是截取所产生的模型。重新验算通知无法触及这些文件,因此渠道是公告(SA-2026-035):从 3D 重新截取模型,或者直接用 3D 求解。

修复之后:公告

凡是在已发布版本中可能产生错误或偏不安全结果的缺陷,都会发布安全公告:哪里出了错,影响哪些模型,如何识别它们,对已交付的结果需要重新验算什么,以及能复现它的算例。本周这些修复的公告已在代码仓库中起草,将随 0.5.0 版本一并发布,正如 SA-2026-001 至 024 随 0.3.0 和 0.4.0 发布一样。

公告哪里出了错严重程度
SA-2026-033当一根低矮的构件立在某层楼面的一部分之上时,荷载生成器漏掉了该层的面荷载高
SA-2026-034对于漏掉了部分荷载的校核,平衡校核依然显示吻合中
SA-2026-0353D 转 2D 截取使杆件绕错误的截面轴弯曲高
SA-2026-036在 Y–Z 或 X–Y 上的 3D 转 2D 截取,把约束按框架立在 X–Z 平面中来读取高
SA-2026-0373D 共旋分析把转动向量相减中
SA-2026-040ACI 318 和 EN 1992 验算在没有验算扭矩的情况下让混凝土构件通过高
SA-2026-041钢筋混凝土柱验算只把最大弯矩与最大压力配对高
SA-2026-0422D 屈曲高估了压力沿杆件增大的杆件的屈曲系数高
为 2026 年 11 月 4 日和 5 日合并的修复起草的公告。
网站上的 Stabileo 更新日志页面:最新条目在最前,日期为 11 月 6 日,标题为“设计验算和动力分析中的错误结果已修复,生成荷载已更正,PRO 的分析模式已完成”,开头是其引擎方面的变更,左侧可按领域筛选。
更新日志页面,最新在前,开头是本周改变结果的修复。

这套机制做不到什么

  • 通知只知道已登记的变更。尚未发现的缺陷不在任何登记册中;这正是求解器背后的验证所要解决的,也是一旦发现问题后遏制措施所涵盖的。
  • 它从已保存的文件中读取模型的特征,无法判断时,就把该特征视为存在:多一次通知,好过一项变更对其所涉及的模型隐而不报。
  • 数值一旦离开应用,出现在图纸、电子表格或已交付的报告中,它就无法再追踪。这正是公告的作用。
  • 无论是被遏制、被拒绝求解还是已修复,结果在签字之前仍然要由工程师检查。
全部文章

继续阅读