跳到主要内容

图像统计

用于计算直方图、纹理、清晰度和区域统计量。

图像质心​

CentroidImage · 可执行

计算图像像素强度的质心坐标。

签名​

Image centroid = CentroidImage(channel: 0);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回输入图像克隆;量测值s 输出 centroidX、centroidY、totalIntensity、channel、pixelCount。

行为​

  • 按 Σ(x×I)/ΣI 和 Σ(y×I)/ΣI 计算灰度加权质心。
  • 全黑图像的 totalIntensity=0,此时返回几何中心 ((width−1)/2, (height−1)/2)。
  • 图像数据不变;输入像素数上限为 1,048,576。

错误与限制​

  • VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像,或 channel 超出范围。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
  • VISION_CORE_RESULT_NON_FINITE:质心或总强度包含 NaN 或 Infinity。

示例​

计算通道 0 的像素强度质心。

Image centroid = CentroidImage(channel: 0);

彩色直方图​

ColorHistogram · 可执行

分别计算三个通道的一维直方图,并叠加绘制彩色可视化。

签名​

Image chist = ColorHistogram(bins: 32, channelA: 0, channelB: 1, channelC: 2);

输入​

inputImage
  • 输入
  • 必填
  • 约束 输入像素数不得超过 1,048,576。
8-bit 的 1、3 或 4 通道源图像;单通道输入会复用通道 0。

参数​

binsint
  • 输入
  • 可选
  • 默认 32
  • 约束 范围 2–256。
每通道直方图柱数。
channelAint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
第一通道索引。
channelBint
  • 输入
  • 可选
  • 默认 1
  • 约束 范围 1 至输入通道数-1。
第二通道索引。
channelCint
  • 输入
  • 可选
  • 默认 2
  • 约束 范围 2 至输入通道数-1。
第三通道索引。

返回值​

returnImage
返回 512×320 BGR8 三曲线可视化;量测值s 输出 peak、bins、channelA、channelB、channelC。

行为​

  • 对 channelA、channelB、channelC 分别调用一维 CalcHist,并把三条归一化曲线叠加绘制。
  • 单通道输入会复用通道 0;本算子不计算 bins³ 的联合直方图。
  • 输入像素数上限为 1,048,576。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:bins 或显式通道参数超出 参数合同 范围。
  • VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。

示例​

分别绘制 BGR 三通道的 32-bin 一维直方图。

Image chist = ColorHistogram(bins: 32, channelA: 0, channelB: 1, channelC: 2);

灰度共生矩阵​

Cooccurrence · 可执行

计算灰度共生矩阵 (GLCM), 用于纹理分析。

签名​

Image glcm = Cooccurrence(levels: 8, distance: 1, direction: "Horizontal", channel: 0);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

levelsint
  • 输入
  • 可选
  • 默认 16
  • 约束 范围 2–64。
灰度量化级数。
distanceint
  • 输入
  • 可选
  • 默认 1
  • 约束 范围 1–32。
像素对距离。
directionstring
  • 输入
  • 可选
  • 默认 Horizontal
  • 约束 可选值: Horizontal, Vertical, Diagonal45, Diagonal135。
方向。
channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回输入图像克隆;量测值s 输出 contrast、homogeneity、energy、levels、distance、channel、pixelCount。

行为​

  • 把指定通道量化到 levels 个灰度级,并按 direction 和 distance 累计有向像素对。
  • 从归一化 GLCM 计算 contrast、homogeneity 和 energy;不返回矩阵图像。
  • 输入像素数上限为 1,048,576。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ENUM:direction 不是 Horizontal、Vertical、Diagonal45 或 Diagonal135。
  • VISION_PIPELINE_PARAMETER_RANGE:levels、distance 或 channel 超出声明范围。
  • VISION_CORE_DEGENERATE_GEOMETRY:图像尺寸和方向/距离组合没有可统计的像素对。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。

示例​

计算水平方向、距离 1 的 8 级灰度共生矩阵。

Image glcm = Cooccurrence(levels: 8, distance: 1, direction: "Horizontal", channel: 0);

边缘密度​

EdgeDensity · 可执行

计算图像的边缘密度。

签名​

Image density = EdgeDensity(threshold: 50, apertureSize: 3);

输入​

inputImage
  • 输入
  • 必填
  • 约束 输入像素数不得超过 1,048,576。
8-bit 的 1、3 或 4 通道源图像;彩色输入在执行时转灰度。

参数​

thresholdint
  • 输入
  • 可选
  • 默认 50
  • 约束 范围 0–255。
Canny 边缘检测阈值。
apertureSizeint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 3–7, 必须为奇数。
Sobel 孔径大小。

返回值​

returnImage
返回输入图像克隆;量测值s 输出 edgeDensity、edgePixelCount、threshold、apertureSize、pixelCount。

行为​

  • 8-bit 的 1、3 或 4 通道输入先转灰度。
  • Canny 低阈值为 max(1, threshold/2),高阈值为 max(1, threshold)。
  • 图像数据不变;输入像素数上限为 1,048,576。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:threshold 不在 0–255,或 apertureSize 不是 3–7 的奇数。
  • VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。

示例​

计算 Canny 边缘密度。

Image density = EdgeDensity(threshold: 50, apertureSize: 3);

信息熵​

Entropy · 可执行

计算图像的信息熵,衡量图像纹理复杂度。

签名​

Image entropy = Entropy(channel: 0);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回输入图像克隆;量测值s 输出 entropyBits、occupiedBins、pixelCount。

行为​

  • 提取 channel 后按固定 256 个 bin 计算直方图。
  • 按 H = -Σ(p×log2(p)) 计算熵;图像数据不变。

错误与限制​

  • VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像,或 channel 超出范围。
  • VISION_CORE_RESULT_NON_FINITE:熵结果包含 NaN 或 Infinity。

示例​

计算通道 0 的信息熵。

Image entropy = Entropy(channel: 0);

聚焦度量​

FocusMetrics · 可执行

计算 Laplacian 方差、Tenengrad 均值和 Brenner 均值三种聚焦指标。

签名​

Image focus = FocusMetrics(maximumPixels: 2073600);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

maximumPixelsint
  • 输入
  • 可选
  • 默认 2073600
  • 约束 范围 1–16777216。
参与计算的最大像素数。

返回值​

returnImage
返回输入图像克隆;量测值s 输出 laplacianVariance、tenengradMean、brennerMean。

行为​

  • 输入先转为灰度,再分别计算 Laplacian、Scharr 和 Brenner 指标。
  • 输入宽度至少为 3;输入像素数不得超过 maximumPixels。
  • 图像数据不变,指标进入 量测值s。

错误与限制​

  • VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 maximumPixels。
  • VISION_CORE_DEGENERATE_GEOMETRY:输入宽度小于 Brenner 计算要求的 3 列。
  • VISION_CORE_RESULT_NON_FINITE:任一聚焦指标包含 NaN 或 Infinity。

示例​

计算图像清晰度,最大处理 1920x1080 像素。

Image focus = FocusMetrics(maximumPixels: 2073600);

梯度幅度​

GradientMagitude · 可执行

使用 Scharr 计算梯度幅值并输出单通道 8U 可视化;符号名保留历史拼写 GradientMagitude。

签名​

Image grad = GradientMagitude(channel: 0);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回同尺寸单通道 8U 梯度幅值图;量测值s 输出 rawMin、rawMax、responseMean8U、channel、pixelCount。

行为​

  • 对指定通道计算 Scharr X/Y 梯度和 sqrt(Gx²+Gy²)。
  • 32F 响应按本帧 rawMin/rawMax 线性投影为 8U;常量响应输出全零。
  • 输入像素数上限为 1,048,576。

错误与限制​

  • VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入类型或 channel 不受支持。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
  • VISION_CORE_RESULT_NON_FINITE:梯度响应包含 NaN 或 Infinity。

示例​

计算通道 0 的梯度幅度图。

Image grad = GradientMagitude(channel: 0);

直方图统计​

Histogram · 可执行

计算指定通道直方图并绘制 512×320 BGR8 折线图。

签名​

Image hist = Histogram(bins: 256, channel: 0);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

binsint
  • 输入
  • 可选
  • 默认 256
  • 约束 范围 2–1024。
直方图柱数。
channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
512×320 的 BGR8 直方图折线图;峰值计数和实际 bins 另写入 量测值s。

行为​

  • 对指定输入通道调用 视觉运行时 CalcHist,并把计数归一化到 300 像素高度后绘制折线。
  • 返回的是直方图可视化图像,不返回原始 bin 数组。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:bins 不在 2–1024,或 channel 超出输入通道范围。
  • VISION_PIPELINE_PARAMETER_TYPE:bins 或 channel 不是整数文本。

示例​

计算通道 0 的 256 级直方图。

Image hist = Histogram(bins: 256, channel: 0);

二维直方图​

Histogram2D · 可执行

计算两个通道的二维联合直方图并生成 512×320 Jet 色图。

签名​

Image h2d = Histogram2D(bins: 32, channelA: 0, channelB: 1);

输入​

inputImage
  • 输入
  • 必填
  • 约束 至少需要两个通道。输入像素数不得超过 1,048,576。
BGR8 或 BGRA8 多通道源图像。

参数​

binsint
  • 输入
  • 可选
  • 默认 16
  • 约束 范围 2–128。
每个维度的直方图 bin 数。
channelAint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
第一通道索引。
channelBint
  • 输入
  • 可选
  • 默认 1
  • 约束 范围 1 至输入通道数-1。
第二通道索引。

返回值​

returnImage
返回 512×320 BGR8 Jet 色图;量测值s 输出 peak、bins、channelA、channelB、totalPairs。

行为​

  • 在 channelA×channelB 上调用二维 CalcHist,将 bins×bins 响应归一化并应用 Jet 色表。
  • 执行器不要求两个通道互异,但输入必须至少有两个通道;实际支持 BGR8 或 BGRA8。
  • 输入像素数上限为 1,048,576。

错误与限制​

  • VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入少于两个通道、不是受支持的 8-bit 格式,或通道索引越界。
  • VISION_PIPELINE_PARAMETER_RANGE:bins 不在 2–128,或显式通道参数超出 参数合同 范围。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。

示例​

计算通道 0 和 1 的 32 级 2D 联合直方图。

Image h2d = Histogram2D(bins: 32, channelA: 0, channelB: 1);

峰度和偏度​

KurtosisSkewness · 可执行

计算图像像素值的峰度 (Kurtosis) 和偏度 (Skewness)。

签名​

Image ks = KurtosisSkewness(channel: 0);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回输入图像克隆;量测值s 输出 mean、variance、stdDev、skewness、kurtosis、channel、pixelCount。

行为​

  • 两遍扫描指定通道:第一遍求均值,第二遍求二至四阶中心矩。
  • 标准差≤1e-10 的常量图像将 skewness 和 kurtosis 置 0。
  • 图像数据不变;输入像素数上限为 1,048,576。

错误与限制​

  • VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像,或 channel 超出范围。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
  • VISION_CORE_RESULT_NON_FINITE:均值、方差、偏度或峰度包含 NaN 或 Infinity。

示例​

计算通道 0 的峰度和偏度。

Image ks = KurtosisSkewness(channel: 0);

局部最大值​

LocalMaximum · 可执行

计算局部窗口内像素值的最大值。

签名​

Image max = LocalMaximum(windowSize: 3, channel: 0);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

windowSizeint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–255, 必须为奇数。
局部窗口大小。
channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回同尺寸单通道 8U 局部最大值图;量测值s 输出 rawMin、rawMax、responseMean8U、windowSize、channel、pixelCount。

行为​

  • 以矩形结构元素和 Reflect101 边界执行一次 Dilate,得到局部最大值。
  • 只接受 8-bit 的 1、3 或 4 通道图像,且像素数上限为 1,048,576。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ODD:windowSize 不是奇数。
  • VISION_PIPELINE_PARAMETER_RELATION:windowSize 超过输入宽度或高度。
  • VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入类型或 channel 不受支持。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。

示例​

使用 3x3 窗口计算局部最大值。

Image max = LocalMaximum(windowSize: 3, channel: 0);

局部均值​

LocalMean · 可执行

计算局部均值并输出按本帧量程归一化的单通道 8U 显示图。

签名​

Image mean = LocalMean(windowSize: 3, channel: 0);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

windowSizeint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–255, 必须为奇数。
局部窗口大小。
channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回同尺寸单通道 8U 显示图;量测值s 输出 rawMin、rawMax、responseMean8U、windowSize、channel、pixelCount。

行为​

  • 以 Reflect101 边界调用归一化 BoxFilter 计算 64F 局部均值。
  • 64F 响应按本帧 rawMin/rawMax 投影为 8U;常量响应输出全零。
  • 只接受 8-bit 的 1、3 或 4 通道图像,且像素数上限为 1,048,576。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ODD:windowSize 不是奇数。
  • VISION_PIPELINE_PARAMETER_RELATION:windowSize 超过输入宽度或高度。
  • VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入类型或 channel 不受支持。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。

示例​

使用 3x3 窗口计算局部均值。

Image mean = LocalMean(windowSize: 3, channel: 0);

局部最小值​

LocalMinimum · 可执行

计算局部窗口内像素值的最小值。

签名​

Image min = LocalMinimum(windowSize: 3, channel: 0);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

windowSizeint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–255, 必须为奇数。
局部窗口大小。
channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回同尺寸单通道 8U 局部最小值图;量测值s 输出 rawMin、rawMax、responseMean8U、windowSize、channel、pixelCount。

行为​

  • 以矩形结构元素和 Reflect101 边界执行一次 Erode,得到局部最小值。
  • 只接受 8-bit 的 1、3 或 4 通道图像,且像素数上限为 1,048,576。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ODD:windowSize 不是奇数。
  • VISION_PIPELINE_PARAMETER_RELATION:windowSize 超过输入宽度或高度。
  • VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入类型或 channel 不受支持。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。

示例​

使用 3x3 窗口计算局部最小值。

Image min = LocalMinimum(windowSize: 3, channel: 0);

局部平方均值 (8U)​

LocalSquaredMean8U · 可执行

计算局部窗口内像素平方值的均值。

签名​

Image lsm = LocalSquaredMean8U(windowSize: 3, channel: 0);

输入​

inputImage
  • 输入
  • 必填
  • 约束 输入为 8U 类型。
8 位无符号整数源图像。

参数​

windowSizeint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–255, 必须为奇数。
局部窗口大小。
channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回同尺寸单通道 8U 显示图;量测值s 输出 rawMin、rawMax、responseMean8U、windowSize、channel、pixelCount。

行为​

  • 以 Reflect101 边界计算 windowSize×windowSize 邻域内像素平方值的均值。
  • 真实响应按本帧 rawMin/rawMax 线性投影为 0–255;常量响应输出全零。
  • 只接受 8-bit 的 1、3 或 4 通道图像,且像素数上限为 1,048,576。

错误与限制​

  • VISION_WAVEC_STATISTICS_INPUT_TYPE_UNSUPPORTED:输入类型或 channel 不受支持。
  • VISION_WAVEC_STATISTICS_INPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
  • VISION_WAVEC_STATISTICS_WINDOW_INVALID:windowSize 不是 1–255 的奇数,或超过输入宽高。
  • VISION_WAVEC_STATISTICS_RESULT_NON_FINITE:64F 或 8U 统计响应包含非有限值。

示例​

使用 3x3 窗口计算局部平方均值。

Image lsm = LocalSquaredMean8U(windowSize: 3, channel: 0);

局部标准差 (8U)​

LocalStdDev8U · 可执行

计算局部窗口内像素值的标准差。

签名​

Image stddev = LocalStdDev8U(windowSize: 3, channel: 0);

输入​

inputImage
  • 输入
  • 必填
  • 约束 输入为 8U 类型。
8 位无符号整数源图像。

参数​

windowSizeint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–255, 必须为奇数。
局部窗口大小。
channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回同尺寸单通道 8U 显示图;量测值s 输出 rawMin、rawMax、responseMean8U、windowSize、channel、pixelCount、negativeClampCount。

行为​

  • 先按 E[x²]−E[x]² 计算局部方差,再对非负方差开平方。
  • 绝对值不超过 1e-9 的负方差夹为 0;真实响应按本帧量程投影为 8U。
  • 只接受 8-bit 的 1、3 或 4 通道图像,且像素数上限为 1,048,576。

错误与限制​

  • VISION_WAVEC_STATISTICS_INPUT_TYPE_UNSUPPORTED:输入类型或 channel 不受支持。
  • VISION_WAVEC_STATISTICS_INPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
  • VISION_WAVEC_STATISTICS_WINDOW_INVALID:windowSize 不是 1–255 的奇数,或超过输入宽高。
  • VISION_WAVEC_STATISTICS_NEGATIVE_VARIANCE_EXCEEDED:负方差小于 -1e-9。
  • VISION_WAVEC_STATISTICS_RESULT_NON_FINITE:统计响应包含 NaN 或 Infinity。

示例​

使用 3x3 窗口计算局部标准差。

Image stddev = LocalStdDev8U(windowSize: 3, channel: 0);

局部方差 (8U)​

LocalVariance8U · 可执行

计算局部窗口内像素值的方差。

签名​

Image variance = LocalVariance8U(windowSize: 3, channel: 0);

输入​

inputImage
  • 输入
  • 必填
  • 约束 输入为 8U 类型。
8 位无符号整数源图像。

参数​

windowSizeint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–255, 必须为奇数。
局部窗口大小。
channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回同尺寸单通道 8U 显示图;量测值s 输出 rawMin、rawMax、responseMean8U、windowSize、channel、pixelCount、negativeClampCount。

行为​

  • 以 Reflect101 边界计算 E[x²]−E[x]²。
  • 绝对值不超过 1e-9 的负方差夹为 0;更大的负值 fail-closed。
  • 真实响应按本帧 rawMin/rawMax 投影为 8U;像素数上限为 1,048,576。

错误与限制​

  • VISION_WAVEC_STATISTICS_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像,或 channel 超出范围。
  • VISION_WAVEC_STATISTICS_INPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。
  • VISION_WAVEC_STATISTICS_WINDOW_INVALID:windowSize 不是 1–255 的奇数,或超过输入宽高。
  • VISION_WAVEC_STATISTICS_NEGATIVE_VARIANCE_EXCEEDED:负方差小于 -1e-9,不能归因于舍入误差。
  • VISION_WAVEC_STATISTICS_RESULT_NON_FINITE:统计响应包含 NaN 或 Infinity。

示例​

使用 3x3 窗口计算局部方差。

Image variance = LocalVariance8U(windowSize: 3, channel: 0);

中心块中位绝对偏差 (MAD)​

MadBlockMetric · 可执行

计算中心块像素相对该块中位数的平均绝对偏差。

签名​

Image mad = MadBlockMetric(blockSize: 8, channel: 0);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

blockSizeint
  • 输入
  • 可选
  • 默认 8
  • 约束 范围 1–64。
块大小。
channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回输入图像克隆;量测值s 输出 mad、meanMad、blockSize、channel、pixelCount。

行为​

  • 提取居中的 blockSize×blockSize 区域,排序求中位数,再计算平均绝对偏差。
  • 这是单图中心块统计,不比较两幅图像或相邻块。
  • blockSize 不得超过输入宽高;输入像素数上限为 1,048,576。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:blockSize 不在 1–64,或 channel 超出范围。
  • VISION_PIPELINE_PARAMETER_RELATION:blockSize 超过输入宽度或高度。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。

示例​

使用 8x8 块计算 MAD 度量。

Image mad = MadBlockMetric(blockSize: 8, channel: 0);

众数滤波​

MajorityFilter · 可执行

对图像执行众数滤波, 每个像素替换为局部窗口中出现次数最多的灰度值。

签名​

Image majority = MajorityFilter(windowSize: 3, channel: 0);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

windowSizeint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–15, 必须为奇数, 复杂度护栏上限 15。
局部窗口大小。
channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回同尺寸单通道 8U 众数滤波图;量测值s 输出 responseMean8U、windowSize、channel、pixelCount。

行为​

  • 逐像素统计裁剪到图像边界内的局部窗口 256 级直方图,并取计数最大的最小灰度值。
  • windowSize 上限 15 是 O(N×W²) 复杂度护栏;像素数上限为 1,048,576。
  • 出现并列众数时选择灰度值较小者。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ODD:windowSize 不是奇数。
  • VISION_PIPELINE_PARAMETER_RANGE:windowSize 不在 1–15,或 channel 超出范围。
  • VISION_PIPELINE_PARAMETER_RELATION:windowSize 超过输入宽度或高度。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。

示例​

使用 3x3 窗口执行众数滤波。

Image majority = MajorityFilter(windowSize: 3, channel: 0);

灰度中值模糊​

MedianBlurGray · 可执行

对灰度图像执行中值模糊滤波。

签名​

Image median = MedianBlurGray(kernelSize: 3, channel: 0);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

kernelSizeint
  • 输入
  • 可选
  • 默认 3
  • 约束 声明范围 1–255, 必须为奇数。当前可执行效果固定为 3×3;传入其他合法奇数不会改变结果。
参数合同 声明的中值核大小;当前执行器未读取该字段,实际固定使用隐式 windowSize=3。
channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回同尺寸单通道 8U 中值滤波图;量测值s 输出 rawMin、rawMax、responseMean8U、windowSize、channel、pixelCount。

行为​

  • 提取 channel 后调用 视觉运行时 MedianBlur。
  • 当前执行器的窗口校验读取未公开的 windowSize 并回落到 3,随后以 3 调用 MedianBlur;公开 kernelSize 目前不影响执行结果。
  • 输入像素数上限为 1,048,576。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ODD:参数合同 中的 kernelSize 不是奇数。
  • VISION_PIPELINE_PARAMETER_RANGE:kernelSize 不在 1–255,或 channel 超出范围。
  • VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。

示例​

使用 3x3 核执行中值滤波。

Image median = MedianBlurGray(kernelSize: 3, channel: 0);

百分位数​

Percentile · 可执行

计算图像指定百分位数的像素值。

签名​

Image pct = Percentile(percentile: 50, channel: 0);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

percentileint
  • 输入
  • 可选
  • 默认 50
  • 约束 范围 0–100。
百分位数 (0–100)。
channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回输入图像克隆;量测值s 输出 percentileValue、percentile、pixelCount、channel。

行为​

  • 读取指定通道的全部像素并执行升序排序,索引为 round((percentile/100)×(N−1))。
  • percentile=50 为本实现的离散中位数取样;图像数据不变。
  • 只接受 8-bit 的 1、3 或 4 通道图像,且像素数上限为 1,048,576。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:percentile 不在 0–100,或 channel 超出输入通道范围。
  • VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。

示例​

计算通道 0 的中位数。

Image median = Percentile(percentile: 50, channel: 0);

像素统计​

PixelStatistics · 可执行

计算指定通道的最小值、最大值、均值、标准差、非零像素数和总像素数。

签名​

Image stats = PixelStatistics(channel: 0);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回输入图像克隆;量测值s 输出 minimum、maximum、mean、stdDev、nonZeroCount、pixelCount。

行为​

  • 从 8-bit 的 1、3 或 4 通道输入提取 channel,调用 MinMaxLoc 和 MeanStdDev。
  • 图像数据不变;统计量进入 量测值s,不返回匿名结构体。

错误与限制​

  • VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入不是 8-bit 的 1、3 或 4 通道图像,或 channel 超出范围。
  • VISION_CORE_RESULT_NON_FINITE:统计结果包含 NaN 或 Infinity。

示例​

计算通道 0 的像素统计量。

Image stats = PixelStatistics(channel: 0);

峰值信噪比 (PSNR)​

Psnr · 可执行

比较指定通道与其高斯模糊副本,计算高频细节的 PSNR 指标。

签名​

Image psnr = Psnr(blurRadius: 3, channel: 0);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

blurRadiusint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–31, 必须为奇数。
高斯模糊半径。
channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回输入图像克隆;量测值s 输出 psnr、mse、blurRadius、channel、pixelCount。

行为​

  • 对指定通道执行 blurRadius×blurRadius 高斯模糊,并计算 MSE。
  • PSNR=10×log10(255²/MSE);MSE≤1e-10 时返回 100 dB 上限。
  • 这是单输入高频细节指标,不接受第二幅参考图;像素数上限为 1,048,576。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ODD:blurRadius 不是奇数。
  • VISION_PIPELINE_PARAMETER_RELATION:blurRadius 超过输入最大尺寸。
  • VISION_CORE_INPUT_TYPE_UNSUPPORTED:输入类型或 channel 不受支持。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。

示例​

计算通道 0 的 PSNR。

Image psnr = Psnr(blurRadius: 3, channel: 0);

中心块绝对偏差和 (SAD)​

SadBlockMetric · 可执行

计算中心块像素相对全图均值的绝对偏差和与平均值。

签名​

Image sad = SadBlockMetric(blockSize: 8, channel: 0);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

blockSizeint
  • 输入
  • 可选
  • 默认 8
  • 约束 范围 1–64。
块大小。
channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回输入图像克隆;量测值s 输出 sad、meanSad、blockSize、channel、pixelCount。

行为​

  • 先计算指定通道的全图均值,再取居中的 blockSize×blockSize 区域累加绝对偏差。
  • 这是单图中心块统计,不比较两幅图像或两个块。
  • blockSize 不得超过输入宽高;输入像素数上限为 1,048,576。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:blockSize 不在 1–64,或 channel 超出范围。
  • VISION_PIPELINE_PARAMETER_RELATION:blockSize 超过输入宽度或高度。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。

示例​

使用 8x8 块计算 SAD 度量。

Image sad = SadBlockMetric(blockSize: 8, channel: 0);

清晰度度量​

SharpnessMetric · 可执行

一次计算 Laplacian 方差、Tenengrad 均值和 Brenner 均值三种清晰度指标。

签名​

Image sharpness = SharpnessMetric(variant: "All");

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

variantstring
  • 输入
  • 可选
  • 默认 All
  • 约束 可选值: LaplacianVariance, Tenengrad, Brenner, All。
清晰度度量方法。

返回值​

returnImage
返回输入图像克隆;量测值s 输出 laplacianVariance、tenengradMean、brennerMean、variant。

行为​

  • variant=All 时一次计算 LaplacianVariance、Tenengrad 和 Brenner,并写入三个 量测值。
  • 当前执行器会对未计算的 量测值 做有限性校验,因此单独选择 LaplacianVariance、Tenengrad 或 Brenner 会以 VISION_CORE_RESULT_NON_FINITE 失败;可执行合同限 All。
  • Brenner 要求输入宽度至少 3;输入像素数上限为 1,048,576。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ENUM:variant 不在 LaplacianVariance、Tenengrad、Brenner、All。
  • VISION_CORE_DEGENERATE_GEOMETRY:执行 Brenner 时输入宽度小于 3。
  • VISION_CORE_RESULT_NON_FINITE:结果包含非有限值;当前也包括选择非 All 单变体的执行限制。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。

示例​

一次计算并输出三项清晰度 量测值。

Image sharp = SharpnessMetric(variant: "All");

结构相似性 (SSIM)​

Ssim · 可执行

比较指定通道与其高斯模糊副本,计算局部结构相似性均值。

签名​

Image ssim = Ssim(blurRadius: 3, windowSize: 3, channel: 0);

输入​

inputImage
  • 输入
  • 必填
由视觉图连接提供的源图像。

参数​

blurRadiusint
  • 输入
  • 可选
  • 默认 3
  • 约束 范围 1–31, 必须为奇数。
高斯模糊半径。
windowSizeint
  • 输入
  • 可选
  • 默认 8
  • 约束 范围 1–255, 必须为奇数。不得超过输入宽度或高度。
SSIM 局部窗口边长;当前执行器隐式默认 8 与奇数约束冲突,调用时必须显式传入合法奇数。
channelint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围 0 至输入通道数-1。
目标通道索引。

返回值​

returnImage
返回输入图像克隆;量测值s 输出 ssim、ssimMean、blurRadius、windowSize、channel、pixelCount。

行为​

  • 源通道先生成高斯模糊副本,再以 BoxFilter 计算局部均值、方差和协方差。
  • 采用 L=255、K1=0.01、K2=0.03 的 SSIM 常数,输出 ssimMap 的全图均值。
  • 这是单输入指标;像素数上限为 1,048,576。

错误与限制​

  • VISION_PIPELINE_PARAMETER_ODD:blurRadius 或 windowSize 不是奇数;省略 windowSize 时当前隐式默认 8 也会触发此错误。
  • VISION_PIPELINE_PARAMETER_RELATION:blurRadius 超过输入最大尺寸,或 windowSize 超过输入宽高。
  • VISION_CORE_RESULT_NON_FINITE:SSIM 均值为 NaN 或 Infinity。
  • VISION_CORE_OUTPUT_LIMIT_EXCEEDED:输入像素数超过 1,048,576。

示例​

计算通道 0 的 SSIM。

Image ssim = Ssim(blurRadius: 3, windowSize: 3, channel: 0);