# FindCircle

Localiza un borde circular sencillo dentro de una región anular (forma de corona circular o anillo) de la imagen. La función FindCircle forma proyecciones unidimensionales de la región de la imagen al sumar los valores de los píxeles ubicados en círculos concéntricos que va explorando sucesivamente para radios cada vez mayores. Las transiciones en los bordes se extraen de los datos de la imagen proyectada.

## FindCircle 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.
Polaridad | Especifica la polaridad del borde a localizar respecto a la dirección de exploración de la región del Edge; la función informará únicamente sobre los bordes que tienen la polaridad especificada.
0 = negro a blanco | Especifica que la polaridad del borde es la de negro a blanco.
1 = blanco a negro | Especifica que la polaridad del borde es la de blanco a negro.
2 = cualquiera (por defecto) | Especifica que la polaridad del borde puede ser tanto de negro a blanco como de blanco a negro.
Buscar por | Define el método de selección de bordes que utilizará la función para seleccionar un borde de entre múltiples candidatos a borde.
0 = mejor puntuación (por defecto) | Especifica que el borde con la mayor puntuación recibe la mayor de las consideraciones.
1 = círculo más pequeño | Especifica que el círculo más pequeño detectado recibe la mayor de las consideraciones.
2 = círculo más grande | Especifica que el círculo más grande detectado recibe la mayor de las consideraciones.
Umbral de aceptación | Especifica el contraste mínimo aceptable que deben presentar los bordes (0 a 100; por defecto = 25); el valor de contraste se normaliza a partir del histograma de escala de grises dentro de la región a una escala de 0 a 100. La función rechazará cualquier borde cuya puntuación de contraste sea inferior a este valor.
Normalizar puntuación | Especifica si las puntuaciones de los bordes serán normalizadas al histograma de escala de grises de la región. Cuando la opción Normalizar puntuación está habilitada, las puntuaciones brutas de los bordes se normalizan al contraste máximo encontrado en la región de imagen utilizando la fórmula siguiente: Puntuación = (Puntuación bruta del borde) x (100/contraste máximo) Donde la puntuación bruta del borde es la diferencia en niveles de gris a lo ancho del borde y el contraste máximo es la diferencia entre el nivel de gris máximo y el mínimo (0 a 255) en la región de la imagen. Si se deshabilita la opción Normalizar puntuación, los bordes de bajo contraste tendrán una puntuación inferior a la de los bordes de alto contraste. Se utiliza la siguiente fórmula: Puntuación = (Puntuación bruta del borde) x (100/255)
0 = DESACTIVADO | No normaliza la puntuación.
1 = ACTIVADO (por defecto) | Normaliza la puntuación.
Nota: Sugerencia: Este parámetro sirve para encontrar bordes en una región de bajo contraste. Si prevé que los bordes a detectar son todos de alto contraste, desactive este parámetro.
Ancho de borde | Especifica la distancia en píxeles (de 1 a 50; por defecto = 3) en la que se produce una transición de borde. El parámetro Ancho de borde se utiliza para filtrar la imagen antes de extraer los bordes.
Mostrar | Especifica el modo de visualización de las superposiciones gráficas de FindCircle sobre la imagen.
0 = ocultar todo (por defecto) | Se ocultarán todos los gráficos, excepto cuando la celda que contiene la función FindCircle es la celda activa en la hoja de cálculo.
1 = solo gráficos de resultados | Se visualizará en todo momento el borde circular.
2 = gráficos de entrada y resultado | Se visualizarán en todo momento la región de la imagen entrada y el borde circular.
3 = mostrar todo: entrada, resultado y gráfico | Se visualizarán en todo momento la región de la imagen entrada, el borde circular y el gráfico de respuesta del borde. Nota: El gráfico de respuesta a bordes es una ventana acoplable. Para más información, consulte el tema Editor de hojas de cálculo - Gráficos.

## FindCircle Salidas

Devuelve | Una estructura de datos Edge que contiene un borde circular sencillo, o #ERR si alguno de los parámetros de entrada no es válido.
Resultados | Cuando se inserta inicialmente FindCircle en una celda, se crea una tabla de resultados en la hoja de cálculo mediante las siguientes Edges Vision Data Access functions
Etiqueta | Función | Descripción
CentX | GetX(Edges, 0, 0) | La coordenada X del centro.
CentY | GetY(Edges, 0, 0) | La coordenada Y del centro.
Radius | GetRadius(Edges, 0) | El radio.
Score | GetScore(Edges, 0) | La puntuación de contraste del borde. La puntuación es positiva cuando las transiciones son de negro a blanco y negativa cuando las transiciones son de blanco a negro.