> 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/analysis/std-of-image.md).

# Std. of Image

Ce bloc fonction calcule l'écart type des valeurs de pixels d'une image (plage 0–255) et affiche le résultat dans son interface. Il est utile pour évaluer le contraste de l'image, le niveau de bruit ou la variation globale de luminosité.

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

`Image Any`\
Ce port d'entrée accepte n'importe quelle image (niveaux de gris ou couleur). Fournissez l'image que vous souhaitez analyser.

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

`Standard Deviation`\
Ce port de sortie fournit une seule valeur numérique : l'écart type des valeurs des pixels de l'image.

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

Ce bloc n'a pas de contrôles interactifs. Il met à jour la valeur affichée automatiquement dès qu'une image est fournie en entrée.

## 🎯 Caractéristiques <a href="#features" id="features"></a>

* Retour numérique rapide sur la variabilité de l'image (contraste / bruit).
* Mise à jour en temps réel de la valeur affichée lorsque vous fournissez une nouvelle image.
* Fonctionne avec des images en niveaux de gris et en couleur (produit un seul nombre récapitulatif).

## 📝 Utilisation <a href="#usage" id="usage"></a>

1. Connectez un bloc produisant une image à l'entrée `Image Any`. Exemples : `Camera USB`, `Load Image` ou `Video`.
2. Lisez la valeur calculée depuis la sortie `Standard Deviation` ou depuis l'étiquette affichée du bloc.
3. Utilisez cette valeur pour déclencher une logique, un enregistrement ou une visualisation (par exemple avertir si l'image est trop uniforme ou trop bruitée).

## ⚙️ Évaluation <a href="#evaluation" id="evaluation"></a>

Lorsque le scénario s'exécute et qu'une image arrive en entrée, le bloc calcule l'écart type des intensités des pixels et fournit le résultat numérique tout en mettant à jour son affichage.

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

* Pour obtenir des statistiques plus précises sur une zone spécifique, recadrez d'abord avec `Image ROI` ou `Image ROI Select` et fournissez l'image recadrée à ce bloc.
* Pour réduire l'impact du bruit avant la mesure, prétraitez avec `Blur` ou `Denoising` puis mesurez l'écart type.
* Comparez cette valeur avec `Mean Value of Image` pour mieux comprendre le contraste par rapport à la luminosité globale.
* Lors de l'analyse de nombreuses images ou pour surveiller des tendances, connectez la sortie à `Scope` pour un tracé en temps réel ou à `Image Logger` / `CSV Export` pour l'enregistrement.
* Si l'image est volumineuse et que vous n'avez besoin que d'une estimation rapide, réduisez-la avec `Image Resizer` avant de l'envoyer à ce bloc pour accélérer le traitement.
* Combinez avec `Image Resolution and Channel Value` ou `Non-zero of Image` pour ajouter des vérifications contextuelles (ex. : s'assurer que l'image a les canaux ou le contenu attendus avant de se fier à la statistique).

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

* Aucune valeur affichée : vérifiez qu'un bloc en amont envoie une image valide vers `Image Any`.
* Valeur anormalement basse ou élevée : confirmez que vous mesurez la région souhaitée (utilisez `Image ROI`) et envisagez un prétraitement avec `Blur` ou `Denoising` pour supprimer le bruit du capteur ou les artefacts de compression.
* Inspection visuelle : connectez la même source d'image à `Show Image` pour prévisualiser l'image tout en vérifiant la statistique.