Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Massenerhaltung

This tutorial does not require running code, but we recommend to at least setting up a Telemac model, such as described in the steady 2d tutorial, which eases the understanding of concepts and terms.

Workflow für Mass Conservation

Mit dem Verständnis der Randbedingungen kann ein Telemac-Modell robust nach folgendem Workflow aufgebaut werden:

  1. Make sure to draw liquid boundaries according to the recommendations in the section on boundaries.

  2. For a dry-initialized model (e.g., in the steady 2d tutorial), use 5 5 5 upstream (prescribed Q and H) and a 5 4 4 downstream (prescribed H) boundaries in the .cli file to prescribe steady discharges through the PRESCRIBED FLOWRATES and PRESCRIBED ELEVATIONS keywords, respectively in the steering (.cas) file.

    • A 4 5 5 upstream (prescribed Q) boundary can cause simulation crashes because of supercritical flow conditions resulting from zero water depth and non-zero flow velocity (recall the definition of the Froude number) at the concerned boundary.

    • Die 5 5 5-Grenze des trocken initialisierten Modells erfordert ein gut definiertes Wasserstands-Abfluss Beziehung, das gemäß dem 1d hydraulics Python exercise und dem resultierenden optimalen Wert für das Schlüsselwort ROUGHNESS COEFFICIENT OF BOUNDARIES in der Steuerungsdatei festgelegt werden kann (siehe unten).

    • For a wet-initialized (i.e., hotstarted) model, as described in the unsteady 2d simulation tutorial, use a 4 5 5 upstream (prescribed Q) along with a 5 4 4 downstream (prescribed H) boundary to avoid overdetermined conditions. However, once robustly determined, never modify the ROUGHNESS COEFFICIENT OF BOUNDARIES keyword in the steering file (see below).

    • If necessary, modify boundaries in the .cli file along with the correct keywords in the steering (.cas) file. For more details refer to our tutorial on editing boundaries.

  3. Use the following keywords to prescribe roughness coefficients at the boundaries that correspond to measured Wasserstands-Abfluss Beziehung and back-calculated cross-section averaged hydraulics:

    • ** RECHT DER FRICHTUNG ÜBER LATERAL BOUNDARIES (ganzzahlig) **

    • ROUGHNESS-KOEFFIZIENTER VON BOUNDARIEN (Float)

    • To back-calculate a roughness (friction) coefficient corresponding to a measured pair of water depth and discharge, take a look at the Python exercise on 1-d hydraulics for solving the Manning-Strickler formula.

    • Beachten Sie, dass **die Verwendung dieser Schlüsselwörter ** dazu führt, dass jede Rauheitskalibrierung ** die Massenbilanz beeinflusst *.

  4. Führen Sie stetige Simulationen mit **PRESCRIBED FLOWRATES ** aus, die Entladungen entsprechen, für die hydraulische (z. B. Wassertiefe und Strömungsgeschwindigkeit) **Messungen ** zur Verfügung stehen, um die Rauheit ** zu kalibrieren (dh **FRICTION **).

    • Jede anfängliche stationäre Zustandssimulation sollte ausreichend lang laufen (\geq104^4timesteps), um mass convergence zu erreichen, dh nahezu gleiche Zu- und Abflüsse, die über das Schlüsselwort MASSENBALANCE : JA geschrieben werden.

    • The roughness should be preferably defined specifically for zones with equal terrain attributes (e.g., cobble, sand bar, or vegetation), as described in the spotlight focus on defining roughness zones. As a result, simulated and measured water depths (or water surface elevations) and flow velocities should be in similar ranges (not more than ±0.10 m difference).

  5. Verwenden Sie das kalibrierte Modell für Ihre Zwecke mit Hotstart-Bedingungen:

    • Das Schlüsselwort PRESCRIBED FLOWRATES in der .cas-Datei reicht aus, um physische habitat suitability indices für bestimmte Entladungen zu berechnen.

    • Define unsteady inflows through a hydrograph file, such as inflows.liq used in the unsteady 2d tutorial.

Zusätzliche Steering File Keywords

Während einer Simulation kann die Massenbilanz beobachtet werden, indem das Schlüsselwort MASSENBALANCE in der Steuerungsdatei aktiviert wird, was jedoch ** keine Massenbilanz** erzwingt:

/ steering .cas file
MASS-BALANCE : YES

After the simulation, the conservation of mass can be verified as discussed in the analysis of the results in the steady 2d tutorial.

Die Priorität, die Telemac verwendet, um eine Massenbilanz zu erhalten, kann definiert werden mit:

/ steering .cas file
TREATMENT OF FLUXES AT THE BOUNDARIES : 1 / 1-priority of prescribed values, 2-priority of correct fluxes

Andere schlüsselwörter können definiert werden, um nicht nur zu beobachten, sondern auch die massenbilanz zu verbessern. Zum Beispiel ist die Standardanzahl von Grenzknoten in einer Lenkdatei 30, was in einem großen Modell schnell überschritten wird. Wenn es also mehr als 30 Randknoten gibt, erhöhen Sie die maximale Anzahl von Randknoten in der Steuerungsdatei (.cas), zum Beispiel auf 50:

/ steering .cas file
MAXIMUM NUMBER OF BOUNDARIES : 50

Also, too small water depths can cause supercritical flows at liquid boundaries, which should be avoided, either by correctly defining the boundary nodes at the bottom of the riverbed only (recall the recommendations to draw liquid boundaries) or by increasing the minimum water depth from its default value of 0.1 m to a higher value in the steering file, for example to 0.2 m:

/ steering .cas file
MINIMUM DEPTH TO COMPUTE TIDAL VELOCITIES BOUNDARY CONDITIONS : 0.2
MINIMUM DEPTH TO COMPUTE TIDAL VELOCITIES INITIAL CONDITIONS : 0.2

In addition, the MINIMUM VALUE OF DEPTH keyword may be increased from its default value of 0.0, but such increases might negatively effect on the mass balance.

Um die Rechengeschwindigkeit zu erhöhen, empfehlen einige Tutorials die Verwendung von Massenklumpen, die sich jedoch negativ auf die Massenerhaltung auswirken: