Histogram Statistics vTool#
You can use the Histogram Extractor vTool to extract brightness values from an image and use those integer arrays as input.
The vTool outputs the following statistical data:
- 最小值
- 最大值
- Mean
- Median
- StandardDeviation
- PixelCount
If you want to remove brightness values from the top and bottom of the distribution, e.g., because extremely high or low values may be caused by hot or dark pixels, you can do this via the following API parameters:
- Bottom Percentile: This allows you to specify which percentage of brightness values you want to remove from the bottom of the distribution. The default is 0.02, which means that values smaller than 2 percent of all values are removed.
- Top Percentile: This allows you to specify which percentage of brightness values you want to remove from the top of the distribution. The default is 0.02, which means that values higher than 98 percent of all values are removed.
- Discard: Enable this parameter to remove the top and bottom percentiles from the distribution before evaluation.
配置 vTool#
To configure the Histogram Statistics vTool:
- In the Features - All pane, open the vTool category.
- Specify desired value for the Top Percentile parameter.
- Specify desired value for the Bottom Percentile parameter.
- Select the Discard check box to remove the specified percentiles.
输入#
HistogramData#
Accepts integer arrays from the Histogram Extractor vTool.
- 数据类型：图像
输出#
最小值#
Returns the lowest index position of the input array, i.e., brightness value, of the histogram.
- 数据类型：浮点数
最大值#
Returns the highest index position of the input array, i.e., brightness value, of the histogram.
- 数据类型：浮点数
Mean#
Returns the mean value of the histogram.
- 数据类型：浮点数
Median#
Returns the median value of the histogram.
- 数据类型：整数
StandardDeviation#
Returns the standard deviation of the histogram.
- 数据类型：浮点数
PixelCount#
Returns the overall number of pixels that contributed to the histogram.
- 数据类型：整数