UC3DStudio 宽度测量与点位置检测

本文介绍 UC3DStudio 桌面软件中的宽度测量与点位置检测工具。
数据来源：《UC3DStudio 用户说明书》V1.38 §8.2「测量工具 - 宽度 / 位置检测」。

宽度测量的三种检测方式

配置面板的「检测方式」下拉：

外轮廓 / 开口检测可设 弧形容差（0.1~10mm，默认 1.0）：z 偏离参考面超过该值判为非实体。调大 → 弧端计入实体（宽度最大）；调小 → 外缘退回主平面。
三种方式均带调参可视化叠加层：点到点画左右检测区带 + 候选 / 选中点；外轮廓 / 开口检测画实体掩码带（蓝 = 实体 / 灰 = 非实体）、参考面 z 中位线 + ±容差带、开口区间竖带（编号 #1 #2 …，生效那个转红标「生效」）、边缘点与宽度标尺；顶部概要给出点数 / 间隙阈 / z 中位 / MAD / 生效容差 / 实体点数 / 开口数与生效编号 / 预览宽。

峰值 / 谷值 / 边缘 / 手动 / 左边缘 / 右边缘 / 最左点 / 平均点 / 最右点 / 拐点（WidthInflection）。

边缘点源（第 N 个交点）：轮廓与参考线可能相交多次，由两个参数决定取哪一个：

配置面板在选中边缘点源后会显示实测提示「当前轮廓与参考线共 N 个交点」，参考线在图区以浅灰蓝长划虚线绘制。

提取轮廓斜率突变点，配合 灵敏度 / 形状（山形·谷形·两者）/ 计算点数 / 检测标签 参数定位特定拐点。

参数	取值	说明
去趋势	0（关闭）/ >2（点数，如 31 / 61）	先做 median3→5 平滑，再用边缘感知滑动均值去除轮廓整体倾斜（母材倾斜、大弧度背景），仅用于斜率计算，候选拐点仍取真实 Z。窗口需远大于被测特征宽度（否则特征自身被削弱）
弯折阈值	0（关闭，用相对阈值）/ >0（绝对阈值，mm⁻¹）	开启后拐点判定改用绝对弯折量阈值，不再随每帧最大弯折量自适应

为什么需要绝对阈值：默认模式下阈值 = 判定强度% × 本帧最大弯折量，帧间噪声会让阈值与锚点逐帧漂移（典型症状：焊瘤 / 焊缝轮廓上左右基部点逐帧跳动，偶发整点丢失）。开启绝对阈值（配合去趋势）后阈值固定，跨帧稳定。

推荐参数（焊缝焊瘤）：去趋势 61、弯折阈值 0.6 mm⁻¹、形状谷形、计算点数 16。若特征坡度很缓（弯折量 ≈0.5 mm⁻¹）导致漏检，可把阈值降到 0.5。

适用位置：宽度点到点左 / 右点源、段差点源上 / 下、位置检测拐点区，三处参数各自独立、互不影响；均随项目文件持久化。

点位置检测复用宽度测量的点源提取算法，在检测区内提取一个特征点并输出该点 X / Z 坐标；视图用黄色十字虚线标注。

点源	语义
峰值 / 谷值	范围内 z 最大 / 最小点
平均点	全范围均值中心
拐点	斜率变化最大处
边缘	用户输入参考线与轮廓的交点（多次相交时按交点序号 + 编号方向选取）
最左 / 最右点	x 极值

位置检测常与 ROI 定位关联（跟随） 配合：把跟随源设为位置检测的 位置X / 位置Z，ROI 即随工件位置移动，后续测量项无需重调。详见「多 ROI 管理与定位关联」一篇。

选中检测项进入配置面板时，中央视图自动绘制：关联 ROI 范围（浅黄竖带）、候选点、最终选中点、边缘参考线与全部交点编号、拐点灵敏度轮廓 + 判定阈值；面板实时回显「实测交点 N 个，当前取 #k」与计算点数等效物理宽度，调参不再盲调。