# TrainPatMaxPattern

Extrae y entrena un patrón de una imagen para utilizarlo posteriormente con la función FindPatMaxPatterns.

## TrainPatMaxPattern Descripción general

Un patrón de PatMax® es una colección de características geométricas en la que cada característica es un punto en el límite entre dos regiones que se diferencian por tener píxeles de distinto valor. La TrainPatMaxPattern entrena un patrón y se utiliza posteriormente la función FindPatMaxPatterns para localizar un o más de un ejemplar de dicho patrón en una imagen. PatMax ofrece tres características clave que lo distinguen de otras tecnologías de localización de patrones disponibles para la visión artificial:

- Localización a alta velocidad de objetos cuya apariencia ha sufrido una rotación, un cambio de escala y/o un alargamiento
- Tecnología de localización que se basa en la forma del objeto, no en valores en escala de grises
- Muy alta precisión

PatMax se diferencia de otras tecnologías de localización de patrones en que no se basa en representaciones de píxeles en cuadrículas que tienen el inconveniente de no poder ser sometidos de manera eficaz y precisa a una rotación u operación de cambio de escala. En su lugar, PatMax utiliza una representación basada en características que se puede transformar de forma rápida y precisa para la concordancia de patrones.

Nota: Cuando se selecciona una celda que contiene un patrón entrenado de PatMax®, se visualizan las características del patrón. De este modo, el usuario puede ver el patrón entrenado sin tener que entrar en la hoja de propiedades de TrainPatMaxPattern, lo que además implica que se vuelve a entrenar el patrón.

## TrainPatMaxPattern 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 (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)
Región del patró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.
Nota: Los parámetros Elemento posicionador y Región deben estar definidos dentro de los límites de la imagen; de lo contrario, la función dará #ERR.
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.
Origen del patrón | Especifica las coordenadas X e Y del origen del patrón de entrenamiento, como dos componentes de desplazamiento con respeto al centro de la región de entrenamiento.
Desplazamiento X | Especifica el desplazamiento en X desde el centro del patrón entrenado.
Desplazamiento Y | Especifica el desplazamiento en Y desde el centro del patrón entrenado.
Ajustes para patrón | Especifica los ajustes para entrenar el patrón.
Algoritmo | Especifica el algoritmo a utilizar para entrenar el patrón.
0 = PatMax (por defecto) | 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.
Elasticidad | Especifica la magnitud de la desviación del perímetro (0 a 10; 0 = por defecto). 0 = Sin tolerancia 1 o mayor = Límite flexible
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 | Permitir características de coincidencia de color invertido.
Sensibilidad | 0 = No implementado
Granularidad gruesa | Especifica la granularidad gruesa, como valor de píxel. La granularidad gruesa se utiliza para encontrar características grandes con el fin de encontrar rápidamente una coincidencia de patrón aproximada en una imagen en tiempo de ejecución (0 a 10; 0 = por defecto). Nota: Si se especifica un valor menor que 1,0, se calcularán automáticamente los valores de los parámetros Granularidad gruesa y Granularidad fina.
Granularidad fina | Especifica la granularidad fina, como valor de píxel. La granularidad fina se utiliza para encontrar pequeñas características a fin de determinar con precisión la ubicación del patrón (0 a 10; 0 = por defecto). Nota: Si se especifica un valor menor que 1,0, se calcularán automáticamente los valores de los parámetros Granularidad gruesa y Granularidad fina. El valor de granularidad fina no debe ser mayor que el valor de granularidad gruesa.
Evento de entrenamiento | Especifica Referencias de celda a una celda que contiene un desencadenante del evento de entrenamiento de un modelo. Nota: El entrenamiento se produce cuando la hoja de propiedades está abierta o cuando un desencadenante del evento, como un botón u otra celda habilitada condicionalmente, es distinto de cero.
Reutilizar imagen de entrenamiento | Especifica si la imagen utilizada para entrenar el patrón ha de guardarse o no cuando se modifican los parámetros de «Ajuste para patrón».
0 = DESACTIVADO (por defecto) | La imagen actual (es decir, la imagen especificada en el parámetro Imagen) se utilizará para entrenar/reentrenar el patrón.
1 = Activado | La imagen que se utilizó inicialmente para entrenar el patrón se utilizará otra vez para volver a entrenar el patrón en el caso de que se modifique alguno de los parámetros de «Ajustes para patrón». Cuando se habilita por primera vez, se utilizará la imagen identificada por el parámetro Imagen para entrenar el patrón y se guardará una copia de la imagen en la tarea. Cualquier modificación que se realice posteriormente en los parámetros de «Ajustes para patrón» se realizará utilizando la imagen almacenada. Nota: Cuando este parámetro está habilitado, si se modifica el elemento posicionador entrado, se desplaza o modifica «Región de patrón» (o «Región externa»), la función ajustará la región de entrenamiento en la imagen de entrada, guardará la nueva imagen y volverá a entrenar el patrón. Si el parámetro «Reutilizar imagen de entrenamiento» está en ON (habilitado), pero no se ha entrenado aún un patrón, la función dará #ERR hasta que el parámetro se haya puesto en OFF (deshabilitado) y se haya entrenado un nuevo patrón.
Tiempo de espera | Especifica la duración del periodo de tiempo, en milisegundos (0 a 30000), durante el cual la función buscará un patrón válido y tras el cual se detiene la ejecución de la función y emite un #ERR. Si este parámetro se pone a 0, este se deshabilita y no se implementará el tiempo de espera.
Mostrar | Especifica el modo de visualización de los gráficos de TrainPatMaxPattern sobre la imagen.
0 = ocultar todo | Se ocultarán todos los gráficos, excepto cuando la celda que contiene la función TrainPatMaxPattern está seleccionada en la hoja de cálculo.
1 = solo gráficos de resultados | Se visualizarán en todo momento las características entrenadas del patrón.
2 = gráficos de entrada y resultado | Se visualizarán en todo momento la región de la imagen de entrada, el origen del patrón y las características entrenadas. Nota: El color de una característica entrenada (verde, amarillo o rojo) indica la calidad de la característica candidata a concordancia. El verde representa alta calidad; el rojo representa poca calidad. Los parámetros de granularidad deben ajustarse hasta que todas las características entrenadas se muestren en verde o hasta que se elija una imagen mejor para entrenar. Características distintivas (bordes) y un buen contraste de imagen proporcionan los mejores resultados.
3 = mostrar todo: entrada, resultado e imagen de entrenamiento | Se visualizarán en todo momento la región de la imagen de entrada, el origen del patrón, las características entrenadas y la imagen de entrenamiento.

## TrainPatMaxPattern Salidas

Devuelve | Una estructura de datos Patterns que contiene el patrón entrenado, o #ERR si alguno de los parámetros de entrada no es válido.
Resultados | Cuando se inserta inicialmente la TrainPatMaxPattern en una celda, se visualiza automáticamente el estado de entrenamiento en la celda adyacente de la derecha. Si no se puede entrenar un patrón, se insertará #ERR. Se inserta automáticamente una Patterns Vision Data Access functions en la hoja de cálculo:
Trained | GetTrained(Patterns) | Devuelve 1 si se ha podido entrenar correctamente el patrón o 0 si no se ha podido entrenar un patrón.
Nota: Mientras se está en la hoja de propiedades de la función, se proporcionan cadenas de información suplementaria que presentan sugerencias para mejorar el entrenamiento de un patrón. Posibles informaciones presentadas por las cadenas son: Es posible que el patrón contenga muy pocas características coincidentes. Hay dificultades para configurar automáticamente la granularidad de las características; configure manualmente la Granularidad. Es posible que el patrón sea menos preciso de lo esperado debido a que parece que la imagen de entrenamiento es algo borrosa. Los resultados del patrón pueden ser inestables debido a que las características gruesas tienen la misma dirección. Puede que aumente el tiempo de ejecución debido a numerosas características finas; configure manualmente la Granularidad. Es posible que el patrón contenga información insuficiente como para medir con fiabilidad el Ángulo o la Escala. Para insertar cadenas de información en la hoja de cálculo, utilice la función GetInfoString del conjunto Vision Data Access.