测量圆
本工具用于测量一个或多个圆。
本工具可使用 easyTouch 和 easyTouch+。这意味着您可以在图像中以交互的方式选择要测量的圆，而相应的参数会自动调整。将鼠标指针移至要测量的圆的边缘上方。MERLIC将显示所建议的圆的预览。如果要测量预览的圆，请单击圆边缘以确认选择。参数会自动调整以拟合选定的圆。但是，您仍然可以在在相应的连接器中手动调整它们。
要将更多圆添加到测量中，可以使用 easyTouch+，即通过按 Ctrl 键并选择其他圆。MERLIC 将自动检查所选圆是否符合上一选择的当前参数设置。如果不符合，例如，因为鼠标悬停在具有相反边缘过渡的圆上，MERLIC 将在图像中立即给出反馈。在这种情况下，仍然可以将圆添加到测量中，但参数设置将相应调整。
或者您可以使用感兴趣区域 (ROI) 进行测量。在图像中绘制 ROI 或将 “ROI” 参数连接至前一工具的结果。如果 ROI 在符合当前参数设置的图像中取样圆形，则会自动确定和测量它。
参数
基本参数
图像：
此参数表示测量圆的输入图像。
如果在此工具中将彩色图像用作输入图像，仅第一个通道（即红色通道）将用于处理。
边缘对比度：
此参数定义了圆边缘相对于背景的对比度。它以灰度值为单位并默认设为 20。一旦选定某个要测量的圆，该圆的“边缘对比度”也就随即确定并被采用。如要使用 easyTouch+ 添加更多圆，则在将每个圆添加到选择中时，“边缘对比度”的值会自动调整。不过，您也可以在相应的连接器中手动更改该值。
边缘宽度：
此参数定义了圆边缘的宽度。它以像素为单位并默认设为 1 像素。一旦选定某个要测量的圆，该圆的“边缘宽度”也就随即确定并被采用。如要使用 easyTouch+ 添加更多圆，则在将每个圆添加到选择中时，“边缘宽度”的值会自动调整。不过，您也可以在相应的连接器中手动更改该值。
边缘变换：
该参数定义了圆边缘的转变属性。转变的确定顺序为由内到外。默认情况下，此参数设置为 “亮到暗”。一旦选定某个要测量的圆，该圆的“边缘变换”值也就随即确定。该值会针对添加的每一个圆进行自动调整。
|
值 |
描述 |
|---|---|
|
亮到暗 |
圆边缘由亮变暗，即，边缘的灰度值由大变小。 如果设置为该值，则测量对象仅限于具有这种转变属性的圆。其他圆将被排除在测量范围之外。 |
|
暗到亮 |
圆边缘由暗变亮，即，边缘的灰度值由小变大。 如果设置为该值，则测量对象仅限于具有这种转变属性的圆。其他圆将被排除在测量范围之外。 |
|
任意 |
圆边缘可以朝着任意方向转变，即，边缘的灰度值既可以由大变小，也可以由小变大。 如果设置为该值，则测量对象包括所有圆。 |
其他参数
ROI：
此参数定义需要处理的感兴趣区域 (ROI)。在默认情况下，ROI 定义为空。如果想要使用 ROI 进行处理，您必须将参数连接至前一工具的适当 ROI 结果，或者必须使用 ROI 按钮 
在图像中绘制新的 ROI。
如果定义的圆形 ROI 对应于符合当前参数设置的图像中的圆形，则会对其进行检查，例如，如果“边缘变换”设为“暗到亮”，工具会检查圆边是否从暗变亮。如果在 ROI 中找到合适的圆形，它们会用于测量。
标定数据:
此参数定义校正可能的镜头失真和相对于图像平面的相机位置所需的标定数据。默认情况下，不定义任何标定数据。如果想要使用标定数据，您必须将参数连接至前一工具的适当结果（例如，标定相机），以确保标定数据会传输到此工具。它会立即应用到图像。
如果此工具使用了“标定数据”，则表示像素值的所有结果都将自动转换为对应的现实坐标。
对齐数据:
此参数表示用于对齐 ROI 的对齐数据。默认情况下不会连接对齐数据，因此不显示任何效果。如果想要使用特定对齐数据，您必须将参数连接至前一工具的适当结果，例如通过匹配确定对齐、确定与直线边缘对齐、对齐图像或旋转图像。
半径容差：
此参数定义单个圆段的允许半径的容差值。它也可以作为要测量的圆的圆度指示符。当鼠标移到圆段的边缘上时，MERLIC 搜索能将单独的段拟合到圆的更多圆段。“半径容差”定义这些圆段的半径可在多大程度上不同于使用鼠标选定的圆段的容差值。因此，如果您要使用高形状质量（即，高圆度）测量圆，我们建议您设置低“半径容差”，反之亦然。
参数以像素为单位，默认情况下设为 10 像素。这意味着，单个圆段与选定圆边的半径最多可以相差 10 像素。对于不满足此条件的圆，easyTouch 的预览将不提供建议。
最小边缘完整性：
|
显示 |
描述 |
|---|---|
|
|
此参数定义了必须由沿 ROI (3) 检测的轮廓 (2) 支持的圆形 (1) 的最小分数。如果检测的轮廓占圆周的比例小于 “最小边缘完整性”，MERLIC 将不会创建圆形。在这种情况下，轮廓和圆形都不会显示。将沿 ROI 的整个边缘检测用于确定 “最小边缘完整性” 的轮廓，并且如左边图像所示，轮廓可能还会包括不需要的轮廓段。 “最小边缘完整性”被定义为介于 0 和 1 之间的值，并可以被解读为一个介于0至100%的百分比值。默认情况下设置为 0.5。但是，如果选择边缘，此值将由 easyTouch 自动确定。不过，如果您仅要使用具有特定“最小边缘完整性”圆，您也可以手动调整参数值。 |
测量失败：
此参数定义了无法进行测量时结果“半径”、“X 轴”、“Y 轴”、“边缘完整性”和“形状质量”返回的值。默认情况下，此参数设置为 “忽略”。 您可以在相应连接器中将参数设置为下列值。
|
值 |
描述 |
|---|---|
|
忽略 |
如果无法进行测量，将不返回任何值。 |
|
-1 |
如果无法进行测量，将返回 -1。 您可以直接在连接器的输入字段中输入任何想要返回的数字或字符串来代替它。 |
|
* |
如果无法进行测量，将返回 *。您可以直接在连接器的输入字段中输入任何想要返回的数字或字符串来代替它。 |
结果
基本结果
圆形：
此结果返回已测量圆的图形表示。返回结果为一个圆 ROI。如果测量对象不止一个圆，则“圆形”包含所有圆的 ROI。
半径：
此结果返回已测量圆的半径。返回的结果为实数，单位为像素。如果测量对象不止一个圆，则将以元组形式返回相应的半径。
形状质量：
此结果返回圆的s形状的比例。以介于 0 和 1 之间的实数返回百分比值。值越高，表示已测量圆的形状越接近圆形。“形状质量”的值为 1 表示该圆呈完美的圆形。如果测量对象不止一个圆，则将以元组形式返回相应的“形状质量”值。
工具状态：
“工具状态”返回有关工具状态的信息，因此可用于处理错误。请参阅主题工具状态结果，了解关于不同工具状态结果的更多信息。
其他结果
X 轴：
此结果返回所测量的圆的中心点在 X 轴 方向的位置。它以像素坐标返回结果。如果使用了“标定数据”，位置会以现实坐标返回。如果测量对象不止一个圆，则将以元组形式返回相应的 X 坐标。
Y 轴：
此结果返回所测量的圆的中心点在 Y 轴 方向的位置。它以像素坐标返回结果。如果使用了“标定数据”，位置会以现实坐标返回。如果测量对象不止一个圆，则将以元组形式返回相应的 Y 坐标。
边缘完整性：
此结果包含已测量圆的实际“边缘完整性”。以介于 0 和 1 之间的实数返回百分比值。它用于指示圆形边缘中有多少轮廓点可用于测量。如果测量对象不止一个圆，则将以元组形式返回相应的“边缘完整性”值。
已使用边缘：
此结果返回测量过程所使用的棱边轮廓。“已使用边缘”中返回的轮廓可能根据图像的实际边缘有所不同，尤其是在 ROI 极小时。
处理时间:
此结果返回最近一次执行工具的持续时间（以毫秒为单位）。该结果作为附加结果提供。因此，默认情况下它是隐藏的，但是可以通过工具结果旁边的 
按钮显示。有关更多信息，处理时间请参工具参考中所阅部分。
应用程序示例
此工具用于以下 MERLIC Vision App 示例：
- adapt_brightness_for_measuring.mvapp
- determine_circle_quality.mvapp
- measure_distance_segment_circle_calibrated.mvapp
