====== Ergebnisse aus der res1d nach Tabellen oder GIS exportieren ======


⯇ Zurück zu [[mikeplus:anleitungen:anleitungen_siedlungsentwaesserung#ergebnisse|Anleitungen zum Arbeiten in der Siedlungsentwässerung]]  \\
⯇ Zurück zu [[mikeplus:dialog:menues_cs#ergebnisse|Menüs und Werkzeuge Siedlungsentwässerung]]\\


~~NOTOC~~

{{INLINETOC 2-2}}


===== Einleitung – Installation von Python =====

Die Installation von Python und den notwendigen Komponenten ist auf **[[mikeplus:anleitungen:installation_python_mikeio1d|Installation von Python und MIKE IO 1D]]** erklärt.

Das Skript benötigt einige Komponenten, die üblicherweise nicht in der Basisinstallation von Python enthalten sind:

  * MIKE IO 1D 0.2
  * Pandas
  * NumPy
  * GeoPandas (wird für den Shape-Export benötigt)
  * openpyxl (wird für den Excel-Export benötigt)

In der Zwischenzeit ist MIKE IO 1D weiterentwickelt worden, aber wir sind noch nicht dazugekommen das Skript an die neue Version anzupassen. Falls Sie eine Fehlermeldung erhalten (die Klasse «ResultData» kann nicht importiert werden etc. etc.) müssen Sie die aktuelle Version von MIKE IO 1D deinstallieren, und die Version 0.2 installieren:

    python -m pip uninstall mikeio1d
    python -m pip install "mikeio1d==0.2"



===== Anlegen des Export-Ordners =====

<WRAP center round download 60%>
Laden Sie die Datei {{ :mikeplus:anleitungen:mikeplus-export-results_v02.zip |mikeplus-export-results_v02.zip}} herunter und entzippen Sie das Python-Skript in Ihren Export-Ordner.
</WRAP>


Zusätzlich zum eigentlichen Skript haben wir einen **{{ :mikeplus:anleitungen:mikeplus-export-results_v02_example.zip |Beispieldatensatz}}** zusammengestellt, der neben dem Skript auch Ausgangsdaten und Ergebnisse enthält.



Sie starten mit dem Anlegen des Export-Ordners, in dem die notwendigen Dateien liegen und das Ergebnis erzeugt wird. 
Die folgenden Dateien werden benötigt: 

  * Skript, mit dem der Export durchgeführt wird (mikeplus-export-results.py)
  * Resultate, die Sie exportieren wollen (*.res1d)
  * MIKE+ Datenbank mit Zusatzinformationen, die Sie exportieren wollen (*.sqlite)




Falls sich mehrere Datenbanken und Ergebnisdateien im Verzeichnis befinden, verarbeitet das Skript immer die jüngste, also die zuletzt geänderte Datei. Das funktioniert gut, wenn Sie das Modell ändern und einen neuen Simulationslauf starten. Falls Ihre Dateien anders strukturiert sind, legen Sie immer nur eine sqlite- und eine res1d-Datei ins Verzeichnis.

{{ :mikeplus:anleitungen:python_res1d_needed.png?direct&400 |}}


===== Ausführen Ergebnisexport =====

==== Eingabeaufforderung starten ====
 
Navigieren Sie zu dem Ordner, in dem Sie den Export durchführen wollen. Markieren Sie im Explorer den Dateipfad.

{{ :mikeplus:anleitungen:python_cmdtodateipfad.png?direct&600 |}}

Wenn der Dateipfad blau markiert ist, geben Sie "darüber" ''cmd'' ein. Mit <Enter> öffnen Sie die Eingabeaufforderung in dem Ordner, in dem Ihr Export stattfinden soll.


==== Ausführen Ergebnisexport ====

In der Eingabeaufforderung geben Sie folgenden Befehl ein und starten das Skript mit <Enter>:

<code>python mikeplus-export-results.py</code>

Dieser Befehl stellt sicher, dass die Python-Version ausgeführt wird, die in der Path-Umgebungsvariable als erste gefunden wird. Wenn Sie gemäß unserer Anleitung vorgegangen sind, sollte das diejenige sein, in die auch alle Komponenten inklusive MIKE IO 1D installiert worden sind. ((Wenn Ihr Computer gut aufgeräumt ist, müsste eigentlich auch ''mikeplus-export-results.py'' ohne das vorangestellte ''python'' reichen.))






Während der Durchführung können Sie die Schritte des Exports nachverfolgen.





In dem Ordner, in dem das Python Skript ausgeführt wurde, finden Sie nun Shape-Dateien, zwei *.csv-Dateien (eine mit den Knotenergebnissen, und eine mit den Haltungsergebnisse), sowie eine Excel-Datei:



{{ :mikeplus:anleitungen:ergebnisbericht_tabellenkalkulation.png?direct&600 |}}


==== Hydraulische Zustandsklasse berechnen ====

Das Skript enthält einen Abschnitt, der die hydraulische Zustandsklasse von Schächten berechnet. Solche Zustandsklassen sind in der einen oder anderen Form in mehreren Regelwerken vorgesehen.

Das hier vorgestellte Schema ist angelehnt an eine Vorlage, die uns freundlicherweise von der [[http://www.ing-flick.de|Flick Ingenieurgemeinschaft]] (Ibbenbüren, DE) zur Verfügung gestellt worden ist.

{{ :mikeplus:anleitungen:ergebnisbericht_hydraulische-zustandsklasse.png?direct&600 |}}

Bei diesem Ansatz genügt ein Blick auf die Schächte, um zu erkennen, ob die angeschlossenen Haltungen eingestaut sind. Die Haltungen sind daher frei für ein anderes Ergebnis, und zwar den hydraulischen Auslastungsgrad.

Tritt Überstau auf, wird das maximale Volumen über Gelände herangezogen, um einen Anhaltspunkt für die möglichen Auswirkungen zu geben. Ob das Wasser nun auf der Straße bleibt, oder in einen Keller abfließt, 5 m³ auf einer Fläche von 5 x 5 m entsprechen einer Wassertiefe von 20 cm. Damit das Volumen in die res1d geschrieben wird, muss dieser zusätzliche Ergebnistyp aktiviert sein.
===== Updates =====

{{tablelayout?rowsHeaderSource=Auto&colwidth="76px,108px,587px"}}
^  Version  ^  Datum      ^ Bemerkung      ^
| v02       | 2022-05-02  | Weitere Spalten ergänzt, hydraulischer Zustand der Schächte berechnet, Export nach Shape-Datei und nach Excel-Datei hinzugefügt  |
| v01       | 2022-02-23  | Erste Version  |


===== Weiterführende Links =====

  * Github-Seite zum Paket mikeio1d: [[https://github.com/DHI/mikeio1d| hier]]

===== Offene Punkte =====

  * zur Verfügung stehende Felder anführen
  * Zusätzliche Ergebnisse ins Skript einführen, wie z.B. max. Froude-Zahl((DHI intern: Fall CAS-98998-K9K4P8 bzw 11061)) oder Volumen über Gelände; Skript darf nicht stoppen, wenn Ergebnis fehlt