做NX二次开发这些年最常被问到的需求除了批量出图、自动BOM就是这种给我一个3D零件帮我算出它的坯料尺寸。这个“坯料尺寸”听起来简单真做起来坑不少——单位搞错、坐标系歪了、多实体漏算、斜着放的零件包围盒虚大每一步都能让人折腾半天。这篇文章讲的是这个系列的第一集用Python在NX里实现坯料尺寸的自动计算。我会从需求逻辑、环境准备讲到完整代码、经验参数和避坑清单目标是让拿到脚本的人跑完就能直接用。适合两类人刚入门NX二次开发想找个完整案例的以及有NX操作基础、想用脚本把重复计算工作省掉的工程师。1. 这个需求到底在解决什么问题1.1 坯料尺寸从3D零件到一块“能加工”的料先把这个概念聊透。零件设计出来之后不管你是要车、铣、刨、磨还是走铸造、锻造路线手上拿到的第一块材料都不可能直接是成品形状。做机加工前要先去仓库找一块比零件大的料做铸造时模具型腔里先有一个带余量的毛坯形状做CAM编程开粗时软件也要先知道毛坯边界在哪。这块“比成品大一圈”的初始材料就是坯料。计算逻辑拆开就三步拿到成品零件的最大外形尺寸在需要加工的面或方向上留出加工余量再乘上材料收缩率。用公式表示就是坯料尺寸 成品外形尺寸 ×1 收缩率 单边加工余量 × 2为什么加收缩率铸造件从高温冷却到常温会缩水模具型腔必须按“放大了的成品”来设计锻造件也有热胀冷缩和氧化皮损耗。为什么左右都加因为零件放在坯料中间X、Y两个方向都要余量所以是“两倍”。这份逻辑看着简单但真正跑到代码里需要处理的边界情况比想象中多。1.2 方案选型包围盒为什么是第一步计算三维模型外形尺寸常见思路有三条。第一条包围盒法。直接问NX要这个体的最小包围盒Bounding Box拿到X、Y、Z三个方向的最小和最大坐标一减就是长宽高。优点是快、稳、API简单适合外形接近方块、长条、圆柱的绝大多数机械零件。缺点是零件斜着放或者有曲面轮廓时包围盒会比真实投影外形“虚大”。第二条面投影轮廓法。把零件往基准平面投影提取最外轮廓曲线再量轮廓的包络尺寸。精度高能处理斜面、异形面但需要遍历面、边、环的拓扑关系代码量上了一个台阶。第三条Structures/Parasolid底层分析。通过内核函数直接访问几何拓扑做精确的最小外接尺寸计算最准但开发成本也最高。我做第一集时定下的原则是先把包围盒方案做成型跑通把参数框架、单位处理、批量逻辑沉淀下来。等到第二集再针对异形轮廓、通孔盲孔这些做拓扑层面的精修。事实证明这个节奏是对的——包围盒方案解决了80%的常规零件剩下的20%才有必要上高级手段。2. 环境准备Python跑进NX的两条路2.1 NX版本和Python运行环境先回答一个被反复问的问题NX的Python二次开发要不要自己装Python答案是不用。NX从11.0开始内置了Python解释器12.0之后对NXOpen Python API的支持已经相当完整我日常用的NX版本是12.0和2206系列下面的代码在两个版本上都实测过。确认你的NX支持Python最简单的办法是打开菜单文件 - 执行 - Python。如果弹出的是Python脚本选择对话框那环境基本没问题。有些老版本比如NX 10没有这个入口那就需要先升级到NX 11以上或者在命令行里手动配置NXOpen Python环境那种情况建议直接换版本没必要纠结。另外NX内置的Python版本和操作系统没关系也不影响系统中是否装了Anaconda或者其他Python发行版。脚本里写的import NXOpen、import NXOpen.UF指向的都是NX自带的那套API库这一点在刚开始写的时候容易混淆。2.2 Journal录制法让NX自己教你写API对刚接触NX二次开发的朋友我强烈建议先学会“录制Journal”。操作方法在NX里点“录制”按钮图标是个圆点选择语言为Python老版本默认是C#或VB记得在录制选项里切换然后手动做一遍操作停止录制后就会生成一个.py文件。打开这个文件你会发现NX把你刚才点菜单、选对象、改参数的动作全翻译成了API调用。我的习惯是拿录制出来的文件当“API字典”遇到不知道的函数就去录制一段对应操作再对照代码找函数名和参数。比如想确认“获取当前显示部件”的写法录一下就知道是theSession.Parts.Display还是theSession.Parts.Work。这套方法比翻帮助文档直观很多尤其适合Python这种相对小众的NX开发语言。2.3 脚本存放与执行写好的Python脚本建议统一放在固定目录比如C:\NXScripts文件名用英文。执行脚本有两种方式第一种是文件 - 执行 - Python直接选择脚本运行第二种是写一个简单的菜单脚本.men文件注册到NX里之后从菜单按钮一键触发。第一集先用第一种方式简单直接调通逻辑再考虑做成菜单按钮。调试技巧方面print输出是主力工具。NX执行Python时print的内容会输出到系统控制台或者“信息”窗口具体看NX版本。我建议在脚本开头加一段输出分隔线把运行过程打印出来方便定位问题。3. 核心代码从零件到坯料尺寸的完整脚本3.1 获取当前工作部件里的所有实体先写最基础的骨架连上NX会话拿到当前工作部件遍历部件里的所有Body筛出实体Solid Body而不是片体。import NXOpen import NXOpen.UF the_session NXOpen.Session.GetSession() the_ufsession NXOpen.UF.UFSession.GetUFSession() work_part the_session.Parts.Work if work_part is None: raise RuntimeError(请先打开一个部件文件) all_bodies work_part.Bodies solid_tags [] for body in all_bodies: if body.IsSolidBody: solid_tags.append(body.Tag) print(有效实体数量:, len(solid_tags)) if len(solid_tags) 0: raise RuntimeError(当前工作部件中没有实体)这段代码里有个细节值得注意the_session.Parts.Work拿的是当前工作部件如果NX界面里打开了多个文件显示部件和工作部件可能不是同一个文件。我处理批量零件时都会先弹出一个提示让使用者确认工作部件是对的否则脚本可能跑在错误的文件上结果看起来“莫名其妙”。body.IsSolidBody这个判断必须加。NX里既有Solid实体也有Sheet片体。如果不过滤片体的包围盒也会被算进来最后毛坯尺寸会整体偏大。我在测试时有一次忘了加这个判断一个带曲面片体的零件算出来的X方向尺寸比实际大了将近50毫米排查了半天才锁定是片体在捣乱。3.2 核心UF_MODL_ask_bounding_box 包围盒计算获取包围盒的接口我推荐用UF函数而不是NXOpen原生API原因后面专门说。UF_MODL_ask_bounding_box这个函数在Python里的调用形式是the_ufsession.Modl.AskBoundingBox(body_tag)。# 初始化范围 inf float(inf) min_point [inf, inf, inf] max_point [-inf, -inf, -inf] for tag in solid_tags: result the_ufsession.Modl.AskBoundingBox(tag) # 不同NX版本对返回值的封装不同这里做兼容 if isinstance(result, tuple) and len(result) 2: error_code result[0] box result[1] else: error_code 0 box result if error_code ! 0: print(包围盒计算失败Body Tag:, tag) continue # box依次是 min_x, min_y, min_z, max_x, max_y, max_z min_point[0] min(min_point[0], box[0]) min_point[1] min(min_point[1], box[1]) min_point[2] min(min_point[2], box[2]) max_point[0] max(max_point[0], box[3]) max_point[1] max(max_point[1], box[4]) max_point[2] max(max_point[2], box[5]) part_len max_point[0] - min_point[0] part_wid max_point[1] - min_point[1] part_hei max_point[2] - min_point[2] print(成品最大外形尺寸: {:.3f} x {:.3f} x {:.3f}.format(part_len, part_wid, part_hei))这里必须说清楚一个容易踩的返回坑顺便提一句这个函数返回的坐标是基于绝对坐标系的跟WCS没关系。所以如果零件离原点很远min和max的数值会很大但差值也就是长宽高不受影响我们计算毛坯尺寸时只需要差值问题不大。3.3 把余量和收缩率算进去拿到成品外形尺寸之后下一步就是套公式加余量、乘收缩率。我在脚本里把参数都放在文件顶部方便每个人按自己工厂的工艺习惯去改。# 加工余量单边单位mm allowance_xy 2.0 allowance_z 2.0 # 材料收缩率普通铸钢约1.5%铝合金约1.0%这里先用常见值 shrink_rate 0.005 blank_len part_len * (1 shrink_rate) 2 * allowance_xy blank_wid part_wid * (1 shrink_rate) 2 * allowance_xy blank_hei part_hei * (1 shrink_rate) 2 * allowance_z print(含余量毛坯尺寸: {:.3f} x {:.3f} x {:.3f}.format(blank_len, blank_wid, blank_hei))实话说这个公式是坯料计算的基础框架真正的工厂会加上更多条件。比如有的锻件要考虑拔模斜度毛坯顶部和底部的余量不一样有的铸件要留出分型面飞边尺寸还要再大一圈。这些在后续版本里都可以慢慢加但第一版先把最核心的“外形尺寸余量收缩”跑通。脚本最后我把尺寸向上取整到整数毫米因为实际买料、下料不可能精确到小数点后三位import math blank_len_r int(math.ceil(blank_len)) blank_wid_r int(math.ceil(blank_wid)) blank_hei_r int(math.ceil(blank_hei)) print(圆整后的坯料尺寸: {} x {} x {}.format(blank_len_r, blank_wid_r, blank_hei_r))圆整这步看上去不起眼实际用途很大。铝合金型材、棒料、板材都有标准规格圆整到整数之后更好去库存里对号入座。4. 原理、细节与经验参数4.1 为什么用UF接口而不是NXOpen原生APINXOpen的原生API里其实有一个方法可以拿包围盒body.GetBoundingBox()。但我在实际项目里发现这个方法在不同NX版本上的返回类型不稳定有的版本返回两个点坐标有的版本返回一个BoundingBox对象升级NX之后原有代码经常要改。UF函数UFUN则稳定得多UF_MODL_ask_bounding_box这个接口在NX老版本里就有函数签名几乎没变过而且UF函数在Python里调用性能开销小大批量算几百个零件时优势明显。用UF也不是没有代价最典型的就是错误处理不如NXOpen那么优雅。NXOpen的API很多会抛异常UF函数通常只返回一个整数错误码需要自己判断。我在脚本里做了一版兼容处理判断返回值是不是元组是就按“错误码数据”解析不是就直接当数据用。这套兼容逻辑帮我省了不少和不同版本NX“商量”的时间。4.2 单位、坐标系、隐藏体和多实体四个高频翻车点单位问题是我见过最多的坑。UF_MODL_ask_bounding_box返回的数值单位是“部件单位”不一定就是毫米。如果零件模板是英制的返回的就是英寸直接拿去当毫米算毛坯尺寸会差25.4倍。稳妥的做法是脚本开头判断部件单位if work_part.Units NXOpen.Part.Units.Inches: scale 25.4 print(检测到英制部件结果将转换为毫米) else: scale 1.0 part_len_mm part_len * scale part_wid_mm part_wid * scale part_hei_mm part_hei * scale坐标系方面包围盒基于绝对坐标系跟WCS无关。如果零件是斜着建模的包围盒会“虚大”这种情况我会提示用户先把装配或零件摆正再跑脚本或者等第二集的投影轮廓方案来解决。隐藏体也要注意。work_part.Bodies返回的是部件里所有Body包括被Blank掉的。多数场景下隐藏体不影响毛坯计算因为它的外形包围盒依然需要参与合并。但有些设计人员会故意把老版本、旧外形放在某个图层里隐藏掉这时候就需要判断body.IsBlankskip_blank False # 默认不跳过隐藏体 if body.IsBlank and skip_blank: continue多实体零件的处理逻辑我在脚本里已经做了对每个体分别求包围盒再把所有体的最小值和最大值合并。这相当于求出“多实体组合体的总包围盒”对大多数毛坯计算场景是准确的。但如果多个实体之间有重叠的干涉部分这种方法不会自动把它们“合并成一个凸包”理论上会偏大一点。实际零件很少出现这种情况遇到了再单独处理就行。4.3 加工余量与收缩率参考表余量和收缩率不能拍脑袋给至少要对得上工厂的常用工艺。我把自己整理的一份参考值放出来仅供参考具体以各自车间的工艺卡片为准。加工余量方面常见单边余量参考如下加工类型单边余量mm适用场景粗铣、开粗1.5 ~ 3.0数控铣削前备料半精铣0.5 ~ 1.0粗加工后留半精余量精铣、磨削0.1 ~ 0.3最终精加工余量钻孔按孔径留量孔径大于30mm时毛坯可预铸或预钻材料收缩率方面常见材料参考如下材料类型收缩率灰铸铁0.7% ~ 1.0%球墨铸铁0.5% ~ 0.9%铸钢1.5% ~ 2.0%铝合金铸件0.8% ~ 1.3%锻件碳钢0.5% ~ 1.0%我在脚本里默认用的是0.5%收缩率、2mm单边余量这组参数适合大多数中小型钢制零件。如果是大件或者精密件强烈建议先和工艺工程师确认再修改脚本开头的参数不要直接套默认值。5. 常见问题与排查实录贴几个我实际踩过、且群里同行反复问过的问题整理成速查表故障现象可能原因解决办法执行脚本报“没有实体”打开了装配但没有激活工作部件或当前部件全是片体用CtrlW确认工作部件检查Body过滤条件输出的尺寸数值明显偏大英制部件没做单位换算或者片体参与计算加Part.Units判断严格过滤IsSolidBody局部实体数值为0AskBoundingBox返回了错误码被脚本continue跳过了打印错误码检查该体是不是被抑制或有问题中文print输出乱码NX内置Python控制台编码不匹配脚本开头重设stdout编码为GBK或UTF-8零件斜着放尺寸偏大包围盒随绝对坐标系走了虚大的矩形包络先摆正零件再计算或升级用投影轮廓方案有多个体但只算了一个遍历逻辑只取了Bodies[0]循环遍历所有SolidBody合并min/max挑两个典型问题展开说。一个典型问题是print中文乱码。NX在Windows上执行Python时内置解释器的stdout输出编码和NX的控制台窗口经常对不上打印中文要么报错要么乱码。我在这类脚本开头都会加一段import sys import io try: sys.stdout io.TextIOWrapper(sys.stdout.buffer, encodinggbk, errorsignore) except Exception: pass这段代码在部分NX版本上可能会因为sys.stdout.buffer不可用而抛异常所以用try包住不影响主流程。加上之后中英文输出基本都能正常显示。另一个典型问题是“算出来的结果和你手工测的差很多”。有一次我拿一个带大量圆角、倒角的铸件测试包围盒算出来是310x220x180但工艺老师傅手工量出来是305x215x178。原因很简单圆角处的外形不是直角包围盒按最大包络算自然比实际可贴合的加工尺寸大几个毫米。这个场景就属于我之前说的“包围盒虚大”。解决办法是评估一下虚大量对工厂备料的影响如果备料本身就要留安全余量这几个毫米根本无所谓如果是精密锻造模具设计那就必须走拓扑轮廓路线。6. 还没完异形轮廓、通孔盲孔怎么办6.1 包围盒的局限到底在哪拿一个最直观的例子一根直径50毫米、长200毫米的圆棒包围盒算出来会是多少200x50x50。这没问题因为圆棒的包围盒刚好是个方条和实际棒料占用的矩形空间一致买圆钢还是方钢都能对上。但如果是一个斜放45度的方块边长为100毫米包围盒算出来的X方向尺寸会变成约141毫米比实际大了41%。这种虚大在一些对尺寸敏感的场合是没法接受的。同理通孔和盲孔的问题也会在坯料计算里冒出来。铸造毛坯有一个经典原则直径比较小的通孔毛坯阶段不铸出来直接做实心后续全靠机加工钻直径足够大的通孔毛坯才需要预铸出孔来减少后续加工量。要不要在毛坯里铸出这个孔判断依据就是这个孔是通孔还是盲孔、孔多深、孔径多大。而这些判断没法靠包围盒解决必须遍历面、边、环的拓扑关系。6.2 下一篇预告拓扑与孔特征分析第二集我会重点拆解两块内容第一块如何从实体上提取面、边、环的拓扑数据用拓扑关系准确判断一个孔到底是通孔还是盲孔第二块如何基于面投影轮廓做更精确的最小包络尺寸计算把斜件、异形件的虚大问题解决掉。会用到UF_MODL_ask_face_data、边循环遍历这类接口也会讲清楚拓扑数据结构在NX里到底是怎么组织的。第一集先把包围盒这套基础功能用熟把环境、单位、余量这些基础设施打牢。后续所有高级功能都建立在这套代码框架之上。最后说点实在的。我在实际项目里用这套脚本跑了几个月的坯料计算最大的体会是脚本本身不复杂真正花时间的是把边界情况都想到。单位有没有转、片体有没有过滤、隐藏体要不要参与合体、余量是不是按工艺来这些才是决定脚本能不能被车间师傅接受的关键。建议拿到代码之后先找两三个自己熟悉的零件手工测量比对一遍确认结果符合预期再批量使用。等确认稳定了再把固定参数抽成界面输入或者做成菜单按钮真正变成自己手里的趁手工具。