Water Overlay

From Tygron Support wiki
Jump to navigation Jump to search

A water overlay is an implementation of a number of hydrological formulas which together can simulate the flow of water across large areas with a high level of detail. These formulas combined form the model that is part of the Water Module in the Tygron Platform. Its calculations form a simulation of an arbitrary amount of time, during which water is allowed to move.

Water flow is affected by properties of the surface across which it flows, including the terrain height and the properties of the underlying terrain.

To perform the calculations, the project area is divided into a grid of cells. Each cell has a specific quantity of water, and specific hydrological parameters based on the data in the project. The total time which should be simulated is divided into discrete timesteps. Per timestep, every cell communicates with all adjacent cells to exchange water. By dividing the project area and simulation time into sufficiently small cells and steps the behavior becomes effective continuous.

The final results of the calculation can be inspected, as well as snapshots of the hydrological situation in the simulation, known as timeframes.

Different water overlays

The water module can be called upon by adding one of the following overlays to a project. Each variant has a number of parameters tuned to best fit specific use-cases.

  • The Rainfall Overlay, provides insight into the water stress and impact caused by (excessive) rainfall.
  • The Flooding Overlay, provides insight into water stress and impact caused by breaches in levees or other sources causing excessive water inflow.
  • The Groundwater Overlay, provides insight into long-term processes of water flow both on the surface and underground.

Input Data and Settings

The calculations performed by the water overlay are influenced by many kinds of geographical information present in the project area. For any given location, terrain, constructions and other features can influence either the initial state of the simulation or how water flows in a given area.

Furthermore, the water overlay features a number of overall settings which can be configured for the hydrological calculations and its results. These settings do not have a geographical or temporal element to them, and are fixed values relevant for the simulation as a whole.

Hydological features
The water system can be enhanced with a number of hydrological features, which can be loaded in as areas. These hydrological features form special properties or modifications on the hydrological system. See Hydological features for a list of supported features.
Hydraulic structures
See Hydraulic structures for the list of supported structures.
Hydrological attributes of constructions
Besides the constructions which directly influence the hydrologic model as a hydraulic structure, each construction may also have attributes which can contribute to the hydrological model in some way. These attributes are stored and used on a grid cell level. This is different from the hydraulic structure attributes, which are stored and used on an object level. For a full list, see Additional hydrological attributes of constructions.
Hydrological attributes of terrain
Terrains in a project have a number of hydrological attributes which can influence the flow of water in a project. Because there is always both surface and underground terrain defined for the entirety of the project area, all cells are affected by all attributes of terrains, unless a construction is present with overwriting values. For a full list, see Terrain attributes for the water overlay.
Model settings
For a full list, see: Water Model attributes

Results

See results.

Theory and technical details

See water module theory.

Troubleshoot, warnings and recommendations

When the water overlay is used and calculations take place, there are some problems or points of attention the calculation can run into. Where possible, the water overlay will show appropriate warnings when running into any issues. See Troubleshoot, warnings and recommendations;

Use cases

Use cases Water Overlay

How-to's