CSV Export

Ce bloc fonction collecte des colonnes de données entrantes au fil du temps et les enregistre dans un fichier CSV sur demande. Utilisez-le pour constituer des journaux de données simples (mesures, compteurs, étiquettes) et les exporter pour analyse ou archivage.

📥 Entrées

• Folder Path Dossier où le fichier CSV sera enregistré (utilise le dossier courant si non renseigné)

• File Name Nom de fichier à utiliser pour le CSV exporté (nom horodaté par défaut si non renseigné)

• Start Logging Déclencheur booléen pour commencer à ajouter les données entrantes dans le tampon interne de journalisation

• Export File Déclencheur booléen pour écrire les données accumulées dans le fichier CSV

• Data_1 ... Data_10 Colonnes de données génériques qui seront stockées (seules les colonnes connectées sont enregistrées)

📤 Sorties

• Ce bloc fonction ne produit aucune sortie.

🕹️ Contrôles

• Header fields Dix champs texte où vous pouvez fournir des noms de colonnes lisibles pour les entrées correspondantes Data_1 ... Data_10. Laissez un champ vide pour utiliser le label par défaut Data_n.

• Start Logging entrée Utilisée pour activer la journalisation des valeurs entrantes dans le tampon interne.

• Export File entrée Utilisée pour vider les lignes tamponnées dans un fichier CSV sur le disque.

🎯 Fonctionnalités

• Horodatage automatique par ligne (l'heure est ajoutée en première colonne).

• Colonnes flexibles : seules les entrées Data_n connectées sont incluses dans le CSV.

• Gestion des en-têtes : si vous modifiez les champs d'en-tête, la ligne d'en-tête du CSV existant est mise à jour automatiquement (si le fichier existe déjà).

• Journalisation tamponnée : les lignes sont stockées en interne pendant que Start Logging est actif et ne sont écrites que lorsque Export File est déclenché.

• Écriture sécurisée : des avertissements et erreurs sont affichés dans l'interface si le fichier est ouvert ailleurs ou si l'écriture échoue.

📝 Comment l'utiliser

1. Définissez la destination en utilisant les entrées Folder Path et File Name (optionnel).

2. Fournissez des noms de colonnes lisibles dans les Header fields pour les prises Data_n que vous allez connecter.

3. Connectez les sources de données aux entrées correspondantes Data_1 ... Data_10 (n'utilisez que les entrées nécessaires).

4. Pilotez Start Logging avec un signal booléen (par exemple via un bloc Logic Input) pour commencer à mettre en tampon les lignes.

5. Lorsque vous êtes prêt, activez l'entrée Export File pour enregistrer les lignes tamponnées sur le disque. Le bloc ajoutera ou mettra à jour automatiquement l'en-tête CSV.

📊 Comportement

• Tant que Start Logging est actif, le bloc capture l'horodatage courant et les valeurs de toutes les prises de données connectées dans une liste interne.

• Lorsque Export File devient vrai, le bloc écrit les lignes accumulées dans le fichier CSV à l'emplacement Folder Path + File Name. Après un export réussi, le tampon interne est vidé.

💡 Conseils et astuces

• Utilisez des blocs Date-Time ou Date-Time List pour construire des noms de fichiers significatifs ou pour alimenter des colonnes supplémentaires liées au temps en plus de l'horodatage automatique.

• Utilisez Logic Input pour contrôler manuellement Start Logging et Export File depuis l'interface.

• Pour des mesures numériques, utilisez Number Input ou des blocs mathématiques (comme Add, Subtract) en amont pour préparer les valeurs avant de les connecter aux entrées Data_n.

• Pour des étiquettes ou ID textuels, utilisez String Input ou String Merge pour combiner des champs texte avant de les envoyer à une entrée Data_n.

• Pour exporter des méta-données liées aux images (par ex. nombre de frames, nombres de détections), connectez des blocs d'analyse pertinents comme Object Detection, Mask Detection ou Find Object aux entrées génériques Data_n.

• Si vous voulez sauvegarder des images en parallèle des journaux numériques, utilisez Image Logger ou Image Write et conservez le CSV pour les métadonnées numériques/textuelles uniquement.

• Utilisez CSV Export avec Scope pour visualiser des flux numériques puis enregistrez les données une fois les événements d'intérêt vérifiés.

🛠️ Dépannage

• Fichier non enregistré / erreur de permission : assurez-vous que le fichier CSV n'est pas ouvert dans un autre programme et que vous disposez des droits d'écriture pour le dossier sélectionné. Lancez l'application avec les privilèges nécessaires si besoin.

• Aucune donnée exportée : vérifiez que vous avez activé Start Logging au moins une fois afin que le tampon interne contienne des lignes avant de déclencher Export File. Le bloc avertira s'il n'y a pas de données stockées lors de la demande d'export.

• Mauvaises colonnes dans le CSV : confirmez quelles prises Data_n sont connectées et ajustez les champs Header fields. Le bloc n'inclut que les entrées connectées et met à jour l'en-tête lorsque vous changez le texte des champs.