本文旨在提供一种在 CadQuery 或 build123d 环境中检测 CAD 模型中圆角或倒角边缘的方法。通过利用 Open CASCADE Technology (OCP) 的底层几何查询功能，特别是 `BRep_Tool.Curve_s` 方法，我们可以识别出具有特定几何类型（如 `Geom_TrimmedCurve`）的边缘，从而有效区分和提取模型中的圆角特征。
在处理 CAD 模型时，除了获取基本的几何信息（如边、面数量、包围盒尺寸、体积等）之外，识别特定特征（例如圆角或倒角）对于模型分析和后续处理至关重要。CadQuery 和 build123d 作为基于 Open CASCADE Technology (OCP) 的强大 Python CAD 库，虽然在模型创建方面提供了丰富的 API，但在现有模型的特征识别方面，其高级接口可能不如创建接口直观。
本教程将介绍一种利用 OCP 底层功能来检测模型中圆角边缘的有效方法。
核心原理
CadQuery 和 build123d 构建在 Open CASCADE Technology (OCP) 之上。这意味着，尽管它们的 Pythonic API 抽象了许多底层细节，我们仍然可以通过访问其 wrapped 属性来获取 OCP 对象。OCP 提供了 BRep_Tool 类，这是一个用于查询 BRep（边界表示）拓扑元素几何信息的工具。通过 BRep_Tool.Curve_s 方法，我们可以获取构成边缘的底层曲线的几何类型。
圆角和倒角在 OCP 中通常由特定的几何曲线类型表示。例如，圆角（fillet）的曲线段常常是 Geom_TrimmedCurve 的实例，它表示一条被修剪过的曲线（如圆弧）。通过检查边缘底层曲线的 DynamicType().Name()，我们可以识别出这些特征。
实现步骤
以下是检测圆角边缘的具体实现步骤：
- 导入必要的库： 我们需要 build123d 用于模型操作，ocp_vscode 用于可视化（可选），以及 OCP.BRep 用于访问底层 BRep 工具。
- 加载或创建模型： 可以从 STEP 文件导入现有模型，或者像示例中那样，创建一个带有圆角的测试模型。
- 遍历模型边缘： 迭代模型中的所有边缘。
- 查询边缘几何类型： 对于每个边缘，使用 BRep_Tool.Curve_s() 方法获取其底层曲线的 OCP 对象，然后通过 DynamicType().Name() 获取其几何类型名称。
- 识别圆角： 根据几何类型名称进行判断。如果类型是 "Geom_TrimmedCurve"，则该边缘很可能是一个圆角。
示例代码
from build123d import *
from ocp_vscode import *
from OCP.BRep import BRep_Tool
# 1. 创建一个带有圆角的测试模型
# 这是一个1x1x1的立方体，并在顶部的一个面上进行圆角操作
b = Box(1, 1, 1)
b = fillet(b.edges().group_by(Axis.Z)[-1], 0.2) # 在Z轴正方向的面上的所有边进行圆角
# 上述代码等效于从STEP文件导入模型，例如：
# b = import_step("some_step_file.step")
# 2. 初始化一个列表来存储检测到的圆角边缘
fillets = []
# 3. 遍历模型中的所有边缘
for edge in b.edges():
# 4. 查询边缘的底层几何类型
# edge.wrapped 访问底层的OCP对象
# 0.0, 1.0 是曲线的参数范围
curve_handle = BRep_Tool.Curve_s(edge.wrapped, 0.0, 1.0)
type_name = curve_handle.DynamicType().Name()
# 5. 根据几何类型名称识别圆角
if type_name == "Geom_TrimmedCurve":
fillets.append(edge)
# 6. 可视化原始模型和检测到的圆角边缘
# show(b, fillets) # 如果使用ocp_vscode，可以取消注释此行进行可视化
print(f"检测到 {len(fillets)} 个圆角边缘。")注意事项与扩展
- Geom_TrimmedCurve 的含义： Geom_TrimmedCurve 表示一条被修剪过的曲线。虽然它通常用于表示圆角和倒角，但并非所有 Geom_TrimmedCurve 都一定是圆角或倒角。它可能也用于表示其他复杂的几何特征。在实际应用中，可能需要结合其他几何信息（如曲率、相邻面的角度等）来进一步精确判断。
- 倒角的检测： 倒角（chamfer）的几何表示可能有所不同。有时它们也可能由 Geom_TrimmedCurve 表示，但更多情况下可能涉及到 Geom_Line 或其他直线段。如果需要区分圆角和倒角，可能需要更复杂的逻辑，例如检查相邻面的几何关系或边缘的曲率。
- 性能考量： 对于包含大量边缘的复杂模型，遍历所有边缘并查询其底层几何类型可能会有一定性能开销。
- CadQuery 与 build123d： 示例中使用了 build123d，它是 CadQuery 的一个现代替代品，提供了更简洁和 Pythonic 的 API，但底层都依赖于 OCP。此方法同样适用于 CadQuery 对象，只需将 b.edges() 替换为 CadQuery 对象的相应边缘选择器即可。
- 更高级的特征识别： 对于更高级的特征识别（如孔、槽、凸台等），仅仅依靠边缘的几何类型是不够的。通常需要结合拓扑分析、特征识别算法或机器学习方法。
总结
通过直接访问 Open CASCADE Technology 的底层几何查询功能，我们可以在 CadQuery 或 build123d 环境中有效地检测和识别模型中的圆角边缘。这种方法提供了一种强大的工具，能够深入分析现有 CAD 模型的几何特性，为后续的特征提取、质量检查或自动化处理奠定基础。
