For the complete documentation index, see llms.txt. This page is also available as Markdown.

Social Distance Detector

Ce bloc fonctionnel analyse un flux d'images pour détecter des personnes et vérifier le respect des distances physiques selon un seuil donné. Il visualise les personnes détectées et met en évidence les paires qui enfreignent la distance spécifiée.

📥 Inputs

Image Any Fournissez l'image ou la trame vidéo à analyser.

Perspective Matrix Matrice de transformation optionnelle pour convertir les coordonnées image vers un plan réel afin d'obtenir des mesures de distance plus précises.

Distance Threshold Distance minimale autorisée entre personnes (les unités dépendent de la calibration de la perspective).

📤 Outputs

Image Any Image annotée avec les personnes détectées, les lignes de connexion et les mises en évidence des infractions.

Person Count Nombre de personnes détectées dans la trame.

Violation Count Nombre de paires en infraction (paires plus proches que le seuil).

Is Violated ? Booléen indiquant s'il existe au moins une infraction.

🕹️ Controls

Confidence Ratio Curseur qui ajuste la sensibilité de confiance de la détection. Des valeurs plus élevées nécessitent une confiance plus forte pour qu'un élément soit considéré comme personne.

🎨 Features

  • Détection de personnes en temps réel et visualisation sur les images entrantes.

  • Mesure des distances paire-à-paire entre personnes détectées.

  • Correction de perspective optionnelle via la Perspective Matrix fournie pour des contrôles de distance en valeurs réelles plus précis.

  • Sorties claires pour la surveillance et le traitement en aval : image, comptages et indicateur d'infraction.

📊 Mécanisme d'exécution

Lorsque le bloc est actif, il reçoit l'entrée Image Any, détecte les positions des personnes dans la trame, optionnellement mappe ces positions à l'aide de la Perspective Matrix fournie, calcule les distances paire-à-paire et les compare au Distance Threshold. Le bloc renvoie une image annotée ainsi que des sorties numériques/booléennes décrivant l'état des détections et des infractions.

📝 How to use

  1. Fournissez une source d'image à Image Any (flux caméra ou image chargée).

  2. Si vous avez besoin de distances réelles, fournissez une Perspective Matrix calibrée. Sans elle, les vérifications de distance utilisent des unités du plan image (pixels).

  3. Définissez le Distance Threshold souhaité selon votre calibration ou une estimation en pixels.

  4. Ajustez le Confidence Ratio pour équilibrer détections manquées et faux positifs.

  5. Lisez les sorties pour déclencher alertes, journaux ou traitements supplémentaires lorsqu'une infraction est détectée.

💡 Tips and Tricks

  • Pour une entrée caméra, combinez ce bloc avec une source d'image comme Camera USB, Camera IP (ONVIF), Stream Reader ou Load Image.

  • Pour prévisualiser les résultats en grand, ajoutez Show Image après ce bloc.

  • Si la détection est bruyante, essayez de redimensionner ou de débruiter l'image en amont avec Image Resizer ou Denoising pour améliorer la stabilité.

  • Pour une détection de personnes plus robuste ou des classes personnalisées, pensez à combiner en amont avec Object Detection ou Object Detection - Custom et à fournir les centres détectés à ce bloc pour le contrôle de distance.

  • Utilisez Perspective Transform pour produire une Perspective Matrix fiable lorsque vous avez besoin de distances en unités réelles.

  • Limitez la zone d'analyse avec Image ROI ou Image ROI Select pour réduire les fausses détections et accélérer le traitement.

  • Pour un suivi entre trames, placez Object_Detection_Tracker en aval pour obtenir des IDs persistants et de meilleures analyses.

🛠️ Troubleshooting

  • Aucune personne détectée : augmentez légèrement le Confidence Ratio ou fournissez une entrée en plus haute résolution. Vérifiez l'éclairage de la scène pour obtenir des contours de personnes nets.

  • Trop de faux positifs : essayez d'augmenter le Confidence Ratio, appliquez un prétraitement (Blur, Image Threshold) ou restreignez la zone avec Image ROI.

  • Mesures de distance incorrectes : vérifiez la calibration et fournissez une Perspective Matrix correcte via Perspective Transform. Sans correction de perspective, les distances sont en pixels et peuvent ne pas refléter les valeurs réelles.

  • Charge CPU/GPU élevée : réduisez la résolution d'entrée avec Image Resizer ou exécutez la détection moins fréquemment.

Mis à jour