名称
measure_thresh - 沿矩形或环形弧提取具有特定灰度值的点。
用法
measure_thresh(Image : : MeasureHandle, Sigma, Threshold, Select : RowThresh, ColumnThresh, Distance)
描述
measure_thresh提取一维灰度值分布图内的灰度值等于指定的阈值Threshold的点。 将灰度值轮廓投影到与参数MeasureHandle一起传递的度量矩形的长轴上，因此在灰度值轮廓内计算的阈值点对应于确定图像坐标上的矩形长轴。算子结果RowThresh和ColumnThresh返回这些坐标。
如果灰度值轮廓与阈值线相交数次，则参数Select将确定要返回哪些值。 可能的设置是“first”，“last”，“first_last”（第一个和最后一个）或“all”。 对于最后两种情况，Distance中返回计算点之间的距离。
通过平均所有线段的灰度值来创建灰度值轮廓，所述线段由度量矩形定义如下：
1.分段垂直于矩形的长轴，
2.它们有一个到矩形中心的整数距离，
3.线段限定在矩形内。
对于每一个线段，计算与长轴具有整数距离的所有点的灰度值的平均值。 由于测量矩形相对于图像坐标存在平移和旋转，输入图像Image通常在亚像素位置被采样。
由于这涉及可以在多个投影中重复使用的一些计算，所以使用算子gen_measure_rectangle2预先执行一次这些计算。 在这里，测量对象MeasureHandle被生成，并且可以选择不同的插值方案。
注意
只有边缘是直的并垂直于矩形或弧的长轴，measure_thresh返回的结果才有意义。 因此它不应该用于从曲面对象中提取边缘。 此外用户应确保矩形或弧线尽可能接近垂直于图像中的边缘。 此外，西格玛不能大于约0.5 * Length1（对于Lenth1请参见gen_measure_rectangle2）。
应该记住，为了效率的原因，measure_thresh会忽略Image的ROI域。 如果图像中的特定区域应该从measurement中排除，则应该生成具有适当修改的参数的新measure对象。
并行
● 多线程类型：可重入（与非独占算子并行运行）。
● 多线程范围：全局（可以从任何线程调用）。
● 不并行处理。
参数
Image (input_object) 单通道图像 → object (byte / uint2 / real)
输入图像。
MeasureHandle (input_control) measure_id → (integer)
Measure对象句柄。
Sigma (input_control) number → (real)
高斯模糊Sigma。
Default value: 1.0
Suggested values: 0.0, 0.4, 0.6, 0.8, 1.0, 1.5, 2.0, 3.0, 4.0, 5.0, 7.0, 10.0
Typical range of values: 0.4 ≤ Sigma ≤ 100 (lin)
Minimum increment: 0.01
Recommended increment: 0.1
Restriction: Sigma >= 0.0
Threshold (input_control) number → (real)
阈值。
Default value: 128.0
Typical range of values: 0 ≤ Threshold ≤ 255 (lin)
Minimum increment: 0.5
Recommended increment: 1
Select (input_control) string → (string)
要选择的点。
Default value: 'all'
List of values: 'all', 'first', 'first_last', 'last'
RowThresh (output_control) point.y-array → (real)
具有阈值的点的Row坐标。
ColumnThresh (output_control) point.x-array → (real)
具有阈值的点的Column坐标。
Distance (output_control) real-array → (real)
连续点之间的距离。
结果
如果参数值正确，则算子measure_thresh返回值2（H_MSG_TRUE）。 否则，会引发异常。
Possible Predecessors
gen_measure_rectangle2
Possible Successors
close_measure
Alternatives
measure_pos, edges_sub_pix, measure_pairs
模块
1D Metrology