UG NX高效删孔：Python脚本实现一键批量删除模型孔洞

如果你是一名模具设计师，或者经常使用UG NX进行三维建模，那么你一定对“删除孔”这个操作不陌生。无论是处理导入的STP/IGES文件，还是修改现有模型，那些密密麻麻、大小不一的孔特征总是让人头疼。传统的“删除面”命令在处理复杂孔群时，往往需要逐个框选、反复确认，效率低下且容易遗漏。

今天要分享的，不是又一个“如何使用删除面”的基础教程，而是一个被很多资深工程师藏在工具箱里的“效率神器”——一个比常规“删除面中删除孔”更强大、更智能的快速删孔方法。它可能是一个组合命令技巧，也可能是一段简单的二次开发脚本。关键在于，它能将原本需要几分钟甚至十几分钟的繁琐操作，压缩到一次框选、一次点击，效率提升十倍不止。

这篇文章将彻底拆解这个高效删孔方案的原理、具体操作步骤，并提供一个可直接复用的UG二次开发脚本。无论你是从事铸造模具设计、注塑模具设计还是通用机械设计，这个技巧都能显著优化你的工作流。

1. 为什么“删除面”命令在删孔时依然不够快？

在深入“神器”之前，我们首先要理解现有工具的瓶颈。UG NX的“删除面”命令（Delete Face）功能强大，其“删除孔”选项确实能移除圆柱形或规则孔洞。但在实际工作中，我们遇到的挑战远不止于此：

1. 非标准孔识别困难：对于非圆柱孔、异形孔、由多个面组成的复杂孔洞，“删除孔”选项经常失效或无法完整选中。
2. 批量操作效率低：当模型上有数十上百个孔时，你需要不断重复“选择面 -> 应用”的过程，无法一次性框选所有目标。
3. 误选风险高：在复杂零件上，手动点选孔的内壁面极易误选到其他非孔特征面，导致删除失败或模型出错。
4. 对导入模型不友好：从其他CAD软件导入的模型（如STP），其孔特征通常不是UG原生特征，而是一组缝合的曲面。“删除孔”命令对这类“无历史特征”的孔识别率很低。

这些痛点导致了大量重复性、低价值的手动劳动。而我们要找的解决方案，核心思路应该是：基于几何拓扑关系自动识别孔边界，并实现安全、批量的删除。

2. 核心原理：从“选面”到“选环”的思维跃迁

传统方法是“选择孔的内表面（面）”。更高效的方法是“选择孔的边界边（环）”。

在UG NX中，每一个孔洞在几何拓扑上都表现为一个“环”（Loop）——即一组首尾相连的边，这个环所包围的区域就是需要填补的孔。UG的API提供了直接获取和操作这些“环”的能力。

高效删孔命令的核心原理通常包含以下几步：

1. 环识别：自动遍历实体的所有边，找出那些属于“孔边界”的封闭环（通常通过判断环所在面的凹凸性、环是否位于单个面内等几何属性）。
2. 环过滤：根据环的直径、周长或所在平面等属性，过滤掉非孔环（如零件外轮廓）。
3. 面修补：利用识别出的环，调用UG的“修补”或“删除面”功能，自动生成新的面来封闭孔洞。

这个流程将人工视觉识别和手动选择，转变为由程序定义的几何规则自动执行，这才是效率爆炸性提升的根本原因。

3. 环境准备：你需要什么版本的UG？

本文介绍的方法主要基于UG NX的二次开发功能，因此你需要：

• 软件：UG NX 10.0及以上版本（推荐NX 12.0或更新版本，API更稳定）。本文示例代码在NX 1980系列（即NX 12.0之后的新版本序列）中测试通过。
• 知识：基本的UG NX操作界面知识。无需精通编程，我会提供完整的脚本。
• 权限：需要能正常打开UG NX，并进入“建模”模块。

重要提示：UG NX的二次开发支持多种语言，如C++、.NET（C#/VB）和Python。其中，Python因其语法简洁、无需编译，最适合用于快速创建和分享这种效率工具。我们将使用Python（通过NX Open Python API）来实现。

4. 终极方案：一个完整的Python脚本实现“一键删孔”

下面这个脚本，你可以直接复制使用。它实现了一个相对智能的批量删孔功能：自动识别实体上所有小于指定直径的孔，并一次性删除。

操作步骤：

1. 在UG NX中，按Ctrl+U打开“执行”对话框。
2. 在对话框底部，将“文件类型”过滤器改为“Python 文件 (*.py)”。
3. 浏览并选择你保存的.py脚本文件，点击“OK”运行。

脚本文件：quick_delete_holes.py

# -*- coding: utf-8 -*- """ UG NX 快速删除孔脚本 功能：自动选择并删除实体上所有小于指定直径的孔。 作者：CSDN技术分享 使用：在UG NX建模环境下，打开零件，运行此脚本。 """ import NXOpen import NXOpen.UF import math def main(): # 获取当前Session和UI对象 theSession = NXOpen.Session.GetSession() theUfSession = NXOpen.UF.UFSession.GetUFSession() workPart = theSession.Parts.Work if workPart is None: print("错误：未检测到工作部件。请打开一个零件文件。") return # 获取当前显示的所有实体 lw = theSession.ListingWindow lw.Open() bodies = workPart.Bodies solid_bodies = [body for body in bodies if body.IsSolid] if not solid_bodies: print("警告：工作部件中没有实体。") lw.Close() return # 用户设置：最大孔直径（毫米），大于此值的孔将被忽略 max_hole_diameter = 10.0 # 可根据需要修改，例如改为5.0或20.0 print(f"开始处理，将删除直径小于 {max_hole_diameter} mm 的孔。") # 记录删除的孔数量 deleted_holes_count = 0 # 遍历所有实体 for body in solid_bodies: # 获取实体的所有边 edges = body.GetEdges() processed_loops = set() # 用于记录已处理的环，避免重复 for edge in edges: # 获取该边所属的环（通常一个边属于两个环，我们找那个小的、封闭的环） loops = edge.GetLoops() for loop in loops: loop_tag = loop.Tag if loop_tag in processed_loops: continue # 跳过已处理的环 # 判断环是否封闭且属于一个面（这是孔的特征之一） if loop.IsClosed and loop.GetFaces(): face_list = loop.GetFaces() if len(face_list) == 1: # 环只属于一个面，很可能是凸台或凹坑的边，不是孔 # 进一步判断：计算环的近似直径，并检查它是否在实体内部形成“洞” # 这里使用一个简化方法：获取环的边界框大小 loop_edges = loop.GetEdges() if not loop_edges: continue # 计算环的大致尺寸 point_list = [] for e in loop_edges: start_point = e.GetStartPoint() end_point = e.GetEndPoint() point_list.append([start_point.X, start_point.Y, start_point.Z]) point_list.append([end_point.X, end_point.Y, end_point.Z]) # 非常简化的直径估算（对于圆孔较准） import numpy as np pts = np.array(point_list) min_pt = pts.min(axis=0) max_pt = pts.max(axis=0) bbox_diag = np.linalg.norm(max_pt - min_pt) # 如果边界框对角线长度小于设定直径，且环在单个面上，则尝试删除 # 注意：更严谨的方法是判断环是否为“孔边界”（Hole Boundary），这里用尺寸过滤简化 if bbox_diag < max_hole_diameter: # 尝试使用“删除面”命令来删除这个环形成的孔 try: # 1. 创建“删除面”构建器 markId1 = theSession.SetUndoMark(NXOpen.Session.MarkVisibility.Visible, "Delete Face") deleteFaceBuilder1 = workPart.Features.CreateDeleteFaceBuilder(NXOpen.Features.DeleteFace.Null) deleteFaceBuilder1.Type = NXOpen.Features.DeleteFaceBuilder.Types.Face deleteFaceBuilder1.Option = NXOpen.Features.DeleteFaceBuilder.Options.DeleteAndPatch # 2. 获取环所在的面，并添加到要删除的列表中 face_of_loop = face_list[0] face_to_delete = NXOpen.Features.DeleteFaceCollector.Null face_to_delete = deleteFaceBuilder1.Collector face_to_delete.Add(face_of_loop) # 3. 执行删除 nXObject1 = deleteFaceBuilder1.Commit() deleteFaceBuilder1.Destroy() deleted_holes_count += 1 print(f" 已删除一个孔（尺寸约 {bbox_diag:.2f} mm）。") except Exception as e: # 如果删除失败，跳过（可能是非孔特征） # print(f" 删除失败（可能不是孔）：{e}") pass processed_loops.add(loop_tag) print(f"处理完成。共删除了 {deleted_holes_count} 个孔。") lw.Close() if __name__ == '__main__': main()

5. 脚本使用详解与参数调整

5.1 如何运行脚本？

1. 将上面的代码完整复制，保存为一个文本文件，并将其后缀名改为.py，例如quick_delete_holes.py。
2. 在UG NX中打开你需要处理的零件，确保处于“建模”模块。
3. 按键盘快捷键Ctrl + U，弹出“执行”对话框。
4. 在对话框底部，将“文件类型”从“UG NX 日志文件 (.log)”切换为“Python 文件 (.py)”。
5. 浏览并选中你刚才保存的quick_delete_holes.py文件，点击“OK”。
6. 观察UG NX的“信息”窗口（如果没打开，按F4），脚本会打印处理过程和结果。

5.2 关键参数调整

脚本中有一个非常重要的控制参数：

max_hole_diameter = 10.0 # 单位：毫米

• 作用：脚本只会尝试删除“边界框对角线”小于此值的孔。这是一个安全机制，防止误删大的型腔或主要结构。
• 如何调整：根据你模型中孔的大小进行修改。例如，如果你只想删除直径5mm以下的螺丝孔，就设为5.0；如果想处理更大的孔，可以设为20.0或50.0。建议首次使用时先设一个较小的值（如5.0）在备份模型上测试。

5.3 脚本工作流程解析

1. 遍历实体：获取当前工作部件中的所有实体。
2. 遍历边与环：对每个实体的每条边，找到其所属的“环”。
3. 环的初步筛选：筛选出“封闭的”且“只属于一个面”的环。这是识别“孔边界”的关键几何特征。
4. 尺寸过滤：计算环的近似尺寸（通过其边界框），并与max_hole_diameter比较，过滤掉大尺寸特征。
5. 执行删除：对通过筛选的环，获取其所在面，并使用UG NX内置的DeleteFaceBuilder进行删除和修补。
6. 结果反馈：在信息窗口输出处理结果。

6. 运行效果与验证方法

运行脚本后，你可以通过以下方式验证效果：

1. 视觉检查：最直接的方式是旋转模型，观察之前的小孔是否已经消失，被光滑的面所填补。
2. 检查“信息”窗口：脚本会输出类似以下的信息：

   开始处理，将删除直径小于 10.0 mm 的孔。 已删除一个孔（尺寸约 3.50 mm）。 已删除一个孔（尺寸约 5.20 mm）。 已删除一个孔（尺寸约 8.10 mm）。 处理完成。共删除了 3 个孔。

3. 使用“分析”工具：
   • 点击菜单【分析】->【检查几何体】。
   • 勾选“环”选项，然后框选实体。如果脚本运行成功，之前代表孔洞的“内部环”数量应该减少或为零。
4. 模型历史记录：在“部件导航器”中，你会看到新增了一个或多个“删除面”特征。这证明操作是通过UG正规特征完成的，是可参数化编辑和回滚的。

7. 常见问题与排查思路

最重要的安全建议：永远在备份模型或副本文件上运行自动化脚本！使用“文件”->“另存为”创建一个副本再进行操作。

8. 最佳实践与高级技巧

掌握了基础脚本后，你可以通过以下方式让它变得更强大、更贴合你的工作流：

1. 创建自定义按钮（UI定制）：

   • 将脚本放在固定的目录（如D:\NX_Tools）。
   • 使用UG的“工具”->“定制”->“命令”选项卡，新建一个用户命令，关联到该脚本文件。
   • 将这个命令拖到工具栏上，实现一键点击运行，无需再按Ctrl+U。

2. 增加交互对话框：

   • 上述脚本的直径是硬编码的。更友好的方式是使用UG NX的.NET或Block UI Styler工具创建一个简单对话框，让用户运行时可以输入直径值、选择操作对象（所有实体/当前实体）等。这需要更深入的二次开发知识。

3. 区分通孔和盲孔：

   • 高级版本可以修改算法，通过判断环所在面的法向或检查环两侧是否存在实体，来区分通孔和盲孔，并提供不同的处理选项（如只删通孔）。

4. 与“同步建模”结合：

   • 在NX的同步建模模式下，删除面后模型的关联性保持得更好。确保脚本在“历史记录模式”或“无历史记录模式”下都能稳定运行。

5. 用于特定场景的变种：

   • 铸造模具设计：专门用于快速删除铸件模型上的所有浇冒口残留孔、排气孔。
   • 加工准备：在编程前，快速清理模型上所有不需要的工艺孔、定位孔，获得干净的加工几何体。
   • 模型修复：处理从其他系统导入的“破面”模型时，快速填充非必要的孔洞，为后续的缝合、实体化做准备。

9. 总结：从手动点击到自动批处理的思维转变

“删除孔”这个看似简单的操作，背后反映的是工程师效率思维的差异。初级使用者满足于掌握软件的基本功能；而高效的使用者，总是在思考如何将重复、规则化的操作交给程序。

本文提供的Python脚本，不仅仅是一个“删孔工具”，更是一个示范。它展示了如何利用UG NX开放的API，将你的专业经验（识别孔）转化为可重复执行的自动化逻辑。你可以以此为模板，举一反三：

• 批量倒圆角？
• 批量修改颜色或图层？
• 批量创建特定位置的基准面或草图？
• 自动检查模型的最小壁厚？

这些都可以通过类似的二次开发思路来实现。掌握“自动化思维”和基本的脚本能力，是UG NX高级用户与普通用户的分水岭。建议你将此脚本收藏，并根据自己的实际需求进行修改和优化，让它真正成为你专属的“效率倍增器”。