> 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/detections-shapes/shape-analysis/minimum-circle.md).

# Minimum Circle

Ce bloc de fonction trouve et trace le plus petit cercle englobant autour d'une forme fournie (contour) et renvoie le centre et le rayon du cercle, ainsi qu'une image résultat annotée. Il est utile pour estimer la taille ou la position d'un objet, ou pour des mesures simples basées sur la forme.

## 📥 Entrées

`Image Any`\
L'image utilisée comme surface de dessin et référence visuelle pour le résultat. Une copie de cette image sera renvoyée avec le cercle détecté superposé.

`Contour`\
Une forme (contour) qui définit l'objet à englober. Cela provient généralement d'un bloc de détection de contours ou d'extraction de formes.

## 📤 Sorties

`Image`\
Une copie de l'image d'entrée avec le cercle minimum englobant tracé dessus.

`Center`\
La position du centre du cercle englobant (x, y). Utilisez cette valeur pour l'alignement, les mesures ou d'autres opérations géométriques.

`Radius`\
Le rayon du cercle englobant. Utile pour estimer la taille, définir des seuils ou déclencher une logique en aval.

## 🕹️ Contrôles

Ce bloc n'a pas de contrôles interactifs — fournissez simplement les entrées requises et il produira les sorties lors de l'exécution.

## ⚙️ Mécanisme d'exécution

Lors de l'exécution, le bloc accepte un contour et une image. Il calcule le plus petit cercle qui englobe complètement le contour, trace ce cercle sur une copie de l'image fournie, et renvoie l'image annotée ainsi que le centre et le rayon du cercle. Le bloc attend une entrée `Contour` valide ; si aucun contour n'est fourni, le résultat sera vide ou inchangé.

## 🎯 Fonctionnalités

* Produit une image résultat visuelle avec le cercle englobant tracé pour une vérification facile.
* Retourne des sorties géométriques numériques (`Center`, `Radius`) utilisables par d'autres blocs pour des mesures ou de la logique.
* Léger et rapide — adapté aux pipelines temps réel lorsque des contours sont disponibles.
* Fonctionne avec tout bloc produisant des contours ; aucun paramètre supplémentaire n'est requis.

## 📝 Utilisation

1. Fournissez un contour à l'entrée `Contour` — généralement le résultat d'un détecteur de contours ou d'un extracteur de formes.
2. Fournissez une image à l'entrée `Image Any` pour la visualisation.
3. Exécutez le scénario ; le bloc produira l'image annotée et les propriétés du cercle.

## 💡 Conseils et astuces

* Pour obtenir des contours, utilisez les blocs `Find Contour` ou `Find Object` avant ce bloc.
* Si le contour est irrégulier ou trop détaillé, utilisez `Approximate Contour` pour simplifier la forme avant de l'envoyer à ce bloc — cela peut donner un cercle englobant plus significatif pour des contours bruyants.
* Recadrez la zone d'intérêt avec `Image ROI Select` ou `Image ROI` pour accélérer le traitement et éviter les contours non pertinents.
* Prétraitez l'image avec `Blur` ou `Image Threshold` pour améliorer la qualité de détection des contours en amont.
* Visualisez ou annotez les résultats finaux avec `Draw Rectangle`, `Draw Result On Image`, ou envoyez le résultat à `Show Image` pour une fenêtre d'affichage plus grande.
* Utilisez les sorties numériques (`Center`, `Radius`) avec des blocs de mesure ou de logique (par exemple pour comparer des tailles, déclencher des alertes, ou stocker des valeurs).

## 🛠️ Dépannage

* Aucun cercle n'apparaît : vérifiez qu'un `Contour` valide est fourni. Utilisez un bloc producteur de contours tel que `Find Contour` et assurez-vous que le contour n'est pas vide.
* Le cercle semble trop grand ou trop petit : essayez de simplifier le contour avec `Approximate Contour` ou affinez la détection des contours en ajustant le prétraitement en amont (par ex. `Image Threshold`, `Blur`).
* Résultats inattendus sur des images bruyantes : recadrez la zone d'intérêt avec `Image ROI Select` et filtrez le bruit avant d'extraire les contours.