## 1. 从手动到智能：为什么我们需要自动化边识别与倒角 如果你用过Siemens NX（或者大家常说的UG）做机械设计，尤其是处理一些结构件、模具或者零件，那你肯定对“倒角”这个操作不陌生。不管是倒圆角（Blend）还是倒斜角（Chamfer），几乎每个零件上都有那么几条边需要处理。我刚开始用NX的时候，也是老老实实用鼠标一条边一条边地去选，然后输入参数。做一个简单的方块，把四条竖直的棱边倒圆角，再把上下两个面的外轮廓倒斜角，这套操作下来，怎么也得花个一两分钟。 这听起来好像没什么，但如果你面对的不是一个方块，而是一个有几十个甚至上百个特征的中等复杂零件呢？或者，更常见的情况是，你有一系列结构相似、只是尺寸不同的零件族需要处理。这时候，重复的手工操作不仅枯燥、容易出错，更重要的是极大地浪费了宝贵的工程时间。我曾经参与过一个项目，需要为一系列不同尺寸的安装板生成加工模型，每块板都需要在特定的安装边和顶面边缘进行倒角。手动做了三五个之后，我就开始琢磨：能不能让NX自己识别出这些边，然后自动完成倒角？ 这就是我们今天要聊的 **Siemens NX二次开发**，更具体地说，是使用 **Python UF（User Function）API** 来实现智能边识别与倒角特征自动化处理。UF API是NX提供给开发者的一套底层、功能强大的函数库，用Python调用它，你几乎可以操控NX里的一切。我们的目标很简单：写一段脚本，让它能自动分析一个三维实体，找出所有“平行于Z轴的竖直边”并给它们倒圆角，再找出所有“垂直于Z轴的平面”的外边线并给它们倒斜角。整个过程完全自动，你只需要点一下运行，或者甚至把它集成到你的设计流程中，让它在模型更新后自动执行。 这不仅仅是省了几次点击，它代表了一种工作模式的转变——从交互式设计转向参数化、规则驱动的自动化设计。对于需要处理大量相似零件的工程师、对于希望固化企业设计规范（比如特定类型的边必须用特定尺寸的倒角）的团队来说，这种自动化能力价值巨大。接下来，我就带你一步步拆解这个需求，看看如何用Python UF把它变成现实。 ## 2. 环境准备与UF API初探 ### 2.1 搭建你的Python UF开发环境 工欲善其事，必先利其器。在开始写代码之前，我们得先把环境准备好。NX的二次开发主要有两种模式：**内部模式（Internal Mode）** 和 **外部模式（External Mode）**。内部模式是指脚本在NX软件内部运行，就像运行一个宏（Journal）一样，可以直接操作当前打开的会话。外部模式则是在NX软件外部，通过命令行调用一个独立的解释器来执行脚本，适合做批量处理或者集成到其他系统中。 对于初学者，我强烈建议从**内部模式**开始，因为调试和查看结果非常直观。设置起来也很简单： 1. **确保NX安装正确**：你的电脑上需要安装有Siemens NX（NX 12.0, 1847系列，乃至更新的版本都支持）。安装时，通常Python UF的开发组件是默认安装的。 2. **找到Python解释器**：NX自带了一个Python环境。你可以在NX的安装目录下找到它，例如 `D:\Siemens\NX 12.0\PYTHON`。你可以直接使用这个Python，也可以配置你自己熟悉的IDE（如PyCharm）来使用这个解释器，关键是要能访问到NX的Python模块。 3. **准备代码编辑器**：任何一个文本编辑器都可以，但用VS Code或PyCharm这类IDE会更方便，因为有代码高亮和提示。在NX内部，你也可以直接使用“记事本”编辑器来创建和运行.py文件。 一个快速验证环境是否就绪的方法是，在NX内部的“文件”->“新建”中，创建一个“Python脚本”，然后输入最简单的导入语句并运行： ```python import NXOpen import NXOpen.UF as UF the_session = UF.UFSession.GetUFSession() print("UF Session获取成功！") ``` 如果这段代码能成功运行并且没有报错，那么恭喜你，你的Python UF环境已经准备好了。 ### 2.2 理解核心的Python UF函数 原始文章里列出了几个关键函数，我们得先弄明白它们是干什么的，怎么用。别被函数名吓到，我们一个一个来拆解。 * **`NXOpen.UF.Modeling.AskFaceData`**： 这是我们的“侦察兵”。你给它一个面的标签（Tag），它就能返回这个面的详细信息。返回值是一个元组，里面包含了面的类型（是平面、圆柱面还是球面？）、面上一个点的坐标、面的方向向量、边界信息等等。比如，元组的第一个元素（索引0）是个整数，22代表“有界平面”（Bounded Plane），16代表圆柱面。我们后面判断一个面是不是“垂直于Z轴的平面”，主要就靠分析这个函数返回的“面的方向向量”。 * **`NXOpen.UF.Modeling.CreateChamfer`**： 这是“倒斜角工兵”。你告诉它怎么倒（单向偏置还是双向偏置？）、偏置多少、角度多少，再给它一个边的列表，它就能唰唰唰地创建出倒斜角特征。参数`subtype`决定了倒角的形式，最常用的是`1`（单向偏置）和`3`（偏置和角度）。`offset1`, `offset2`, `theta`这些参数虽然是字符串类型，但里面放的是数字，比如`"2.0"`。 * **`NXOpen.UF.ModlFeatures.CreateBlend`**： 这是“倒圆角工兵”。用法更直接，主要参数就是圆角半径`radius`（也是字符串）和需要倒圆的边列表`edge_list`。其他几个`smooth_overflow`, `cliff_overflow`等参数控制圆角遇到特殊几何时的溢出行为，通常设为`1`（防止溢出）能获得更稳定的结果。 * **`NXOpen.UF.Obj.SetColor`**： 这是个“美容师”。干完活之后，我们可以用它给创建好的实体换个颜色，方便在图形界面中区分。比如，把自动处理完的实体设置成绿色，一眼就能看出来。 理解了这几个核心函数，我们自动化流程的“工具”就齐全了。接下来，就是设计一套“智能”的流程，让程序自己能找到该用这些工具加工哪些边。 ## 3. 智能边识别的核心算法：向量计算 自动化倒角的关键和难点，其实不在于“倒角”这个动作本身，而在于前期的“识别”——如何让程序像人眼一样，从一堆边和面中，精准地找出我们想要处理的那几条。这就需要一点简单的几何和向量知识了。 ### 3.1 如何判断一条边是否“平行于Z轴”？ 在我们的场景里，“平行于Z轴的竖直边”通常指的是一个长方体或类似结构在高度方向上的四条棱边。在三维空间里，一条边可以用一个向量来表示，这个向量由边的起点指向终点。 判断两条直线（向量）是否平行，在数学上可以看它们的**方向向量是否成比例**。在程序里，我们采用更实用的方法：**检查方向向量与Z轴方向向量（[0, 0, 1]）的夹角**。如果夹角为0度（或180度），则平行。 但是，由于计算机浮点数计算有精度问题，我们很少直接判断是否“等于0”，而是判断是否“接近0”。这就是代码中那些看起来有点复杂的 `math.fabs(...) <= 1e-6` 在做的事情。`1e-6`（即0.000001）是我们设定的一个非常小的容差范围。 具体到代码逻辑： 1. 首先，通过 `AskEdgeVerts` 函数获取一条边的两个端点坐标。 2. 用终点坐标减去起点坐标，得到这条边的方向向量 `[dx, dy, dz]`。 3. 判断：如果 `dx` 和 `dy` 的绝对值都几乎为0（小于1e-6），而 `dz` 不为0，那么这条边的方向就几乎是纯Z方向的，即平行于Z轴。 ```python # 示例代码片段：判断单条边是否平行于Z轴 def is_edge_parallel_to_z(uf_session, edge_tag): # 获取边的端点 edge_data = uf_session.Modeling.AskEdgeVerts(edge_tag) start_point = edge_data[0] # [x1, y1, z1] end_point = edge_data[1] # [x2, y2, z2] # 计算方向向量 dir_vec = [end_point[0] - start_point[0], end_point[1] - start_point[1], end_point[2] - start_point[2]] # 判断：dx和dy接近0，dz不为0 if (abs(dir_vec[0]) < 1e-6) and (abs(dir_vec[1]) < 1e-6) and (abs(dir_vec[2]) > 1e-6): return True else: return False ``` ### 3.2 如何判断一个面是否“垂直于Z轴”？ “垂直于Z轴的平面”通常指的是长方体顶面和底面这类水平面。一个平面的方向由其**法线向量**决定。所谓“垂直于Z轴”，其实就是平面的法线向量与Z轴平行。 所以，判断逻辑和判断边平行非常相似，只是对象从边的方向向量换成了面的法线向量： 1. 通过 `AskFaceData` 函数获取面的数据，其中索引为2的元素就是面的方向向量（对于平面来说就是法向量）。 2. 判断：如果法向量的 `x` 和 `y` 分量绝对值几乎为0，而 `z` 分量不为0，那么这个平面的法线就平行于Z轴，即平面本身垂直于Z轴。 这里还有一个前提：我们得先确保这个面是一个平面。`AskFaceData` 返回的元组第一个元素（类型）等于22时，就代表这是一个“有界平面”。 ```python # 示例代码片段：判断单个面是否为垂直于Z轴的平面 def is_face_perpendicular_to_z(uf_session, face_tag): # 获取面数据 face_data = uf_session.Modeling.AskFaceData(face_tag) face_type = face_data[0] face_normal = face_data[2] # 法线向量 [nx, ny, nz] # 先判断是否是平面 if face_type != 22: # 22 代表有界平面 return False # 再判断法线是否平行于Z轴 if (abs(face_normal[0]) < 1e-6) and (abs(face_normal[1]) < 1e-6) and (abs(face_normal[2]) > 1e-6): return True else: return False ``` 掌握了这两个核心的几何判断逻辑，我们的程序就拥有了“眼睛”。接下来，就是指挥它扫描整个实体，把符合条件的边和面都找出来。 ## 4. 构建完整的自动化处理流程 现在，我们把侦察兵（识别函数）和工兵（创建函数）组织起来，形成一个完整的作战流程。这个流程就像一条清晰的流水线，每一步都环环相扣。 ### 4.1 流程总览与步骤分解 整个自动化脚本的运行逻辑可以概括为以下七个步骤，我画了一个简单的流程图来帮你理解： 1. **初始化与模型准备**：启动UF会话，创建一个新的或打开一个已有的零件文件，并生成或获取一个待处理的三维实体（比如我们的示例长方体）。 2. **获取实体所有边**：通过 `AskBodyEdges` 函数，拿到这个实体上每一条边的唯一标识（Tag）。 3. **筛选平行于Z轴的边**：遍历每一条边，使用我们上一节写的 `is_edge_parallel_to_z` 函数进行判断，把符合条件的边的Tag收集到一个列表里。 4. **创建倒圆角特征**：将上一步收集到的边列表，连同圆角半径参数（如 `"20.0"`），传递给 `CreateBlend` 函数，批量创建圆角。此时模型发生了变化。 5. **获取新实体所有面**：圆角创建后，实体拓扑更新了。我们需要重新获取当前实体的所有面的Tag（使用 `AskBodyFaces`）。 6. **筛选垂直于Z轴的面并获取其外边线**：遍历每一个面，用 `is_face_perpendicular_to_z` 判断。对于每一个符合条件的面（比如顶面和底面），再用 `AskFaceEdges` 获取这个面所有的边（即它的外轮廓），将这些边的Tag收集起来。 7. **创建倒斜角特征并收尾**：将收集到的所有轮廓边列表，连同偏置、角度参数（如 `"2.0"`, `"45"`），传递给 `CreateChamfer` 函数，批量创建斜角。最后，可以选择给实体设置颜色并保存文件。 这个过程是顺序执行的，并且后一步依赖于前一步产生的结果（尤其是实体Tag）。在代码中，我们需要特别注意：在执行了创建特征的操作（如倒圆角）后，原来持有的实体Tag可能会失效，因为NX内部创建新特征后可能会生成新的实体。所以，示例代码中在倒圆角后，又通过 `AskFeatBody` 函数从最新的特征上重新查询了所属的实体Tag，这是一个非常重要的细节，能避免后续操作找不到对象的错误。 ### 4.2 关键代码段深度解析 让我们深入到原始文章提供的示例代码 `pyuf_chamfer_blend.py` 中，看看几个关键部分是如何实现的。 **第一部分：实体遍历与边识别** ```python # 获取实体上所有边tag block_body_edge_tag_list = get_solid_body_edge_tags(the_pyuf_session, block_body_tag) parallel_z_edge_tag_list = [] for item_edge in block_body_edge_tag_list: item_edge_point_info_list = get_solid_body_face_edge_points(the_pyuf_session, item_edge) item_edge_dir = [item_edge_point_info_list[3][0] - item_edge_point_info_list[4][0], item_edge_point_info_list[3][1] - item_edge_point_info_list[4][1], item_edge_point_info_list[3][2] - item_edge_point_info_list[4][2]] # 判断是否平行于Z轴 if math.fabs(item_edge_dir[0]) <= 1e-6 and math.fabs(item_edge_dir[1]) <= 1e-6 and item_edge_dir[2] != 0.000000: parallel_z_edge_tag_list.append(item_edge) ``` 这段代码就是“筛选平行于Z轴的边”的具体实现。它遍历实体每条边，计算方向向量，然后根据我们讨论的规则进行判断。`get_solid_body_face_edge_points` 是一个封装好的函数，内部调用了 `AskEdgeVerts` 来获取边的端点。 **第二部分：面识别与轮廓边提取** ```python vertical_z_face_tag_list = [] for item_face in block_body_face_tag_list: item_face_data_tuple = get_face_data(the_pyuf_session, item_face) if item_face_data_tuple[0] == 22: # 是平面类型 # 判断法线是否平行于Z轴 if math.fabs(math.fabs(item_face_data_tuple[2][0]) - 0.000000) <= 1e-6 and ... : vertical_z_face_tag_list.append(item_face) for item_face in vertical_z_face_tag_list: item_face_edge_tag_list = get_solid_body_face_edge_tags(the_pyuf_session, item_face) vertical_z_face_edge_chafmer_feature_tag = createChafmer(the_pyuf_session, 1, "2.000000", "2.000000", "45", item_face_edge_tag_list) ``` 这里先找出所有垂直于Z轴的平面，然后对**每一个**这样的平面，获取其所有边（即轮廓），并立即为这个面的轮廓创建倒斜角。注意，这里是在循环内为每个面单独创建倒角特征。对于顶面和底面，这会产生两个独立的倒斜角特征。你也可以选择先把所有面的轮廓边合并成一个大列表，然后一次性创建，但分开创建有时更清晰，也便于后续单独编辑或抑制某个特征。 ## 5. 实战进阶：让脚本更健壮、更通用 原始的示例脚本很好地演示了核心概念，但在实际项目中直接使用，可能会遇到一些问题。下面我分享几个根据自己踩坑经验总结的优化点，能让你的自动化脚本从“玩具”升级为“工具”。 ### 5.1 容错处理与异常捕获 机械模型千变万化，我们的脚本不能假设模型永远是完美的长方体。增加容错处理是必须的。 * **检查函数返回值**：几乎所有的UF函数都会返回一个状态码（0表示成功）。虽然示例中省略了，但在生产代码中，应该检查关键操作的返回值。 ```python blend_tag, status = uf_session.ModlFeatures.CreateBlend(...) if status != 0: print(f"创建倒圆角失败，错误码：{status}") # 可以选择记录日志、跳过或终止脚本 ``` * **使用Try-Except捕获异常**：网络问题、权限问题、模型异常等都可能导致程序崩溃。用try-except块包裹主要逻辑，可以保证脚本即使部分失败，也能给出友好提示并安全退出，而不是让NX直接卡死。 ```python try: # 你的主要自动化逻辑 auto_chamfer_and_blend(part_path) except Exception as e: print(f"脚本执行过程中发生错误：{e}") # 尝试保存当前工作或执行清理操作 finally: # 确保资源被释放，例如关闭不再需要的会话 pass ``` ### 5.2 扩展识别规则：应对复杂几何 “平行/垂直于Z轴”只是最简单的规则。真实零件可能要求识别“与某个基准面成特定角度的边”，或者“直径在某个范围内的圆柱面的边”。 * **基于角度阈值的识别**：我们可以计算边向量（或面法向）与目标方向（不一定是Z轴）的夹角。公式是点积除以模长。然后判断这个夹角的余弦值是否接近1（平行）或接近0（垂直）。 ```python import math def angle_between_vectors(v1, v2): # 计算v1和v2的夹角（弧度） dot_product = v1[0]*v2[0] + v1[1]*v2[1] + v1[2]*v2[2] norm1 = math.sqrt(v1[0]**2 + v1[1]**2 + v1[2]**2) norm2 = math.sqrt(v2[0]**2 + v2[1]**2 + v2[2]**2) cos_angle = dot_product / (norm1 * norm2) # 处理浮点精度问题 cos_angle = max(-1.0, min(1.0, cos_angle)) return math.acos(cos_angle) # 使用：判断边是否与向量[1,1,0]大致平行（夹角小于5度） target_dir = [1, 1, 0] angle_rad = angle_between_vectors(edge_dir, target_dir) if angle_rad < math.radians(5): # 符合条件 ``` * **结合特征属性**：有时光看几何不够。比如，我们想给所有“孔特征”的边倒角。这就需要先识别出“孔”特征（可能是通过特征类型，或通过面的属性），再获取这些特征相关的边。这涉及到更复杂的特征遍历和查询API（如 `UF.ModlFeatures.AskFeatureInfo`）。 ### 5.3 参数化与配置化设计 一个好的自动化脚本不应该把参数（如圆角半径“20.0”、斜角偏置“2.0”）硬编码在代码里。我们可以通过多种方式让它变得可配置： * **使用函数参数**：这是最简单的方式。把核心处理函数设计成接受参数的形式。 ```python def auto_process_edges(uf_session, body_tag, blend_radius="5.0", chamfer_offset="1.0", chamfer_angle="45"): # ... 使用传入的参数 ``` * **使用配置文件（如JSON/YAML）**：对于有多个参数或规则的项目，用一个单独的配置文件来管理是极好的。 ```json // config.json { "blend": { "radius": "20.0", "edge_filter": "parallel_to_z" }, "chamfer": { "offset": "2.0", "angle": "45", "face_filter": "perpendicular_to_z" } } ``` 然后在脚本中读取这个文件，动态加载配置。这样，非开发人员（比如设计师）也能通过修改配置文件来调整脚本行为，而无需触碰代码。 * **集成到NX表达式或属性**：更高级的做法是，让脚本从当前NX部件的表达式（Expression）或对象属性（Attribute）中读取参数。这样，参数可以直接在NX界面中修改，并与模型关联，实现完全参数化驱动。 把这些进阶技巧用上，你的自动化脚本就能从容应对更复杂的实际工程场景，真正成为提升效率的利器。记住，二次开发的最终目的不是炫技，而是解决实际工作中重复、繁琐的问题，让工程师能专注于更有创造性的设计工作。