Découvrez le format des fichiers de variables séparées par des virgules (CSV) utilisés dans l’importation, l’exportation ou la mise à jour des réseaux et des jeux de données de contrôle.
Les sections suivantes sont incluses :
La répartition des données entre les fichiers est assez flexible :
Chaque fichier se compose d’une combinaison des éléments suivants :
Chaque fichier est traité comme une entité individuelle. Les informations du délimiteur de type de données et de l’enregistrement d’en-tête ne sont pas reportées d’un fichier à l’autre.
Le délimiteur de type de données prend la forme de quatre étoiles suivies du nom de la table de base de données contenant les détails de ce type d’objet réseau.
Vous trouverez des informations détaillées sur les noms des tables de base de données dans la section Champs de données réseau.
Exemple :
**** wn_node
Vous pouvez omettre le délimiteur d’en-tête et utiliser le nom de fichier pour indiquer le type d’objet en ajoutant le nom de la table moins le wn_ initial au nom du fichier.
Exemple :
xxx_node.csv indique à InfoWorks WS Pro que le fichier commence par les données de nœud.
L’utilisation du nom de fichier est une façon plus visible d’organiser vos données si vous avez un type d’objet réseau par fichier. Cette approche est utilisée lorsque vous exportez depuis InfoWorks WS Pro en utilisant l’option Exporter chaque table dans un fichier différent.
Vous pouvez utiliser un nom de fichier pour définir le type de données au début d’un fichier et des délimiteurs de type de données pour définir différents types plus bas dans le fichier. Cependant, il est peu probable que cette approche soit très bénéfique.
Vous pouvez utiliser le délimiteur ****deletes pour définir une liste d’objets à supprimer lors de la mise à jour d’un réseau. Le délimiteur est suivi d’un enregistrement pour chaque objet à supprimer contenant le nom de la table et l’ID d’équipement de l’objet.
Exemple :
****deletes
ObjectTable, asset_id
wn_pipe, 28165073
wn_pipe, 28165094
wn_node, 10857075
wn_node, 10857076
Vous pouvez ajouter « deletes » au nom du fichier pour supprimer tous les objets dans un fichier.
L’enregistrement d’en-tête contient une liste des noms de champs présents dans la table de base de données pour l’objet réseau.
Pour InfoWorks WS Pro, les champs de clé primaire sont :
| Tables de nœuds (nœud, nœud de transfert, nœud à charge fixe, borne incendie, réservoir, puits) | La clé primaire pour les nœuds est le champ node_id. Ce champ contient une chaîne de 30 caractères maximum. L’ID doit être unique dans le réseau. |
| Tables de liens (canalisation, vanne, vanne à flotteur, compteur, clapet anti-retour, station de pompage) | Les liens requièrent trois champs : upstream_node_id, downstream_node_id et link_suffix. La combinaison des trois champs doit être unique dans le réseau. |
| Tables de courbes (courbes de pompe, courbes de DLP, courbes de vanne) | La clé primaire des courbes de pompe est le champ ID. Ce champ contient une chaîne de 30 caractères maximum. L’ID doit être unique dans le réseau. |
Les tables de données de contrôle présentent un modèle similaire aux tables de réseau. Il existe une table de contrôle pour chaque nœud et table de liens du réseau. (Il n’existe pas de table de contrôle pour la table wn_pump car les pompes font en fait partie des stations de pompage et les règles de contrôle sont mises en œuvre au niveau de la station de pompage.)
Tous les enregistrements des données de contrôle sont associés à un nœud ou à un lien dans un réseau. C’est pour cette raison que les champs de clé primaire correspondent. Pour que la simulation puisse continuer, la canalisation ou le nœud associé(e) décrit dans la clé primaire Données de contrôle doit exister dans le réseau.
L’enregistrement d’en-tête est suivi de zéro ou plusieurs enregistrements de données.
Dans certaines circonstances, l’utilisation de caractères d’échappement est nécessaire pour maintenir la structure des données exportées.
Vous devez entourer les champs de texte de guillemets doubles s’ils contiennent des virgules ou d’autres guillemets doubles. Sinon, les guillemets sont facultatifs.
Vous pouvez définir les tableaux de valeurs d’un seul type, comme les coordonnées, de manière compacte (dans un seul champ) ou décompactée (chaque valeur dans un champ distinct).
Le tableau est défini dans un seul champ composé d’une accolade ouvrante, suivie d’une liste de valeurs séparées par des virgules, puis d’une accolade fermante.
Exemple : réseau définissant des coudes dans une canalisation
{389956.,110970.,389997.,111017.,390146.,110934.,390661.,111197.}
{389956.,110970.,389923.,111048.,390117.,111259.,390309.,111765.}
Le tableau est défini avec chaque valeur dans un champ distinct, avec des en-têtes de colonne pour la première de chaque type de valeur.
Exemple :
xs |
ys |
|
|
|
|
|
|
389956 |
110970 |
389997 |
111017 |
390146 |
110934 |
390661 |
111197 |
389956 |
110970 |
389923 |
111048 |
390117 |
111259 |
390309 |
111795 |
Ces tableaux contiennent des listes de valeurs qui décrivent des parties plus complexes d’objets particuliers, par exemple :
Vous pouvez définir les tableaux de manière compacte (dans un seul champ) ou séparément (dans un bloc distinct ou un fichier distinct).
Chaque tableau est défini dans un seul champ :
Cet exemple définit la demande au niveau d’un nœud. Deux sous-champs définissent chacun la demande dans une catégorie de demande :
{{Tourism,,10.000000,0},{DomSumer,,13.300000,0}}
Chaque sous-champ contient 4 valeurs, qui doivent apparaître dans le bon ordre. Dans ce cas, l’ordre est le suivant :
Chaque tableau est défini dans un bloc distinct ou un fichier distinct. Chaque valeur du tableau est définie dans un champ distinct.
Le délimiteur de type de données prend la forme de quatre étoiles suivies du nom de la structure de données de la base de données.
Vous trouverez les détails des noms de structures de données de base de données dans la section Champs de données réseau.
****wn_pump_triplets |
|
|
|
id |
flow |
head |
power |
BPu-300 |
0 |
61.1 |
89.5 |
|
|
150 |
58 |
133 |
|
|
240 |
54.1 |
164.8 |
|
|
300 |
50 |
183.8 |
HP-200 |
0 |
48.5 |
46.7 |
|
|
100 |
46.2 |
70.5 |
|
|
200 |
40 |
98 |
|
|
300 |
22.3 |
117.5 |
Lors de l’exportation de fichiers CSV depuis InfoWorks WS Pro, vous avez la possibilité d’exporter des noms de champs descriptifs et des informations sur les unités. Le système exporte ces éléments sous forme d’enregistrements supplémentaires placés avant les enregistrements de données. Si vous exportez des fichiers incluant ces enregistrements supplémentaires, puis essayez de les importer, InfoWorks WS Pro tentera d’interpréter les données supplémentaires comme des enregistrements de données normaux. Vous recevrez presque certainement des messages d’erreur vous indiquant que les valeurs dans le fichier ont une taille ou un type incorrect.
Les options d’exportation supplémentaires sont là pour votre commodité lorsque vous visualisez des données InfoWorks WS Pro dans d’autres logiciels. Assurez-vous que les données que vous avez l’intention de réimporter dans InfoWorks WS Pro sont exportées sans ces enregistrements supplémentaires. La boîte de dialogue Sélectionner les options d’exportation CSV sépare les options nécessaires à la réimportation des options supplémentaires, et vous ne devriez pas avoir de difficulté à exporter dans le format correct. Vous pourriez également supprimer les enregistrements supplémentaires en éditant le fichier dans un autre logiciel avant la réimportation.
Le système n’exporte pas les sections élaguées du réseau vers les fichiers CSV. Un objet Élagage est très complexe, contenant des détails sur tous les liens et nœuds élagués, ainsi que des informations de connectivité.