Il formato Time Series Data è stato sviluppato per fornire un modo flessibile per archiviare grandi quantità di dati serie temporali provenienti da origini diverse, in modo che i dati possano essere importati in InfoWorks.
Il formato è un progetto in corso ed è soggetto a modifiche in futuro. Pertanto, è essenziale contattare Autodesk prima di iniziare ad utilizzare il formato.
Contattarci per:
Nelle sezioni seguenti viene descritto il formato file Time Series Data:
Le descrizioni dei formati sono corrette al momento della pubblicazione di questo file di guida.
I file TSD contengono una sezione di intestazione seguita da una sezione di dati. Tutte le righe che iniziano con un punto e virgola sono righe di commento e saranno ignorate dal lettore di file. Qui di seguito è fornito un esempio:
[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'intestazione contiene vari parametri e i relativi valori.
Ogni riga ha un parametro (uno di un gruppo di tipi di parametri enumerati) seguito da = e da un valore (vedere di seguito). Ogni coppia parametro-valore è racchiusa in una coppia di parentesi graffe. In ogni riga può comparire solo una coppia parametro-valore.
Questa è la sezione più importante del file TSD.
È costituita da una serie di righe separate da virgole che contengono i punti di misurazione o le posizioni utilizzati nel sistema. I campi separati da virgola contengono anche altre informazioni importanti, come il tipo di lettura e le unità di misura.
Il primo campo di ogni riga separata da virgola è una chiave univoca. Questa chiave viene utilizzata per mettere in relazione le informazioni contenute negli altri campi della riga con i valori (le letture effettive) nei file DAT.
I valori contenuti in ciascun campo sono, rispettivamente:
| Campo | Descrizione | Formato | Esempio |
|---|---|---|---|
|
Chiave |
Identificatore univoco utilizzato per correlare gli altri dati sulla riga ai valori nel file DAT. |
Stringa di 8 caratteri contenente caratteri [0-9] e [A-Z] Osservare quanto segue:
|
FO120716 |
|
Posizione |
La posizione dei valori |
Stringa composta da qualsiasi combinazione di caratteri alfanumerici, ad eccezione della virgola e delle virgolette doppie. Osservare quanto segue:
|
FO12 STATION FLOW |
|
Tipo di dati |
Il tipo di misurazione |
Uno dei tipi enumerati nel gruppo Tipi di dati. Vedere di seguito Tipi di dati e unità. |
Flow |
|
Unità |
Unità di misura |
Uno dei tipi enumerati nel gruppo Unità. Vedere di seguito Tipi di dati e unità. |
m3/h |
|
Stato |
Campo riservato: impostare il valore su USED |
Tipo enumerato |
USED |
|
Valore minimo valido |
I limiti accettabili inferiori e superiori dei valori rispettivamente. Questi campi opzionali possono essere utilizzati per filtrare o contrassegnare valori incongruenti che compaiono nei file DAT. Ad esempio, ciò può verificarsi se uno strumento si rivela difettoso. Il modo in cui questi valori vengono gestiti dipenderà dall'implementazione specifica del sistema che legge il file TSD. |
Numero
|
0 |
|
Valore massimo valido |
500 |
Le unità accettabili per i file TSD sono le seguenti:
Se si utilizza una delle unità riportate di seguito, digitare le stringhe esatte, così come appaiono tra virgolette.
| Tipo di dati | Unità accettabili |
|---|---|
|
FLOW |
"l/d", "l/hr", "l/min", "l/s", "litri per sec'', "Ml/d", "Milioni di litri al giorno" "m3/h", "m3/hr", "m3/ora", "cum/hr", "m3/s", "cfs" |
|
PRESSIONE |
"m", "mHd", "metro", "metri", "cm", "mm", "mmH2O" "bar", "psi", "ft", "KPa" |
|
PROFONDITÀ |
"m" "cm" "mm" |
|
CONCENTRAZIONE |
"mg/l", "microg/l" "ppb", "ppm" |
|
POMPA IN ESECUZIONE |
Nessuna (Qualsiasi valore diverso da zero nel file DAT viene letto come ON) |
|
PC_VOLUME |
"% full" (I valori del file DAT vengono letti come percentuale) |
|
APERTURA |
'% open' (I valori del file DAT vengono letti come percentuale di apertura) |
I file DAT sono una gruppo di file con indicazione della data che contengono un certo numero di sezioni con indicazione dell'ora. Ogni sezione contiene una gruppo di record key-value-flag. Qui di seguito è fornito un esempio:
_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
I file DAT hanno una convenzione di denominazione specifica che rappresenta la data dei dati in essi contenuti. Con il seguente formato:
AAAA-MM-GG.dat
dove:
AAAA è un anno a 4 cifre
MM è un mese a 2 cifre (da 01 a 12)
GG è un giorno a 2 cifre (da 01 a 31)
Gli zeri iniziali sono obbligatori. I componenti della data devono essere separati da un segno meno.
Alcuni esempi:
2001-01-20.dat
1998-12-31.dat
Ogni sezione contiene un timestamp e una serie di valori registrati in quel momento. Le sezioni contrassegnate dall'ora appaiono in ordine cronologico ascendente. Ogni valore appare come un record key-value-flag. La chiave viene utilizzata per correlare il valore ai dati memorizzati nel file TSD.
| Riga | Formato | Esempi |
|---|---|---|
|
Timestamp |
_hh:mm dove: hh è un'ora a 2 cifre (da 00 a 23). mm è un minuto a 2 cifre (da 00 a 59). Osservare quanto segue:
|
_00:00 _00:21 |
|
Record key-value-flag |
key,value,flag dove: key è una chiave che compare nel file TSD value è il valore (vedere la nota 3 sopra) flag è un campo intero facoltativo che può essere utilizzato per indicare l'affidabilità o la qualità dei dati. Per ulteriori informazioni sulla visualizzazione delle informazioni relative ai flag, vedere l'argomento Flag dati live. |
FO120716,238.0952, 1 FO120717,102.3199, 1 |