> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/french/function-blocks/blocks-reference/image-transformations/operations/polar-transform.md).

# Polar Transform

Ce bloc fonction convertit une zone d’image rectangulaire (cartésienne) en une représentation polaire linéaire. Utilisez-le pour dérouler des caractéristiques circulaires ou radiales (par exemple : anneaux, roues ou joints circulaires) afin qu’elles deviennent plus faciles à analyser avec des outils linéaires.

## 📥 Entrées <a href="#inputs" id="inputs"></a>

`Image Any` Image d’entrée à transformer. (socket: input)

`Center_X` Coordonnée horizontale du centre de la transformation. Si laissée vide, le bloc utilisera le centre de l’image. (socket: input)

`Center_Y` Coordonnée verticale du centre de la transformation. Si laissée vide, le bloc utilisera le centre de l’image. (socket: input)

`Max Radius` Rayon maximal à utiliser pour la transformation. Si laissé vide, le bloc choisira un rayon qui couvre la zone d’image. (socket: input)

## 📤 Sorties <a href="#outputs" id="outputs"></a>

`Image Any` Image résultante transformée en polaire linéaire. (socket: output)

## 🕹️ Contrôles <a href="#controls" id="controls"></a>

Le bloc n’a pas de widgets d’interface supplémentaires ; les trois entrées numériques servent de paramètres que vous pouvez alimenter depuis d’autres blocs ou manuellement :

`Center_X` Centre horizontal utilisé pour le remappage polaire. Ajustez pour déplacer le centre de la transformation vers la gauche/droite.

`Center_Y` Centre vertical utilisé pour le remappage polaire. Ajustez pour déplacer le centre de la transformation vers le haut/bas.

`Max Radius` Limite jusqu’où la transformation s’étend depuis le centre. Des valeurs plus petites rognent l’étendue radiale ; des valeurs plus grandes incluent une plus grande partie de l’image.

## ⚙️ Mécanisme d’exécution <a href="#running-mechanism" id="running-mechanism"></a>

Lorsque le bloc est exécuté, il lit l’image et les entrées numériques fournies, calcule un remappage linéaire-vers-polaire centré sur les coordonnées spécifiées, puis renvoie l’image déroulée. Si les coordonnées du centre ou le rayon ne sont pas fournis, le bloc utilise des valeurs par défaut raisonnables pour que la transformation s’exécute quand même.

## 🎯 Fonctionnalités <a href="#features" id="features"></a>

* Déroule les structures circulaires ou radiales en une vue rectangulaire pour une inspection facilitée.
* Accepte des paramètres numériques optionnels pour verrouiller précisément le centre et le rayon.
* Fonctionne avec n’importe quel bloc produisant une image en sortie.

## 📝 Instructions d’utilisation <a href="#usage" id="usage"></a>

1. Fournissez une image à l’entrée `Image Any`.
2. Facultatif : envoyez des nombres à `Center_X` et `Center_Y` pour définir le centre de la transformation (ou laissez vide pour utiliser le centre de l’image).
3. Facultatif : envoyez un nombre à `Max Radius` pour limiter l’étendue radiale.
4. Utilisez la sortie transformée `Image Any` pour des analyses ou visualisations ultérieures.

## 💡 Conseils et astuces <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Pour cibler une zone précise, recadrez d’abord avec `Image ROI` ou `Image ROI Select` puis alimentez ce recadrage dans ce bloc.
* Si votre image est très grande et que vous souhaitez un traitement plus rapide, utilisez `Image Resize` avant ce bloc pour réduire l’échelle tout en conservant la zone d’intérêt.
* Si la caractéristique circulaire est tournée, alignez-la d’abord avec `Rotate Image Angle` ou `Image AutoRotator` pour que le résultat déroulé soit plus lisible.
* Après déroulage, utilisez des blocs d’analyse comme `Histogram On Line` pour examiner les profils d’intensité dans la direction radiale ou angulaire.
* Pour inspecter visuellement le résultat, connectez la sortie à `Show Image` pour un aperçu interactif pendant le développement.
* Pour rechercher des objets autour d’un anneau, alimentez l’image transformée dans des blocs de détection comme `Find Object` afin de simplifier la localisation de motifs répétitifs.

(Conseil : combinez les blocs ci-dessus pour construire des chaînes d’inspection robustes pour pièces circulaires, joints ou textures en anneau)

## 🛠️ Dépannage <a href="#troubleshooting" id="troubleshooting"></a>

* Si l’image déroulée semble décalée ou déformée, vérifiez `Center_X` et `Center_Y` et ajustez-les pour correspondre au vrai centre de la caractéristique circulaire.
* Si des parties du cercle sont manquantes, augmentez `Max Radius` ou recadrez différemment l’entrée avec `Image ROI` pour inclure l’ensemble de la caractéristique dans le rayon de transformation.
* Si la sortie paraît étirée ou de faible détail, essayez de réduire la taille d’entrée avec `Image Resize` ou d’améliorer la résolution de capture avant la transformation.
* Si aucune sortie n’apparaît, confirmez que la prise d’entrée nommée `Image Any` reçoit des données d’image valides (utilisez `Show Image` pour vérifier).