Téléchargez des lectures dans un fichier .CSV
Lorsque vous ajoutez des lectures à votre réseau, vous pouvez évaluer ses performances en comparant les résultats de simulation avec des données historiques. Dans cet article, nous allons vous apprendre comment les ajouter facilement à partir d'un fichier .CSV.
Préparez vos fichiers pour le téléchargement
La première chose à faire est d'avoir au moins un réseau téléchargé dans Qatium. Ensuite, pour ajouter des lectures à vos réseaux, vous devez préparer :
- Un fichier .CSV avec les données des lectures
- Un fichier .CSV de mappage des signaux pour mapper vos lectures aux actifs correspondants
Si vous n'avez pas encore de réseau téléchargé dans Qatium, apprenez comment le faire en lisant les articles de cette section.
Fichier .CSV des lectures
Vos fichiers .CSV de lectures doivent avoir une structure spécifique afin que Qatium puisse les interpréter correctement. Préparez votre fichier en suivant les spécifications dans le tableau ci-dessous.
| Étiquette de colonne | temps | actif | métrique | unité | valeur |
| Type de données |
<string> YYYY-MM-DDTHH:MM:SS±HH:MM |
<string> ID du signal |
<string> | <string> | <number> |
Pour que les lectures soient correctement mappées aux actifs, écrivez l'ID du signal dans la colonne “actif”.
Les colonnes de données peuvent être dans n'importe quel ordre, mais elles doivent avoir les mêmes étiquettes exactes que celles indiquées dans le tableau. Par exemple, vous pouvez soumettre l'une des deux versions ci-dessous et vous attendre au même résultat dans Qatium :
"temps","actif","métrique","valeur","unité"
"2024-01-01T00:00:00+10:00","ScadaFeed#1","débit","1.723","l/s"
"2024-01-01T00:00:00+10:00","ScadaFeed#2","pression","66.105","m"
OU
"actif","métrique","valeur","unité","temps"
"ScadaFeed#1","débit","1.723","l/s","2024-01-01T00:00:00+10:00"
"ScadaFeed#2","pression","66.105","m","2024-01-01T00:00:00+10:00"
Conseil rapide:
Téléchargez le exemple de fichier CSV pour une démonstration des données à inclure.
Attention:
Le format du paramètre 'temps' inclut une section de décalage ('±HH:MM'). Si cette section n'est pas définie (c'est-à-dire laissée vide), le paramètre 'temps' sera considéré comme étant en heure UTC. Si le paramètre 'temps' de l'ensemble de données est dans un fuseau horaire différent, la section de décalage doit être ajustée en conséquence. Par exemple, si le fuseau horaire de l'ensemble de données est dans le fuseau horaire (UTC+10), le paramètre 'temps' doit être ajusté à '2024-01-01T01:00:00+10:00'."
Fichier .CSV de mappage des signaux
Pour mapper vos signaux (comme SCADA ou AMI) à vos actifs réseau dans Qatium, préparez un fichier .CSV séparé incluant les informations suivantes :
- “signalId”: Un identifiant unique pour le signal externe.
- “assetId”: L'identifiant de l'actif dans votre réseau auquel vous souhaitez mapper le signal.
- “assetProperty”: La propriété de l'actif que vous mappez (par exemple, débit, pression).
Par exemple :
"signalId","assetId","assetProperty"
"ScadaFeed#1","Pipe#1","débit"
"ScadaFeed#2","J_07293","pression"
Voici les propriétés que vous pouvez définir pour chaque actif :
| Actif | Propriété |
| Réservoir | niveau |
| Jonction | demande, pression |
| Tuyau | débit, état |
| Pompe | état, réglage, pressionAmont, pressionAval |
| Vanne | état, réglage, pressionAmont, pressionAval |
Si vous avez déjà des lectures téléchargées dans Qatium, et que vous devez simplement mapper les signaux, suivez ces étapes :
- Ouvrez votre fichier .CSV de lectures et remplacez l'ID de l'actif dans la colonne “actif”
par l'ID du signal.
Par exemple, si vous avez un fichier de lectures avec la structure suivante :
"temps","actif","métrique","valeur","unité"
"2024-01-01T00:00:00+10:00","Pipe#1","débit","1.723","l/s"
Modifiez-le pour remplacer l'ID de l'actif par l'ID du signal :
"temps","actif","métrique","valeur","unité"
"2024-01-01T00:00:00+10:00","ScadaFeed#1","débit","1.723","l/s"
- Téléchargez à nouveau le fichier de lectures pour remplacer l'existant.
- Ensuite, téléchargez le fichier de mappage des signaux que vous avez créé.
Attention:
Pour les ID de signaux, nous ne préservons que les lettres de a-z et A-Z, les chiffres, et les caractères spéciaux suivants _#-
Conversion des unités (optionnelle)
Pour convertir les unités des valeurs de vos lectures de capteurs, ajoutez une colonne “valueFactor” à votre fichier CSV. Le facteur de valeur est un multiplicateur qui vous permet de convertir les valeurs dans les unités souhaitées.
Par exemple :
signalId,assetId,assetProperty,valueFactor
"PressureSensor#1","Hydrant#1","pression",10.199773339984
Par exemple, si votre capteur capture la pression en bars mais que votre réseau utilise des mètres, le facteur de valeur serait de 10.2.
Attention:
Le “valueFactor” n'accepte que des valeurs numériques et des points décimaux. Tout autre caractère sera ignoré.
Processus de téléchargement
Lorsque vos fichiers .CSV sont prêts, il vous suffit de les glisser-déposer sur le réseau un par un, et Q vous donnera un retour instantané sur l'issue du téléchargement. Rafraîchissez votre navigateur et le réseau reflétera immédiatement les nouvelles données.
Attention:
- N'oubliez pas que Qatium n'accepte qu'un seul fichier de mappage des signaux par réseau. Si vous devez mettre à jour les mappages, téléchargez un nouveau fichier de mappage des signaux pour écraser l'existant.
- Si vous devez mettre à jour vos fichiers de lectures, téléchargez simplement un nouveau fichier CSV pour écraser les données existantes.
- Pour supprimer complètement les lectures d'un réseau, contactez-nous.
FAQs et dépannage
Mes lectures ne sont pas assignées au bon actif
My readings are not assigned to the correct asset
Pour ajouter des lectures à vos réseaux et les faire correctement attribuer aux actifs de votre réseau, vous devez préparer :
- Un fichier .CSV avec les données des lectures.
- Un fichier .CSV de mappage des signaux pour associer vos lectures aux actifs correspondants.
Lisez cet article pour apprendre à préparer vos fichiers correctement.
Si vous avez déjà des lectures chargées dans Qatium, et que vous devez simplement mapper les signaux afin qu'ils apparaissent attribués à l'actif correspondant, suivez les étapes de cet article.
J'ai reçu une erreur de “format incorrect” lors du téléchargement de fichiers CSV
I got a “wrong format” error when uploading CSV files
Vos fichiers CSV doivent avoir une structure spécifique afin que Qatium puisse les interpréter correctement. Les colonnes de données peuvent être dans n'importe quel ordre, mais elles doivent avoir les exactes mêmes étiquettes que celles montrées dans cet article.
Comment puis-je mettre à jour ou supprimer des lectures de mes réseaux ?
How can I update or remove readings from my networks?
Si vous devez mettre à jour ou supprimer vos lectures parce qu'elles sont obsolètes ou incorrectes, vous pouvez :
- Mettre à jour les données en téléchargeant un nouveau fichier CSV pour remplacer l'existant (fonctionne pour les fichiers de lectures et de cartographie des signaux).
- Nous contacter pour supprimer complètement vos données de vos réseaux.