夜雨聆风学习资料网

ARTICLE · 1400803

从脚本到插件:发卡绕组 NX 自动建模的实现与验证

从脚本到插件:发卡绕组 NX 自动建模的实现与验证

三套实现交叉验证,首次完成 NX 插件实跑

MarkYing   2026-11-21
摘要:在上一篇脚本自动建模的基础上,本文进一步将发卡绕组三维建模封装为 Siemens NX 插件,实现走线文件读取、尺寸核算、实体生成及干涉检查的一体化流程。走线算法仍由桌面版统一计算,NX 插件只负责读取与建模,避免多套走线实现带来的维护风险。为验证插件结果的正确性,对 JavaScript、Python 和 C# 三套几何与核算实现做了交叉对拍:在 6 组算例、897 个实体上,中心线坐标最大差异为 2×10⁻¹³ mm。插件首次在 NX 2506 中实跑,78 个实体全部生成,1294 对实体干涉检查全部为无干涉。本文的核心做法是:走线算法只保留一份实现,几何与核算通过三套实现交叉验证。目前在 NX 中只实跑了一组算例。
主要结论:(1)走线算法只保留一份实现:桌面版导出走线文件,NX 插件读取;几何与核算通过三套实现交叉验证;(2)几何与核算的三套实现(JavaScript、Python、C#)在 6 组算例、897 个实体上逐点一致,中心线坐标最大相差 2×10⁻¹³ mm;(3)对拍发现一处取法依赖浮点末位:897 个实体中有 2 个在不同语言下结果不同,中心线长度相差 0.021 mm;修正后已实跑过的几何不变;(4)插件在 NX 2506 中首次实跑:78 / 78 个实体,1294 对无干涉,对照被正确识别;(5)编译不需要集成开发环境,用系统自带的编译器即可。

▲ 图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 结果

验证项目
结果
对拍算例
6 组
对拍的实体数量
897 个
三套实现中心线坐标最大差异
2×10⁻¹³ mm
插件自检
48 项通过,0 项失败
NX 实跑生成的实体
78 / 78
NX 实体干涉检查
1294 / 1294 对无干涉
故意重叠的对照
被正确识别为干涉

汇总。各项的来源与细节见下文。

结论先行:

(1)C# 版自检 48 项全部通过,6 组算例与参考值一致;

(2)核算在本机用时 209~572 毫秒;

(3)插件在 NX 2506 中生成 78 / 78 个实体,用时 86 秒;

(4)干涉检查 1294 对,全部无干涉,用时 187 秒;对照被识别为存在干涉。

4.1 自检(不依赖 NX)

槽 / 极 / 层 / 支路
实体
核算取点
核算用时
靠近的实体对
36 / 6 / 4 / 2
78
94362
209 ms
1294
48 / 8 / 4 / 1
99
110763
209 ms
1685
48 / 8 / 8 / 2
198
229518
500 ms
4097
54 / 6 / 4 / 2
114
141894
267 ms
2946
60 / 10 / 6 / 2
186
196230
406 ms
3641
72 / 8 / 6 / 2
222
254658
572 ms
6421

在作者本机上编译并运行的输出。实体数、取点数、靠近的实体对数与上一篇的结果相同。

4.2 NX 中的首次实跑(36 槽 6 极 4 层 2 支路)

▲ 图4:插件运行中:实体逐个生成(此时为 A 相)

📎 文件:nxpl_running.png

项目
插件(C#)
上一篇的脚本(Python)
生成的实体
78 / 78
78 / 78
建模用时
86 s
62 s
实体总体积
380488.7 mm³
380477.6 mm³
检查的实体对 / 无干涉
1294 / 1294
1294 / 1294
干涉检查用时
187 s
170 s
引出导体体积差
+1.364 %~+1.365 %
+1.364 %~+1.365 %
发卡体积差
+0.319 %~+0.678 %
+0.319 %~+0.678 %
同层跳线体积差
+0.150 %~+0.217 %
+0.169 %~+0.215 %

体积差 = 单个实体的体积与「截面积 × 中心线长度」之差。两次运行在同一台机器、同一版本的 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

#电机设计#扁线电机#发卡绕组#三维建模#NX二次开发

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料