线线卡尺

## 线线卡尺

找到符合梯度响应值的边缘点，利用ransac拟合两条直线，并求出直线间的距离

## 参数配置说明

### 主界面参数
![](/media/202602/2026-02-11_110838_4011150.7547040388424769.png)
【**直线设置**】
    直线1：选择直线1的参数进行设置
    直线2：选择直线2的参数进行设置

【**梯度阈值**】边缘位置沿着扫描方向的灰度梯度，大于该阈值的点被保留。图像清晰、边缘明显时：设置较高的值（ >40)，图像模糊或边缘不明显时：设置较低值（10-30）
![](/media/202601/tidu_1769762616.png)
【**直线扫描方向**】从上到下或者从下到上扫描，由ROI上箭头指示。

【**直线极性**】
    由黑到白：沿矩形箭头，由低灰度区域指向高灰度区域。
    由白到黑：沿矩形箭头，由高灰度区域指向低灰度区域。
    全部：既可以检测由黑到白，也可以检测由白到黑。
![](/media/202601/jixing_1769766940.png)
【**拟合点选择**】
    全部点：使用所有检测到的边缘点。
    最强点：使用扫描方向上遇到的梯度值最大的边缘点。
    第一排点：使用扫描方向上遇到的第一个边缘点。
    最后一排点：使用扫描方向上遇到的最后一个边缘点。

![](/media/202602/拟合点选择_1770083578.png)
【**直线筛选**】
    最优拟合：综合考虑拟合最优的直线；
    最多拟合点：拟合的直线中，符合条件的拟合点的数量最多的直线；
    最强拟合：拟合的直线中，拟合点的梯度值最强的直线；
    第一条：沿着扫描方向拟合的第一条直线；
    最后一条：沿着扫描方向拟合的最后一条直线；
    指定ID条：沿着扫描方向，筛选出指定第ID条直线。

### 高级参数
![](/media/202602/2026-02-11_110939_0167280.24950672875106517.png)
筛选参数：
【**直线1和2同步修改**】当勾选时，修改任意一条直线的参数，另一条直线的参数也会同步修改

【**高斯滤波阈值**】高斯函数中的σ，此处可以理解为过渡区域像素宽度的一半。(值越大，噪点影响越小，但边缘也会变得模糊，值越小，保留更多细节，但噪点影响也越大)
![](/media/202602/滤波阈值_1770111631.png)
【**与ROI角度范围**】拟合直线时允许的直线偏移角度。如下图，将与ROI角度范围设置为16，直线角度-ROI角度  = 9，在16以内，直线符合

![](/media/202602/与ROI角度_1770110521.png)
【**采样点数**】对ROI扫描线垂直的方向均匀等分的数量

![](/media/202602/采样点数_1770016300.png)
【**采样点宽度**】按照采样点数均分的中心点，取采样点宽度，形成一个个小的矩形区域，在这些小的矩形区域中沿着扫描方向计算和判断，检查是否有符合条件的边缘点。

![](/media/202602/采样点宽度_1770017004.png)
【**拟合点数**】拟合直线中最少的拟合点数量，小于该值被认为拟合失败。如下图，拟合点数设置为5，白圈标示的总共6个
![](/media/202602/最少拟合点数_1770111223.png)
【**距离阈值**】边缘点到拟合直线垂直距离小于该值的点，会被用来拟合直线。如下图，检测到的边缘点与直线距离小于距离阈值，显示为蓝色，大于距离阈值，显示为红色。

![](/media/202602/距离阈值_1770630645.png)
【**最大迭代次数**】需要不断迭代的最大次数，如果提前拟合出了符合条件的直线，则可以提前停止拟合。

【**迭代无提升次数**】在拟合时，直线的拟合效果没有继续增强则停止迭代。

【**得分阈值**】最终判断直线的得分，得分小于该阈值时被认为拟合失败，范围是0-1。用所有边缘点到拟合直线的垂直距离求和，值越小，得分越高， 当所有的拟合点都在拟合的直线上时，得分是1。

距离参数：
【**标准值**】理论目标值
【**补偿值**】修正系统固定误差或工艺偏移的校准量
【**下偏差**】比标准值小的最大量
【**上偏差**】比标准值大的最大量
      公式：测量值+补偿值 = [标准值 + 下偏差, 标准值 + 上偏差]
【**尺寸转换**】
    不启用：不进行尺寸转换
    比例尺：手动输入一个数值，进行图像坐标到现实坐标的转换
    标定：连接一个标定数据，进行图像坐标到现实坐标的转换

### ROI设置
![](/media/202602/2026-02-11_112623_9470530.7222533323260001.png)
【**ROI来源**】手动ROI：可在窗口手动拖动ROI的位置及大小；引用ROI:可在端口连接外部ROI。

【**位置修正**】选择姿态修正后可连接坐标系使ROI区域跟随坐标系移动。

【**ROI个数**】选项有一个和两个ROI,如果选择一个，提取两条直线时，共用一个ROI,选择两个时，一个ROI对应一个直线提取

【**位置调整**】调整ROI的位置及大小。

## 输出说明
  运行结果：成功输出真，失败输出假。
  距离：检测到的两条直线的距离
  距离线段：检测到的两条直线的距离线段
  距离线段中点：检测到的两条直线的距离线段中点
  提取直线1：检测到的直线1
  提取直线2：检测到的直线2
  斜矩形ROI1：用来检测的ROI1
  斜矩形ROI2：用来检测的ROI2
![](/media/202602/2026-02-11_112930_7305930.737260548936928.png)

点击此处跳转到对应的中文说明书文章页:&nbsp;[Line-Line Caliper](/doc/428)