ARTICLE · 1400803
从脚本到插件:发卡绕组 NX 自动建模的实现与验证
三套实现交叉验证,首次完成 NX 插件实跑

▲ 图1:插件在 NX 中跑完一组算例:78 个实体、1294 对无干涉、对照正常
📎 文件:nxpl_done.png
1 问题:为什么要从脚本做成插件
上一篇《6 组槽极配合、20084 对实体无干涉:发卡绕组 NX 三维模型的参数化建模》给出的做法是:桌面版核算通过后生成一个脚本,在 NX 中播放。这样做不需要在 NX 一侧安装任何东西,但有两点不便:每改一次尺寸都要回到桌面版重新导出;脚本是明文。
在方案迭代阶段,尺寸往往要反复调整,而调整后的模型是在 NX 中查看的。脚本方式虽然能自动建模,但改尺寸、导出脚本、生成模型分在两个软件里完成,来回切换,交互效率低。因此需要把核算与建模直接放进 NX 环境。
插件的形态是:在 NX 中打开一个窗口,尺寸在窗口里改,核算、建模、查干涉都在 NX 中完成。由此带来的问题是:核算必须在插件里再实现一遍,如何保证它与桌面版的结果一致?走线算法是否也要在插件里再写一遍?
2 方案与假设
2.1 分工
(1)桌面版:计算走线,导出走线文件。文件内容是每条支路依次经过的(槽,层)序列,以及可选的 13 个尺寸;
(2)NX 插件:读取走线文件;填写或修改尺寸;按导体中心线核算;核算通过后生成实体、按相着色、测量体积;最后逐对检查干涉。

▲ 图2:分工与核对关系:走线只在桌面版计算;两处核算分别与同一份参考值对拍
📎 文件:nxpl_arch.png
走线算法包含支路平衡、形状种类最少等搜索与判据,是整个流程中最复杂的部分。让插件读取文件而不是重写这部分,走线算法就只有一份,不存在两份实现逐渐不一致的问题。
2.2 插件的形式
插件是一个 .NET 类库(DLL),窗口为非模态:窗口开着时 NX 照常可以操作。可以通过「文件 → 执行」加载,也可以配置成 NX 菜单栏上的一个常驻菜单。
2.3 沿用的纪律
(1)不设缺省尺寸:没有填写或填写有误时拒绝,并指出是哪一项;「填入示意尺寸」只在点击按钮时写入输入框;
(2)核算不通过不生成模型,只说明冲突的位置和原因,不替使用者修改尺寸;
(3)生成前检查 NX 的状态:没有打开部件、部件不是毫米单位时拒绝;部件中已有实体时先询问。

▲ 图3:左:核算通过后的提示;右:NX 中没有打开部件时,拒绝生成并说明原因
📎 文件:nxpl_states.png
模型假设与前两篇相同:等截面矩形裸导体;端部为示意画法;模型只含导体。
3 跨语言实现的一致性验证
3.1 为什么会有三套
几何与核算现在有三套实现:桌面版用 JavaScript 做核算;写入脚本、在 NX 中画图的是 Python;插件是 C#。三者算的是同一件事,任何一处写错都会造成「核算说不冲突、画出来却冲突」。
3.2 对拍的方法
先由 Python 版对 6 组算例计算一份参考值:实体数、中心线点数、核算取点数、中心线坐标的校验和、三个最小间隙。JavaScript 版在桌面版的页面检查中与参考值比较,C# 版在一个不依赖 NX 的自检程序中与参考值比较。容差为 10⁻⁹ mm。
3.3 浮点末位导致的跨语言结果分叉
C# 版第一次自检时,6 组中有 5 组一致,60 槽 10 极 6 层这一组不一致:897 个实体中有 2 个(均为同层跳线)的中心线长度与另外两套实现相差 0.021 mm。
原因在发卡头顶点的取法。换层过渡段以顶点为中心,顶点原先取「中心线上轴向坐标最大的那个取点」。圆角顶部若恰好有两个对称的取点,它们的轴向坐标在数学上相等,计算结果只在浮点数的最后一位上有差别;哪一个更大,取决于正弦、余弦函数在该语言数学库中的末位舍入。三种语言的数学库并不保证末位相同,于是选中的点不同,过渡段的位置相差一个取点间距。
修正的办法是让取法不依赖末位:取「轴向坐标不低于最大值 10⁻⁹ mm 的第一个点」。修正后三套实现在 6 组算例上全部一致;用修正后的 Python 版重新计算,897 个实体逐点不变,即此前在 NX 中实跑过的几何没有改变。
这一问题的性质不是某一套实现算错了,而是一处跨语言的确定性风险:三套实现各自运行时结果都稳定、都可重复,单独测试任何一套都发现不了;只有把它们放在一起比较才会暴露。对需要在多个平台上重复实现同一算法的软件,这类风险值得专门设防。
3.4 接口的核对
建模与查干涉的调用顺序沿用上一篇已在 NX 中跑通的脚本。改写成 C# 后,用 NX 安装目录中的接口库做编译核对,发现扫掠构建器的类型自 NX 2412 起已更换,旧类型不能赋值;据此改正。脚本语言不做类型检查,这一类问题在脚本中不会暴露。
4 结果
汇总。各项的来源与细节见下文。
结论先行:
(1)C# 版自检 48 项全部通过,6 组算例与参考值一致;
(2)核算在本机用时 209~572 毫秒;
(3)插件在 NX 2506 中生成 78 / 78 个实体,用时 86 秒;
(4)干涉检查 1294 对,全部无干涉,用时 187 秒;对照被识别为存在干涉。
4.1 自检(不依赖 NX)
在作者本机上编译并运行的输出。实体数、取点数、靠近的实体对数与上一篇的结果相同。
4.2 NX 中的首次实跑(36 槽 6 极 4 层 2 支路)

▲ 图4:插件运行中:实体逐个生成(此时为 A 相)
📎 文件:nxpl_running.png
体积差 = 单个实体的体积与「截面积 × 中心线长度」之差。两次运行在同一台机器、同一版本的 NX 上,相隔一天。
实体数、检查的实体对数和干涉结论两者相同。总体积差异约为 +0.003 %。两次运行中,三维实体都是由 NX 内核按引导线重新构建的,这里比较的是重建后测得的体积,而不是直接比较实体的边界数据,目前尚未定位这一差异的具体来源。它比单个实体体积与「截面积 × 中心线长度」之间的偏差(本组为 +0.15 %~+1.36 %)小一到两个数量级,本文不再展开。建模用时多出 24 秒,推测与每生成一个实体就刷新一次进度显示有关,未作验证。
5 对 CAD 自动化开发的几点经验
根据上述结果,可归纳以下几点(适用范围见第 7 节):
(1)复杂的算法只留一份,用文件传递结果。走线由桌面版计算、插件读取,避免了走线算法的第二份实现。
(2)必须重复实现的部分,用同一份参考值对拍。核算无法避免在插件中再实现一遍;三套实现都与同一份参考值比较,6 组算例、897 个实体逐点一致。
(3)对拍能发现单套实现自己发现不了的问题。依赖浮点末位的取法在任何一种语言里单独运行都得到稳定的结果,只有跨语言比较才暴露:897 个实体中的 2 个。
(4)几何算法里的比较应留容差。「取最大值」「是否相等」这类判断若落在数学上相等的两个量之间,结果就由末位舍入决定。
(5)用真实的接口库做编译核对。类型不匹配在编译时就被指出,不必等到在 NX 中运行。
6 插件验证结果
(1)三套实现一致:6 组算例、897 个实体,中心线坐标最大相差 2×10⁻¹³ mm,核算取点数相同;C# 自检 48 项通过;
(2)修正不改变已实跑的几何:修正顶点取法后,Python 版 897 个实体逐点不变;
(3)NX 实跑:78 / 78 个实体生成,1294 对干涉检查全部无干涉、无出错,对照被识别为存在干涉;与上一篇同一组的脚本结果相同;
(4)核算与界面一致:插件窗口显示的核算结果(78 个实体、72 个焊点对位、间隙 1.06 / 1.57 / 0.29 mm)与自检和上一篇的数值相同;
(5)桌面版检查:页面检查 478 项通过,其中包含导出的走线文件与插件自检所用文件逐字相同一项。
7 适用范围与局限性
插件在 NX 中只实跑了一组算例(36 槽 6 极 4 层 2 支路),其余 5 组只通过了不依赖 NX 的自检;只在 NX 2506 上运行过,其他版本的接口是否一致未验证。本次实跑使用的走线文件由程序按桌面版的同一格式生成,桌面版界面上的导出按钮尚未实际操作验证。三套实现目前一致,但其中仍有依赖浮点运算的取整步骤,本文只修正了已经暴露的一处。插件目前不校验授权。单个实体体积与截面积 × 中心线长度的偏差原因仍未查明;端部形状为示意画法,不能作为制造图样;检查对象为裸导体。
尽管目前只完成一组算例的 NX 实跑,但从跨语言对拍、自检和这一次实际建模的结果看,插件的核心流程(读文件、核算、建模、查干涉)已经完整走通。
8 结论
(1)发卡绕组三维建模可以做成 NX 插件:核算、建模与干涉检查在 NX 中完成。架构上的要点是:走线算法只保留一份实现,几何与核算通过三套实现交叉验证;
(2)几何与核算的三套实现在 6 组算例、897 个实体上逐点一致;
(3)跨语言对拍发现并修正了一处由浮点末位决定结果的取法,涉及 2 个实体;
(4)插件在 NX 2506 中首次实跑,78 个实体、1294 对干涉检查全部通过;
(5)其余算例在 NX 中的实跑、其他 NX 版本和授权方式有待后续完成。
附录 开发记录
(1)编译最初打算使用集成开发环境,后改为用系统自带的 C# 编译器写成批处理:编译插件、编译自检程序并运行自检,一步完成;为此源码只使用旧版编译器支持的语法;
(2)源文件含中文,需带字节序标记并指定代码页,否则中文字符串在中文系统上会被按本地编码读取;
(3)窗口布局先在无显示的环境中截图检查过一次,尺寸输入区最初占满了剩余高度,日志区被压缩,据此调整;
(4)第一次点击「生成三维模型」时 NX 中没有打开部件,插件按设计拒绝并给出提示(图 3 右)。
相关工具
免费网页版(cycloidgear.com/winding.html,文末「阅读原文」为 48 槽 8 极):绕组排布、槽电势星形图、绕组系数、磁动势谐波分析、并联支路判定。
桌面版在网页版基础上增加:DXF 导出、Maxwell / JMAG / FEMM 绕组脚本导出、发卡绕组连接走线、发卡绕组三维模型(生成 NX 脚本;本文的 NX 插件目前处于验证阶段)、项目管理与批量计算。

扫码打开网页版
📎 文件:web_qr.png

桌面版咨询:微信扫码加作者,备注「绕组授权」
📎 文件:wx_markying.jpg















































































