(glossary)=
# Glossary

This section provides a glossary with technical terms recurring in this eBook. While it is intended to be as exhaustive as possible, some terms might not yet be defined. 

````{glossary}
  
Advection
  Advection is the motion of particles along with the bulk flow. The properties (e.g., heat) of an advected particle or substance are conserved. Mathematically, advection of incompressible fluids (e.g., water) is described by the {term}`Continuity equation` {cite:p}`kundu_fluid_2008`.

  *French: Advection <br>German: Advektion*

Anabranch
  An anabranched river (section) is characterized by one or more side channels diverting from the main river stem. Anabranching (or also anastomosing) channels occur primarily in alluvial channel beds where more sediment is available than the water runoff can transport (transport capacity-limited rivers). Thus, an anabranching river has high sediment loads and channel avulsion is likely to occur during floods {cite:p}`nanson_anabranching_1996,riquier_are_2017,huang_why_2007`. This eBook shows an example for an anabranching river section in the morphdynamic modeling tutorial in {numref}`Fig. %s <jenbach-2020>`.

  *French: Anabranche <br>German: Flussarm*

Anastomosing rivers
  See {term}`Anabranch`.

ASCII
  The American Standard Code for Information Interchange (ASCII) is an encoding standard for text on computers. The development of ASCII goes back to telegraphy and was first published in 1961 for the Latin alphabet. It was later extended by other alphabets and special characters {cite:p}`ascii1980`. ASCII code represents characters in the form of numbers. For instance, the ASCII code `65` represents uppercase `A` (utf-8 encoding). In Python applications, ASCII code numbers can be useful to iterate through the alphabet (e.g., alphabetic column names), where `chr(ASCII)` returns a letter as a function of the system encoding. For instance, in Python, `print(chr(78))` returns uppercase `N` for **utf-8** encoding (default on many Linux systems). To find out the encoding type of your Python installation, open a Python terminal, tap `import sys` and `sys.getdefaultencoding()`.

Bedload
  Bedload (also referred to as *bed load*) $Q_b$ (or $q_b$ for unit bedload) in kg$\cdot$s$^{-1}$ (or kg$\cdot$s$^{-1}\cdot$m$^{-1}$) is a special type of {term}`Sediment transport` describing the displacement of coarse particles by rolling, sliding, and/or jumping on the riverbed. In river hydraulics, the so-called {term}`dimensionless bed shear stress <Dimensionless bed shear stress>` or also referred to as {term}`Shields parameter` {cite:p}`shields_anwendung_1936` is often used as the threshold value for the mobilization of sediment from the riverbed. The dimensionless expression of bedload transport is {cite:p}`einstein_bed-load_1950`:

  $$
  \Phi_b = \frac{q_b}{\rho_{w} \sqrt{(s - 1) g D^{3}_{pq}}} \approx \frac{Q_b}{0.5\cdot(b + B)\rho_{w} \sqrt{(s - 1) g D^{3}_{pq}}}
  $$

  where $\rho_{w}$ is the density of water; $s$ is the ratio of sediment grain and water density (typically 2.68) {cite:p}`schwindt_hydro-morphological_2017`; $g$ is gravitational acceleration; $D_{pq}$ is the grain diameter of which $pq \%$ of the mixture are finer; and $b$ and $B$ are the channel bottom and surface width, respectively (or cell width/height in a 2d numerical model).

  Read more about the calculation of bedload in this eBook in the {ref}`Python exercises <mpm>` or the {ref}`Telemac2d-Gaia tutorial <tm-gaia>`. In numerical models, bedload transport is often computed using the {term}`Exner equation`.

  ```{image} https://github.com/Ecohydraulics/media/raw/main/png/sediment-uptake.png
  ```

  In addition, the term *traveling bedload* refers to a transport mode that is similar to wash load, but without suspended load {cite:p}`yu_effect_2009,piton_sediment_2016`.

  *French: Charriage <br>German: Geschiebtransport*

Benthos
   The betnhos is composed of organisms inhabiting the bottom of aquatic environments, including oceans, lakes, and rivers. Benthic organisms reside in close proximity to the substrate and comprise various species like invertebrates (e.g., worms, mollusks, crustaceans, and insects), certain fish, and amphibians. The benthos plays a crucial role in nutrient cycling, organic matter decomposition, and it serves as a food source for higher trophic levels {cite:p}`flint1975effects, costello2009distinguishing`.

Boussinesq approximation
  The Boussinesq approximation of the {term}`continuity equation <Continuity equation>` assumes that density variations can be neglected except for the gravity term (i.e., in the vertical momentum equations). In addition, the Boussinesq approximation assumes that a fluid is incompressible and that wave motion is inviscid {cite:p}`boussinesq_essai_1877,spiegel1960`. Caution: not to be confused with the {term}`Boussinesq hypothesis`.

  *French: approximation de Boussinesq<br>German: Boussinesq-Approximation*

Boussinesq hypothesis
  The Boussinesq hypothesis states that the turbulent stresses are related to the mean velocity gradients in a similar way as the viscous stresses are related to the total velocity gradients {cite:p}`glegg_chapter_2017`. In practice, the Boussinesq hypothesis corresponds to the assumption that the momentum transfer caused by turbulent eddies can be modeled with an eddy viscosity, which is important, for example, for turbulence closures (e.g., in {term}`RANS` models) {cite:p}`boussinesq_essai_1877,schmitt_boussinesq_2007`. Caution: not to be confused with the {term}`Boussinesq approximation`.

  *French: hypothèse de Boussinesq<br>German: Näherung von Boussinesq*

Braiding
  A braiding river morphology refers to anabranched channel networks with high {term}`bedload <Bedload>` supply, mostly located in moderately steep mid-land to mountain rivers {cite:p}`leopold_river_1957, rosgen_classification_1994`.

  ```{figure} ../img/nature/devoll-alluvial-braided-2021.jpg
  :alt: river geomorphology anabranch tresse zopfform
  :name: braided-channel

  A braided section of the Devolli River (Albania). Source: Sebastian Schwindt (2021)
  ```

  *French: en tresse <br>German: Geflecht- bzw. Zopfausbildung (?)*

CFD
  **Computational Fluid Dynamics (CFD)** is a branch of fluid mechanics that uses numerical methods and algorithms to analyze and (iteratively) solve problems involving fluid flows.

  CFD involves the simulation of fluid behavior, such as the movement of air, water, or gases, by solving the governing mathematical equations (typically the {term}`Navier-Stokes equations`) using iterative computational techniques. These simulations provide insights into complex fluid dynamics phenomena, including turbulence, heat transfer, chemical reactions, and multiphase flows.

  CFD is widely applied in a variety of industries, including aerospace, automotive, civil engineering, or energy production, to optimize designs, predict performance, and improve efficiency. General-purpose CFD tools are specialized software such as {ref}`OpenFOAM <chpt-openfoam>` (open source), FLOW-3D (proprietary), ANSYS Fluent (proprietary), or STAR-CCM+ (proprietary). Although {ref}`Telemac <chpt-telemac>` falls under the broader category of CFD software due to its ability to solve fluid flow problems using numerical techniques, it is more specialized for free surface flow and sediment transport than general-purpose CFD software.

CFL
  In the field of hydrodynamics, the abbreviation CFL commonly refers to the **Courant-Friedrichs-Lewy** condition, which represents a convergence criterion for the numerical solution to the {term}`Navier-Stokes equations` (partial differential equations, PDEs). The CFL applies to explicit time integration schemes that may become unstable for large time steps as a function of the size of mesh cells. Today, most numerical software uses an internal value for the CFL to adaptively calculate the maximum time step that is required for the stability of explicit solvers. In 2d modelling, the CFL condition is defined as $c_{cfl}={u_x \cdot \Delta t}/\Delta x + {u_y \cdot \Delta t}/\Delta y$, where $\Delta t$ is the time step, $\Delta x$ and $\Delta y$ are grid cell sizes in $x$ and $y$ directions of the coordinate reference system, and $u_x$ and $u_y$ are the flow velocities in the $x$ and $y$ directions. An explicit solver is assumed to be stable when $c_{cfl} \leq c_{cfl, crit}$, where the critical value $c_{cfl, crit}$ for the CFL condition must be smaller than 1.0. To this end, numerical modelling software, such as BASEMENT, uses a default value of $c_{cfl, crit} = 0.9$.

  *French: Nombre de Courant <br>German: CFL-Zahl*

Clogging
  Riverbed clogging describes the sedimentation of the porous coarse sediment matrix of the hyporheic zone under and along gravel-cobble-bed rivers. We differentiate between external and internal clogging: external clogging affects surficial layers and is a direct consequence of the deposition of fine, cohesive sediment; internal clogging occurs in deeper layers of the hyporheic zone and is the consequence of spontaneous percolation or grain sorting at the surface {cite:p}`berkman_effect_1987,schaelchli_clogging_1992`.

  ```{figure} ../img/nature/outer-clogging.jpg
  :alt: riverbed clogging siltation colmation colmatation Kolmation
  :name: outer-clogging

  Example of outer riverbed clogging of a coarse sediment matrix with fine muddy sediment. Picture: Sebastian Schwindt (2021).
  ```

  *French: Colmation/colmatation <br>German: Kolmation*

Continuity equation
  The differential form of the continuity equation is $\frac{\partial \psi}{\partial t}+\mathbf{u} \cdot \nabla \psi = 0$ where $\psi$ is a constant of the particle/substance in consideration and $\mathbf{u}$ is the fluid velocity vector. The $\nabla$ operator is literally a vector of partial differential operators $\frac{\partial}{\partial x_i}$ where $x_i$ refers to the dimensions of the flow field. In the case of steady flow (no variability in time) the advection equation becomes $\mathbf{u} \cdot \nabla \psi = 0$ {cite:p}`kundu_fluid_2008`.

  The mass continuity equation of an incompressible fluid, such as water, considers the constant $\Psi$ as a mass and has the form $\nabla \cdot \mathbf{u} = 0$ or $\frac{\partial u_i}{\partial x_i} = 0$ {cite:p}`kundu_fluid_2008`.

  *French: Équation de continuité <br>German: Kontinuitätsgleichung*

Convection
  Convection encompasses {term}`Advection` and {term}`Diffusion` {cite:p}`kundu_fluid_2008`. Thus, convection is fluid motion because of bulk transport (water flowing in a river with reference to {term}`Advection`) and dispersion of a fluid component from high-density to low-density regions ({term}`Diffusion`) in the flow field (e.g., an ink drop dispersing in a river).

  *French: Convection <br>German: Konvektion*

CRS
  A Coordinate Reference System (CRS), also referred to as Spatial Reference System (**SRS**), is an orientation unit system to geographically locate objects in a map. The CRS involves an origin ($x$=0.0 and $y$=0.0) and a projection. Objects of one map can be put into another map through the transformation of their CRS with respect to the coordinates and the projection. Read more about CRS in the section on {ref}`Projections and Coordinate Systems <prj>`.

  *French: Système de coordonnées <br>German: Koordinatenreferenzsystem / Koordinatenbezugsystem (KBS)*

CSV
  The Comma-Separated Values (CSV) file format describes the structure of a text file storing simply structured data. The file name extension is `*.csv`, which may also contain Tab-Separated Values (TSV). The separator (i.e., comma, semicolon, or tab) sign delimits (or separates) colon values in one line of a `*.csv` file. Spreadsheet software, such as {ref}`Libre Office Calc <lo>`, enables to import and process `*.csv` files for cell-formula based data analyses.

DEM
  A Digital Elevation Model (DEM) represents the bare Earth's topographic surface excluding objects such as buildings or trees. In contrast, a Digital Surface Model (DSM) includes objects such as trees or buildings. In addition, a Digital Terrain Model (DTM) represents similar data to a DEM and both DEM and DTM can be used synonymously in many regions of the world. However, in the United States, a DTM refers to a {ref}`Vector <vector>` (regularly spaced points) dataset while a DEM is a {ref}`raster` dataset. The translation into other languages does not go along with the same definition of a DEM, DSM, and DTM, and the following translations refer to the English definitions rather than the same (translated) words.

  *French for DSM: Modèle numérique d'élévation (MNE) <br>German for DSM: Digitales Höhenmodell (DHM)*

  *French for DEM: Modèle numérique de terrain (MNT) <br>German for DEM: Digitales Oberflächenmodell (DOM)*

  *French for DTM: Modèle numérique d'élévation (MNE) <br>German for DTM: Digitales Geländemodell (DGM)*

  Ultimately, there are many options for *correct* DEM-terminology depending on the region where you are. Now, what is the correct term in which language? There is no universal answer to this question and a good choice is to be patient with the communication partner.


Diadromous
  Diadromous fish {term}`guilds <Guild>` migrate between the sea and freshwater in their life cycle, as opposed to {term}`potamodromous fish <Potamodromous>` that only migrates in freshwater regions. Within diadromous fish guilds, further distinction is made between sub-guilds {cite:p}`myers_fish_1949`:
  
  * *Anadromous* fish live in the seas and migrate to freshwaters, mainly for reproduction. Examples for anadromous fish are sea trout (*Salmo trutta trutta*) or Pacific salmon (*Oncorhynchus*).
  * *Catadromous* fish live in freshwaters and migrate to the sea for reproduction. An example for catadromous fish is American eel (*Anguilla rostrata*).
  * *Amphidromous* fish migrate regularly between the sea and freshwaters. An example for amphidromous fish is round goby (*Neogobius melanostomus*) {cite:p}`lecaudey_fish_2019`.

Diffusion
  Diffusion is the result of random motion of particles, driven by differences in concentration (e.g., dissipation of highly concentrated particles towards regions of low concentration). Mathematically, diffusion is described by $\frac{\partial \psi}{\partial t} = \nabla \cdot (D \nabla \psi)$ where $\psi$ is a constant of the particle/substance in consideration; $D$ is a diffusion coefficient (or diffusivity) in m$^2$/s, which is a proportionality constant between molecular flux and the gradient of a substance (or species). The $\nabla$ (*nabla*) operator is a vector of partial differentials $\frac{\partial}{\partial x_i}$ where $x_i$ refers to the dimensions of the flow field {cite:p}`kundu_fluid_2008`.

  *French: Diffusion <br>German: Diffusion*

Dimensionless bed shear stress
  The dimensionless bed shear stress $\tau_x$ (in the literature often called $\theta$) is derived from the shear forces that act on the riverbed as a result of flowing water. $\tau_x$ is a key parameter in the calculation of {term}`bedload <Bedload>` transport where many semi-empiric equations assume that a sediment grain is mobile when a particle size-related, critical value of the dimensionless bed shear stress is exceeded. This critical value of dimensionless bed shear stress is also referred to as {term}`Shields parameter`. To this end, $\tau_x$ is calculated based on hydraulic characteristics and the characteristic grain size $D_{pq}$ {cite:p}`von_karman_mechanische_1930,kramer_modellgeschiebe_1932`:

  $$
  \tau_{x} = \frac{\rho_w \cdot g \cdot R_h \cdot S_e}{\rho_w \cdot g \cdot \left(s-1\right) \cdot D_{pq}}
  $$

  where $R_h$ is the hydraulic radius (cf. calculation in the {ref}`1d hydraulic Python exercise <calc-1d-hyd>`); $S_{e}$ is energy slope; and $s$ is the ratio of sediment grain and water density (typically 2.68) {cite:p}`schwindt_hydro-morphological_2017`. $R_h$ may be substituted by water depth in wide rivers with monotonous cross-sectional shape and for (grid) cells of a 2d numerical model. The terms $\rho_w$ (water density) and $g$ (gravitational acceleration) cancel in the nominator and denominator, and are provided here to make clear that the nominator essentially is (dimensional) bed shear stress.

  *French: Cisaillement adimensionel <br>German: Dimensionslose Schubspannung*


Dirichlet boundary condition
  A Dirichlet boundary condition (after Johann Peter Gustav Lejeune Dirichlet) prescribes values for the solutions of ordinary or partial differential equations at the boundaries (i.e., outer edges) of a (numerical) model. This is why Dirichlet boundary conditions are also called first-order boundary conditions. In contrast, a second-order {term}`Neumann boundary condition` prescribes values for the derivatives of ordinary or partial differential equations {cite:p}`kundu_fluid_2008`.

  *French: Condition aux limites de Dirichlet <br>German: Dirichlet-Randbedingung*


Echo sounder
  An echo sounder emits an acoustic signal under water, which is reflected by the objects of the underwater landscape. Echo sounding is an active {term}`Sonar` technique and enables the creation of an underwater DEM, which is also referred to as bathymetry. To perform echo sounding a probe must be installed on a boat that requires a minimum navigable water depth. In addition, the use of the echo sounder (probe) itself also requires a minimum water depth to operate with little noise inference. Therefore, by experience, a minimum water depth of 1-2 m is necessary to survey the bathymetry of a river by echo sounding. Echo sounding can be performed with single-beam (one underwater spot) or multi-beam (underwater surface) devices.

  *French: Échosondeur / Sondeur acoustique <br>German: Echolot / Fächerecholot*

Ethohydraulics
  Ethohydraulics is the interdisciplinary study of aquatic animal behavior in response to hydraulic environments, particularly focusing on how organisms interact with water flow patterns in their natural habitats. The term is a blend of "ethology" and "hydraulics", coined to describe a scientific field merging behavioral ecology with fluid mechanics. Thus, ethohydraulics investigates how fish species adapt their swimming behavior to different water currents in rivers and streams {cite:p}`lehmann2022ethohydraulics`.

  *French: ethohydraulique (f) <br>German: Ethohydraulik (w)*

Exner equation
  The {cite:t}`exner_uber_1925` equation yields sediment mass conservation in a hydro-morphodynamic model (see also the {ref}`TELEMAC-Gaia tutorial <tm-gaia>`) and expresses that the time-dependent {term}`Topographic change` rate $\frac{\partial \eta}{\partial t}$ equals the unit sediment ({term}`bedload <Bedload>`) fluxes $q_b$ over the boundaries {cite:p}`hirano1971,blom2003`:

  $$
  \frac{\partial \eta}{\partial t} = -\frac{1}{\epsilon}\frac{\partial q_b}{\partial x}
  $$

  where $\epsilon$ is the porosity of the active transport (riverbed) layer, and $\eta$ is the thickness of the active (riverbed) transport layer.

  ```{admonition} TELEMAC-Gaia uses a mass-conservative form of the Exner equation
  :class: note, dropdown

  TELEMAC's morphodynamics module {ref}`Gaia <tm-gaia>` uses a vertical integral of a mass transport vector $\boldsymbol{q_b}$ in the Exner equation, which accounts for the sediment grain density $\rho_s$:

  $$
  \left(1 - \epsilon\right) \frac{\partial \left(\rho_s \eta\right)}{\partial t} + \nabla \cdot \left(\rho_s \boldsymbol{q_b} \eta \right) = 0
  $$

  The $\nabla$ operator is a vector of partial differentials $\frac{\partial}{\partial x_i}$ where $x_i$ refers to the dimensions of the flow field {cite:p}`kundu_fluid_2008`.  The unit bedload transport vector $\boldsymbol{q_b}$ is composed of an $x$ and a $y$ component:

  $$
  \boldsymbol{q_b} =  \begin{pmatrix}q_{b_x} \\ q_{b_y} \end{pmatrix}  =  \begin{pmatrix}q_{b} \cos \alpha \\ q_{b} \sin \alpha  \end{pmatrix}
  $$

  where $\alpha$ is the angle between the longitudinal channel ($x$) axis and the bedload transport vector $\boldsymbol{q_b}$.
  ```

  *French: Équation de Exner <br>German: Exner-Gleichung*


Froude number
  The Froude number $Fr$ is the ratio between inertia and gravity forces and it is a key number of wave propagation. Thus, $Fr$ states whether information can be transmitted in upstream direction or not {cite:p}`chow59,hager09,hager10`:

  $$
  Fr^2 = \frac{Q^2}{A^3 g} \frac{\partial A}{\partial h}\begin{cases} < 1 \rightarrow \mbox{ subcritical flow (upstream and downstream wave propagation)} \\ = 1 \rightarrow \mbox{critical flow (standing waves in upstream direction)} \\ > 1 \rightarrow \mbox{ supercritical flow (downstream wave propagation only)} \end{cases}
  $$

  The transition from supercritical flow to subcritical flow is called *hydraulic jump*. For a rectangular cross section $A$, the Froude number becomes:

  $$
  Fr = \frac{u}{\sqrt{g \cdot h}}
  $$

  The Froude number is also the basis for scaling many sediment transport phenomena in open channel flow {cite:p}`yalin71,yalin77`.

  *French: Nombre de Froude <br>German: Froude-Zahl*

GeoTIFF
  The Georeferenced Tag Image File Format (GeoTIFF) links geographic positions to {ref}`raster` images. A GeoTIFF involves multiple files containing the tagged image itself (`*.tif` file), a world file (`*.tfw` file) containing information about the geographic reference and projection system, and potentially an `*.ovr` file that links the GeoTIFF with other resource data. Read more at the *Open Geospatial Consortium*'s [standard for GeoTIFF](https://www.ogc.org/standards/geotiff).

Geomorphic heterogeneity
  Geomorphic heterogeneity describes the spatial pattern of gemorphic units (e.g., {term}`Riffle pool`) within the {term}`River corridor`. It describes the non-uniformity of a river compared with a monotonous trapezoidal or rectangular artificial channel {cite:p}`wohlegu2022`.

Guild
  An ecological guild describes a group of species that share common ecosystem resources. Species in a guild are not necessarily related to each other, nor do they necessarily use similar ecological niches. The term guild was introduced by {cite:t}`root_niche_1967` and is used in ecohydraulics to describe (physical) habitat preferences of fish species and their lifestages. For instance, we may differentiate between {term}`reophilic <Reophile>` and {term}`limnophilous <Limnophile>` fish guilds. In addition, we can distinguish between fish {term}`spawning guilds <Spawning guild>`, and {term}`potamodromous <Potamodromous>`, {term}`oceanmodromous <Oceanodromous>` and {term}`diadromous <Diadromous>` migration guilds.

  *French: Guilde (f) <br>German: Gilde (w)*

HDF
  The [Hierarchical Data Format (HDF)](https://www.hdfgroup.org/) provides the `*.h5` (HDF4) and `*.h5` (HDF5) file formats that store large datasets in an organized manner. HDF is often used with high-performance computing (HPC) applications, such as numerical models, to store large amounts of data output. This eBook impinges on HDF datasets in the {ref}`chpt-basement` tutorial where {term}`xdmf` files represent the model output, and in the {ref}`chpt-telemac` tutorials. In particular, Telemac builds on mesh and boundary files of the EnSim Core that is described in the user manual of the pre- and post-processing software [Blue Kenue](https://chyms.nrc.gc.ca/download_public/KenueClub/BlueKenue/2011_UserManual.pdf)<sup>TM</sup> (the newest [Blue Kenue installer](https://chyms.nrc.gc.ca/download_public/KenueClub/BlueKenue/Installer/BlueKenue_3.12.0-alpha+20201006_64bit.msi) contains an updated version of the user manual). Understanding the HDF format significantly facilitates troubleshooting structural errors of computational meshes for numerical models.

Hyporheic zone
  The hyporheic zone is the space under and along rivers where surface water and groundwater exchange takes place. The exchange processes of a functional, non-{term}`clogged <Clogging>` hyporheic zone are important for the ecosystem, in particular for fish spawning {cite:p}`boulton_hyporheic_1998`.

Kolmogorov microscales
  The Russian mathematician Andrey Nikolaevich Kolmogorov introduced the concept that the smallest scales of turbulence are similar for any turbulent flow (i.e., universal) {cite:p}`youschkevitch_kolmogorov_1983`. According to this concept, the so-called Kolmogorov microscales, the {term}`turbulent kinetic energy <Turbulent kinetic energy>` dissipates to heat when viscosity dominates. The Kolmogorov microscales can be calculated for length, time, and velocity units as a function of the kinematic viscosity $\nu$, and the dissipation rate $\epsilon$ of {term}`turbulent kinetic energy <Turbulent kinetic energy>` (per unit mass).

  The Kolmogorov length scale $\eta_L$ is calculated as follows, and typically is in the order of 0.1-10 m$^{-3}$ {cite:p}`dey_fluvial_2014`:

  $$
  \eta_L = {\left( \frac{\nu^3 }{\epsilon } \right)} ^{1/4}
  $$

  The Kolmogorov time scale $\eta_T$ is calculated as {cite:p}`dey_fluvial_2014`:

  $$
  \eta_T = {\left( \frac{\nu}{\epsilon } \right)} ^{1/2}
  $$

  The Kolmogorov velocity scale $\eta_U$ is calculated as {cite:p}`dey_fluvial_2014`:

  $$
  \eta_U = ( \nu \cdot \epsilon )^{1/4}
  $$

Krylov space
  Krylov (sub) spaces are used in numerical approximation schemes for finding solutions to sparse (many zero entries), high-dimensional linear systems {cite:p}`bunch1974`. To this end, Krylov (sub) space methods use Gaussian elimination (e.g., {term}`LU decomposition`) to speed up calculations {cite:p}`gutknecht2007`.

  *French: Sous-espaces de Krylov / Méthode de la puissance itérée <br>German: Krylowraum*

IAHR
  The International Association for Hydro-Environment Engineering and Research (IAHR) is an independent non-profit organization that unites professionals in the field of water resources. The IAHR has multiple branches and publishes several journals in collaboration with external publishing companies. Read more about the IAHR at [https://www.iahr.org](https://www.iahr.org).

Lidar
  Light Detection and Ranging (*LiDAR* or *lidar*) uses laser pulses to measure earth surface properties such as canopy or terrain elevation. The laser pulses are sent from a remote sensing platform (fix station or airborne) to surfaces, which reflect the pulses with different speed (time-of-flight informs about terrain elevation) and energy pattern (leaves behave differently than rock). In its raw form, lidar data is a point cloud with various, geo-referenced information about the reflected signal. Lidar point clouds for end users are typically stored in *las* format or compressed *laz* format. *las*-formatted data are much faster to process, but also much larger than *laz*-formatted data. For this reason, lidar data are preferably transferred in *laz* format, while the *las* format is preferably used for processing lidar data.

Limnophile
  The term limnophile is used as a noun in reference to species that prefer to live in calm waters. Thus, limnophilous species, such as common rudd (*Scardinius erythrophthalmus*), colonize slow-flowing to stagnant fresh water regions. Unlike limnophilous species, reophilic species prefer fast flowing regions (see also {term}`Reophile`).

  *French: <br>German: limnophil*

LU decomposition
  A lower-upper (LU) decomposition applies to the solution of linear systems (matrices) by re-organizing a matrix of equations into an upper and a lower triangular matrix. Thus, LU decomposition is a form of Gaussian elimination, which is typically applied in numerical analysis (e.g., {ref}`Telemac2d <tm2d-solver-pars>`) or machine learning.

  *French: Décomposition LU <br>German: LR Zerlegung (Gaußsches Eliminationsverfahren)*

MPI
  In computing, MPI stands for *Message Passing Interface*, which is a portable message passing standard. MPI is implemented in many open-source C, C++, and Fortran applications to enable parallel computing.

Navier-Stokes equations
  The general form of the Navier-Stokes equations describes the motion of a Newtonian fluid and expresses the conservation of mass and momentum {cite:p}`batchelor_2000_chpt3`. The Navier-Stokes equations is a special type of {term}`Continuity equation` that is derived from Cauchy's equation (conservation of momentum). The equation simplifies with the assumption of incompressible fluids and reduces to the *Euler equation* when viscous effects are negligible, which is generally the case in far distance from the boundaries {cite:p}`kundu_fluid_2008`.
  A theoretical, exact solution of the Navier-Stokes equations would yield a perfect description of many natural processes. However, the underlying system equations involves more unknown parameters than equations. For this reason, rigorous simplifications (e.g., the {term}`Shallow water equations`) and numerical approximations with considerably larger computational effort than for an analytical solution are necessary for the solution of the Navier-Stokes equations. Simplification hypotheses are, for example, a hydrostatic pressure distribution (leading to the shallow water equations) or the assumption that a fluid is incompressible.
  Contemporary models predominantly use a specific form of the Navier-Stokes equations, notably the {term}`Reynolds-averaged Navier-Stokes (RANS) <RANS>` equations.

  *French: Équations de Navier-Stokes <br>German: Navier-Stokes-Gleichungen*

Neumann boundary condition
  A Neumann boundary condition (after Carl Gottfried Neumann) prescribes values for the derivatives of ordinary or partial differential equations at the boundaries (i.e., outer edges) of a (numerical) model. This is why Neumann boundary conditions are also called second-order boundary conditions. In contrast, a first-order {term}`Dirichlet boundary condition` prescribes values for the solutions of ordinary or partial differential equations {cite:p}`kundu_fluid_2008`.

  *French: Condition aux limites de Neumann <br>German: Neumann-Randbedingung*

Oceanodromous
  Oceanodromous {term}`fish guilds <Guild>` exclusively live in oceans. While oceanodromous fish may encounter {term}`diadromous fish <Diadromous>` (migrate from the sea to freshwaters), they will very likely never meet {term}`potamodromous <Potamodromous>` fish {cite:p}`myers_fish_1949`. Examples for oceanmodromous fish are Atlantic mackerels (*Scomber scombrus*) or Atlantic herring (*Clupea harengus*).

Operating System
  An Operating System (OS) manages the hardware of a computer, software (resources), and services for any program you want to install.

  *French: Système d'exploitation <br>German: Betriebssystem*

Pelagic zone
  The pelagic zone encompasses the open water column in oceans, seas, and (large) lakes, excluding the bottom and coastal areas. The pelagic zone is divided into subzones based on depth and light penetration, including the epipelagic (surface layer), mesopelagic (twilight zone), bathypelagic (midnight zone), and abyssopelagic (abyssal zone). This zone is inhabited by pelagic organisms, such as fish, marine mammals, and plankton, which are adapted to life in the water column (away from the seafloor, that is, {term}`benthos <Benthos>`) {cite:p}`costello2009distinguishing`.

Plane bed
  A plane bed refers to a type of riverbed that is characterized by irregular bedforms with distant, varying confinement, often in transition between transport capacity-limited and sediment supply-limited river sections {cite:p}`schwindt_hydro-morphological_2017`.

  ```{figure} ../img/nature/plane_bed_Drance.jpg
  :alt: planebed plane bed river stream example geomorphology
  :name: plane-bed

  Example of a plane bed river section at the Drance (VS, Switzerland). Picture: Sebastian Schwindt (2016).
  ```

Potamodromous
  Potamodromous {term}`fish guilds <Guild>` live and migrate in freshwater regions. Their migration is mostly due to reproduction. The difference with {term}`diadromous fish <Diadromous>` is that those migrate from the sea to freshwater regions. In addition, potamodromous fish will very likely never meet {term}`oceanmodromous <Oceanodromous>` fish {cite:p}`myers_fish_1949`. Examples for potamodromous fish are eal (*Anguilla anguilla*) and river trout (*Salmo trutta fario*).


RANS
  The Reynolds-averaged Navier-Stokes (RANS) equations are a statistical approximation of the {term}`Navier-Stokes equations` to model turbulence with a time average and variance of velocity and pressure. Specifically, RANS solutions at coarse scales (i.e., coarser than {term}`Kolmogorov microscales`) account for turbulence by replacing velocity $u_k$ (and pressure) components by a mean value $\overline{u_k}$ and fluctuations $u'_k$ around this mean value {cite:p}`nikora_double-averaging_2007`. The subscript $_k$ indicates flow directions 1 (streamwise/longitudinal $x$-direction), 2 (lateral / $y$-direction), and 3 (vertical / $z$-direction). The RANS equations read as follows {cite:p}`franca_turbulence_2015` for mass balance (Reynolds-averaged {term}`continuity equation <Continuity equation>`):

  $$
  \frac{\partial \left(\rho_w\overline{u_k}\right)}{\partial x_k} = 0
  $$

  where $\rho_w$ denotes water density and $u$ is the flow velocity. The RANS momentum balance reads as follows {cite:p}`franca_turbulence_2015`:

  $$
  \overbrace{\frac{\partial \left(\rho_w \overline{u_j}\right)}{\partial t}}^{I} + \textcolor{orange}{\overbrace{\frac{\partial \left(\overline{\rho'_w u'_j}\right)}{\partial t}}^{II}} + \overbrace{\frac{\partial \left(\overline{u_k} \overline{\rho_w} \overline{u_j}\right)}{\partial x_k}}^{III} + \textcolor{orange}{\overbrace{\frac{\partial \left(\overline{u_k} \overline{\rho'_w u_j'}\right)}{\partial x_k}}^{IV}} + \textcolor{orange}{\overbrace{\frac{\partial \left(\overline{u_j} \overline{\rho'_w u_k'}\right)}{\partial x_k}}^{V}} =\\\ \overbrace{-\frac{\partial \overline{p}}{\partial x_j}}^{VI} + \overbrace{\mu \frac{\partial^2 u_j}{\partial x_k \partial x_k}}^{VII}
   -\overbrace{\frac{\partial \overline{\rho_w} \overline{u'_k u'_j}}{\partial x_k}}^{VIII} - \textcolor{orange}{\overbrace{\frac{\partial \overline{\rho'_w u'_k u'_j}}{\partial x_k}}^{IX}} + \overbrace{\overline{\rho_w} g}^{X}
  $$

  where subscript $_j$ is analogous to $_k$, $t$ denotes time, $p$ is pressure, and $\mu$ is the dynamic viscosity (of water). The terms I to X have the following meanings:

  * I local derivative of (time) averaged momentum
  * <font color='orange'>II local derivative of averaged momentum fluctuation</font>
  * III mean {term}`advection <Advection>` of averaged momentum
  * <font color='orange'>IV mean {term}`advection <Advection>` of momentum fluctuation (in $_k$ direction)</font>
  * <font color='orange'>V mean {term}`advection <Advection>` of momentum fluctuation (in $_j$ direction)</font>
  * VI averaged pressure
  * VII viscous diffusion
  * VIII Reynolds stress
  * <font color='orange'>IX turbulent {term}`diffusion <Diffusion>` (i.e., turbulent transport of momentum fluctuation)</font>
  * X average body force / gravity

  The <font color='orange'>orange-color</font> terms involve <font color='orange'>density fluctuation</font>, and thus, <font color='orange'>cancel out</font> when using the {term}`Boussinesq approximation`. In term VIII, $\overline{u'_k u'_j}$ denotes the Reynolds stress tensor, which is an additional stress that results from Reynolds averaging, and poses a closure problem. To this end, the (in)famous $k$-$\epsilon$ model is often used, where $k$ denotes the {term}`turbulent kinetic energy <Turbulent kinetic energy>` and $\epsilon$ its dissipation rate.

  ```{margin} Telemac Implementation
  Telemac3d users can activate the Spalart-Allamaras model to enable so-called *Detached Eddy Simulation* (DES) by setting the `HORIZONTAL TURBULENCE MODEL` and `VERTICAL TURBULENCE MODEL` keywords to `5`, while LES can be activated through the Smagorinsky model (`4`).
  ```

  RANS solvers are computationally highly efficient but physically imprecise because they represent turbulence only as statistical moments {cite:p}`nikora_double-averaging_2007`. For this reason, there is a growing trend in numerical modeling toward the use of so-called Large Eddy Simulations (LES), which can be used at high {term}`Reynolds numbers <Reynolds number>` to precisely model large eddies and simulate smaller eddies with a fine structure model. A precise representation of turbulence was possible by means of Direct Numerical Simulation (DNS), which is currently and for the time being not computationally feasible for most free-surface waters {cite:p}`georgiou_direct_2018`.

  *French: Moyenne de Reynolds <br>German: (Osborne) Reynolds-gemittelte Navier-Stokes-Gleichungen*  


Rating curve
  See {term}`Stage-discharge relation`.

Reophile
  The term reophile is used as a noun in reference to species that prefer to live in fast-flowing water. In addition, a distinction is made between reophilic A and B species. Reophilic A species (e.g., brown/river trout *Salmo trutta (fario)* or minnow *Phoxinus phoxinus*) colonize the main stream of a river at all lifestages. Reophilic B species (e.g., gudgeon *Gobio gobio*) occupy calmer flow regions (e.g., oxbows) in some lifestages. Unlike reophilic species, limnophilic species (e.g., common rudd *Scardinius erythrophthalmus*) prefer calm (stagnant) flow regions (see also {term}`Limnophile`).

  *French: <br>German: reophil*

Reynolds number
  The Reynolds number $Re$ relates viscous forces to inertia and is a key parameter for flow turbulence {cite:p}`chow59`:

  $$
  Re = \frac{u h}{\nu} \begin{cases} < 800 \rightarrow \mbox{ laminar flow} \\ \geq 800 \mbox{ and } \leq 2000 \rightarrow \mbox{ transitional flow} \\ > 10000 \rightarrow \mbox{ turbulent flow} \end{cases}
  $$

  Where $\nu$ denotes the kinematic viscosity (10$^{-6}$ m$^{2}$ s$^{-1}$ for water at 20$^{\circ}$C). In gravel-cobble bed rivers, inertia forces are typically dominant compared with viscous forces; therefore $Re$ is generally larger than 2000 and the flow is turbulent {cite:p}`chow59,wohl_mountain_2000`.

  *French: Nombre de Reynolds <br>German: Reynolds-Zahl*


Rheotaxis
  Rheotaxis is a behavior exhibited by aquatic organisms in response to the flow direction of water, and aids fish in compensating for drift losses {cite:p}`elder2015influence`. It is characterized by two types: positive and negative rheotaxis. Positive rheotaxis involves orientation against the flow, commonly observed in salmonids. Negative rheotaxis involves movement with the flow, typical in eels or certain species of freshwater catfish, but this behavior is less common than positive rheotaxis.

  *French: Rhéotaxie (f) <br>German: Rheotaxis (w)*

Rich Text Format
  The proprietary Rich Text Format (RTF) wraps raw text in functional blocks that enable graphically flavored *Word*-like processors to identify document properties such as font size and type. Common RTFs are, for instance, *docx* or *odf* and enable exchanging text files between different *Word*-like processors on different operating systems.

Riffle pool
  Riffle-pool (or pool-riffle) sequences are a sequence of fast-flowing, shallow flow units and deeper, slower flowing units of a river, where the dimensions of one unit correspond approximately to one channel width {cite:p}`lisle1979sorting`. The maintenance of riffle-pool channels requires sufficient sediment supply during smaller floods and a velocity reversal when those floods occur {cite:p}`caamano_unifying_2009`.

  *French: Rapide (m, verifcation required) - affouillement (m, verifcation required) <br>German: Furt (w) - Kolk (m); sometimes also Rausche (w) - Kolk (m); although "Rausche" rather refers to "glide".*


  ```{figure} ../img/nature/pool-riffle.jpg
  :alt: riffle pool bedform gravel bed
  :name: riffle-pool

  A pool-riffle sequence at the American River close to Sacramento (CA, USA). Source: Sebastian Schwindt (2018)
  ```

River corridor
  The river corridor embraces the active river channel(s), floodplains, and the hyporheic zone underneath {cite:p}`wohlegu2022`.

Riverbed clogging
  See {term}`Clogging`.

Rouse number
  The Rouse number $Ro$ determines the transport mode (essentially, {term}`bedload <Bedload>` or {term}`suspended load <Suspended load>`) of a sediment particle and it serves for calculation of the concentration profile of suspended sediment. In its function of a characteristic of a vertical suspended load profile and because of its original definition of an *exponent in the suspended load function* (see page 13ff in {cite:t}`rouse_analysis_1939`), the Rouse number is also referred to as with a capital $Z$. It is calculated as:

  $$
  Ro = \frac{w_s}{\kappa\cdot u_*}
  $$

  where $w_s$ denotes the {term}`settling velocity <Settling velocity>`, $\kappa$ (=0.41) is the van Karmàn constant {cite:p}`von_karman_mechanische_1930`, and $u_*$ is the {term}`shear velocity <shear velocity>`.

  A particle is typically transported in suspension when it has a low Rouse number ($Ro \lessapprox 0.5$), in the water column when it has a Rouse number between approximately 0.5 and 2.0, as bedload when its Rouse number is higher, and tends to deposit for very high Rouse numbers ($Ro \gtrapprox 12$) {cite:p}`dubuis_clogging_2023`.


Saint-Venant equations
  The French mathematician Adhémar Jean Claude Barré de Saint-Venant introduced dimensional simplifications of the {term}`Navier-Stokes equations`. For simple cross-sections, the one-dimensional (1d), cross-section averaged Saint-Venant equations can be applied, and represent the baseline for the Manning-Strickler Formula (cf. the {ref}`1d Hydraulics Python exercise <ex-1d-hydraulics>`). The two-dimensional (2d), depth-averaged Saint-Venant equations are more frequently referred to as the {term}`Shallow water equations`, which imply a hydrostatic pressure distribution {cite:p}`graf_hydraulique_2011`.

  *French: Équations (de Barré) de Saint-Venant <br>German: Saint-Venant-Gleichungen / Flachwassergleichungen (f, pl.)*

Sand bed
  Sand bed rivers are characterized by the abundance of fine sediment and sand bars. Compared with a gravel bed, a sand bed tends to have higher suspended load. This type of morphology is often observed lowland and coastal regions where the the hypothetic energy grade is low is less intense than in steeper regions {cite:p}`kleinhans2005, zyserman1994`.

  ```{figure} ../img/nature/sand-bed.jpg
  :alt: sandbed dunes anti-dunes
  :name: sand-bed

  Dune bedforms of a sand bed in a side channel of the Inn River in Bavaria, Germany. Source. Sebastian Schwindt (2022)
  ```

Sediment transport
  Fluvial sediment transport encompasses two modes of particle displacement: (1) suspended load and (2) bedload (see figure below). Finer particles with a weight that can be carried by the fluid (water) are transported as {term}`Suspended load`. Coarser particles rolling, sliding, and jumping on the channel bed are transported as {term}`bedload <Bedload>`. There is third type of transport, the so-called wash load, which is finer than the coarse bed load, but too heavy (large) to be transported in suspension {cite:p}`einstein_bed-load_1950`. The units for sediment transport are for an integral flow cross-section kg$^3\cdot$s$^{-1}$ or per unit width kg$^3\cdot$s$^{-1}$m$^{-1}$. Additionally, the {term}`Rouse number` can be used to determine whether a particle is transported in suspension, as bedload, or not at all.

  ```{image} https://github.com/Ecohydraulics/media/raw/main/png/sediment-transport.png
  ```

  *French: Transport solide <br>German: Sedimenttransport*

Sediment yield
  The sediment yield is the amount of sediment eroded per unit area (tons$\cdot$km$^{-2}\cdot$year$^{-1}$) of a watershed {cite:p}`griffiths2006a`.

  *French: Apport solide <br>German: Feststoffeintrag*


Settling velocity
  The settling velocity $w_s$ is computed as a function of the ratio of sediment grain and water density $s$, gravitational acceleration $g$, grain size $D_x$, and the dimensionless drag coefficient $C_D$ {cite:p}`dey_fluvial_2014`:

  $$
  w_{s} = \sqrt{\frac{4}{3}\cdot \frac{(s-1)\cdot g\cdot D_x}{C_{D}}}
  $$

  In turn, $C_{D}$ is a function of the {term}`Reynolds number`, and can be approximated (not generally valid!) as follows {cite:p}`stokes1850`:

  $$
  C_{D} = \frac{24}{Re}
  $$



Shallow water equations
  In shallow (i.e., small water depths) and wide waters (many rivers), the assumption of hydrostatic pressure distribution can be made to simplify the {term}`Navier-Stokes equations`. The corresponding simplified form of the {term}`Navier-Stokes equations` is referred to as the shallow water equations. The shallow water equations imply that vertical flow velocity is negligible compared to horizontal (and longitudinal) flow velocity. This assumption is valid in many river systems, but there are several cases for which the shallow water equations are not suited {cite:p}`kundu_fluid_2008`.

  For instance, the depth-averaged shallow water equations are **not suited** for any pressurized flows (e.g., at weirs or in pipes). This eBook recommends to **use the shallow water equations** only when the water depth is smaller than a 1/20 times the characteristic wavelength (e.g., flood waves or in tsunami/oceanic models) and when the water depth is smaller than 1/10 of the wetted channel width. The application of the shallow water equations is featured in this eBook with the tutorials on 2d numerical modeling (i.e., in the {ref}`BASEMENT <basement2d>` and {ref}`Telemac2d <telemac2d-steady>` chapters).

  *French: Équations (de Barré) de Saint-Venant <br>German: Flachwassergleichungen*

Shear velocity
  Shear velocity $u_*$ (or friction velocity) expresses shear stress in units of velocity. The parameter is useful, for example, to describe the shear effect of depth-averaged flow velocity. It can be calculated as follows {cite:p}`schwindt_hydro-morphological_2017`:

  $$
  u_* \approx \sqrt{\tau_b / \rho_w} = g\cdot R_h \cdot S_e \approx g\cdot h \cdot S_e
  $$

  where $\tau_b$ denotes the {term}`bed shear stress <Dimensionless bed shear stress>`, $rho_w$ is the density of water, $R_h$ is the hydraulic radius (see also the {ref}`1d hydraulic Python exercise <calc-1d-hyd>`), $g$ is gravitational acceleration, and $S_{e}$ is energy slope. $R_h$ may be substituted by water depth $h$ in wide rivers with monotonous cross-sectional shape and for (grid) cells of a 2d numerical model.

  *French: Vitesse de frottement <br>German: Schubspannungsgeschwindigkeit*  


Shields parameter
  The {cite:t}`shields_anwendung_1936` parameter $\tau_{x,cr}$ (in the literature also often named $\theta_{cr}$) is a dimensionless value of critical bed shear stress for sediment mobility. For this reason, the Shields parameter is also often referred to as **dimensionless critical bed shear stress**. Flow conditions and grain sizes with a {term}`dimensionless bed shear stress <Dimensionless bed shear stress>` $\tau_x$ smaller than the Shields parameter curve are considered immobile. Vice versa, flow conditions and grains associated with a {term}`dimensionless bed shear stress <Dimensionless bed shear stress>` larger than the Shields parameter are considered mobile. In fully turbulent flow, the Shields parameter can be considered a constant value of approximately 0.047$\pm$0.15 {cite:p}`von_karman_mechanische_1930,kramer_modellgeschiebe_1932,smart_sedimenttransport_1983`. To evaluate if a grain is in motion, its {term}`dimensionless bed shear stress <Dimensionless bed shear stress>` value is plotted against its dimensionless diameter $D_x$ in the so-called Shields diagram (also referred to as the *Hunter-Rouse* {cite:p}`rouse_critical_1965` diagram). $D_x$ is calculated for any grain with a diameter $D_{pq}$ (in m) as {cite:p}`einstein_bed-load_1950`:

  $$
  D_x = \left[\frac{(s-1)\cdot g}{\nu^2}\right]^{1/3}\cdot D_{pq}
  $$

  where $s$ is the ratio of sediment grain and water density (typically 2.68); $g$ is gravitational acceleration; and $\nu$ is the kinematic viscosity of water ($\approx$10$^{-6}$m$^{2}$ s$^{-1}$) {cite:p}`schwindt_hydro-morphological_2017`. Read the definition of {term}`dimensionless bed shear stress <Dimensionless bed shear stress>` for the calculation of $\tau_{x}$. {numref}`Figure %s <shields-diagram>` shows the Shields diagram where the Shields curve is plotted based on descriptions in {cite:t}`guo_logarithmic_2002`.

  ```{figure} ../img/shields-diagram.jpg
  :alt: Shields diagram guo hunter critical bed shear stress
  :name: shields-diagram

  The Shields parameter $\tau_{x,cr}$ (critical dimensionless bed shear stress) for grain mobility as a function of the dimensionless particle diameter $D_x$, according to {cite:t}`guo_logarithmic_2002` (image source: {cite:t}`schwindt_hydro-morphological_2017`).
  ```

  Beyond grain size and local hydrodynamics, $\tau_{x,cr}$ is also a function of global channel roughness and slope, relative submergence and bedload transport intensity {cite:p}`wilcock_critical_1993,gregoretti_inception_2008,lamb_is_2008,recking_bed-load_2008,ferguson_river_2012`.

Spawning guild
  Different groups of fish (i.e., {term}`fish guilds <Guild>`) have different practices and preference for spawning their eggs. In ecohydraulics, a distinction is made, for instance,  between {term}`fish guilds <Guild>` that prefer to build nests in the surface of the riverbed (*lithophilous*) or glue their eggs to sediment (*psamnophilous*) or plants (*phytophilous*). Also, *pelagophilous* fish release their eggs into the free-flowing water.

Suspended load
  Suspended load is a special type of {term}`Sediment transport` describing the displacement of fine particles with the bulk flow.

  *French: Transport en suspension <br>German: Schwebstofftransport*

SMS 2dm
  SMS (Surface-water Modeling System) is a proprietary software suite from *Aquaveo* for surface water modeling. `2dm` file format is natively produced with SMS and represents a computational grid with x, y, and z coordinates of nodes along with node ids. The [developer's wiki](https://www.xmswiki.com/wiki/SMS:2D_Mesh_Files_*.2dm) provides a comprehensive description of the file format.

Sonar
  Sound navigation and ranging (*Sonar*) is a technique for locating objects in space and underwater by emitting sound pulses. An active *Sonar* system, such as radio detecting and ranging (*radar*), emits and receives sound signals to map objects underwater (time-of-flight measurement). Passive *Sonar* detects signals emitted by an object itself (e.g., vibrations from fish motion or Whale chant), but cannot accurately map underwater objects.

SRS
  See {term}`CRS`.

Stage-discharge relation
  A stage-discharge relation (also referred to as **rating curve**) plots discharge (in m$^3$/s or CFS) as a function of water surface elevation function (in m above sea level or ft) at a specific river cross-section. Most stream gauging stations have a regularly calibrated stage-discharge relation that is often maintained by a state authority. This is why, it is mostly state authorities that provide stage-discharge functions for their gauging stations online, such as the state of Bavaria at the [Mühldorf am Inn gauge](https://www.hnd.bayern.de/pegel/donau_bis_passau/muehldorf-18004506/abflusstafel?).

  *French: Courbe d'étalonnage / Courbe hauteur-débit / Courbe de tarage <br>German: Wasserstands-Abfluss Beziehung, bzw. Abflusskurve / Abflussschlüsselkurve / Eichkurve*

Step pool
  Step pools are a type of morphological units, typically  found in steep mountain rivers. They are characterized by high gradients (exceeding 2%) and a rough surface composed of cobble and bedrock {cite:p}`gonda2008characteristics`.

STL
  The Standard Tessellation Language (STL) file format is native to a three-dimensional (3d) printing CAD software type called [stereolithography](https://en.wikipedia.org/wiki/Stereolithography). An STL file describes 3d structures in the form of unstructured triangulated surfaces with arbitrary units.

Thalweg
  The term Thalweg stems from old German spelling for valley (today: *Tal*) and should be more correctly referred to as *Talweg*. The literal translation of Talweg is valley path and originally refers to a line that longitudinally connects the lowest points of valley cross-section profiles. Geomorphologists sometimes use slightly different definitions of Talweg. International law is more explicit, referring to the Thalweg as the primary navigable channel at boarders between two countries.

  *French: talweg / thalweg <br>German: Talweg*

Topographic change
  Topographic change is the increase or decrease in elevation of the Earth's surface as a function of time. Conceptually, tracking topographic changes could consist of a simple comparison (i.e., subtraction) of elevation changes at two different moments. However, topographic change detection is not quite that simple, since every measurement technique has spatial inaccuracies with regards to the exact location and elevation of recorded points. For this reason, methods have been developed that, based on a level of detection (LoD), generate topographic change maps conveying and accounting for spatial uncertainty. Depending on the method, either strict global LoD raster {cite:p}`pasternack_flood-driven_2017` or less strict pixel-based LoD values {cite:p}`wheaton_accounting_2010` are used to remove uncertainty from topographic change maps. Topographic change maps also enable the visualization of soil loss (i.e., erosion), which is a growing challenge for agriculture and beyond. To this end, the USGS developed a publicly available website that is dedicated to topographic change (visit [https://usgs.gov](https://www.usgs.gov/core-science-systems/eros/topochange)).

  *French: Changement du terrain (non-technique) <br>German: Topografischer Wandel (kein technischer Begriff)*

Turbulence
  See {term}`Reynolds-averaged Navier-Stokes <RANS>` equations.

Turbulent kinetic energy
  Turbulence kinetic energy (TKE, or $k$ in this eBook) is the mean kinetic energy per unit mass associated with turbulent eddies. It is measured as the quadratic velocity fluctuations. In a river or lab flume, TKE can be indirectly measured with an Acoustic Doppler Velocimeter (ADV) that enables to derive the streamwise ($u_x$ or just $u$), later/spanwise ($u_y$ or $v$), and vertical ($u_z$ or $w$) velocity fluctuations (i.e., $u'_x$, $u'_y$, and $u'_z$, respectively) with the following expression {cite:p}`nikora_adv_1998,kundu_fluid_2008`:

  $$
  k = \frac{1}{2} \cdot \left( {\overline{{u'_x}^{2}} + \overline{{u'_y}^{2}} + \overline{{u'_z}^{2}}} \right)
  $$ (eq-tke)

  Thus, $k$ is the half trace of the Reynolds stress tensor (see {term}`RANS`) {cite:p}`franca_turbulence_2015`. For evaluating $k$ in field or lab experiments, have a look at our Python packages [TKE-calculator (standalone scripts)](https://tke-calculator.readthedocs.io) and [TKE-analyst (pip-installer)](https://tkeanalyst.readthedocs.io).

  In numerics, the TKE ($k$) is calculated by turbulence closure methods, such as the $k$-$\epsilon$ closure, which are required for numerically solving the {term}`Reynolds-averaged Navier-Stokes <RANS>` equations.

xdmf
  The [eXtensible Data Model and Format (XDMF)](https://www.xdmf.org/) library provides standard routines for exchanging (scientific) datasets that result from high performance computing (HPC) tasks. XDMF files redundantly store *light* and *heavy* data in XML and HDF5 format and *Python* interfaces exist for both formats. Thus, XDMF or XMF files are often linked to a `*.h4` or `*.h5` ({term}`HDF`) file that contains heavy simulation datasets.
````
