====== QGIS-Erweiterung und Crayfish-Plugin verwenden ======

⯇ Zurück zu [[mikeplus:qgis:erweiterung_plugin_installieren_322|QGIS 3.22-Erweiterung und Crayfish-Plugin installieren]] 

Auf unserem YouTube-Kanal finden Sie das Video "Visualize DFSU to QGIS", in dem [[https://youtu.be/E8o00xfH8CM?t=157|ab 2:37]] die Darstellung von Simulationsergebnissen vorgestellt wird.

[[https://youtu.be/E8o00xfH8CM?t=157|{{ mikeplus:qgis:qgis_erweiterung_verwenden_youtube.jpg?direct&600 |}}]]


/*** Der erste Eintrag entfernt die automatische Inhaltsangabe rechts oben. Der zweite Eintrag stellt nur die Ebene 2 dar, und zwar direkt auf der Seite (nutzt das TocTweak Plugin https://www.dokuwiki.org/plugin:toctweak). ***/

~~NOTOC~~

{{INLINETOC 2-2}}

===== Ergebnisse zur Karte hinzufügen =====

Wenn die Installation korrekt durchgeführt worden ist, werden dfsu-Dateien im Browser als Mesh erkannt und mit einem entsprechenden Icon versehen. Fügen Sie das Mesh mit den in QGIS üblichen Methoden zur Karte hinzu, beispielsweise, indem Sie das Mesh doppelklicken.

{{ :mikeplus:qgis:erweiterung_plugin_verwenden_browser.png?direct&350 |}}

===== Ergebnisdarstellung konfigurieren =====

Einfacher ist es, wenn Sie zunächst mit einem Mesh beginnen, das nur einen Zeitstempel enthält, beispielsweise die Maximalwerte. Weiter unten erklären wir den Umgang mit Zeitserien.

==== Darzustellende Layer auswählen ====

In den "Layer properties – Symbology" im ganz linken Register werden die in der dfsu verfügbaren Ergebnistypen angeführt. Quadrate bedeuten flächige Darstellung, manche Layer können zusätzlich Fließvektoren anzeigen. Durch Klick auf das entsprechende Icon wird ein bestimmter Ergebnistyp aktiviert und dabei farblich hervorgehoben.

{{ :mikeplus:qgis:erweiterung_plugin_verwenden_datasets.png?direct&500 |}}


==== Konturlinien visualisieren ====

Die Darstellung der Flächen wird im zweiten Register von links konfiguriert.

{{ mikeplus:qgis:erweiterung_plugin_verwenden_image02.png?direct&500 }}

**Min und Max**

Mit "Min" und Max" werden die Grenzen der Farbabstufung festgelegt. Mit dem Doppelpfeil werden die Minima und Maxima aus dem Datensatz wiederhergestellt. Engt man die Grenzen ein, werden Werte außerhalb der Grenzen mit der äußersten Palettenfarbe dargestellt.

**Resampling method**

  * None: Jedes Dreieck hat eine bestimmte Farbe
  * Neighbour Average: Interpolation quer über Dreiecke, mehrere Farben pro Dreieck möglich

{{ :mikeplus:qgis:erweiterung_plugin_verwenden_resampling.png?direct&700 |}}


**Interpolation**

  * Discrete: jede Farbe gilt innerhalb einer Klasse bis zur Obergrenze, d.h. die Farben sind abgestuft
  * Linear: jede Farbe gilt nur für einen bestimmten Wert, dazwischen wird die Farbe linear interpoliert
  * Exact: jeder Wert im Mesh erhält eigene Farbe; das wäre wohl nur bei diskreten Werten sinnvoll

{{ :mikeplus:qgis:erweiterung_plugin_verwenden_discrete-linear.png?direct&700 |}}

<wrap lo>Beide obige Abbildungen wurden mit der Resampling method "Neighbour Average" erstellt, das heißt die Farben werden quer über die Meshelemente interpoliert. Links zu sehen ist die Interpolation "Discrete" mit klar abgestuften Farben pro Klasse. Rechts zu sehen ist die Interpolation "Linear", die keine Klassen aufweist, sondern nur Stützpunkte für einzelne Farben, dazwischen werden die Farben interpoliert. </wrap>

**Mode:**

  * Continuous: automatisch 52 Werte; optisch wirkt diese Methode quasi kontinuierlich
  * Equal Interval: Anzahl der Klassen kann man festlegen; die Werte der Klassenobergrenze (bei "Discrete") bzw. der Stützpunkte (bei "Linear") lassen sich einzeln anpassen





==== Vector visualization ====

Die Symbologie von Vektoren ist nur zugänglich, wenn unter den darustellenden Layern (siehe oben) ein Pfeilsymbol aktiviert ist, typischerweise für die Fließgeschwindigkeit im Zeitverlauf. Die Pfeile lassen sich einfärben, skalieren, und wahlweise auf jedem Meshelement oder in einem bestimmten Raster darstellen.

{{ mikeplus:qgis:erweiterung_plugin_verwenden_image03.png?direct&500 }}

==== Meshelemente anzeigen ====

{{ mikeplus:qgis:erweiterung_plugin_verwenden_image04.png?direct&500 }}


===== Zeitachse kontrollieren =====


Layer, die mehrere Zeitschritte aufweisen, sind an der kleinen symbolisierten Uhr zu erkennen.

{{ :mikeplus:qgis:erweiterung_plugin_verwenden_clock.png?direct&300  |}}

In den "Layer Properties – Source" könnte man den Layer auf einen bestimmten Zeitschritt fixieren. Interessant ist dieser Schalter eigentlich nur, weil man hier die originalen Zeitschritte der dfsu-Datei sieht.

{{ :mikeplus:qgis:erweiterung_plugin_verwenden_treat_static.png?direct&500 |}}

In den "Layer Properties – Temporal" sieht man unter "Start time" und "End time" über welchen Zeitraum sich die dfsu-Datei erstreckt. Die "Reference Time" braucht man nicht zu verändern, weil mit MIKE+ erstellte Ergebnisdateien ohnehin absolute Zeitangaben enthalten.

Die Anzeige der Zeit steuert man über das [[https://docs.qgis.org/3.28/en/docs/user_manual/map_views/map_view.html#the-temporal-controller-panel|Temporal Controller Panel]], welches Sie über das Menü View » Panels » Temporal Controller aktivieren.


{{ :mikeplus:qgis:erweiterung_plugin_verwenden_temporal_controller.png?direct&700 |}}


Die Bedienung ist selbsterklärend. Beachten Sie, dass der dargestellte Zeitraum sich nicht automatisch mit der dfsu-Datei deckt. Wenn Sie nicht das gewünschte Ergebnis sehen, könnte es sein, dass Sie den falschen Zeitraum darstellen. Kopieren Sie die Zeitangabe aus dem Register "Temporal".



===== Ergebnisse abfragen =====

Ergebnisse in einzelenen Mesh-Elementen lassen sich mit dem Werkzeug "Identify" abfragen, indem man auf eine bestimme Zelle klickt.

{{ mikeplus:qgis:erweiterung_plugin_verwenden_image05.png?direct&600 }}

===== Zeitserien darstellen =====

Öffnen Sie den Zeitserienplot, indem Sie mit der rechten Maustaste auf einen Layer klicken und "2D Plot" wählen":

{{ mikeplus:qgis:erweiterung_plugin_verwenden_image06.png?direct&400 }}

Der 2D Plot verfügt über folgende Parameter:

  * Layer: darzustellende dfsu-Datei
  * Plot: wählen Sie "Time-series"
  * Group: darzustellender Ergebnistyp innerhalb der dfsu-Datei
  * From Map: wählen Sie "Point"

{{ :mikeplus:qgis:erweiterung_plugin_verwenden_2dplot_timeseries.png?direct&600 |}}


Die Zeitserienanzeige ist interaktiv, wenn Sie die Maus über den Lageplan bewegen, verändert sich der Plot. alls Sie kein Fadenkreuz sehen, wählen Sie erneut "From Map: Point" aus. Mit einem <Klick> fixieren Sie den dargestellten Punkt. Mit <Strg> + <Klick> wählen Sie mehrere Punkte aus.

{{ mikeplus:qgis:erweiterung_plugin_verwenden_image08.png?direct&500 }}

Mit der rechten Maustaste auf den 2D Plot kann man den Plot in diverse Bildformate und als CSV exportieren.

===== Längsschnitt darstellen =====

Öffnen Sie den Längsschnitt, indem Sie mit der rechten Maustaste auf einen Layer klicken und "2D Plot" wählen:

{{ mikeplus:qgis:erweiterung_plugin_verwenden_image06.png?direct&400 }}

Der 2D Plot verfügt über folgende Parameter:

  * Layer: darzustellende dfsu-Datei; scheinbar funktionieren nur dfsu-Dateien mit einer Zeitachse
  * Plot: wählen Sie "Cross-section"
  * Group: darzustellender Ergebnistyp innerhalb der dfsu-Datei
  * Time: Mit "current" ändert sich der Längsschnitt, wenn Sie die Zeit verstellen.
  * From Map: keine Auswahlmöglichkeit

{{ :mikeplus:qgis:erweiterung_plugin_verwenden_2dplot_crosssection.png?direct&600 |}}

Um den Verlauf des Längsschnitts zu zeichnen, 

  * klicken Sie auf <From Map>,
  * klicken Sie auf die Karte, und zwar für den Anfangspunkt und für jeden weiteren Stützpunkt,
  * und schließen Sie mit rechtem Mausklick ab (erzeugt keinen weiteren Stützpunkt!).

Die Y-Achse wird normalerweise automatisch skaliert, was bei Betrachtung im Zeitverlauf stört. Fixieren Sie den Ausschnitt der Y-Achse mittels rechtem Mausklick:

{{ :mikeplus:qgis:erweiterung_plugin_verwenden_2dplot_crosssection_fix.png?direct&250 |}}

===== Darstellung in 3D =====

Offizielle QGIS-Dokumentation: [[https://docs.qgis.org/3.28/en/docs/user_manual/map_views/3d_map_view.html|]] 

Erstellen Sie über das Menü "View » 3D Map Views" ein neue 3D Map View und üffenen Sie die Konfiguration:

{{ :mikeplus:qgis:erweiterung_plugin_verwenden_3dmap_configuration.png?direct&500 |}}

Wählen Sie "Mesh" und die gewünschte dfsu-Datei aus. Passen Sie die Symbologie an:

{{ mikeplus:qgis:erweiterung_plugin_verwenden_image10.png?direct&500 }}

Mit <OK> wird die 3D-Ansicht angezeigt. Mit den Maustasten oder mit den vier Pfeiltasten, wahlweise mit <Shift>, lässt sich die Perspektive verändern.

{{ mikeplus:qgis:erweiterung_plugin_verwenden_image11.png?direct&500 }}

===== Weitere Ergebnisse berechnen mit dem Mesh calculator =====

Official QGIS documentation: https://docs.qgis.org/3.28/en/docs/user_manual/working_with_mesh/mesh_properties.html#mesh-calculator

Der Mesh Calculator ist im Menü „Mesh“ zu finden.((nicht zu verwechseln mit dem Mesh Calculator, der in der Processing Toolbox unter Crayfish gelistet wird))

{{ mikeplus:qgis:erweiterung_plugin_verwenden_image12.png?direct&500 }}

{{ mikeplus:qgis:erweiterung_plugin_verwenden_image13.png?direct&500 }}

Die berechneten Werte werden zum originalen Mesh als zusätzliche Kanäle hinzugefügt:

{{ mikeplus:qgis:erweiterung_plugin_verwenden_image14.png?direct&500 }}

===== Toolbox zum Exportieren von Daten =====

Offizielle QGIS-Dokumentation: [[https://docs.qgis.org/3.22/en/docs/user_manual/processing_algs/qgis/mesh.html]]

Zu finden über das Menü "Processing > Toolbox" in der Gruppe "Mesh".

{{ mikeplus:qgis:erweiterung_plugin_verwenden_image15.png?direct&400 }}

==== Export contours ====

Exportiert werden

  * Kontur//linien//
  * //Flächen// mit einem Multipart-Polygon pro Klasse


{{ mikeplus:qgis:erweiterung_plugin_verwenden_image16.png?direct&500 }}

Entweder man gibt ''Increment between contour levels'', ''Minimum contour level'' und ''Maximum contour level'' an.

Oder man gibt die Klassengrenzen ''List of contours level'' an, in obigem Bild ''0.01,0.2,0.4,0.6,0.8,1,1.5,2,3,999''. Der kleinste und der größte Wert werden als Außengrenze verstanden, jenseits davon werden keine Polygone exportiert. Exportiert wird je ein Multipart-Polygon pro Klasse:


{{ :mikeplus:qgis:erweiterung_plugin_verwenden_attribute_table.png?direct&300 |}}





==== Export mesh faces ====

Mit diesem Tool lassen sich dfsu Dateien (z.B. Ergebnisse der maximalen Wassertiefe) in einen Polygon-Layer umwandeln. 

1) Wählen Sie die zu konvertierende dfsu Datei aus.

2) Um den Export erfolgreich durchführen zu können, muss gegebenenfalls das Koordinatensystem des Ausgabe-Layers definiert werden.

{{ :mikeplus:qgis:export_mesh_faces.png?600 |}}

/*** Früher einmal wurden die Attribute als Text exportiert; scheint in der Zwischenzeit besser zu klappen.

Attribute (z.B. maximale Wassertiefe) werden als Text exportiert. Der "Delete value" wird ebenfalls als Text exportiert, also beispielsweise "1.0000000180025095e-35", je nachdem, was in der dfsu-Datei als "Delete value" vorgesehen war.

Für weitere Analysen müssen wir diese **Texte in Zahlen umwandeln**. Öffnen Sie hierzu die Attributtabelle des zuvor erzeugten Polygon-Layers.

1) Wechseln Sie in den Field Calculator

2) Erzeugen Sie eine neue Attributspalte mit den gewünschten Einstellungen. Für Kommazahlen setzten Sie den output field type auf Decimal number (real)

3) Bei der Gruppenliste wählen Sie unter Fields und Values die vorhandene Text-Attributspalte

4) Bestätigen Sie mit OK

{{ :mikeplus:qgis:texttofloat.png?600 |}}

{{ :mikeplus:qgis:texttofloat_result.png?600 |}}

***/

==== Export mesh edges und Export mesh vertices ====

Es stehen keine Attribute zur Auswahl, weil dfsu eben nur auf Flächen schreibt.

===== Animationen exportieren =====

{{ mikeplus:qgis:erweiterung_plugin_verwenden_image19.png?direct&400 }}

===== Dokumentation =====

QGIS-Dokumentation: [[https://docs.qgis.org/3.22/en/docs/user_manual/working_with_mesh/mesh_properties.html]]

MDAL and QGIS Mesh Layer - Lutra Consulting: [[https://www.lutraconsulting.co.uk/projects/mdal/]]

Overview of QGIS 3.12 Mesh Features - Lutra Consulting: [[https://www.lutraconsulting.co.uk/blog/2020/01/15/crayfish-3-2-1/]]