Erfahren Sie mehr über das Format für CSV-Dateien (durch Kommas getrennte Werte), das beim Importieren, Exportieren oder Aktualisieren von Netz- und Steuerungsdatensätzen verwendet wird.
Die folgenden Abschnitte sind enthalten:
Die Verteilung von Daten auf Dateien ist relativ flexibel:
Jede Datei enthält eine Kombination folgender Bestandteile:
Jede Datei wird als einzelnes Objekt behandelt. Die Informationen zu Datentyptrennzeichen und Kopfzeilendatensätzen werden nicht von einer Datei in eine andere übertragen.
Das Datentyptrennzeichen besteht aus vier Sternen, gefolgt vom Namen der Datenbanktabelle, die Details zu diesem Netzobjekttyp enthält.
Details zu den Datenbanktabellennamen finden Sie im Abschnitt Netzdatenfelder.
Beispiel:
**** wn_node
Das Trennzeichen in der Kopfzeile kann weggelassen werden. Stattdessen kann der Dateiname zur Bezeichnung des Objekttyps verwendet werden, indem der Tabellenname ohne das anfängliche wn_ an den Dateinamen angehängt wird.
Beispiel:
xxx_node.csv teilt InfoWorks WS Pro mit, dass die Datei mit Knotendaten beginnt.
Die Verwendung des Dateinamens ist eine besser sichtbare Möglichkeit, Ihre Daten zu organisieren, wenn ein Netzobjekttyp pro Datei vorhanden ist. Diese Vorgehensweise wird verwendet, wenn Sie aus InfoWorks WS Pro exportieren und dabei die Option Jede Tabelle exportieren nach für den Export in eine andere Datei verwenden.
Sie können den Datentyp am Anfang einer Datei mithilfe eines Dateinamens und unterschiedliche Typen weiter unten in der Datei mithilfe von Datentyptrennzeichen definieren. Dieser Ansatz ist jedoch sehr wahrscheinlich nicht von großem Nutzen.
Das Trennzeichen ****deletes kann verwendet werden, um eine Liste von Objekten zu definieren, die beim Aktualisieren eines Netzes gelöscht werden sollen. Nach dem Trennzeichen steht ein Datensatz für jedes zu löschende Objekt mit dem Tabellennamen und der Asset-ID des Objekts.
Beispiel:
****deletes
ObjectTable, asset_id
wn_pipe, 28165073
wn_pipe, 28165094
wn_node, 10857075
wn_node, 10857076
Alternativ können Sie deletes an den Dateinamen anhängen, um alle Objekte in einer Datei zu löschen.
Der Kopfzeilendatensatz enthält eine Liste der Feldnamen, die in der Datenbanktabelle für das Netzobjekt enthalten sind.
InfoWorks WS Pro enthält die folgenden Primärschlüsselfelder:
| Knotentabellen (Knoten, Übertragungsknoten, Knoten mit konstantem Wasserspiegel, Hydrant, Reservoir, Brunnen) | Der Primärschlüssel für Knoten ist das Feld node_id. Dieses Feld enthält eine Zeichenfolge mit bis zu 30 Zeichen. Die ID muss innerhalb des Netzes eindeutig sein. |
| Verbindungstabellen (Rohr, Ventil, Schwimmerventil, Zähler, Rückschlagventil, Pumpstation) | Verbindungen erfordern drei Felder: upstream_node_id, downstream_node_id und link_suffix. Die Kombination der drei Felder muss innerhalb des Netzes eindeutig sein. |
| Kurventabellen (Pumpenkurven, PRD-Kurven, Ventilkurven) | Der Primärschlüssel für Pumpenkurven ist das ID-Feld. Dieses Feld enthält eine Zeichenfolge mit bis zu 30 Zeichen. Die ID muss innerhalb des Netzes eindeutig sein. |
Steuerungsdatentabellen weisen ein ähnliches Muster auf wie Netztabellen. Es gibt eine Steuerungstabelle für jeden Knoten und jede Verbindungstabelle im Netz. (Für die Tabelle wn_pump gibt es keine Steuerungstabelle, da Pumpen Teil von Pumpstationen sind und die Steuerungsregeln auf Pumpstationsebene implementiert werden.)
Alle Datensätze in den Steuerungsdaten sind mit einem Knoten oder einer Verbindung in einem Netz verknüpft. Aus diesem Grund stimmen die Primärschlüsselfelder überein. Damit die Simulation fortgesetzt werden kann, muss der zugehörige Knoten oder das Rohr, der bzw. das im Primärschlüssel der Steuerungsdaten beschrieben ist, im Netz vorhanden sein.
Auf den Kopfzeilendatensatz folgen keine oder weitere Datensätze.
In bestimmten Fällen ist es erforderlich, Escape-Zeichen zu verwenden, um die Struktur der exportierten Daten beizubehalten.
Textfelder müssen in doppelten Anführungszeichen stehen, wenn sie Kommas oder andere doppelte Anführungszeichen enthalten. Andernfalls sind Anführungszeichen optional.
Wertanordnungen eines einzelnen Typs, z. B. Koordinaten, können als gepackt (als einzelnes Feld) oder als ungepackt (jeder Wert in einem separaten Feld definiert) definiert werden.
>Die Anordnung wird in einem einzelnen Feld definiert, das aus einer öffnenden geschweiften Klammer, gefolgt von einer durch Kommas getrennten Werteliste und einer schließenden geschweiften Klammer besteht.
Beispiel: Anordnung zum Definieren von Biegungen in einem Rohr
{389956.,110970.,389997.,111017.,390146.,110934.,390661.,111197.}
{389956.,110970.,389923.,111048.,390117.,111259.,390309.,111765.}
Die Anordnung wird mit jedem Wert in einem separaten Feld mit Spaltenüberschriften für den ersten Wert jedes Typs definiert.
Beispiel:
xs |
ys |
|
|
|
|
|
|
389956 |
110970 |
389997 |
111017 |
390146 |
110934 |
390661 |
111197 |
389956 |
110970 |
389923 |
111048 |
390117 |
111259 |
390309 |
111795 |
Diese Anordnungen enthalten Wertelisten, die komplexere Teile bestimmter Objekte beschreiben. Beispiele:
Die Anordnungen können als gepackt (als einzelnes Feld) oder separat (in einem separaten Block oder einer separaten Datei) definiert werden.
Jede Anordnung ist in einem einzelnen Feld definiert:
In diesem Beispiel wird der Bedarf an einem Knoten definiert. Zwei untergeordnete Felder definieren jeweils den Bedarf in einer Bedarfskategorie:
{{Tourism,,10.000000,0},{DomSumer,,13.300000,0}}
Jedes untergeordnete Feld enthält vier Werte, die in der richtigen Reihenfolge angezeigt werden müssen. In diesem Fall lautet die Reihenfolge:
Jede Anordnung wird in einem separaten Block oder einer separaten Datei definiert. Jeder Wert in der Anordnung wird in einem separaten Feld definiert.
Das Datentyptrennzeichen besteht aus vier Sternen, gefolgt vom Namen der Datenbank-Datenstruktur.
Details zu den Namen der Datenbank-Datenstruktur finden Sie im Abschnitt Netzdatenfelder.
****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 |
Beim Exportieren von CSV-Dateien aus InfoWorks WS Pro können Sie beschreibende Feldnamen und Einheiteninformationen exportieren. Diese werden als zusätzliche Datensätze exportiert, die vor den Datensätzen eingefügt werden. Wenn Sie Dateien mit diesen zusätzlichen Datensätzen exportieren und später importieren, versucht InfoWorks WS Pro, die zusätzlichen Daten als normale Datensätze zu interpretieren. Sehr wahrscheinlich werden Sie in Fehlermeldungen darüber informiert, dass die Werte in der Datei die falsche Größe oder den falschen Typ aufweisen.
Die zusätzlichen Exportoptionen sind verfügbar, um Ihnen die Anzeige von InfoWorks WS Pro-Daten in anderen Paketen zu erleichtern. Sie sollten sicherstellen, dass Daten, die Sie später wieder in InfoWorks WS Pro importieren möchten, ohne diese zusätzlichen Datensätze exportiert werden. Im Dialogfeld CSV-Exportoptionen auswählen werden die für den erneuten Import erforderlichen Optionen von den zusätzlichen Optionen getrennt, sodass das Exportieren im richtigen Format problemlos möglich sein sollte. Die zusätzlichen Datensätze können auch entfernt werden, indem die Datei vor dem erneuten Import in einem anderen Paket bearbeitet wird.
Gestutzte Abschnitte des Netzes werden nicht in CSV-Dateien exportiert. Ein Stutzobjekt ist sehr komplex und enthält Details zu allen gestutzten Verbindungen und Knoten sowie Konnektivitätsinformationen.