跳到主要内容

缺陷检测

用于检测表面、边缘、颗粒和参考图差异,适合在线质量检查。

斑点缺陷检测​

BLOBDEFECT · 可执行

以连通域分析和面积筛选标记斑点缺陷。主目录已聚合本算子,ExecuteNode 主链可分派。

签名​

var blob = BLOBDEFECT(areaMin: 16, threshold: 128, blurKsize: 3, morphCloseKsize: 5);

输入​

inputImage
  • 输入
  • 必填
  • 约束 图像必须非空,深度为 CV_8U,通道数只能为 1(灰度)或 3(BGR)。
经入站图连接提供的非空 8-bit 灰度或 BGR 图像。

参数​

areaMindouble
  • 输入
  • 可选
  • 默认 16
  • 单位 pixel²
  • 约束 必须大于或等于 0,且不得大于 areaMax。
保留连通域的面积下限。
areaMaxdouble
  • 输入
  • 可选
  • 默认 0.75 × input.Width × input.Height
  • 单位 pixel²
  • 约束 必须大于或等于 areaMin。
保留连通域的面积上限。
thresholddouble
  • 输入
  • 可选
  • 默认 128
  • 约束 范围 0–255。
灰度二值化阈值。
blurKsizeint
  • 输入
  • 可选
  • 默认 3
  • 单位 pixel
  • 约束 范围 1–15,必须为奇数。
高斯模糊核边长。
morphCloseKsizeint
  • 输入
  • 可选
  • 默认 5
  • 单位 pixel
  • 约束 范围 1–31,必须为奇数。
椭圆形态学闭运算核边长。

输出​

outputImage
8-bit 三通道 BGR 图像,符合面积范围的缺陷连通域以红色高亮。
measurements量测值集合
键为 {nodeId}.regionCount、{nodeId}.totalArea、{nodeId}.labelCount,值均为有限数。

行为​

  • 将输入转灰度后依次执行高斯模糊、固定阈值二值化和椭圆核闭运算。
  • 视觉运行时.ConnectedComponentsWithStats 按 8 邻接提取连通域,背景标签不计入缺陷。
  • 仅保留面积落在 [areaMin, areaMax] 内的区域,并写入接受数量、总面积和背景外标签总数。
  • 取消令牌在原生处理前后被检查,取消时抛出 OperationCanceledException。

错误与限制​

  • VISION_DEFECT_PARAMETER_OUT_OF_RANGE:areaMin/areaMax 关系无效,或 blurKsize、morphCloseKsize 不是允许范围内的奇数。
  • VISION_DEFECT_INPUT_TYPE_UNSUPPORTED:输入为空、不是 CV_8U,或通道数不是 1/3。
  • VISION_DEFECT_DEGENERATE_GEOMETRY:连通域分析没有返回有效标签。
  • VISION_DEFECT_RESULT_LIMIT_EXCEEDED:背景外连通域数量超过 1024。

示例​

按面积范围筛选斑点缺陷。

var blob = BLOBDEFECT(areaMin: 50, areaMax: 5000, threshold: 128, blurKsize: 3, morphCloseKsize: 5);

裂纹线段检测​

CRACKDETECT · 可执行

以 Canny 和概率霍夫变换检测线段状裂纹。主目录已聚合本算子,ExecuteNode 主链可分派。

签名​

var crack = CRACKDETECT(cannyLow: 50, cannyHigh: 150, minLineLength: 20, maxLineGap: 5, threshold: 30, blurKsize: 3);

输入​

inputImage
  • 输入
  • 必填
  • 约束 图像必须非空,深度为 CV_8U,通道数只能为 1(灰度)或 3(BGR)。
经入站图连接提供的非空 8-bit 灰度或 BGR 图像。

参数​

cannyLowdouble
  • 输入
  • 可选
  • 默认 50
  • 约束 范围 0–1000,且必须严格小于 cannyHigh。
Canny 低阈值。
cannyHighdouble
  • 输入
  • 可选
  • 默认 150
  • 约束 范围 0–1000,且必须严格大于 cannyLow。
Canny 高阈值。
minLineLengthdouble
  • 输入
  • 可选
  • 默认 20
  • 单位 pixel
  • 约束 必须大于或等于 1。
HoughLinesP 接受的最小线段长度。
maxLineGapdouble
  • 输入
  • 可选
  • 默认 5
  • 单位 pixel
  • 约束 必须大于或等于 0。
同一线段内允许的最大间隙。
thresholdint
  • 输入
  • 可选
  • 默认 30
  • 约束 范围 1–1000。
HoughLinesP 累加器投票阈值。
blurKsizeint
  • 输入
  • 可选
  • 默认 3
  • 单位 pixel
  • 约束 范围 1–15,必须为奇数。
高斯模糊核边长。

输出​

outputImage
8-bit 三通道 BGR 图像,检测到的线段以红色绘制。
measurements量测值集合
键为 {nodeId}.lineCount、{nodeId}.totalLength、{nodeId}.maxLength,值均为有限数。

行为​

  • 将输入转灰度并经高斯模糊后执行 Canny 边缘检测。
  • 视觉运行时.HoughLinesP 按投票阈值、最小长度和最大间隙检测线段状裂纹。
  • 实现把每条线段以红色叠加,并写入线段数量、总长度和最大长度。
  • 取消令牌在原生处理前后被检查,取消时抛出 OperationCanceledException。

错误与限制​

  • VISION_DEFECT_PARAMETER_OUT_OF_RANGE:Canny 阈值关系、线段长度/间隙、投票阈值或模糊核不满足合同。
  • VISION_DEFECT_INPUT_TYPE_UNSUPPORTED:输入为空、不是 CV_8U,或通道数不是 1/3。
  • VISION_DEFECT_RESULT_LIMIT_EXCEEDED:HoughLinesP 返回的线段数量超过 8192。

示例​

检测线段状裂纹。

var crack = CRACKDETECT(cannyLow: 50, cannyHigh: 150, minLineLength: 20, maxLineGap: 10, threshold: 80, blurKsize: 3);

边缘轮廓缺陷检测​

EDGEDEFECT · 可执行

以 Canny 外轮廓及面积筛选标记边缘缺陷。主目录已聚合本算子,ExecuteNode 主链可分派。

签名​

var edge = EDGEDEFECT(cannyLow: 50, cannyHigh: 150, minContourArea: 16);

输入​

inputImage
  • 输入
  • 必填
  • 约束 图像必须非空,深度为 CV_8U,通道数只能为 1(灰度)或 3(BGR)。
经入站图连接提供的非空 8-bit 灰度或 BGR 图像。

参数​

cannyLowdouble
  • 输入
  • 可选
  • 默认 50
  • 约束 范围 0–1000,且必须严格小于 cannyHigh。
Canny 低阈值。
cannyHighdouble
  • 输入
  • 可选
  • 默认 150
  • 约束 范围 0–1000,且必须严格大于 cannyLow。
Canny 高阈值。
minContourAreadouble
  • 输入
  • 可选
  • 默认 16
  • 单位 pixel²
  • 约束 必须大于或等于 0,且不得大于 maxContourArea。
保留轮廓的面积下限。
maxContourAreadouble
  • 输入
  • 可选
  • 默认 0.75 × input.Width × input.Height
  • 单位 pixel²
  • 约束 必须大于或等于 minContourArea。
保留轮廓的面积上限。

输出​

outputImage
8-bit 三通道 BGR 图像,符合面积范围的边缘轮廓以红色绘制。
measurements量测值集合
键为 {nodeId}.contourCount、{nodeId}.totalLength、{nodeId}.totalArea,值均为有限数。

行为​

  • 将输入转灰度后执行 视觉运行时.Canny,并以 External/ApproxSimple 模式调用 视觉运行时.FindContours。
  • 仅保留面积落在 [minContourArea, maxContourArea] 内的轮廓。
  • 实现把接受轮廓以红色叠加,并写入轮廓数量、总周长和总面积。
  • 取消令牌在原生处理前后被检查,取消时抛出 OperationCanceledException。

错误与限制​

  • VISION_DEFECT_PARAMETER_OUT_OF_RANGE:Canny 阈值未满足 0 <= cannyLow < cannyHigh,或轮廓面积上下限关系无效。
  • VISION_DEFECT_INPUT_TYPE_UNSUPPORTED:输入为空、不是 CV_8U,或通道数不是 1/3。
  • VISION_DEFECT_RESULT_LIMIT_EXCEEDED:FindContours 返回的轮廓数量超过 4096。

示例​

按面积范围筛选边缘轮廓缺陷。

var edge = EDGEDEFECT(cannyLow: 50, cannyHigh: 150, minContourArea: 10, maxContourArea: 10000);

微粒轮廓计数​

PARTICLECOUNT · 可执行

以 Otsu 二值化、外轮廓与面积筛选统计微粒。主目录已聚合本算子,ExecuteNode 主链可分派。

签名​

var particles = PARTICLECOUNT(threshold: 128, minContourArea: 1, maxContourArea: 10000, blurKsize: 3);

输入​

inputImage
  • 输入
  • 必填
  • 约束 图像必须非空,深度为 CV_8U,通道数只能为 1(灰度)或 3(BGR)。
经入站图连接提供的非空 8-bit 灰度或 BGR 图像。

参数​

thresholddouble
  • 输入
  • 可选
  • 默认 128
  • 约束 范围 0–255。
传给 Otsu 二值化调用的初始阈值;实际分割阈值由 Otsu 计算。
minContourAreadouble
  • 输入
  • 可选
  • 默认 1
  • 单位 pixel²
  • 约束 必须大于或等于 0,且不得大于 maxContourArea。
计入微粒统计的轮廓面积下限。
maxContourAreadouble
  • 输入
  • 可选
  • 默认 10000
  • 单位 pixel²
  • 约束 必须大于或等于 minContourArea。
计入微粒统计的轮廓面积上限。
blurKsizeint
  • 输入
  • 可选
  • 默认 3
  • 单位 pixel
  • 约束 范围 1–15,必须为奇数。
高斯模糊核边长。

输出​

outputImage
8-bit 三通道 BGR 图像,符合面积范围的微粒轮廓以绿色绘制并以红点标出中心。
measurements量测值集合
键为 {nodeId}.particleCount、{nodeId}.totalArea、{nodeId}.avgArea,值均为有限数。

行为​

  • 将输入转灰度并经高斯模糊后执行 Binary + Otsu 二值化;传入 threshold 被读取,但 Otsu 决定实际分割阈值。
  • 视觉运行时.FindContours 以 External/ApproxSimple 模式提取外轮廓,并按面积上下限筛选微粒。
  • 实现把轮廓以绿色叠加、有效中心以红点标记,并写入数量、总面积和平均面积。
  • 取消令牌在原生处理前后被检查,取消时抛出 OperationCanceledException。

错误与限制​

  • VISION_DEFECT_PARAMETER_OUT_OF_RANGE:阈值、轮廓面积上下限关系或模糊核不满足合同。
  • VISION_DEFECT_INPUT_TYPE_UNSUPPORTED:输入为空、不是 CV_8U,或通道数不是 1/3。
  • VISION_DEFECT_RESULT_LIMIT_EXCEEDED:FindContours 返回的微粒候选数量超过 65536。

示例​

统计面积范围内的微粒轮廓。

var particles = PARTICLECOUNT(threshold: 128, minContourArea: 5, maxContourArea: 500, blurKsize: 3);

表面纹理异常检测​

SURFACEDEFECT · 可执行

以 Laplacian 响应的自适应阈值标记表面纹理异常。主目录已聚合本算子,ExecuteNode 主链可分派。

签名​

var surface = SURFACEDEFECT(laplacianKsize: 3, blurKsize: 3, sensitivity: 3.0, threshold: 32);

输入​

inputImage
  • 输入
  • 必填
  • 约束 图像必须非空,深度为 CV_8U,通道数只能为 1(灰度)或 3(BGR)。
经入站图连接提供的非空 8-bit 灰度或 BGR 图像。

参数​

laplacianKsizeint
  • 输入
  • 可选
  • 默认 3
  • 单位 pixel
  • 约束 范围 1–31,必须为奇数。
Laplacian 核边长。
blurKsizeint
  • 输入
  • 可选
  • 默认 3
  • 单位 pixel
  • 约束 范围 1–15,必须为奇数。
高斯模糊核边长。
sensitivitydouble
  • 输入
  • 可选
  • 默认 3.0
  • 约束 必须为正有限值。
自适应阈值中标准差的倍率。
thresholddouble
  • 输入
  • 可选
  • 默认 32
  • 约束 范围 0–255;当前执行路径不消费该值。
schema 声明的阈值参数;当前计算使用 mean + sensitivity × standardDeviation,不消费该值。

输出​

outputImage
8-bit 三通道 BGR 图像,自适应阈值筛出的纹理异常轮廓以黄色绘制。
measurements量测值集合
键为 {nodeId}.roughness、{nodeId}.adaptiveThreshold、{nodeId}.regionCount、{nodeId}.totalArea,值均为有限数。

行为​

  • 将输入转灰度并经高斯模糊后执行 CV_64F Laplacian,再转换为 8-bit 绝对响应图。
  • 执行器以 mean + sensitivity × standardDeviation 计算 adaptiveThreshold;已声明并读取的 threshold 参数当前不参与计算。
  • 视觉运行时.FindContours 提取全部异常外轮廓,以黄色叠加,并写入粗糙度、自适应阈值、区域数量和总面积。
  • 取消令牌在原生处理前后被检查,取消时抛出 OperationCanceledException。

错误与限制​

  • VISION_DEFECT_PARAMETER_OUT_OF_RANGE:Laplacian/模糊核不是允许范围内的奇数,或 sensitivity 不是正有限值。
  • VISION_DEFECT_INPUT_TYPE_UNSUPPORTED:输入为空、不是 CV_8U,或通道数不是 1/3。
  • VISION_DEFECT_RESULT_LIMIT_EXCEEDED:FindContours 返回的异常区域数量超过 1024。

示例​

标记表面纹理异常;threshold 当前无运行效果。

var surface = SURFACEDEFECT(laplacianKsize: 3, blurKsize: 3, sensitivity: 1.5, threshold: 50);

参考图差异检测​

TEMPLATEDEFECT · 可执行

以参考灰度图和 Absdiff 标记差异区域。主目录已聚合本算子,referencePath 为必需字符串参数。

签名​

var template = TEMPLATEDEFECT(referencePath: "golden.png", threshold: 32, blurKsize: 3, minContourArea: 8);

输入​

inputImage
  • 输入
  • 必填
  • 约束 图像必须非空,深度为 CV_8U,通道数只能为 1(灰度)或 3(BGR)。
经入站图连接提供的非空 8-bit 灰度或 BGR 图像。

参数​

referencePathstring
  • 输入
  • 必填
  • 约束 必须非空且可由视觉运行时以灰度模式加载,图像尺寸必须与 input 完全一致。解析后的路径必须位于授权根内。
授权资源根内的参考图路径;相对路径以视觉资源授权根为基准。
thresholddouble
  • 输入
  • 可选
  • 默认 32
  • 约束 范围 0–255。
参考图差值的二值化阈值。
blurKsizeint
  • 输入
  • 可选
  • 默认 3
  • 单位 pixel
  • 约束 范围 1–15,必须为奇数。
输入图像高斯模糊核边长。
minContourAreadouble
  • 输入
  • 可选
  • 默认 8
  • 单位 pixel²
  • 约束 必须大于或等于 0。
保留差异轮廓的面积下限。

输出​

outputImage
8-bit 三通道 BGR 图像,符合最小面积的参考图差异轮廓以品红色绘制。
measurements量测值集合
键为 {nodeId}.defectCount、{nodeId}.totalArea、{nodeId}.maxArea,值均为有限数。

行为​

  • 以灰度模式加载 referencePath 指向的参考图,并要求其尺寸与 input 完全一致。
  • 输入图先经高斯模糊,再以 视觉运行时.Absdiff 计算逐像素差异并执行固定阈值二值化。
  • 视觉运行时.FindContours 以 External/ApproxSimple 模式提取差异外轮廓,仅把面积不小于 minContourArea 的区域以品红色叠加,并写入数量、总面积和最大面积。
  • 取消令牌在原生处理前后被检查,取消时抛出 OperationCanceledException。

错误与限制​

  • VISION_DEFECT_PARAMETER_OUT_OF_RANGE:referencePath 缺失,或阈值、模糊核、最小轮廓面积不满足合同。
  • VISION_DEFECT_INPUT_TYPE_UNSUPPORTED:输入为空、不是 CV_8U,或通道数不是 1/3。
  • VISION_DEFECT_DETECTOR_UNAVAILABLE:referencePath 指向的参考图无法以灰度图加载。
  • VISION_DEFECT_DEGENERATE_GEOMETRY:参考图尺寸与 input 不一致。
  • VISION_DEFECT_RESULT_LIMIT_EXCEEDED:差异轮廓数量超过 1024。

示例​

与授权根内参考图做差异检测。

var template = TEMPLATEDEFECT(referencePath: "golden.png", threshold: 30, blurKsize: 5, minContourArea: 100);