> 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/non-zero-of-image.md).

# Non-zero of Image

Ce bloc retourne le nombre total de pixels non nuls trouvés dans une image. Il est utile pour des mesures rapides comme le comptage de pixels de premier plan, les vérifications d'occupation ou la validation de la couverture d'un masque.

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

`Image Any` Fournissez l'image à analyser. Le bloc accepte des images en couleur ou en niveaux de gris.

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

`Count` Nombre total de pixels non nuls détectés dans l'image fournie.

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

Ce bloc n'a pas de contrôles visibles pour l'utilisateur. Il s'exécute automatiquement lorsqu'une image est fournie.

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

* Résultat unique et rapide, utile pour des analyses simples et la prise de décision.
* Accepte les images couleur et niveaux de gris (les images couleur sont interprétées en interne pour l'activité des pixels).
* Idéal comme métrique légère pour les masques, résultats binaires ou la détection de premier plan.

## ⚙️ Principe de fonctionnement <a href="#how-it-works" id="how-it-works"></a>

Lors de l'évaluation, le bloc examine l'image fournie et compte les pixels non nuls (c'est‑à‑dire contenant de l'information utile/de premier plan). Le résultat est renvoyé sous la forme d'une valeur numérique unique via la sortie `Count`.

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

1. Connectez un bloc producteur d'image à l'entrée `Image Any`.
2. Lisez la valeur numérique sur la sortie `Count` pour piloter de la logique, des enregistrements ou des alarmes.
3. Combinez avec d'autres blocs pour le pré‑traitement, la visualisation ou la prise de décision.

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

* Préparez un masque binaire clair avant le comptage en utilisant `Image Threshold` ou `Image Adaptive Threshold` pour réduire les faux positifs dus au bruit.
* Utilisez `Image ROI` ou `Image ROI Select` pour limiter la zone de comptage à une région d'intérêt (mesures localisées).
* Réduisez le bruit avec `Blur`, `Bilateral Filter` ou `Denoising` avant le comptage pour éviter des résultats surestimés.
* Visualisez ce qui est compté en envoyant la même image vers `Show Image` ou en superposant les résultats avec `Draw Result On Image` / `Write Text On Image`.
* Enregistrez les résultats numériques dans le temps avec `CSV Export` ou `Data to JSON` pour analyser les tendances ou garder un historique.
* Combinez avec `Logic Input` ou des blocs de comparaison pour déclencher des actions lorsque le comptage dépasse un seuil.

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

* Comptages anormalement élevés : vérifiez la présence de bruit ou de pixels parasites. Appliquez `Image Threshold` et des filtres de lissage pour nettoyer l'entrée.
* Zéros ou comptages très bas : assurez‑vous que l'image en amont est valide avec `Show Image` et que la zone d'intérêt contient le premier plan attendu.
* Variations inattendues entre images : restreignez la zone avec `Image ROI` ou stabilisez l'entrée à l'aide de filtres pour réduire la variation d'une image à l'autre.