# SortPatterns

Clasifica y ordena los patrones por su posición en la imagen. Para cada patrón de la estructura de datos Patterns de entrada, la función SortPatterns calcula la posición de la respuesta de patrón con respecto al sistema de coordenadas del elemento posicionador especificado. Los patrones se clasifican según uno de los siguientes criterios: coordenada X, coordenada Y, ángulo, distancia angular, distancia o cuadrícula; los patrones clasificados y ordenados se devuelven en forma de una nueva estructura de datos Patterns.

## SortPatterns Entradas

Parámetro | Descripción
Patterns | Este argumento debe hacer referencia a una celda de la hoja de cálculo que contiene una estructura válida de datos Patterns devuelta por la función .
Número a clasificar | Especifica el número máximo (de 1 a 255; por defecto = 1) de patrones a clasificar.
Clasificar por | Especifica el método de clasificación.
0 = Y (por defecto) | Clasificación por distancia en Y en el sistema de coordenadas del elemento posicionador, de menor a mayor.
1 = X | Clasificación por distancia en X en el sistema de coordenadas del elemento posicionador, de menor a mayor.
2 = Ángulo | Clasificación por el ángulo (de 0 a 360 grados) medido en sentido antihorario desde el eje Y del sistema de coordenadas del elemento posicionador hasta el segmento de línea definido por el punto de respuesta de patrón y el origen del elemento posicionador, de más cercano a más lejano, en orden descendente.
3 = Distancia angular | Clasificación por valor absoluto del ángulo (de -180 a 180 grados) medido desde el eje X del sistema de coordenadas del elemento posicionador hasta el segmento de línea definido por el punto de respuesta de patrón y el origen del elemento posicionador, de más cercano a más lejano, en orden descendente.
4 = Distancia | Clasificación por distancia entre origen del elemento posicionador y el punto de respuesta de patrón, de más cercano a más lejano, en orden descendente.
5 = Cuadrícula Y | Clasificación por distancia en Y en el sistema de coordenadas del elemento posicionador y seguidamente por distancia en X, de más cercano a más lejano, en orden descendente. Nota: La función SortPatterns da #ERR si se selecciona Cuadrícula Y mientras la función hace referencia a una imagen calibrada en coordenadas mundo, como una proporcionada por las funciones CalibrateImage o TransPatternsToWorld. La opción Cuadrícula Y solo puede aplicarse a coordenadas de píxel.
6 = Cuadrícula X | Clasificación por distancia en X en el sistema de coordenadas del elemento posicionador y seguidamente por distancia en Y, de más cercano a más lejano, en orden descendente. Nota: La función SortPatterns da #ERR si se selecciona Cuadrícula Y mientras la función hace referencia a una imagen calibrada en coordenadas mundo, como una proporcionada por las funciones CalibrateImage o TransPatternsToWorld. La opción Cuadrícula Y solo puede aplicarse a coordenadas de píxel.
Fixture | Define el patrón referenciado con respecto al Fixture de entrada o al sistema de coordenadas de la imagen de salida proporcionada por una herramienta de Vision Tools. Si se establece que el patrón referenciado se define con respecto al elemento posicionador, se asegura que cualquier desplazamiento o rotación del elemento posicionador implicará el correspondiente desplazamiento o rotación del patrón con respecto al elemento posicionador. 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)
Tolerancia en la clasificación | Especifica el tanto por ciento en altura del patrón entrenado (del 1% al 500%; por defecto = 50%) que debe tener un patrón detectado para que sea incluido en el grupo de patrones al clasificar por cuadrícula X o por cuadrícula Y. Nota: Este parámetro se utiliza únicamente cuando la opción para el parámetro «Clasificar por» es Cuadrícula X o Cuadrícula Y.
Mostrar | Especifica el modo de visualización de los gráficos de SortPatterns sobre la imagen.
0 = ocultar todo (por defecto) | Se ocultarán todos los gráficos, excepto cuando la celda que contiene la función SortPatterns está seleccionada en la hoja de cálculo.
1 = solo gráficos de resultados | Se visualizará en todo momento 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, una cruz para cada patrón encontrado y las características coincidentes. Nota: Las características coincidentes se visualizarán únicamente en el caso de patrones entrenados con PatMax.

## SortPatterns Salidas

Devuelve | Una estructura de datos Patterns que contiene los puntos de respuesta de patrón clasificados o #ERR si alguno de los parámetros de entrada no es válido.
Resultados | Cuando se inserta inicialmente SortPatterns en una celda, se crea una tabla de resultados en la hoja de cálculo mediante las siguientes 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 porcentual con respecto al modelo original.
Score | GetScore(Patterns, Índice) | La puntuación de la respuesta al patrón.
Nota: Si el valor del parámetro Número a clasificar es mayor que cero, la SortPatterns insertará automáticamente una tabla de resultados que tiene como máximo las 10 entradas que corresponden a los 10 primeros patrones contenidos en la estructura de datos Patterns. Si desea que se visualicen más entradas, puede ampliar la tabla copiando la última fila y pegando adicionalmente la fila tantas veces como desee al final de la table; asegúrese de incrementar el número de índice de la(s) fila(s) recién pegada(s) para que se indexen adecuadamente los patrones.