Subsidence Overlay getting started

From Tygron Support wiki
Jump to navigation Jump to search

This page will give an overview of different user possibilities of the Subsidence overlay.

Affecting the overlay

During a session, stakeholders can affect the data in the project. They can do this through, for example, actions or events. This can include affecting data which is used in the subsidence calculation. The subsidence overlay is then recalculated with that new data.


Oxidation is affected by changes in the (ground) water level. During a session, if the WATER_LEVEL attribute is changed, the groundwater level is adjusted as well. This in turn leads to more or less subsidence through oxidation. The groundwater level can also be affected by the user creating drainage. These are buildings with a "drainage" function value. Drainage sets the groundwater level to an artificial height, affecting the amount of oxidation taking place.


During a session, a stakeholder can raise or lower land. They can do this directly, via Raise land and Lower land actions, or by constructing levees. As the land is raised above the starting height, more compaction will start taking place.

Configuring the overlay

When the subsidence overlay is added to a project, there is some minimum information required for a calculation. You can choose to use the wizard to guide you through the configuration, or to set a few parameters manually for an initial calculation.

Using the wizard

The wizard will be able to guide you through the configuration of the overlay. It will pass through a number of steps in which individual aspects of the subsidence overlay are set up. The wizard can be opened by clicking on the configuration wizard button in the general tab of the subsidence overlay.

Subsidence overlay wizard.PNG


In 3 steps, some geographical information will be configured, related to surface- and ground water. Options presented allow for importing data, or generating some parameters based on general assumptions.


Drainages can be imported or generated based on existing data.

Hydrological Coefficients

In 4 steps, a number of general parameters for the various calculations have to be set. These are non-geographical parameters which allow for the configuration of the intensity and speed of subsidence, and the external environmental factors which influence the sensitivity of the soil to subsidence.


Besides the primary result type for the overlay, a number of additional result types can be displayed which are added as child overlays to the parent overlay,

Input Visualization

For debugging and analysis purposes, the wizard will offer to add a number of additional overlays as child overlays of this overlay to the project. These are Average Overlays, which display the values of specific geographical input attributes as an overlay in the 3D Visualization. This provides insight into the exact values used to perform the subsidence calculations.


When the subsidence overlay is added to a project, there is some minimum information required for a calculation.

Peat soil

The calculation will only work when the terrain is sensitive to subsidence. By default, peat is the only terrain sensitive to subsidence. If your project does not yet have a peat soil, you can either set a different soil type to be sensitive to subsidence, or add peat to your project.

Note that ground water levels are calculated for any kind of soil, not just soil that is sensitive to subsidence. This means this step kan be skipped if you're using the ground water level result types(s).

Editor → Current Situation (Ribbon tab) → Terrain (Ribbon bar) → The Terrain type to edit (Left panel)
How to change soil sensitivity to subsidence:
  1. Hover over the 3D Visualization and click to find the underground soil type
  2. Select that underground soil type in the left panel
  3. In the right panel, switch to the attributes tab
  4. Add the attribute "SUBSIDENCE" with value 1
How to change the soil type:
  1. Select "peat" in the left panel
  2. Select the "General" tab in the right panel
  3. Draw the terrain in the 3D Visualization

Water areas

Subsidence is only calculated within water areas, regardless of what data is present in the project. These areas are defined by the fact that they have a WATER_LEVEL attribute.

There are 2 ways of getting this data into your project: by importing it (i.e. your own data) into the project as areas with attributes, or by manually drawing the appropriate areas and adding attributes to those.

Editor → Current Situation (Ribbon tab) → Areas (Ribbon bar)
How to import water areas:
  1. Drag your GeoJSON file into the editor
  2. Select "Import as areas
  3. Rename the water level attribute to "WATER_LEVEL"
  4. Select "Send"
How to create a water area manually:
  1. Add a new area to the project
  2. Draw the area into the 3D Visualization
  3. Add the attribute "WATER_LEVEL" to the area, with a value of, for example, "-10"
  4. Select "refresh grid"

Refresh overlays

When data has been loaded in or changed in the editor, the grid is not updated automatically, so you will not immediately see your changes. To force the grid to update, you can refresh the grid.

Note that only oxidation is calculated outside of a session or testrun. Compaction requires a stakeholder to take a certain type of action first.

Further data

It's possible to configure the overlay further with additional data.

Ground water levels

By default, the ground water levels are loaded in from a publicly available GeoTIFF automatically. Under the "Keys" tab in the right panel, you can change the selected GeoTIFF by selecting a different one at "Include Ground Water Tiff". You can also disable the ground water GeoTIFF, and use a ground water level attribute of areas instead.

How to add your own ground water data:
  1. Select the overlay
  2. In the right panel, select the "keys" tab
  3. Uncheck the "Include Ground Water Tiff" checkbox
  4. Select or create an area, part of the project
  5. Add the attribute "GLG" to the area, with a value of, for example, "-1"
Clay thickness

By default, no data about clay thickness is available, and is considered to be "0". It's possible to add this attribute to areas to further influence the amount of subsidence taking place.

How to add clay thickness data:
  1. Select the overlay
  2. Select or create an area, part of the project
  3. Add the attribute "CLAY_THICKNESS" to the area, with a value of, for example, "0,4"
Other keys/attributes

For more information on which values can be adjusted, see Subsidence calculation (section on configuring).

When a subsidence overlay is added, with one or more result type child overlays, changing the configuration of the parent overlay will also affect the results presented by the child overlays. However, when multiple subsidence overlays are added to a project, changing the configuration of one overlay will not affect the results of the other overlays.