SCALGO Live Documentation


Analysis - Flash Flood Map

The Flash Flood Map calculates where surface runoff will flow and gather during a chosen rain event and potentially create flooding. The Flash Flood Map is available from the dock.

The Flash Flood Map Concept

The flash flood simulation models how water flows on the terrain for a given rain event. It is a simple, powerful, stationary event-based screening model. In the following we describe the overall concept of the Flash Flood Map and, following that, we go through the individual layers and other options available for the Flash Flood Map in SCALGO Live.

Events: In the Flash Flood Map an event is a specification of how much rain should be simulated for each location (raster cell) in the elevation model. The amount of rain is a single value representing the total rain for the cell, the Flash Flood Map does not consider the duration of the rain event creating that amount of rain, it assumes all the water is available on the cell immediately. In SCALGO Live you will typically specify the event through the rain slider (described below), which lets you select any amount of rain which will be uniformly applied to the whole terrain so all locations have the same amount of rain available. In workspaces you can modify these events by adding infiltration, this happens on the basis of the land use types available in the workspace. More on that further down on this page.

Simulation: To compute final water heights for the entire terrain, the simulation routes the water volume placed on the terrain in the given event downstream, filling depressions on the way. If the volume of the water arriving is larger than the volume of the depression, the depression is filled and the remaining water continues downstream to the next depression. If the volume of a depression is larger than the volume of the water arriving at that depression, the water remains in that depression and does not go further downstream - we say that the depression is active. This gives rise to a watershed for each active depression, defined as the set of cells that route to the depression, possibly via upstream full depressions. This is the basic idea of the Flash Flood Map. As there is no temporal component to the analysis, the length of the flow paths between a location and various depressions is of no consequence to the simulation.

The illustration shows how water gathers in depressions during an extreme rain event. In the top left figure, none of the depressions are full and all depressions are active and have their own watershed, as illustrated with the different colors. In the top right figure, the green depression is full, and the water from the green depression is now part of the watershed of the red depression. In the bottom left figure, the red depression is also full and contributes downstream to the orange depression. Finally, in the bottom right figure the purple depression is also full and contributes downstream to the orange depression as well.

The Flash Flood Map is available from the dock, to which it can be added from the library. In the dock the Flash Flood Map looks like this:

The Flooded Areas layer shows the areas with standing water after the given event simulation. The Flow Accumulation layer enhances this view with flow paths in and out of the flooded areas, and the Watersheds layer shows the watersheds of all the active depressions for the given event. These layers are described in more detail below.

Flooded Areas

The Flooded Areas layer shows the water in depressions for the current event. The default color scale goes from light to dark blue depending on the height of the water column at the given location.

Flooded Areas layer showing depressions with water for a 100 mm rain event. Only regions with at least 10 cm of water are shown, as set by the water depth slider.

Sliders: Rain and water depth

There are two sliders available for the flooded areas in the Flash Flood Map.

  • The Rain slider allows you to set the event simulated in the Flash Flood Map. The rain is applied uniformly and instantaneously across the terrain as defined above.
  • The Water depth slider lets you filter the flooded areas to only show those locations where the standing water depth after the simulation is larger than the slider value. Thus if you only care about water on the terrain where the depth of the water is more than 10 cm, you can set the water depth slider to that value.

Point query: Information about a particular flooded area

The point query tool is used to get information about a chosen flooded area. When you click on a point in a flooded area, the area is highlighted in orange, and the point info dialog displays:

  • The amount of rain required for the chosen point to flood.
  • The water depth at the point.
  • The volume of the water currently in the depression.
Point queries in the flash flood map. Point u is in a depression and gives information about that depression, point v is on a flow path, read more below on point queries for flow paths.

Profile: See the water level of the chosen rain event in profile

Use the profile tool to view the water level at a chosen rain event in a profile view along with the underlying elevation model.


Through the styles dialog, there are several interesting display options available for the flooded areas. These include:

  • You can choose the Highlight active depressions option to highlight all active depressions, i.e. those that are not full in the current rain event.
  • You can choose the banded option to color the depressions in different colors depending on water depth, or event thresholds that you define yourself.
  • You can choose a different color (purple) for rendering the depressions. This is useful for comparing two Flash Flood Maps.
The styles dialog for the Flooded Areas layer gives you a number of options for controlling how the layer is drawn.

Flow Accumulation

The Flow Accumulation layer shows how water flows on the surface of the terrain between depressions. The layer can only be enabled if the Flooded Areas layer is also enabled.

The flow paths for the Flash Flood Map showing those flow paths that have an upstream area of at least 500 square metres as set by the flow detail slider, the flow paths are shown for a 100mm rain event. Also shown are the flooded areas, but only where the depth of the water is at least 10cm.

Slider: Flow detail

The flow detail slider allows you to select an area and we only show flow lines for places where the upstream area is larger than the value set on the slider. Thus if you set the slider to a high value you will only see major flow paths in the terrain, this is an effective way to filter out irrelevant information for many use cases.

Point query: Querying flow information at a point

When you use point query on a flow path, e.g. point v in the figure above, you get information about:

  • The upstream area of the point. In the figure above, it is the green area to the left of point v,
  • The depression storage of the point, which is defined as the volume of rainwater stored in the depressions upstream. In the figure above, this is both the volume of depression B and C, as they are both full. The volume of depression A is not included as this depression is not in the watershed of point v,
  • The runoff volume flowing through the point. In the figure above, it is the volume of the rainwater upstream of v not stored in depressions; that is, the total volume of the rain in the green watershed minus the depression storage. If your point is in a depression, the resulting values are that of the outlet of the depression.


The Watersheds layers shows the watersheds of the active depressions in the Flash Flood Map. Recall, that the active depressions are those that are not yet full. Thus, as you increase the rain, the watersheds will merge as depressions fill up eventually ending up with a set of watersheds matching those of the depression-free flow analysis when all the depressions have been filled.

The watersheds of the Flash Flood Map showing watersheds for a 10 mm rain event. Each watersheds correspond to a unique active depression inside it, but there can be multiple full depressions in a watershed.

Sliders: Rain

The Rain slider allows you to set the event simulated in the Flash Flood Map. It is the same slider also shown for the Flooded Areas layer and we refer to that section for more information.

Point query: See the size of a watershed

Point query provides the following information:

  • The upstream area of the watershed.
  • A unique ID identifying the watershed.

The watershed tool

Interested in watersheds for a particular location, and not for a depression? You can use the powerful watershed tool to highlight the watershed of a chosen point. The watershed is shown in green and the flow path downstream of the chosen point, including downstream depressions, in blue. If the chosen point drains to an active (not full) depression at the selected rain event, this active depression is highlighted in light blue. If the chosen point is part of a depression, this depression is highlighted in red. If your point is in a depression the resulting values are that of the outlet of the depression.

An Illustration of the watershed tool used with the Flash Flood Map. The queried point (blue pin) is in a depression (red) with a larger watershed (green). The downstream path passes through a depression (blue), before it reaches a depression that is not yet full (light blue).

Subsurface structures

The Show subsurface option allows you to see flow paths underneath the surface, e.g. underpass or culverts. They might happen to due hydrological corrections from a national dataset in your country, or through subsurface structures created in your workspace.

Water that flows through a subsurface structure beneath a highway.


The Flash Flood Map can (in workspaces) include infiltration using the runoff functions concept. When the rain is put on each cell, by default the simulation runs with that exact amount of water on the cell. However, in workspaces you can configure different runoff functions for each land use type in the workspace. When infiltration is available for a Flash Flood Map, a new button is available in the top right of the dialog:

A Flash Flood Map with infiltration support in the dock. Infiltration is currently disabled.

Hitting that button will show a dialog that allows you to toggle infiltration on and off. Here's the dialog when infiltration is turned off:

When infiltration is turned on you see the following:

The left column lists the land use types used in the Flash Flood Map, and the right column shows what runoff function is applied to each type of land use. In the case above, Building and Lake surfaces are treated as glass (zero-infiltration) surfaces and Other Impervious surfaces as well as Impervious surfaces are treated using a custom Sand runoff function.

Runoff functions

Runoff functions govern how much of the rain arriving on a cell is infiltrated and are parameterized by a runoff coefficient and an initial loss. The initial loss is in depth units (e.g. mm) and is deducted from the rain initially placed on the cell. Following that, the runoff coefficient - which is a ratio - is applied to determine how much of the remaining rain is flowing on the terrain and thus used in the Flash Flood Map simulation. In other words, if the rain is set to r, the runoff coefficient is c and the initial loss is l, the final amount of rain used in the simulation is (r-l)·c. Thus if the initial loss is 0 and the runoff coefficient is 25%, then only 25% of the rain falling on that particular cell is included in the computation. An initial loss of 0 and a coefficient of 100% corresponds to the so-called glass surface model. The runoff function has no impact on the water flowing through the cell in the Flash Flood Map simulation, it only affects the water originally placed on the cell.

The runoff editing dialog shows the different runoff functions and allows you to edit their parameters. For each runoff function you are shown a graph that shows how this particular parameterization translates an input rain amount into the runoff amount after infiltration.