Background Subtractor

Ce bloc fonction détecte les régions en mouvement/avant-plan en comparant les images courantes à un modèle d'arrière-plan appris. Utilisez-le pour séparer les objets au premier plan (personnes, véhicules, pièces en mouvement) d'un arrière-plan stable et produire un masque avant-plan binaire/gris pour une analyse ultérieure.

📥 Inputs (sockets)

Input Image Accepte l'image d'entrée ou la trame vidéo à analyser (couleur ou niveau de gris).

📤 Outputs (sockets)

Foreground Mask Produit un masque en niveaux de gris/binaire où les pixels de premier plan sont mis en évidence.

🕹️ Controls

Method Choisissez l'algorithme de soustraction d'arrière-plan (par ex. MOG2 ou KNN) disponible dans la liste déroulante.

History Contrôle le nombre de trames passées utilisées pour construire le modèle d'arrière-plan. Des valeurs plus élevées rendent le modèle plus lent à s'adapter.

VarThreshold Contrôle la sensibilité aux changements de pixel. Des valeurs plus faibles rendent le soustracteur plus sensible aux petits changements ; des valeurs plus élevées le rendent moins sensible.

⚙️ Mécanisme d'exécution

À chaque exécution du bloc :

• Il utilise le Method sélectionné ainsi que les réglages courants de History / VarThreshold.

• Si les paramètres changent, le modèle d'arrière-plan interne est réinitialisé pour prendre en compte les nouveaux paramètres.

• Il traite l'Input Image et produit le Foreground Mask montrant les régions de premier plan détectées.

Ce masque est mis à jour image par image et peut être consommé par d'autres blocs pour le comptage, le suivi ou l'enregistrement.

🎯 Features

• Changement rapide d'algorithme via Method.

• Réglage des paramètres en temps réel avec les curseurs History et VarThreshold pour équilibrer vitesse d'adaptation et stabilité.

• Produit un masque de premier plan prêt à l'emploi pouvant être acheminé vers des blocs de détection ou d'analyse.

📝 Usage

1. Connectez un bloc producteur d'images (camera, video, ou load image) à Input Image.

2. Sélectionnez le Method souhaité et ajustez History et VarThreshold tout en observant les résultats.

3. Utilisez le Foreground Mask avec des blocs en aval pour la détection, le comptage ou la journalisation.

💡 Tips and Tricks

• Pour des résultats bruités, essayez d'abord de lisser l'entrée avec Blur ou de réduire le bruit haute fréquence avec Denoising avant d'alimenter ce bloc.

• Pour supprimer de petites taches dans le masque, ajoutez Morphological Transformations après ce bloc (opérations opening/closing).

• Si vous ne vous intéressez qu'à une zone spécifique, recadrez l'entrée avec Image ROI Select ou Image ROI avant la soustraction d'arrière-plan pour accélérer le traitement.

• Utilisez Show Image pour prévisualiser le Foreground Mask dans un visualiseur plus grand lors du réglage des paramètres.

• Pour une analyse au niveau des objets, alimentez le masque dans Blob Detector ou utilisez Find Contour pour extraire et mesurer les composants détectés.

• Pour annoter ou mettre en évidence les détections sur la trame originale, combinez avec Draw Detections ou Draw Rectangle en utilisant les coordonnées dérivées de l'analyse des contours/blobs.

• Si vos trames d'entrée sont très grandes, insérez Image Resizer pour réduire la taille d'abord et accélérer le traitement.

• Conservez des trames ou masques importants avec Image Logger ou Image Write lorsqu'une condition déclenchante se produit (par ex. le nombre de détections dépasse un seuil).

• Utilisez Image Memory pour figer une trame pour inspection pendant que le traitement en direct continue.

(les conseils ci‑dessus font uniquement référence à la liste des blocs disponibles)

🛠️ Troubleshooting

• Si le masque de premier plan est trop sensible (beaucoup de pixels qui scintillent), augmentez VarThreshold ou augmentez History pour que le modèle s'adapte plus lentement.

• Si les objets en mouvement ne sont pas détectés de manière fiable, diminuez VarThreshold ou réduisez le lissage préalable.

• Si le masque contient du bruit isolé, ajoutez Morphological Transformations (opening) ou appliquez Blur sur l'entrée.

• Si l'arrière-plan change fréquemment (éclairage, fond en mouvement), réduisez History pour que le modèle s'adapte plus vite, ou restreignez le traitement à une ROI stable avec Image ROI Select.

• Si vous ne voyez pas clairement le masque, utilisez Show Image pour l'ouvrir dans le visualiseur d'images pour une inspection plus fine.

🔗 Combinaisons de blocs recommandées

• Prétraitement : Blur → Background Subtractor → Morphological Transformations

• Détection ciblée : Image ROI Select → Background Subtractor → Blob Detector → Draw Detections

• Journalisation et revue : Background Subtractor → Show Image (prévisualisation) et Image Logger ou Image Write (sauvegarde de masques/trames)

• Post-analyse : Background Subtractor → Find Contour / Measure Object Distance → Data to JSON ou CSV Export

Ces combinaisons aident à construire des pipelines d'analyse vidéo fiables en utilisant les blocs disponibles.