# Calibrate

À l’aide d’un nombre déterminé (maximum 32) de points choisis par l’utilisateur, la fonction Calibrate crée une transformation 2D pour effectuer une conversion entre les systèmes de coordonnées réelles et de pixels.

## À propos de Calibrate

La fonction Calibrate nécessite des points choisis par l’utilisateur, exprimés dans deux systèmes de coordonnées différents : Le système de coordonnées physiques réelles de l’objet, et les coordonnées de pixels de l’image de l’objet. Pour extraire les caractéristiques d’une image, la fonction Calibrate nécessite un Outils de vision. La fonction Calibrate utilise l’emplacement des caractéristiques sous forme de coordonnées réelles et de pixels.

Pendant la phase de calibration, la fonction acquiert une image qui contient des caractéristiques dont l’emplacement est connu en coordonnées réelles. Pour repérer et indiquer les caractéristiques d’une image en coordonnées de pixels, la fonction utilise des outils de vision tels que ou FindLine.

Remarque : L’origine des coordonnées de pixels est toujours le coin supérieur gauche du pixel supérieur gauche.

Dans la phase suivante, la fonction Calibrate entre les coordonnées de pixels et les coordonnées réelles respectivement pour les paramètres Point pixel et Point réel. Pour les coordonnées du point de pixel, la fonction Calibrate utilise Références à des cellules comme valeurs X et Y de l’outil de vision. Pour les coordonnées du point réel, la fonction Calibrate utilise une valeur numérique. La fonction calcule la transformation 2D entre les coordonnées réelles et de pixels pour créer une structure Calib qui représente la transformation.

Vous pouvez également utiliser la fonction Calibrate pour réaliser les transformations suivantes :

- la translation en deux dimensions,
- la rotation autour de trois axes,
- l’échelle en deux dimensions,
- la déformation de perspective,
- la torsion ou le parallélogramme.

Remarque : Si vous utilisez la fonction Calibrate, la configuration physique et optique (objectif, capteur et relation physique entre le capteur et la scène) doit être identique pour la calibration et l’opération exécutable. Si vous modifiez l’un de ces éléments, vous devez recalibrer le système. Il est recommandé d’utiliser les mêmes capteur et objectif pour la calibration et le traitement des images obtenues en cours d’exécution. Les paramètres de configuration et de calibration d’origines du capteur et de l’objectif doivent également être conservés. Par exemple, tout modification de la résolution ou tout déplacement du capteur rend invalide la conversion 2D calculée qui associe les pixels à des coordonnées réelles.

## Calibrate – entrées

Entrée | Description
--- | ---
Point pixel, 0 à N | Indique les coordonnées de pixels de l’association pixel/point réel.
X | Abscisse de l’image.
Y | Ordonnées de l’image.
Point réel, 0 à N | Indique les coordonnées réelles de l’association pixel/point réel.
X | Abscisse, comme valeur réelle.
Y | Ordonnée, comme valeur réelle.

## Calibrate – Sorties

Renvoie | Une structure de données Calib contenant les coefficients qui définissent la transformation entre deux systèmes de coordonnées.