# FindCircleDefects

La función FindCircleDefects convierte cada píxel contenido en una región con forma de anillo circular (corona circular) de una imagen de entrada en un píxel blanco o negro en función de su relación con un valor umbral establecido por el usuario, indicándose así con blanco las características no circulares o no radiales. El usuario define y posiciona el anillo circular sobre la imagen y elige si la función ha de calcular el gradiente de píxeles en dirección circular o radial. Los valores iguales o superiores al nivel de umbral se visualizan como píxeles blancos en la imagen en blanco y negro de salida.

## FindCircleDefects Entradas

Parámetro | Descripción
Imagen | This parameter must reference a spreadsheet cell that contains an Imagen data structure; by default, this parameter references A0, the cell containing the data structure. This parameter can also reference other Image data structures, such as those returned by the Image Vision Data Access functions or Funciones de transformación de coordenadas.
Elemento posicionador | Define la región de interés (RDI) con relación a un Fixture entrado o al sistema de coordenadas de imagen proporcionado por una función de Vision Tools. Establecer la RDI con relación al un elemento posicionador permite asegurar que si se gira o desplaza el elemento posicionador, se girará o desplazará en consonancia la RDI, manteniéndose fija la relación entre ambos. El valor de configuración predeterminado es (0,0,0), la esquina superior izquierda de la imagen.
X | El desplazamiento en X, en coordenadas de la imagen.
Y | El desplazamiento en Y, en coordenadas de la imagen.
Theta | La rotación desde el eje X de la imagen, en el sistema de coordenadas de imagen. (+/-360 grados en el sentido de las agujas del reloj)
Anillo | También conocida como región de interés (RDI), especifica la región de la imagen que se somete al análisis; crea una región anular que puede ser trasladada y girada en la imagen. Cuando este parámetro está seleccionado, al pulsar el botón Maximize Region de la barra de herramientas de la hoja de propiedades, se expande automáticamente la región hasta cubrir toda la imagen.
X | El desplazamiento en X del origen, en coordenadas del elemento posicionador.
Y | El desplazamiento en Y del origen, en coordenadas del elemento posicionador.
Radio interior | El tamaño del radio interior.
Radio exterior | El tamaño del radio exterior.
Nota: Los parámetros Elemento posicionador y Anillo deben estar definidos dentro de los límites de la imagen, de lo contrario, la función dará #ERR.
Tipo de defecto | Especifica el tipo de defecto al que es sensible la función: circular o radial. Los píxeles que presentan valores en escala de grises distintos de los de los píxeles circundantes indican posibles defectos.
0 = Características no circulares (por defecto) | Especifica el cálculo del gradiente de píxeles a realizar en dirección circular en un anillo circular para detectar desviaciones con respecto a la forma de un círculo.
1 = Características no radiales | Especifica el cálculo del gradiente de píxeles a realizar en dirección radial en un anillo circular para detectar desviaciones con respecto a las características radiales.
Desviación | Especifica el grado de tolerancia en la detección de defectos.
0 = DESACTIVADO (por defecto) | Especifica que el objeto ha de ser circular y estar centrado en el anillo circular; es un ajuste poco tolerante.
1 = Activado | Especifica que el objeto puede ser ovalado o estar algo descentrado con respecto al anillo circular; es un ajuste más tolerante.
Umbral de aceptación | Especifica el umbral de defecto, un valor en escala de grises. (0–255; predeterminado = 30)
Mostrar | Especifica qué superposiciones gráficas han de visualizarse sobre la imagen.
0 = ocultar todo (por defecto) | Se ocultan los elementos gráficos disponibles, excepto cuando la celda que contiene la función FindCircleDefects está resaltada en la hoja de cálculo.
1 = solo gráficos de resultados | Se visualizará la imagen procesada en todo momento.
2 = sólo gráficos de entrada | Se visualizarán en todo momento los elementos gráficos asociados a la región de la imagen entrada.

## FindCircleDefects Salidas

Devuelve | Una estructura de datos Imagen que almacena la imagen en blanco y negro ("binaria»), o #ERR si alguno de los parámetros de entrada no es válido.
Resultados | Cuando se inserta inicialmente FindCircleDefects en una celda, se crea una tabla de resultados en la hoja de cálculo mediante las siguientes Image Vision Data Access functions
Etiqueta | Función | Descripción
DarkCounts | GetDarkPixelCount(Image) | Devuelve el número de píxeles cuyo valor está por debajo del umbral de defecto; estos píxeles se visualizan en negro.
BrightCount | GetBrightPixelCount(Image) | Devuelve el número de píxeles cuyo valor es igual o superior al umbral de defecto; estos píxeles se visualizan en blanco.
Se puede acceder a elementos adicionales de datos mediante las siguientes Image Vision Data Access functions:
Area | GetArea(Image) | Devuelve el área de la región.

## FindCircleDefects Ejemplo

En este ejemplo, se utilizan un objeto de plástico de forma circular (izquierda) y otro radial (derecha) para demostrar la funcionalidad de FindCircleDefect. Los dos objetos son de color gris medio y presentan bordes interiores y exteriores gruesos y oscuros.

Tras insertar la función en la hoja de cálculo de In-Sight, el usuario define el anillo circular haciendo doble clic sobre la palabra «Annulus» en la hoja de propiedades, la cual desaparece entonces para que se visualice el anillo circular de color rojo superpuesto a la imagen. El usuario puede desplazar el anillo circular o cambiar su tamaño utilizando el cursor y haciendo clic sobre el botón OK de la barra de herramientas de edición de tareas para confirmar la selección y volver a la hoja de propiedades. (Se puede confirmar también la selección pulsando la tecla Entrar o haciendo doble clic sobre el anillo circular). A continuación se presentan las imágenes de los objetos junto con los anillos circulares.

Para completar la configuración de este ejemplo, se selecciona un tipo de defecto (no circular o no radial), se elige activar («ON») o desactivar («OFF») la tolerancia en desviación y, a continuación, se hace clic sobre Aceptar en la hoja de propiedades para aplicar la función a la imagen de entrada.

Se presentan a continuación las imágenes en blanco y negro del objeto circular obtenidas con la función configurada para detectar defectos no circulares, el parámetro Umbral de aceptación ajustado a su valor predeterminado de 30 y la tolerancia en desviación en «OFF» (izquierda) u «ON» (derecha). Obsérvese lo estricta que es la opción de ajuste «OFF» (izquierda) con la que se marcan los píxeles del borde exterior del objeto como posibles defectos, aunque parezcan formar parte de la suave curva circular del borde del objeto.

A continuación puede verse la imagen de salida en blanco y negro del mismo objeto circular obtenida con la función configurada para detectar defectos no radiales. La función marca los bordes interiores y exteriores del contorno exterior como posibles defectos radiales.

A continuación se presentan imágenes de salida en blanco y negro del objeto radial obtenidas con la función configurada para detectar defectos no radiales, con el parámetro «Umbral de aceptación» ajustado en 70 y la tolerancia en desviación en «OFF» (izquierda) u «ON» (derecha). Obsérvese que el ajuste «OFF» (izquierda) es de nuevo mucho más estricto y que se marcan con él los bordes exteriores de las partes radiales como posibles defectos.

A continuación se presenta la imagen de salida en blanco y negro del mismo objeto radial obtenida con la herramienta configurada ahora para detectar defectos no circulares. La función marca ahora todas las estructuras radiales que se encuentran dentro del anillo circular como posibles defectos circulares.

En una aplicación real, el usuario aplicaría seguidamente otra herramienta a la imagen de salida para tomar una decisión en base a los resultados obtenidos.