Dateiformat für Zeitreihendaten

Das Dateiformat für Zeitreihendaten wurde entwickelt, um eine flexible Möglichkeit zum Speichern großer Mengen von Zeitreihendaten aus verschiedenen Quellen zu bieten, damit die Daten in InfoWorks importiert werden können.

Anmerkung:

Das Format ist ein fortlaufendes Projekt und kann sich in Zukunft ändern. Es ist daher wichtig, dass Sie Kontakt zu Autodesk aufnehmen, bevor Sie das Format verwenden.

Kontaktieren Sie uns:

• Teilen Sie uns mit, dass Sie an der Verwendung des Formats interessiert sind.
• Holen Sie sich die neuesten Formatdefinitionen, falls sie sich von den hier beschriebenen unterscheiden.
• Teilen Sie uns Ihre speziellen Anforderungen an das Format mit.

In den folgenden Abschnitten wird das Format der Zeitreihendatendateien beschrieben:

1. TSD-Datei
2. DAT-Datei

Die Formatbeschreibungen sind zum Zeitpunkt der Veröffentlichung dieser Hilfedatei korrekt.

TSD-Datei

TSD-Dateien enthalten einen Kopfzeilenabschnitt, gefolgt von einem Datenabschnitt. Alle Zeilen, die mit einem Semikolon beginnen, sind Kommentarzeilen und werden vom Datei-Reader ignoriert. Im Folgenden finden Sie ein Beispiel:

[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 

Kopfzeilenabschnitt

Die Kopfzeile enthält verschiedene Parameter und deren Werte.

Jede Zeile enthält einen Parameter (einer aus einer Reihe von aufgezählten Parametertypen), gefolgt von = und einem Wert (siehe unten). Jedes Parameter-Wert-Paar ist in eckige Klammern eingeschlossen. In einer Zeile darf nur ein Parameter-Wert-Paar auftreten.

Datenabschnitt

Dies ist der wichtigste Abschnitt der TSD-Datei.

Es besteht aus einer Reihe von durch Kommas getrennten Zeilen, die die im System verwendeten Messpunkte oder -positionen enthalten. Die durch Kommas getrennten Felder enthalten auch andere wichtige Informationen wie den Messtyp und die Einheiten.

Das erste Feld jeder durch Kommas getrennten Zeile ist ein eindeutiger Schlüssel. Dieser Schlüssel wird verwendet, um die Informationen in den anderen Feldern in der Zeile mit den Werten (den tatsächlichen Messwerten) in den DAT-Dateien in Beziehung zu setzen.

Die in den einzelnen Feldern enthaltenen Werte lauten:

Feld	Beschreibung	Format	Beispiel
Schlüssel	Eindeutige Kennung, mit der die anderen Daten in der Zeile mit den Werten in der DAT-Datei in Beziehung gesetzt werden	Zeichenfolge mit 8 Zeichen bestehend aus den Zeichen [0-9] und [A-Z] Beachten Sie, dass: bei wichtigen Vergleichen zwischen Groß- und Kleinschreibung unterschieden wird. führende und nachstehende Leerzeichen ignoriert werden.	FO120716
Position	Position der Werte	Zeichenfolge mit einer beliebigen Kombination aus alphanumerischen Zeichen außer Kommas und doppelten Anführungszeichen Beachten Sie, dass: bei allen Zeichenfolgenvergleichen zwischen Groß- und Kleinschreibung unterschieden wird. führende und nachstehende Leerzeichen ignoriert werden.	FO12 STATION FLOW
Datentyp	Art der Messung	Einer der aufgezählten Typen in den festgelegten Datentypen. (Siehe Datentypen und Einheiten weiter unten.)	Flow
Einheiten	Maßeinheiten	Einer der aufgezählten Typen in den festgelegten Einheiten. (Siehe Datentypen und Einheiten weiter unten.)	m3/h
Status	Reserviertes Feld: Wert auf VERWENDET gesetzt	Aufzählungstyp	USED
Minimal gültiger Wert	Zulässige untere bzw. obere Wertegrenze. Diese optionalen Felder können verwendet werden, um unpassende Werte, die in den DAT-Dateien angezeigt werden, zu filtern oder zu markieren. Dies kann zum Beispiel passieren, wenn ein Instrument Fehler aufweist. Wie mit diesen Werten umgegangen wird, hängt von der spezifischen Implementierung des Systems ab, das die TSD-Datei liest.	Nummer Lassen Sie diese Felder leer, oder geben Sie Leerzeichen ein, wenn sie nicht verwendet werden. Gleitkomma oder Ganzzahl Signiert oder unsigniert Verwenden Sie keine Exponenten, z. B. 1.0234e-01.	0
Maximal gültiger Wert			500

Datentypen und Einheiten

Gültige Einheiten für Zeitreihendatendateien:

• Einheiten, die in der Dropdown-Liste der Spalte Anzeigeeinheiten auf der Registerkarte Einheiten vorhanden sind, die sich im Dialogfeld Optionen (verfügbar unter Werkzeuge | Optionen) für den entsprechenden Datentyp befindet.
• In der folgenden Tabelle aufgeführte Einheiten:
Anmerkung:

Wenn Sie eine der folgenden Einheiten verwenden, geben Sie die exakten Zeichenfolgen ein, wie sie in den Anführungszeichen angezeigt werden.

Datentyp	Zulässige Einheiten
FLOW	'l/d', 'l/hr', 'l/min', 'l/s', 'Litres per sec''Ml/d', 'Million litres per day' 'm3/h', 'm3/hr', 'm3/hour', 'cum/hr', 'm3/s', 'cfs'
DRUCK	'm', 'mHd', 'metre', 'Metres''cm', 'mm', 'mmH2O' 'bar', 'psi', 'ft', 'KPa'
DEPTH	'm' 'cm' 'mm'
CONCENTRATION	'mg/l', 'microg/l' 'ppb', 'ppm'
PUMP_RUNNING	Keine (Alle Werte ungleich null in der DAT-Datei werden als EIN gelesen.)
PC_VOLUME	'% full' (Werte aus der DAT-Datei werden als Prozentwerte gelesen.)
OPENING	'% open' (Werte aus der DAT-Datei werden als Prozentwert der Öffnung gelesen.)

DAT-Dateien

Die DAT-Dateien sind ein Satz von Dateien mit Datumsstempel und enthalten mehrere Abschnitte mit Zeitstempel. Jeder Abschnitt enthält einen Satz von Datensätzen mit Schlüssel-Wert-Kennzeichnung. Im Folgenden finden Sie ein Beispiel:

_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

DAT-Dateien verfügen über eine spezielle Benennungskonvention, die für das Datum der darin enthaltenen Daten steht. Das Format ist:

JJJJ-MM-TT.dat

Dabei gilt:

JJJJ ist eine vierstellige Jahresangabe.

MM ist eine zweistellige Monatsangabe (01 bis 12).

TT ist eine zweistellige Tagesangabe (01 bis 31).

Führende Nullen sind erforderlich. Die Datumskomponenten müssen durch ein Minuszeichen getrennt werden.

Beispiele:

2001-01-20.dat

1998-12-31.dat

Abschnitte und Datensätze mit Schlüssel-Wert-Kennzeichnung

Jeder Abschnitt enthält einen Zeitstempel und eine Reihe von Werten, die zu diesem Zeitpunkt aufgezeichnet werden. Die mit einem Zeitstempel versehenen Abschnitte werden in aufsteigender chronologischer Reihenfolge angezeigt. Jeder Wert wird als Datensatz mit Schlüssel-Wert-Kennzeichnung angezeigt. Der Schlüssel wird verwendet, um den Wert mit den in der TSD-Datei gespeicherten Daten in Beziehung zu setzen.

Zeile	Format	Beispiele
Zeitstempel	_hh:mm Dabei gilt: hh ist eine zweistellige Stundenangabe (00 bis 23). mm ist eine zweistellige Minutenangabe (00 bis 59). Beachten Sie, dass: Führende Nullen sind erforderlich. Die Zeitkomponenten müssen durch einen Doppelpunkt getrennt werden. Der Uhrzeit muss ein Unterstrich vorangestellt werden.	_00:00 _00:21
Datensätze mit Schlüssel-Wert-Kennzeichnung	key,value,flag Dabei gilt: key ist ein Schlüssel, der in der TSD-Datei angezeigt wird. value ist der Wert (siehe Anmerkung 3 oben). flag ist ein optionales Ganzzahlfeld, das verwendet werden kann, um die Zuverlässigkeit oder Qualität der Daten anzugeben. Weitere Informationen zum Anzeigen von Kennzeichnungsinformationen finden Sie im Thema Echtzeitdaten-Kennzeichnungen.	FO120716,238.0952, 1 FO120717,102.3199, 1