# Calibration

À l’aide de quatre points choisis par l’utilisateur, la fonction Calibration crée une transformation 2D pour effectuer une conversion entre les systèmes de coordonnées réelles et de pixels.

## À propos de Calibration

La fonction Calibration 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 capturé, et les coordonnées de pixels de l’image de l’objet. Pour ce faire, la fonction Calibration nécessite l’extraction de caractéristiques d’une image à l’aide d’un Outils de vision. Ensuite, ces emplacements de caractéristiques sont entrés sous forme de coordonnées réelles et de pixels.

Pendant la phase de calibration, l’image obtenue contient des caractéristiques dont l’emplacement est connu avec des coordonnées réelles. À l’aide d’un outil de vision, FindLine par exemple, les caractéristiques de l’image sont repérées et rapportées en coordonnées de pixels.

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

Ensuite, les coordonnées de pixels et réelles sont entrées comme paramètres de point pixel et de point réel : dans le premier cas, on utilise des Références à des cellules avec les valeurs X et Y d’un outil de vision, tandis que dans le second cas, une valeur numérique est entrée pour exprimer les coordonnées réelles. L’outil calcule ensuite la transformation 2D entre les coordonnées réelles et de pixels pour créer une structure Calibration qui représente la transformation.

Calibration prend également en compte les transformations suivantes :

- – la translation en deux dimensions ;
- – la rotation autour de trois axes ;
- – l’échelle en deux dimensions ;
- – la distorsion de perspective ;
- – la torsion ou le parallélogramme.

Remarque : Si vous utilisez la fonction Calibration, la configuration physique et optique (objectif, capteur et relation physique entre le capteur et la scène obtenue) doit être identique pour la calibration et l’opération exécutable. Si l’un de ces éléments est modifié, le système doit être recalibré. Il est donc recommandé d’utiliser le même capteur et le même 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, toute modification apportée au format d’acquisition (en changeant 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.

## Calibration – 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.

## Calibration – Sorties

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