Reference
Glossary
The symbols and terms used in the course. Variables carry their units, the name used in the package source (src/dcrest/kernels and model.py) and the session that introduces them. All water amounts are depths over the catchment, in millimetres.
Variables
Forcing, states and fluxes of one day, in the order the model computes them.
| Symbol | Meaning | Units | In the code | Session |
|---|
Parameters
The sixteen calibrated parameters, their allowed ranges and the released values for the Leaf River (USGS 02472000).
| Parameter | Meaning | Units | Range | Leaf River | Session |
|---|
Scores
| Score | Definition | Perfect | Session |
|---|---|---|---|
| error \(e_t\) | \(Q_{\text{sim},t} - Q_{\text{obs},t}\), model minus observation on day \(t\) | 0 | 10 |
| bias | mean error; the volume ratio \(\beta\) expresses it as a ratio | 0 | 10 |
| MAE | mean absolute error, \(\overline{|e_t|}\), in mm/day | 0 | 10 |
| RMSE | root-mean-square error, \(\sqrt{\overline{e_t^2}}\), in mm/day | 0 | 10 |
| standard deviation \(\sigma\) | the typical size of a series' departures from its mean | – | 10 |
| correlation \(r\) (Pearson) | how closely two series rise and fall together, from −1 to 1 | 1 | 10 |
| rank correlation \(\rho\) (Spearman) | correlation of the ranks: whether two lists put items in the same order | 1 | 13 |
| NSE | Nash–Sutcliffe efficiency, \(1 - \sum e_t^2 / \sum (Q_{\text{obs},t} - \overline{Q}_{\text{obs}})^2\); 0 means no better than predicting the observed mean every day | 1 | 10 |
| KGE | Kling–Gupta efficiency, \(1 - \sqrt{(r-1)^2 + (\alpha-1)^2 + (\beta-1)^2}\) | 1 | 10 |
| \(r\) | correlation between simulated and observed flow (timing) | 1 | 10 |
| \(\alpha\) | variability ratio, \(\sigma_{\text{sim}} / \sigma_{\text{obs}}\) (size of the swings) | 1 | 10 |
| \(\beta\) | bias ratio, \(\mu_{\text{sim}} / \mu_{\text{obs}}\) (volume) | 1 | 10 |
| log-flow NSE | NSE computed on \(\log(Q + 0.01)\); weighs low flows as much as high ones | 1 | 10 |
| loss | what calibration minimises; here 1 − NSE on the training period | 0 | 11 |
Terms
| Term | Meaning | Session |
|---|---|---|
| catchment | all the land that drains to one point on a river; also watershed, drainage basin | 1 |
| stream gauge | a station that records the river's water level and converts it to discharge | 1 |
| discharge | river flow; volume per second, or here a depth per day over the catchment | 1 |
| water year | 1 October to 30 September, named after the year in which it ends | 1 |
| water balance | \(P = ET + Q + \Delta S\): water in equals water out plus the change in storage | 1 |
| runoff ratio | river flow divided by precipitation over a period | 1 |
| forcing | the daily inputs that drive the model: precipitation, temperature, potential evaporation | 1 |
| conceptual model | a model built from storages (buckets) and rules for moving water between them | 2 |
| lumped | one value of each store for the whole catchment, no spatial detail | 2 |
| state, flux, parameter | what the model stores from day to day; what moves during a day; what is fixed and calibrated | 2 |
| degree-day method | snowmelt proportional to how far the temperature is above a threshold | 3 |
| interception | rain caught by leaves and evaporated before reaching the ground | 4 |
| infiltration-capacity curve | the distribution of soil storage capacity across the catchment (VIC curve) that decides how much water infiltrates and how much runs off | 5 |
| saturation excess | runoff produced because the soil is full, not because rain falls faster than it can soak in | 5 |
| interflow | water moving sideways through the soil to the river | 6 |
| baseflow | the slow contribution of groundwater that keeps a river flowing between storms | 7 |
| unit hydrograph | how runoff produced on one day is spread over the following days at the gauge | 8 |
| convolution | adding up the delayed contributions of all past days' runoff with the unit-hydrograph weights | 8 |
| spin-up | years simulated before the scored period so that the initial states no longer matter | 9 |
| training and test periods | the nine water years used to choose the parameters (1 October 1999 to 30 September 2008) and the decade used only to judge them (1 October 1989 to 30 September 1999) | 10 |
| flow duration curve | daily flows sorted from highest to lowest, against the share of days they are exceeded | 10 |
| baseline | a simple prediction that needs no model, such as the average flow or the seasonal cycle | 10 |
| calibration | choosing parameter values so that the simulation matches observations on the training period | 11 |
| effective parameter | a value that makes the model behave like the whole catchment; not a measurable property | 2, 11 |
| loss landscape | the score as a function of the parameters | 11 |
| equifinality | different parameter sets fitting equally well (Beven, 2006) | 11 |
| SCE-UA | shuffled complex evolution, a population-based search that needs only scores (Duan et al., 1992) | 11 |
| gradient descent, Adam | stepping downhill on the loss along its gradient; Adam adds momentum and per-parameter step sizes (Kingma and Ba, 2015) | 11 |
| learning rate \(\eta\) | the step length of gradient descent | 11 |
| momentum | a running average of recent gradients that lets the search roll through small bumps | 11 |
| complex, shuffle | in SCE-UA, a sub-group of the population that evolves on its own; and the regular pooling and re-dealing of all points among the complexes | 11 |
| \(\theta\), \(u\) | a parameter in its physical units, and the unbounded number the optimiser actually moves (Session 11, logistic transform) | 11 |
| logistic transform | \(\theta = \theta_{\min} + (\theta_{\max} - \theta_{\min})/(1 + e^{-u})\); keeps a parameter inside its range while the optimiser moves \(u\) freely | 11 |
| gradient | the list of partial derivatives of a score with respect to each parameter (or input) | 12 |
| automatic differentiation | computing exact derivatives of a program by applying the chain rule to each recorded operation; reverse mode runs backwards from the score | 12 |
| finite difference | approximating a derivative by re-running the model with a slightly changed input | 12 |
| dead (inert) parameter | a parameter whose gradient is exactly zero because it acts only through an inactive branch | 12 |
| kink | a point where a quantity's slope changes abruptly, such as where a cap starts to bind; the left and right slopes differ there | 12 |
| batching | running many catchments at once as columns of one array, so one model run and one backward pass serve them all | 12 |
| GPU | graphics processing unit: a processor that does the same arithmetic on many numbers at once | 12 |
| checkpointing | storing intermediate values only every so often and recomputing the rest during the backward pass, to save memory | 12 |
| CAMELS | Catchment Attributes and Meteorology for Large-sample Studies: 671 little-disturbed US catchments with forcing, flow and attributes | 13 |
| Daymet, Maurer | two gridded daily weather datasets built from station records (Thornton et al., 1997; Maurer et al., 2002), averaged over each catchment in CAMELS | 1, 10 |
| SAC-SMA, Snow-17 | the Sacramento soil moisture accounting model, a conceptual model used operationally by the US National Weather Service, and its companion snow model | 10 |
| HBV | a widely used conceptual model from Sweden, with snow, soil and two groundwater stores | 10 |
| VIC | the Variable Infiltration Capacity land-surface model, whose infiltration curve dCREST uses (Session 5) | 10 |
| mHM, FUSE | the mesoscale Hydrologic Model; and the Framework for Understanding Structural Errors, which assembles many conceptual models from interchangeable parts | 10 |
| LSTM | long short-term memory, a type of neural network for sequences; here one network learns all catchments at once | 10 |
| aridity index | mean potential evaporation divided by mean precipitation; above 1 is dry | 13 |
| regional model | one model (here, the LSTM neural network) trained on many catchments at once | 13 |
| routing | moving the runoff a model makes on the land to a point on the river: when it arrives, and how spread out | 8, 14 |
| reach | a stretch of river treated as one unit by a routing method; in the Rhine case about 10 km long | 14 |
| river network | the reaches of a basin and the order in which they flow into each other, down to the outlet | 14 |
| flood wave | a rise in flow that travels down a river; it moves faster than the water itself | 14 |
| celerity \(c\) | the speed of a flood wave; about 5/3 of the water's velocity in a wide channel | 14 |
| attenuation | the lowering and spreading of a flood crest as it travels, caused by water stored along the way | 14 |
| travel time | the time a wave needs from a reach to the outlet: the sum of length ÷ celerity along its path | 14 |
| time–area diagram | the share of a basin's area by travel time to the outlet; with the same runoff everywhere it is the basin's unit hydrograph | 14 |
| lumped, distributed | a lumped model gives the whole catchment one rainfall value and one set of stores (dCREST v1.0); a distributed model computes runoff in many cells or sub-basins and routes it between them | 14 |
| Saint-Venant equations | conservation of mass and of momentum for flow in a channel; every routing method is a simplification of them | 15 |
| dynamic, diffusive and kinematic wave | the Saint-Venant equations in full; without the inertia terms; and without the water-surface slope as well (waves then only move downstream and do not flatten) | 15 |
| local inertial | the Saint-Venant equations without the advection term; used by floodplain models such as CaMa-Flood | 15 |
| Nash cascade | a chain of equal linear reservoirs; its response is the gamma curve of dCREST's unit hydrograph | 15 |
| Muskingum method | routing a reach with storage \(S = K[X I + (1 - X) O]\): one line of arithmetic per reach and step; \(K\) is the travel time, \(X\) sets the flattening | 15 |
| Muskingum–Cunge | the Muskingum method with \(K\) and \(X\) computed from reach length, celerity, width and slope, so that it behaves like a diffusive wave (Cunge, 1969) | 15 |
| Courant number | \(c\,\Delta t/\Delta x\): how many grid cells or reaches a wave crosses in one time step; explicit schemes need it to stay near or below 1 | 15 |
| time step, sub-step | the interval at which the router updates the flow; a daily model may take many routing sub-steps per day to stay stable | 15 |
| topological level | the position of a reach in the upstream-to-downstream order; reaches of the same level can be computed at the same time | 15 |
| floodplain | the land beside a river that floods at high water; it stores water and delays and caps the flood crest | 16 |
| regulation | the change of a river's flow by dams and reservoirs, which hold back floods and release water later | 16 |