Die auf diesen Seiten beschriebenen numerischen Simulationsmethoden verwenden die frei verfügbare Software open TELEMAC-MASCARET (im Folgenden TELEMAC genannt), die als Handelscode von der F&D-Gruppe der Électricité de France (EDF) gestartet wurde. Seit 2010 übernimmt das TELEMAC-MASCARET Consortium die Entwicklung (EDF R&D ist noch zutiefst beteiligt) und stellt die Software und ihren Quellcode unter einer GPLv3 License. Besuchen Sie ihre website, um mehr über TELEMAC zu erfahren.
Die Zusammenarbeit mit Debian Linux oder einem seiner Derivate (siehe Kapitel Virtual Machines (VMs) and Linux) erleichtert die Handhabung von TELEMAC, da die meisten seiner Kernalgorithmen ursprünglich auf Linux-Plattformen entwickelt wurden. Mit Linux folgen Sie dem TELEMAC installationKapitel (Berechnung für ca. 2 Stunden für die Installation).
Allgemeine Einführung und Anleitung¶
Die Analyse von Hydro-Umgebungen mit TELEMAC beinhaltet die Vorverarbeitung zur Abstraktion der fluvialen Landschaft, die Einrichtung von Kontrolldateien, den Betrieb eines TELEMAC-Lösers und die Nachbearbeitung. Der erste Benutzer sieht eine überwältigende Anzahl von Softwareoptionen für die Vor- und Nachbearbeitung vor. Darüber hinaus verfügt TELEMAC über eine breite Palette von Modulen für zweidimensionale (2d) und dreidimensionale (3d) Modellierung von hydromorphodynamischen Prozessen verschiedener Wasserkörper, von Bergflüssen bis Küstendeltas unter dem Einfluss von Tides. Auch können mehrere Sedimenttransporterscheinungen modelliert und mit stetigen oder unruhigen Strömungsverhältnissen gekoppelt werden. Folglich ist das Anwendungsspektrum von TELEMAC sehr breit und dieses eBook bietet Tutorials für ein fundiertes Verständnis grundlegender Elemente der Flussökosystemmodellierung. Zu diesem Zweck verfügt dieses eBook über folgende Tutorials:
Generieren Sie ein Selafin
*.slf*Geometrie-Netz zusammen mit Randbedingungen mit QGIS, dem BASEmesh-Plugin und BlueKenue in der pre-processing tutorial. Einführendes Tutorial für AnfängerEine rein hydrodynamische, stetige Telemac2d-Simulation in der steady 2d tutorial (Selafin
*.slf*Geometrie) einrichten. Ein zweites Tutorial für AnfängerQuasi-steady (near-census unsteady) Strömungsbedingungen (z.B. wichtig für die Modellierung eines Flut-Hydrographen) in der unsteady Telemac2d tutorial. Dieses Tutorial baut auf dem stationären Telemac2d Tutorial.
Aufbau eines rein hydrodynamischen 3d Modells in der Telemac3d tutorial.
Doppel-Hydrodynamik (d.h. Telemac2d oder Telemac3d) mit Morphodynamik (d.h.Sediment transport) in der Gaia tutorial.
The tutorials build on the user manuals provided by the TELEMAC developers at http://
Vorverarbeitung¶
Die Vorverarbeitung beinhaltet die Abstraktion der Flusslandschaft in ein Rechennetz (Grid) mit Randbedingungen. Für diesen Zweck können viele Software-Tools verwendet werden, z.B.:
QGIS und das BASEmesh-Plugin, die im QGIS pre-processing tutorial dargestellt sind (** die bevorzugte Wahl des Autors*).
Die Software Blue Kenue GUI des National Research Council Canada (vor allem für Windows).
SALOME zur Generierung von Rechennetzen im MED-Dateien-Format.
Modell Setup und Run¶
Das Herzstück eines TELEMAC Modells ist die Steuerungsdatei (Steering oder CAS), die mit Fudaa PrePro eingerichtet werden kann. Das Modell-Setup wird im obigen tutorial guide für TELEMAC erläutert.
Nachbearbeitung¶
Artelia Eau et Environnement erstellte das PostTelemac Plugin für QGIS, das ein leistungsstarkes und komfortables Tool zur Visualisierung und Nachbearbeitung von TELEMAC-Simulationsergebnissen ist. Die Telemac2d (steady) Post-processing illustriert die Nutzung des PostTelemac QGIS Plugins (weiterlesen im TELEMAC pre-processing tutorial) um rasterKarten und andere nützliche Datenderivate vom TELEMAC-Ausgang zu erstellen.
Die TELEMAC Dateistruktur¶
Für jede TELEMAC-Simulation sind die folgenden Eingabedateien verpflichtend:
Steuerungsdatei
Dateiformat:
*.casBereiten Sie sich entweder mit Fudaa PrePro vor oder verwenden Sie einen Texteditor (z.B. NotepadPlus (Text-Editor)).
Geometriedatei
Dateiformate:
*.slf(selafin oder*.med(MED-Dateibibliothek von der salome-platformBereiten Sie
*.slfGeometrien mit QGISorBlue Kenue vor (lesen Sie mehr unter TELEMAC pre-processing tutorial).Bereiten Sie
*.medGeometrien mit SALOME.
Schwere Bedingungen
Dateiformat:
*.cli(mit*.slf) oder*.bnd/*.bcd(mit*.med)Bereiten Sie
*.cli-Dateien mit Fudaa PrePro oder Blue Kenue vor (weiterlesen unter TELEMAC pre-processing tutorial).Prepare
*.bnd/*.bcdfiles either with SALOME or with a text editor.
Es gibt viele weitere Dateien, die für jede TELEMAC-Simulation nicht rechnerisch vorgeschrieben sind, sondern für bestimmte Szenarien (z.B. unruhige Ströme) und Module (z.B. Sedimenttransport mit Gaia) wesentlich sind. Solche optional Dateien umfassen:
Unsteady flow file (z.B. für Wasseroberflächenerhebung oder Durchflussraten)
Erfordert eine Phase-Decharge-Beziehungsdatei
Dateiformat:
*.qsl
Friktionsdatendatei
Format:
*.tbloder*.txt(ASCII)
Restart / Referenz (für Modellvalidierung) Datei
Dateiformat:
.slfoder.medWeitere Informationen in der Telemac2d manual (Abschnitt 4.1.3) (siehe auch Hervouet et al. (2014)).
Abschnittsdatei zur Einstellung von Steuerabschnitten (z.B. Überprüfung von Durchflussraten, Geschwindigkeit oder Wasseroberflächenerhebung)
Quellen (z.B. Wasser oder Sediment) Datendatei
Datei aufheben
Format:
*.tbloder*.txt(ASCII)
Zonen-Dateien, um Reginalreibung oder andere zonale Eigenschaften zu beschreiben
Wenn hydraulische Strukturen in ein Modell integriert werden, werden einige der folgenden Dateien benötigt (je nach Strukturtyp):
Datendatei umwandeln
Weirs Datendatei
Darüber hinaus kann eine FORTRAN (.f)-Datei erstellt werden, um spezielle Randbedingungen, benutzerdefinierte Algorithmen oder die Verwendung von entweder Einzel- oder Doppelpräzision anzugeben.
Mehr Eingabedateien können definiert werden, um Ölverschüttungen, Schadstofftransport, Wind und Tide-Effekte zu simulieren.
Detaillierte Dateibeschreibungen¶
The Steering File (CAS)¶
Die Lenkdatei ist die Hauptsimulationsdatei mit Informationen über obligatorische Dateien (z.B. die selafin Geometrie oder die Grenze), optionale Dateien und Simulationsparameter. Die Lenkdatei kann mit einem Texteditor oder einer erweiterten Software wie Fudaa PrePro oder Blue Kenue erstellt oder bearbeitet werden.
Geometriedateien (SLF oder MED)¶
Die Geometriedatei im Format *.slf (selafin oder SERAFIN) enthält binäre Daten über das Netz mit seinen Knoten. Das Namensformat der Geometriedatei kann in der Lenkdatei mit:
/steering.cas
GEOMETRY FILE : 't2d_channel.slf'
GEOMETRY FILE FORMAT : SLF / or MED with SALOME preferably for 3DMED-Dateien werden typischerweise mit entweder SALOME verarbeitet.
Boundary Bedingungen (CLI oder BND/BCD) und Liquid Boundary (QSL) Dateien¶
Die Randdatei im Format *.cli enthält Informationen über Zufluss- und Abflussknoten (Koordinaten und IDs). Die *.cli-Datei kann mit jedem Texteditor geöffnet und geändert werden, was nicht empfohlen wird, Unstimmigkeiten zu vermeiden. Verwenden Sie vorzugsweise Fudaa PrePro oder Blue Kenue zur Generierung und/oder Modifizierung von *.cli-Dateien (lesen Sie mehr unter TELEMAC pre-processing tutorial). Hier ist ein Beispiel (nur Header) für eine *.cli Randbedingungen Datei:
2 2 2 0.000 0.000 0.000 0.000 2 0.000 0.000 0.000 101 1
2 2 2 0.000 0.000 0.000 0.000 2 0.000 0.000 0.000 102 2
2 2 2 0.000 0.000 0.000 0.000 2 0.000 0.000 0.000 103 3
...*.bnd/*.bcd Dateien können entweder mit SALOME oder einem Texteditor erstellt und bearbeitet werden. Die folgende Blockbox zeigt, wie eine *.bnd Randdatei für eine einfache Blockgeometrie aussehen kann.
4
5 4 4 4 downstream
4 5 5 4 upstream
2 0 0 2 leftwall
2 0 0 2 rightwall
Benutzer können eine flüssige Randbedingungen-Datei (*.qsl) definieren, um zeitabhängige (unsteady) Randbedingungen (z.B. Entladung, Wassertiefe, Strömungsgeschwindigkeit oder Tracer) zu definieren. Der folgende Block zeigt ein Beispiel für eine flüssige Randbedingungen (*.qsl)-Datei:
# bc_unsteady.qsl
# Time-dependent inflow (discharge Q(2) and outflow (depth SL(1)
T Q(1) SL(2)
s m3/s m
0. 0. 5.0
500. 100. 5.0
5000. 150. 5.0Die Randbedingungen und Flüssigkeitsgrenzdateien können in der Lenkdatei hinzugefügt werden mit:
/steering.cas
BOUNDARY CONDITIONS FILE : 'bc_channel.cli'
LIQUID BOUNDARIES FILE : 'bc_unsteady.qsl'Stage-Decharge (oder WSE-Q) Datei (txt - ASCII)¶
Definieren Sie eine Stage-Decharge-Datei, um eine Stufe zu verwenden (Wasser-Oberflächen-Elevation WSE) - Entlade-Beziehung für Randbedingungen. Solche Dateien gelten typischerweise für die stromabwärtige Begrenzung eines Modells an Kontrollabschnitten (z.B. einem freien Überlaufwehr). Der folgende Block zeigt ein Beispiel für eine Stage-Decharge (*.txt)-Datei:
# wse_Q.txt
#
Q(1) Z(1)
m3/s m
50. 0.0
60. 0.9
100. 1.5Um eine Stage-Decharge-Datei zu verwenden, definieren Sie das folgende Schlüsselwort in der Lenkdatei:
/steering.cas
STAGE-DISCHARGE CURVES FILE : YESFriction Data File (tbl/txt - ASCII)¶
Diese optionale Datei ermöglicht die Definition der unteren Reibung in Bezug auf das Rauheitsgesetz zu verwenden und zugehörige Funktionskoeffizienten.
Um Reibungsdaten zu aktivieren und zu verwenden, definieren Sie die folgenden Keywords in der Lenkdatei:
/steering.cas
FRICTION DATA : YES
FRICTION DATA FILE : 'friction.tbl'Die Ergebnisse/Restart-Datei (SLF oder MED)¶
Eine Neustart-Datei stammt aus einer vorherigen TELEMAC-Simulation und muss zu Beginn nicht existieren. Eine gute Möglichkeit zur Visualisierung der Ergebnisse ist die PostTelemac plugin in QGIS. Neue Dateien im MED-Format werden typischerweise mit dem ParaVis-Modul unter SALOME verarbeitet.
Die Ergebnisse/Neustart-Datei kann in der Lenkdatei wie folgt definiert werden:
/steering.cas
RESULTS FILE : 't2d_channel_output.slf'Das Telemac2d manual (Abschnitt 4.1.3) gibt mehr Erläuterungen zur Nutzung von Ergebnissen/Neustart-Dateien (z.B. zur Beschleunigung von Simulationen).
- Hervouet, J. M., Ata, R., & Goeury, C. (2014). User manual of opensource software Telemac 2d (v7p0, p. 123) [usermanT2D]. EDF-R&D. http://www.openmascaret.org