FindPatMaxRedLine

Busca objetos en una imagen según un patrón entrenado. (Una descripción geométrica (interna) entrenada de un objeto que se desea encontrar). El FindPatMaxRedLine busca patrones dentro de una imagen sobre la base de un patrón entrenado contenido en una estructura de datos Patterns.

FindPatMaxRedLine 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.

Fixture

Define la Región a explorar en relación con un Fixture de entrada o el sistema de coordenadas de la imagen proporcionada por una función del conjunto Vision Tools. Establecer la RDI en relación con 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 (por defecto = 0)

El desplazamiento en X, en coordenadas de la imagen.

Y (por defecto = 0)

El desplazamiento en Y, en coordenadas de la imagen.

Theta (por defecto = 0)

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)

Buscar en región

También conocida como región de interés (RDI), especifica la región de la imagen que se somete a análisis. Haga doble clic sobre el parámetro Región para crear un Modo gráfico interactivo que permite transformar y girar. Seleccione este parámetro y pulse el botón «Maximizar región» en la barra de herramientas de edición de tareas de la hoja de propiedades a fin de expandir 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.

Ancho (por defecto = 320)

El tamaño de la región en la dirección del eje X.

Altura (por defecto = 440)

El tamaño de la región en la dirección del eje Y.

Ángulo (por defecto = 0)

La orientación en coordenadas del elemento posicionador.

Curva (por defecto = 0)

La desviación angular entre el eje X de la región y la línea limítrofe del lado opuesto.

Región externa

Este parámetro utiliza Referencias de celda a la celda de hoja de cálculo que contiene una función Annulus, Circle, Region, EditAnnulus, EditCircle, EditCompositeRegion o EditPolygon o o una función EditRegion. Cuando se utiliza este parámetro, la función ignora los valores de ajuste de Región y Elemento posicionador e inspecciona el área de imagen especificada por la región a la que se hace referencia. Si se hace referencia a un control de EditCompositeRegion, el área de inspección puede consistir en una combinación de formas. Cada forma de la región combinada puede definirse como una forma añadida al área de inspección o una sustraída (enmascaramiento) de la misma.

Nota:  Si este parámetro ha sido configurado como referencia a una región externa, entonces, para utilizar la Región interna de la función, habrá que poner manualmente este parámetro a cero introduciendo para ello el valor 0 en lugar de la referencia de celda. En caso contrario, la función seguirá haciendo referencia a la región externa.

Patrón

Este argumento debe hacer referencia a una celda de la hoja de cálculo que contiene una estructura válida de datos de patrones devuelta por la función TrainPatMaxRedLine.

Número a buscar

Especifica el número máximo de patrones coincidentes (1 a 1000; por defecto = 1) que podrá devolver la función.

Umbral de aceptación

Especifica el umbral de aceptación, que es la puntuación más baja de un ejemplar válido. La puntuación de una posible coincidencia debe ser mayor que el valor del umbral de aceptación (0 a 100; por defecto = 50), de lo contrario la función no proporcionará esa coincidencia como resultado de la búsqueda.

Ignorar polaridad

Especifica si se pueden encontrar coincidencias que contienen características de coincidencia de color invertido con respecto al patrón entrenado.

0 = DESACTIVADO (por defecto)

No se considerarán las características de color invertido.

1 = Activado

Se considerarán los bordes que coinciden pero con polaridades opuestas.

Ignorar la polaridad aumenta la variedad de patrones que puede encuentrar PatMax. La siguiente figura muestra algunos ejemplos de polaridades coincidentes y no coincidentes. Si se configura la función PatMaxRedLine para que ignore la polaridad, entonces encuentra todos los patrones que se muestran en la figura. Si se configura la función PatMaxRedLine para que tenga en cuenta la polaridad, entonces es posible que no encuentre el patrón en la fila inferior o que lo encuentre pero le asigne puntuaciones más bajas que al patrón de la fila superior.

Modo de precisión

Especifica el compromiso que ha de hacerse entre precisión/fiabilidad y velocidad de ejecución.

0 = Baja

Especifica precisión/fiabilidad menor a cambio de velocidad de ejecución mayor.

1 = Alta (por defecto)

Especifica precisión/fiabilidad mayor y velocidad de ejecución menor.

Emborronamiento en puntuación

Especifica si la oclusión o ausencia de características del patrón por emborronamiento del fondo ha de reducir la puntuación en los cálculos de la función.

0 = DESACTIVADO (por defecto)

No incluir el efecto de emborronamiento en la puntuación.

1 = Activado

Incluir el efecto de emborronamiento en la puntuación.

Umbral de contraste

Especifica el contraste más bajo de un ejemplar válido. El contraste en una posible coincidencia debe ser mayor que el valor umbral de contraste (0 a 100; por defecto = 0), de lo contrario no se considerará ese ejemplar. El contraste de FindPatMaxRedLine es una medición «relativa» del cambio de contraste entre las características del patrón entrenado frente al de las características de coincidencia en la imagen de búsqueda, expresada porcentualmente. Por lo tanto, si el contraste de las características es similar o más alto en relación con el contraste del patrón, el contraste comunicado será ~100. Si el contraste de las características es inferior al del contraste patrón, el contraste comunicado será <100.

Nota:  El contraste considerado en la función FindPatMaxRedLine es distinto del de la función FindPatMaxPatterns, en cuyo caso es el contraste 'absoluto' de la imagen en la RDI, en escala de grises.

Buscar tolerancias

Especifica los valores a considerar en la búsqueda de patrones que están girados o tienen otras proporciones con respecto al patrón entrenado.

Nota:  Las tolerancias de búsqueda son límites estrictos, es decir, los resultados que se encuentran fuera de las tolerancias de búsqueda especificadas no se presentarán como resultados en la hoja de cálculo.

Ángulo inicial

Especifica el ángulo, medido en grados y en sentido antihorario, en el que debe empezar la búsqueda de coincidencias (un ángulo entre -180 y 180; por defecto = -15).

Ángulo final

Especifica el ángulo, medido en grados y en sentido antihorario, en el que se detiene la búsqueda de coincidencias (un ángulo entre -180 y 180; por defecto = 15).

Escala inicial

Especifica la escala con la que deben empezarse a buscar coincidencias (1 a 10000; por defecto = 100).

Escala final

Especifica la escala a la que se dejarán de buscar coincidencias (1 a 10000; por defecto = 100).

XY de superposición

Especifica la diferencia en posición esperada entre múltiples patrones superpuestos en aproximadamente la misma ubicación X, Y, expresada en tanto porciento con respecto al tamaño del patrón entrenado (0 a 100; por defecto = 70).

Nota:  Al aumentar este valor se amplia la posibilidad de encontrar múltiples coincidencias superpuestas del mismo patrón.

Ajustes avanzados

Utilizar porcentaje aproximado

Especifica si se utiliza o no el valor de «Porcentaje de aceptación aproximado» durante la fase de búsqueda aproximada.

Nota:  En la mayoría de los casos, no es necesario que este parámetro esté habilitado.

0 = DESACTIVADO (por defecto)

Se utilizará únicamente el valor de «Umbral de aceptación» durante la fase de búsqueda aproximada (se ignorará el «Porcentaje de aceptación aproximado»).

1 = Activado

El parámetro «Porcentaje de aceptación aproximado» se habilita para especificar la desviación porcentual con respecto al valor del umbral de aceptación que ha de considerarse durante la fase de búsqueda aproximada.

Porcentaje de aceptación aproximado

Especifica la desviación con respecto al valor de umbral de aceptación, expresada en tanto porciento, que se considerará durante la fase de búsqueda aproximada (0 a 100; por defecto = 60). Este parámetro resulta útil cuando el valor de umbral de aceptación no restringe eficazmente el número de ejemplares y la función devuelve demasiadas coincidencias o, incluso, no devuelve ninguna.

Sobre cómo funciona el «Porcentaje de aceptación aproximado»

La función FindPatMaxRedLine utiliza primero características de gran tamaño para encontrar una coincidencia aproximada de un patrón en la imagen que se está procesando (en la fase de búsqueda aproximada) y, a continuación, utiliza características más pequeñas para determinar con precisión la ubicación del patrón (fase de búsqueda precisa). En ambas fases, el valor de umbral de aceptación se utiliza para restringir el número de ejemplares encontrados.

Flujo normal (Utilizar porcentaje aproximado = desactivado)

Si bien es poco frecuente, puede ocurrir que la función FindPatMaxRedLine no devuelva ninguna coincidencia debido a que solo encuentra ejemplares de baja puntuación en la fase de búsqueda aproximada. Si sucede esto, se puede disminuir el valor de ajuste del umbral de aceptación; sin embargo, un valor bajo para el umbral de aceptación puede implicar que la función devuelva demasiadas coincidencias.

No devuelve ninguna coincidencia o devuelve demasiadas coincidencias
(Utilizar porcentaje aproximado = desactivado)

En tal caso, el parámetro «Porcentaje de aceptación aproximado» le permite definir el valor umbral de aceptación para la fase de búsqueda aproximada. Mediante el uso de un valor de umbral de aceptación distinto para cada fase de búsqueda, se consigue que la función devuelva adecuadamente los resultados esperados.

Devuelve los resultados esperados (Utilizar porcentaje aproximado = activado)

Tiempo de espera

Especifica la duración del periodo de tiempo, en milisegundos (0 a 30000; por defecto = 5000), durante el cual se ejecuta la función de búsqueda de patrones y tras el cual se detiene la ejecución de la función y emite un #ERR. Si este valor se ajusta a 0, el ajuste se desactivará y el tiempo de espera no se aplicará.

Mostrar

Especifica el modo de visualización de los gráficos sobre la imagen.

0 = ocultar todo (por defecto)

Se ocultarán todos los gráficos, excepto cuando la celda que contiene la función FindPatMaxRedLine es la celda activa en la hoja de cálculo.

1 = solo gráficos de resultados

Se visualizará en todo momento una cruz para cada patrón encontrado.

2 = gráficos de entrada y resultado

Se visualizarán en todo momento la región de la imagen entrada y la marca de una cruz para cada patrón encontrado.

3 = entrada, resultado y características coincidentes

Se visualizarán en todo momento la región de la imagen entrada, la marca de una cruz para cada patrón encontrado y las características coincidentes encontradas con PatMax RedLine.

FindPatMaxRedLine Salida

Devuelve

Una estructura de datos Patterns que contiene un modelo y una lista de patrones encontrados, ordenados por puntuación, o #ERR si alguno de los parámetros de entrada no es válido.

Nota:  El FindPatMaxRedLine no emitirá ningún #ERR si no se ha encontrado ningún patrón entrenado. En tal caso, utilice la función Patterns Vision Data Access functions GetNFound(Patterns) que dará 0 si no encuentra ningún patrón coincidente.

Resultados

Cuando se inserta inicialmente FindPatMaxRedLine en una celda, se crea una tabla de resultados en la hoja de cálculo mediante las siguientes funciones de Patterns Vision Data Access functions.

Etiqueta Función Descripción

X

GetX(Patterns, Índice)

La coordenada X de la posición del patrón.

Y

GetY(Patterns, Índice)

La coordenada Y de la posición del patrón.

Angle

GetAngle(Patterns, Índice)

La orientación de la posición del patrón.

Scale

GetScale(Patterns, Índice)

El tamaño del patrón encontrado en comparación con el modelo entrenado expresado como tanto por ciento del tamaño del modelo.

Score

GetScore(Patterns, Índice)

La puntuación del patrón encontrado.