> 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/transformation-filters/denoising.md).

# Denoising

Ce bloc fonction réduit le bruit dans les images en utilisant une méthode rapide de débruitage non-local (non-local means). Il fonctionne sur les images couleur et en niveaux de gris et propose des curseurs permettant de concilier suppression du bruit et conservation des détails.

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

`Image Any` Connectez une image (couleur ou niveaux de gris) que vous souhaitez débruiter.

(indice : il s'agit d'une prise d'entrée)

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

`Image Any` L'image débruitée est fournie ici.

(indice : il s'agit d'une prise de sortie)

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

`Strength` Ajuste la force générale du débruitage. Des valeurs plus élevées suppriment davantage de bruit mais peuvent estomper les détails fins.

`Averaging` Contrôle la puissance dissage utilisée pour lisser. L'augmentation peut réduire le bruit mais adoucir les contours.

`Blend Noise (Colored)` Ajuste le mélange des canaux de couleur pour les images en couleur. Sert à gérer la façon dont le bruit couleur est traité par rapport au bruit de luminance.

(indice : ce sont des curseurs interactifs visibles sur le bloc)

## ⚙️ Fonctionnement <a href="#how-it-works" id="how-it-works"></a>

* Lorsque le bloc reçoit une image via l'entrée `Image Any`, il applique les paramètres de débruitage sélectionnés et met à jour la sortie avec l'image traitée.
* Les paramètres sont lus depuis les curseurs à chaque exécution : modifier un curseur affectera l'évaluation suivante.
* Le bloc gère automatiquement les images mono-canal et multi-canal en sélectionnant le traitement approprié.

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

* Fonctionne pour les images en niveaux de gris et couleur.
* Réglage des paramètres en temps réel via des curseurs pour un retour visuel immédiat.
* Équilibre suppression du bruit / préservation des contours lorsqu'il est correctement réglé.

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

1. Connectez un bloc producteur d'images à l'entrée `Image Any`.
2. Réglez `Strength` pour contrôler l'agressivité du débruitage.
3. Affinez `Averaging` pour gérer l'équilibre lissage vs détails.
4. Pour les images couleur, ajustez `Blend Noise (Colored)` pour le débruitage spécifique aux couleurs.
5. Observez le résultat débruité depuis la sortie `Image Any` (connectez à un visualiseur ou un enregistreur).

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

* Pour des captures bruitées, essayez de combiner ce bloc avec `Bilateral Filter` ou `Blur` avant le débruitage afin de réduire le bruit impulsionnel et d'obtenir des résultats plus propres.
* Utilisez `Show Image` pour prévisualiser les résultats en direct pendant le réglage des curseurs.
* Pour sauvegarder des exemples à comparer plus tard, connectez la sortie à `Image Logger` ou `Image Write`.
* Si vous souhaitez garder une image stable pour la comparaison pendant les réglages, utilisez `Image Memory` pour figer une trame choisie.
* Recadrez d'abord la région d'intérêt avec `Image ROI Select` pour focaliser le débruitage uniquement là où c'est nécessaire et économiser des ressources.

(indice : les blocs complémentaires recommandés sont listés ci‑dessus pour des workflows courants)

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

* Si le résultat paraît trop lisse ou que des détails sont perdus : réduisez `Strength` et diminuez `Averaging`.
* Si des artefacts de couleur apparaissent après le débruitage : réduisez `Blend Noise (Colored)` ou essayez un prétraitement avec `Blur`.
* Si les performances sont lentes sur de grandes images : redimensionnez avec `Image Resizer` ou traitez des ROIs plus petites via `Image ROI Select`.

Si vous avez besoin d'un débogage visuel plus poussé pendant le réglage, connectez la sortie à `Show Image` pour inspecter les changements image par image.