# FindPatMaxPatterns

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 FindPatMaxPatterns busca patrones dentro de una imagen sobre la base de un patrón entrenado contenido en una estructura de datos Patterns.

## FindPatMaxPatterns 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 | 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)
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 | El tamaño de la región en la dirección del eje X.
Altura | El tamaño de la región en la dirección del eje Y.
Ángulo | La orientación en coordenadas del elemento posicionador.
Curva | 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 una herramienta o función de control Annulus, Circle, Region, EditAnnulus, EditCircle, EditCompositeRegion, EditPolygon, EditRegion. Cuando se utiliza este parámetro, la función ignora los ajustes de Región y Elemento 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 una función TrainPatMaxPattern.
Número a buscar | Especifica el número máximo de patrones coincidentes (de 1 a 1024; por defecto = 1) que podrá devolver la función.
Aceptar | 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.
Contrast | 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 255; por defecto = 10), de lo contrario no se considerará ese ejemplar. Se utilizan valores umbral bajos cuando las imágenes tienen poco contraste, mientras que se utilizan umbrales altos de contraste para imágenes de alto contraste.
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 | No incluir el efecto de emborronamiento en la puntuación.
1 = ACTIVADO (por defecto) | Incluir el efecto de emborronamiento en la puntuación.
Fuera de región | Especifica el porcentaje de características del patrón que pueden encontrarse fuera de la región de búsqueda sin que se degrade la puntuación al patrón dada por la función (0 a 100; por defecto = 0).
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.
Á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).
Relación de aspecto | Limita la búsqueda de coincidencias a escalas uniformes o permite que haya un cambio en la proporción entre anchura X y altura Y, además de considerar el cambio de escala uniforme. Nota: Los parámetros Relación de aspecto inicial y Relación de aspecto final están deshabilitados cuando la opción Cambio de escala uniforme está habilitada.
0 = Cambio de escala uniforme
1 = Cambio de escala uniforme y de X
2 = Cambio de escala uniforme y de Y
Relación de aspecto inicial | Especifica el cambio mínimo de escala con el que se inicia la búsqueda de coincidencias, expresadas en tanto porciento con respecto al patrón entrenado (1 a 10000; por defecto = 100).
Relación de aspecto final | Especifica el cambio máximo de escala con el que se finaliza la búsqueda de coincidencias, expresadas en tanto porciento con respecto al patrón entrenado (1 a 10000; por defecto = 100).
Buscar superposiciones | Especifica los ajustes a utilizar en la búsqueda de patrones superpuestos teniendo en cuenta posición, rotación y escala relativas.
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 = 80). Nota: Al aumentar este valor se amplia la posibilidad de encontrar múltiples coincidencias superpuestas del mismo patrón.
Ángulo en superposición | Especifica el ángulo esperado entre múltiples patrones girados que se superponen en aproximadamente la misma ubicación X, Y. A (0 a 360; por defecto = 360). Nota: El parámetro Ángulo en superposición está deshabilitado si los parámetros Ángulo inicial y Ángulo final tienen el mismo valor. Al aumentar este valor se amplia la posibilidad de encontrar múltiples coincidencias superpuestas del mismo patrón.
Escala en superposición | Especifica la diferencia en escala uniforme esperada entre los múltiples patrones que se superponen en aproximadamente la misma ubicación X, Y, expresada como tanto porciento con respecto al tamaño del patrón entrenado (1 a 10000; por defecto = 140). Nota: El parámetro Escala en superposición está deshabilitado si los parámetros Escala inicial y Escala final tienen el mismo valor. Al aumentar este valor se amplia la posibilidad de encontrar múltiples coincidencias superpuestas del mismo patrón.
Aspecto en superposición | Especifica la diferencia en la relación de aspecto esperada entre los múltiples patrones que se superponen en aproximadamente la misma ubicación X, Y, expresada como tanto porciento con respecto al tamaño del patrón entrenado (1 a 10000; por defecto = 140). Nota: El parámetro Aspecto en superposición está deshabilitado si se ha seleccionado la opción «Cambio de escala uniforme» para el parámetro Relación de aspecto o cuando los parámetros Aspecto inicial y Aspecto final tienen el mismo valor. Al aumentar este valor se amplia la posibilidad de encontrar múltiples coincidencias superpuestas del mismo patrón.
Tiempo de espera | Especifica la duración del periodo de tiempo, en milisegundos (0 a 30000), 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 ajuste se pone a 0, se desactivará el parámetro y no se implementará el tiempo de espera.
Algoritmo | Especifica el algoritmo que se utilizará para procesar la imagen en busca del patrón entrenado.
0 = PatMax | El algoritmo PatMax ofrece una mayor precisión que el PatQuick, pero requiere más tiempo para ejecutarse.
1 = PatQuick | El algoritmo PatQuick ofrece menor precisión que el PatMax, pero requiere menos tiempo para ejecutarse.
2 = Patrón entrenado (por defecto) | La función FindPatMaxPatterns utilizará el algoritmo (PatMax o PatQuick) especificado en el parámetro Algoritmo de la función TrainPatMaxPattern referenciada en el parámetro Patrón.
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 FindPatMaxPatterns 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®. Nota: No se indican las características coincidentes si se ha seleccionado PatQuick en el parámetro Algoritmo de la función TrainPatMaxPattern. Marcas de coincidencia en verde = 67 a 100 por ciento de coincidencia. Marcas de coincidencia en amarillo = 20 a 66 por ciento de coincidencia. Marcas de coincidencia en rojo = menos del 20 por ciento de coincidencia.

## FindPatMaxPatterns Salidas

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 o no se ha podido encontrar ningún patrón coincidente.
Resultados | Cuando se inserta inicialmente FindPatMaxPatterns en una celda, se crea una tabla de resultados en la hoja de cálculo. Nota: Además, en la hoja de propiedades de la función se proporcionan cadenas de información suplementaria que presentan sugerencias sobre cómo mejorar la búsqueda de patrones. Para una lista de posibles cadenas de información: [Valor] resultado(s) descartado(s) debido a contraste insuficiente. [Valor] resultado(s) descartado(s) debido a la proximidad de resultados más exactos. [Valor] resultado(s) descartado(s) debido a emborronamiento en el fondo de la imagen. El patrón entrenado contiene muy pocas características para la configuración del parámetro actual. Para insertar cadenas de información en la hoja de cálculo, utilice la función GetInfoString del conjunto Vision Data Access.

## FindPatMaxPatterns Vision Data Access functions

Se insertan automáticamente las siguientes funciones Patterns Vision Data Access functions en la hoja de cálculo para crear la tabla de resultados:

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 de la respuesta al patrón.