> 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/detectors/find-object.md).

# Find Object

Ce bloc fonction aide à localiser une image modèle plus petite à l'intérieur d'une image plus grande en utilisant des méthodes d'appariement sélectionnables et un curseur de sensibilité réglable. Il fournit un retour visuel et des sorties de position détaillées pour faciliter l'inspection, le comptage et le traitement ultérieur.

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

Ce bloc accepte les connexions d'entrée suivantes :

* `Main Image` : Image dans laquelle la recherche de l'objet sera effectuée.
* `Object Image` : Image modèle (unique ou liste) de l'objet à trouver.

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

Ce bloc fournit les sorties suivantes :

* `Image Any` : Résultat visuel où les correspondances détectées peuvent être mises en évidence.
* `Object Positions` : Coordonnées des centres des objets détectés (multiples).
* `Object Count` : Nombre d'objets détectés.
* `Rectangle Coordinates` : Rectangles englobants pour chaque objet détecté (multiples).

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

* `Method` : Choisissez l'algorithme de template matching à utiliser parmi la liste des méthodes disponibles.
* `Match Threshold %` : Ajustez le curseur pour contrôler la rigueur de l'appariement. Des valeurs élevées réduisent les faux positifs mais peuvent manquer des correspondances faibles.
* `Result` : Affiche rapidement le nombre d'objets détectés.

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

* Superposition visuelle des détections sur l'image d'entrée pour une vérification rapide.
* Plusieurs sorties fournissant à la fois des résultats visuels et numériques pour le traitement en aval.
* Fonctionne avec un seul modèle ou une liste de modèles pour trouver la meilleure correspondance disponible.

## 📝 Comment l'utiliser <a href="#usage" id="usage"></a>

1. Fournissez une image source sur l'entrée `Main Image`.
2. Fournissez un modèle ou une liste de modèles sur l'entrée `Object Image`.
3. Sélectionnez une `Method` adaptée aux caractéristiques de la scène et du modèle.
4. Réglez le curseur `Match Threshold %` jusqu'à obtenir la précision de détection souhaitée.
5. Contrôlez les résultats via la sortie visuelle et les sorties numériques.

## ⚙️ Que se passe-t-il à l'exécution <a href="#evaluation" id="evaluation"></a>

À l'exécution, le bloc recherche dans la `Main Image` les régions correspondant à la `Object Image` selon la `Method` et le `Match Threshold %` sélectionnés. Il renvoie une visualisation, les positions centrales des détections, leur nombre et les rectangles englobants.

## 💡 Astuces et conseils <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Pour réduire les faux positifs dans des images bruitées, appliquez `Blur` ou `Denoising` avant ce bloc.
* Si les tailles des modèles et de l'image principale diffèrent, utilisez `Image Resize` pour standardiser les tailles.
* Pour cibler la recherche sur une zone spécifique, recadrez d'abord avec `Image ROI Select` et branchez l'image recadrée.
* Après détection, utilisez `Rectangles in Rectangle` pour filtrer les détections en dehors d'une zone d'intérêt.
* Visualisez et vérifiez les détections avec le bloc `Show Image` pour confirmer les résultats de manière interactive.
* Sauvegardez des images intéressantes ou des échecs avec `Image Logger` ou `Image Write` pour audit et réglages.
* Pour des scènes complexes ou de nombreuses classes d'objets, envisagez d'associer `Object Detection` ou `Object Detection - Custom` lorsque le template matching devient peu fiable.

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

* Si aucun objet n'est trouvé, essayez de baisser le `Match Threshold %` ou d'améliorer le contraste du modèle avec des prétraitements comme `Contrast Optimization` ou `Adjust Colors`.
* Si de nombreux faux positifs apparaissent, augmentez le `Match Threshold %` et songez à filtrer l'image avec `HSV Filter` ou `Image Threshold` pour mettre l'objet en évidence.
* Si les résultats varient d'une image à l'autre, assurez-vous que les modèles sont cohérents avec l'apparence attendue (échelle, rotation, illumination) ou utilisez plusieurs modèles via la liste `Object Image`.