Le format de fichier de données de série temporelle a été développé pour fournir un moyen flexible de stocker de grandes quantités de données de série temporelle provenant de différentes sources afin que les données puissent être importées dans InfoWorks.
Le format est un projet en cours et est susceptible d’être modifié à l’avenir. Il est donc essentiel de Contacter Autodesk avant de commencer à utiliser ce format.
Contactez-nous pour :
Les sections suivantes décrivent le format des fichiers de données de série temporelle :
Les descriptions de format sont correctes au moment de la publication de ce fichier d’aide.
Les fichiers DST contiennent un en-tête suivi d’une section de données. Les lignes commençant par un point-virgule sont des lignes de commentaire et seront ignorées par le programme de lecture de fichiers. Un exemple est fourni ci-dessous.
[TSD_VERSION=3.0] [SYSTEM_TYPE=Radcom logger] FO120716,FO12 STATION FLOW,Flow,m3/h,USED,0,500 FO120717,FO12 BOREHOLE FLOW,Flow,m3/h,USED,0,500
L’en-tête contient divers paramètres et leurs valeurs.
Chaque ligne est associée à un paramètre (qui fait partie d’un jeu de types de paramètres énumérés) suivi de = et d’une valeur (voir ci-dessous). Chaque paire paramètre-valeur est entourée de crochets. Une seule paire paramètre-valeur peut apparaître sur chaque ligne.
Il s’agit de la section la plus importante du fichier DST.
Elle se compose d’un certain nombre de lignes séparées par des virgules, qui contiennent les points de mesure ou les emplacements utilisés dans le système. Les champs séparés par des virgules contiennent également d’autres informations importantes telles que le type de lecture et les unités.
Le premier champ de chaque ligne séparée par une virgule est une clé unique. Cette clé permet d’associer les informations des autres champs de la ligne aux valeurs (lectures réelles) des fichiers DAT.
Les valeurs contenues dans chaque champ sont respectivement les suivantes :
| Champ | Description | Format | Exemple |
|---|---|---|---|
|
Légende |
Identificateur unique utilisé pour associer les autres données de la ligne aux valeurs du fichier DAT |
Chaîne de 8 caractères contenant les caractères [0-9] et [A-Z] Notez les points suivants :
|
FO120716 |
|
Emplacement |
Emplacement des valeurs |
Chaîne composée d’une combinaison quelconque de caractères alphanumériques, à l’exception des virgules et des guillemets doubles Notez les points suivants :
|
FO12 STATION FLOW |
|
Type de données |
Type de mesure |
L’un des types énumérés dans le jeu Types de données. (Voir la section Types de données et unités ci-dessous.) |
Flow |
|
Unités |
Unités de mesure |
L’un des types énumérés dans le jeu Unités. (Voir la section Types de données et unités ci-dessous.) |
m3/h |
|
Statut |
Champ réservé : définir la valeur sur USED |
Type énuméré |
USED |
|
Valeur minimale valide |
Limites inférieure et supérieure acceptables des valeurs, respectivement. Ces champs facultatifs peuvent être utilisés pour filtrer ou signaler les valeurs incohérentes qui apparaissent dans les fichiers DAT. Par exemple, cela peut se produire si un instrument est défectueux. La manière dont ces valeurs sont traitées dépend de l’implémentation spécifique du système lisant le fichier DST |
Nombre
|
0 |
|
Valeur maximale valide |
500 |
Les unités acceptées pour les fichiers de données de série temporelles sont les suivantes :
Si vous utilisez l’une des unités ci-dessous, veuillez saisir les chaînes exactes, telles qu’elles apparaissent à l’intérieur des guillemets.
| Type de données | Unités acceptées |
|---|---|
|
FLOW |
'l/d', 'l/h', 'l/min', 'l/s', 'litres par seconde', 'Ml/j', 'million de litres par jour' 'm3/h', 'm3/hr', 'm3/heure', 'cum/h', 'm3/s', 'cfs' |
|
PRESSURE |
'm', 'mHd', 'mètre', 'mètres', 'cm', 'mm', 'mmH2O' 'bar', 'psi', 'pi', 'KPa' |
|
DEPTH |
'm' 'cm' 'mm' |
|
CONCENTRATION |
'mg/l', 'microg/l' 'ppb', 'ppm' |
|
PUMP_RUNNING |
Aucun (Toute valeur non nulle du fichier DAT est lue comme étant activée) |
|
PC_VOLUME |
'% complet' (Les valeurs du fichier DAT sont lues sous forme de pourcentages) |
|
OPENING |
'% ouvert' (Les valeurs du fichier DAT sont lues sous forme de pourcentage d’ouverture) |
Les fichiers DAT sont un ensemble de fichiers dans lesquels la date est indiquée, qui contiennent un certain nombre de sections dans lesquelles l’heure est indiquée. Chaque section contient un ensemble d’enregistrements key-value-flag. Un exemple est fourni ci-dessous.
_00:00 FO120716,238.0952, 1 FO120717,102.3199, 1 _00:21 FO120716,236.0195, 1 FO120717,102.3199, 2 FO120718,3.2451, 1 FO120719,2.2073, 1 _00:33 FO120716,236.3858, 1 FO120717,102.0757, 2 FO120718,3.2599, 1 FO120719,2.2073, 1
Les fichiers DAT suivent une convention d’attribution de noms spécifique représentant la date des données qu’ils contiennent. Le format est le suivant :
AAAA-MM-JJ.dat
où :
AAAA est une année à 4 chiffres
MM est un mois à 2 chiffres (de 01 à 12)
JJ est un jour à 2 chiffres (de 01 à 31)
Des zéros à gauche sont requis. Les composants de la date doivent être séparés par un signe moins.
Voici quelques exemples :
2001-01-20.dat
1998-12-31.dat
Chaque section contient un horodatage et une série de valeurs enregistrées à l’heure indiquée. Les sections horodatées apparaissent dans l’ordre chronologique croissant. Chaque valeur apparaît sous la forme d’un enregistrement key-value-flag. Le composant « key » est utilisé pour associer la valeur aux données stockées dans le fichier DST.
| Rangée | Format | Exemples |
|---|---|---|
|
TIMESTAMP |
_hh:mm où : hh est une heure à 2 chiffres (00 à 23). mm est une minute à 2 chiffres (00 à 59). Notez les points suivants :
|
_00:00 _00:21 |
|
Enregistrements key-value-flag |
key,value,flag où : key est une clé qui apparaît dans le fichier DST ; value est la valeur (voir la remarque 3 ci-dessus) ; flag est un champ de nombre entier facultatif qui peut être utilisé pour indiquer la fiabilité ou la qualité des données. Voir la rubrique Indicateurs de données actives pour en savoir plus sur l’affichage des informations sur les indicateurs. |
FO120716,238.0952, 1 FO120717,102.3199, 1 |