# Calibrate

A partir de 32 puntos especificados por el usuario, la función Calibrate crea una transformación 2D que permite conversiones entre el sistema de coordenadas de píxel y el sistema de coordenadas mundo.

## Acerca de Calibrate

La función Calibrate requiere puntos especificados por el usuario, expresados en dos sistemas de coordenadas diferentes: El sistema de coordenadas del espacio físico real (mundo), en el que se encuentra el objeto cuya imagen ha sido capturada, y el sistema de coordenadas de los píxeles de la imagen del objeto. Para extraer características de una imagen, la función Calibrate requiere Vision Tools. La función Calibrate entra la ubicación de las características expresándola tanto en coordenadas mundo como en coordenadas de píxel.

Durante la fase de calibración, la función captura una imagen que contiene características en ubicaciones bien conocidas en el sistema de coordenadas mundo. Para localizar y comunicar características de una imagen expresadas en coordenadas de píxel, la función utiliza herramientas de visión como o FindLine.

Nota: El origen del sistema de coordenadas de píxel se sitúa siempre en la esquina superior izquierda del píxel superior izquierdo.

En la siguiente fase, la función Calibrate introduce las coordenadas de píxel y las coordenadas mundo como parámetros de «Punto de píxel» y «Punto mundo». En el caso de las coordenadas de «Punto de píxel», la función Calibrate utiliza Referencias de celda para los valores X e Y de la herramienta de visión. En el caso de las coordenadas de «Punto mundo», la función Calibrate entra un valor numérico. A continuación, la función calcula la transformación en 2D entre el sistema de coordenadas de píxel y el de mundo, generando una estructura Calib que representa la transformación.

La función Calibrate se puede utilizar también para realizar las siguientes transformaciones:

- Traslación en dos dimensiones
- Rotación en torno a tres ejes
- Cambio de escala en dos dimensiones
- Distorsión de perspectiva
- Transformación oblicua

Nota: Cuando se utiliza una función Calibrate, los componentes ópticos y su disposición (lente, sensor, distancia entre sensor y escena que se captura) utilizados durante la calibración deben ser los mismos que los que se utilizan durante el funcionamiento del equipo. Si se modifica alguno de estos elementos, hay que volver a calibrar el sistema. Se recomienda que utilice el mismo sensor y el mismo objetivo para la calibración y durante todo el tiempo de procesamiento de imágenes. El sensor y el objetivo deben conservar también la disposición y los ajustes de calibración originales. Por ejemplo, si se modifica la resolución o se desplaza el sensor, deja de ser válida la transformación en 2D que asocia píxeles con coordenadas mundo.

## Calibrate Entradas

Entrada | Descripción
--- | ---
Punto píxel 0 a N | Especifica las coordenadas de píxel de una asociación píxel-mundo.
X | La coordenada X de imagen.
Y | La coordenada Y de imagen.
Punto mundo 0 a N | Especifica las coordenadas mundo de una asociación píxel-mundo.
X | La coordenada del eje X en el espacio físico mundo.
Y | La coordenada del eje Y en el espacio físico mundo.

## Calibrate Salidas

Devuelve | Una estructura de datos Calib que contiene los coeficientes que definen la transformación entre los dos sistemas de coordenadas.