Subsystem

Ce bloc de fonction agit comme un conteneur de workflow autonome. Utilisez-le pour regrouper des étapes de traitement liées dans un espace de travail séparé et modifiable afin que les scénarios complexes restent organisés et plus faciles à gérer.

📥 Entrées

No default inputs Ce bloc ne déclare pas d'entrées par lui‑même. Les entrées peuvent être créées en ajoutant des prises d'entrée à l'intérieur de l'espace de travail du sous‑système et en les exposant sur la bordure du bloc.

📤 Sorties

No default outputs Ce bloc ne déclare pas de sorties par lui‑même. Les sorties sont définies par les blocs enfants placés à l'intérieur du sous‑système et exposées comme sorties du sous‑système.

🕹️ Contrôles

Open Subsystem Editor Ouvre l'espace de travail du sous‑système pour ajouter ou modifier le workflow contenu. (Généralement disponible par double‑clic sur le bloc ou via le menu contextuel du bloc.)

Expose Input Crée une prise d'entrée à l'intérieur du sous‑système et l'expose sur la bordure du bloc pour que le flux parent puisse fournir des données.

Expose Output Crée une prise de sortie à l'intérieur du sous‑système et l'expose sur la bordure du bloc pour renvoyer les résultats au flux principal.

Run / Debug Inside Exécute et débogue le workflow contenu indépendamment du scénario principal pour valider son comportement.

🎯 Principales fonctionnalités

• Encapsulation : regroupez les étapes de prétraitement, détection, suivi et export en une seule unité réutilisable.

• Espace de travail local : le sous‑système dispose de sa propre toile modifiable pour concevoir un comportement complexe sans encombrer le flux principal.

• Frontières claires : exposez uniquement les entrées et sorties nécessaires, en gardant le graphe principal simple.

• Tests isolés : ouvrez et exécutez l'espace de travail du sous‑système pour déboguer ou valider les sous‑flux indépendamment.

• Réutilisabilité : créez un sous‑système testé une fois, puis réutilisez‑le dans plusieurs projets.

⚙️ Fonctionnement

• Lorsque le scénario s'exécute, le sous‑système exécute son workflow interne.

• Les données entrent dans le sous‑système via les prises d'entrée que vous avez exposées à l'intérieur.

• Les blocs enfants à l'intérieur du sous‑système calculent leurs résultats en séquence.

• Les sorties exposées à l'intérieur du sous‑système sont récupérées et renvoyées au flux parent comme sorties du bloc.

• Si un bloc enfant signale une erreur ou un état invalide, le sous‑système reflétera ce statut afin que vous puissiez localiser et corriger le problème dans l'espace de travail.

📝 Guide d'utilisation

1. Ajoutez un bloc Subsystem à votre flux principal pour contenir une séquence complexe (acquisition → traitement → export).

2. Ouvrez l'espace de travail du sous‑système (Open Subsystem Editor) et ajoutez les blocs nécessaires.

3. À l'intérieur du sous‑système, exposez uniquement les entrées et sorties requises par le flux parent.

4. Testez le sous‑système indépendamment en utilisant les contrôles internes d'exécution/débogage avant de l'intégrer au scénario principal.

5. Réutilisez ou dupliquez des sous‑systèmes pour des tâches similaires afin d'accélérer le développement.

💡 Astuces

• Regroupez une chaîne complète de caméra dans un sous‑système : utilisez Camera USB ou Camera IP (ONVIF) → blocs de prétraitement comme Image Resize / Blur → détecteurs tels que Object Detection ou Find Object → visualisation avec Draw Detections → stockage avec Image Logger ou Image Write.

• Pour les flux de suivi, placez Object Detection (ou Object Detection - Custom) et Object_Detection_Tracker dans un même sous‑système pour conserver la logique de suivi et le post‑traitement ensemble.

• Encapsulez les étapes lourdes d'IA comme Super Resolution, Depth Estimation (DepthAny. V2) ou Background Removal (RMBG-1.4) dans des sous‑systèmes pour pouvoir activer/désactiver ou remplacer des modèles sans perturber le flux principal.

• Utilisez des sous‑systèmes pour implémenter une analyse en plusieurs étapes : par ex. sélection ROI avec Image ROI Select → analyse de forme avec Find Contour / Measure Position Distance → formatage des résultats avec Data to JSON.

• Pour l'analyse d'intersections ou de trafic, gardez la détection et le suivi dans un sous‑système et l'agrégation/export (par ex. le bloc Traffic Intersection Analysis ou CSV Export) dans un autre pour séparer les responsabilités.

• Pour le passage de données et l'état local, combinez les sous‑systèmes avec Data Write Local et Data Read Local pour conserver une mémoire locale sans polluer le flux global.

• Lors du dépannage, ouvrez le sous‑système et exécutez uniquement son contenu pour identifier rapidement quel bloc interne génère des sorties invalides ou inattendues.

🛠️ Dépannage

• No outputs appearing Vérifiez que vous avez exposé des sorties à l'intérieur du sous‑système. Si rien n'est exposé, le bloc ne renverra pas de données au flux parent.

• Inputs not received Assurez‑vous d'avoir créé et exposé des prises d'entrée à l'intérieur du sous‑système et que le flux parent est connecté à ces entrées exposées.

• Child block reports invalid Ouvrez l'espace de travail du sous‑système et inspectez les blocs enfants. Les erreurs à l'intérieur du sous‑système apparaîtront là‑bas — corrigez la configuration du bloc enfant ou remplacez le bloc problématique.

• Performance issues Si le sous‑système contient des traitements lourds (modèles IA, super‑résolution, opérations sur de grands ensembles), envisagez de profiler à l'intérieur du sous‑système et de déplacer les traitements non essentiels vers des sous‑systèmes séparés et à la demande.

• Need to reuse or version Dupliquez le sous‑système et conservez une copie testable. Cela permet d'essayer différents paramètres ou modèles sans affecter le flux en production.