Subsidence Overlay: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
Line 1: Line 1:
{{learned|what the Subsidence overlay is|what calculations are built into the subsidence overlay|what information is displayed by the subsidence overlay|how to configure the subsidence overlay}}
{{learned|what the Subsidence overlay is|what calculations are built into the subsidence overlay|what information is displayed by the subsidence overlay|how to configure the subsidence overlay}}
<!--''Ground water (Overlay) redirects here, because they perform the same calculations.''-->
==What is the subsidence overlay==
==What is the subsidence overlay==


[[File:Subsidence-Overlay.jpg|thumb|200px|left|The subsidence overlay]]
[[File:Subsidence-Overlay.jpg|thumb|200px|left|The subsidence overlay]]
The subsidence overlay is a [[grid overlay]], and part of the [[subsidence calculation|subsidence collection]] of overlays. It shows which places in the [[3D world]] are subject to subsidence due to oxidation and/or compaction of peat. There are actually multiple overlays which perform the exact same calculations, but the output of which differ.
[[File:Groundwater-Overlay.jpg|thumb|200px|left|The ground water overlay]]
The subsidence overlay is a [[grid overlay]]. It shows which places in the [[3D world]] are subject to subsidence due to oxidation and/or compaction of peat. The [[subsidence calculation|calculations]] can give result about the subsidence, and the effects it has on ground water levels.


The subsidence overlay can be used to calculate the amount of subsidence which takes place on peat soil, specifically due to peat oxidation and compaction. In reality, there are more factors which can compound subsidence but these are not yet part of this set of calculations. The calculations are also specific for peat soil. Separate formulas for other soil types have not yet been implemented. This means that results have a greater margin of error for different use-cases.
The subsidence overlay can be used to calculate the amount of subsidence which takes place on peat soil, specifically due to peat oxidation and compaction. The calculations are specific for peat soil. Separate formulas for other soil types have not yet been implemented. Although it's possible to use the overlay to give an impression of subsidence resulting from other factors, the results will be less accurate. This means that results have a greater margin of error for different use-cases.


Because the overlays all contain a complete, self-contained "model" for their calculations, it is possible to have multiple overlays of the same type in the same project. By varying their configuration slightly, it is possible to calculate multiple scenario's or time-frames at the same time.<br style='clear:left;'>
It is possible to add multiple subsidence overlays to a project. By varying their configuration slightly, it is possible to calculate multiple scenario's or time-frames simultaneously.


[[File:Groundwater-Overlay.jpg|thumb|200px|left|The ground water overlay]]
<br style='clear:left;'>
Though not directly apparent, the ground water overlays are also subsidence overlays. They also calculate all aspects of subsidence, including the resulting effects on the ground water levels. These overlays provide information about the ground water aspect of the subsidence calculations.<br style='clear:left;'>


==How the overlay calculates==
==How the overlay calculates==
Line 20: Line 19:


For information on the exact calculation of subsidence due to oxidation, see the article on [[Subsidence calculation#Oxidation Calculation|Subsidence calculation (section on Oxidation)]].
For information on the exact calculation of subsidence due to oxidation, see the article on [[Subsidence calculation#Oxidation Calculation|Subsidence calculation (section on Oxidation)]].
====Ground water levels====
====Ground water levels====
Ground water levels strongly affect how much peat can oxidize. Ground water levels, in turn, are affected by surface water levels, which can be changed during a session. Based on changes in surface water level, the ground water level changes as well.
Ground water levels strongly affect how much peat can oxidize. Ground water levels, in turn, are affected by surface water levels, which can be changed during a session. Based on changes in surface water level, the ground water level changes as well.
Line 34: Line 34:
Subsidence is calculated in 1-year steps. For each year, the amount of subsidence is calculated. That amount is then used to recalculate the input parameters for the overlay. The next 1-year step is then calculated.
Subsidence is calculated in 1-year steps. For each year, the amount of subsidence is calculated. That amount is then used to recalculate the input parameters for the overlay. The next 1-year step is then calculated.


==Legend==
==Result types==
The legend of the subsidence overlays is automatically calculated, based on the amount of years being calculated by the overlay. The colors will remain constant based on average subsidence per year. I.e. if the amount of years is doubled, the values in the legend, corresponding to specific colors, are doubled as well.
The overlay offers the following result types:
{| class="wikitable"
! Result type
! Unit
! Description
|-
| SUBSIDENCE
| m change in land height
| The amount that the ground has lowered as a result of subsidence, both oxidation and compaction. A positive number means the ground has lowered.
|-
| OXIDATION
| m change in land height
| The amount that the ground has lowered as a result of peat oxidation.
|-
| COMPACTION
| m change in land height
| The amount that the ground has lowered as a result of compaction.
|-
| HI_GROUND_WATER
| m distance from surface to ground water
| The distance between the ground surface and the highest ground water level. This number is lower than that of the lowest ground water level. A positive value means the ground water is below the surface of the land. A negative value would theoretically mean the ground water has risen above the surface of the ground.
|-
| LOW_GROUND_WATER
| m distance from surface to ground water
| The distance between the ground surface and the lwowest ground water level. This number is higher than that of the highest ground water level. A positive value means the ground water is below the surface of the land. A negative value would theoretically mean the ground water has risen above the surface of the ground.
|}
 
===Legend===
The legend of the subsidence overlays is automatically calculated, based on the amount of years being calculated by the overlay. The colors will remain constant based on average subsidence per year. I.e. if the amount of years is doubled, the values in the legend, corresponding to specific colors, are doubled as well. Because the legend displays total amounts of subsidence rather than averages, the displayed range of amounts changes when the amount of calculation years changes.


The legend of the ground water overlays is constant, and will display a color from blue through yellow to red to indicate how wet the soil is. The closer the ground water is to the surface of the land, the bluer the overlay.
The legend of the ground water overlays is constant, and will display a color from blue through yellow to red to indicate how wet the soil is. The closer the ground water is to the surface of the land, the bluer the overlay. In contrast to the subsidence legends, the ranges of ground water amounts do not change.


<gallery heights=62px mode="packed">
<gallery heights=62px mode="packed">
Line 46: Line 74:


==Output==
==Output==
The output of all subsidence- and ground water level overlays is in meters. The results can be [[Grid overlay#Export as GeoTiff|exported as GeoTiff]].
The output of all result types of the overlay is in meters. The results can be [[Grid overlay#Export as GeoTiff|exported as GeoTiff]].


===Subsidence output===
===Subsidence output===
The output of the [[grid overlay|grid]] of each subsidence overlay is the subsidence in meters. Depending on the exact overlay added to the [[project]], the output is the amount of subsidence as the result of one specific calculation, or the sum of all the calculations of subsidence.
The output of the [[grid overlay|grid]] of each subsidence result type is the subsidence in meters. Depending on the exact result type used, the output is the amount of subsidence as the result of one specific calculation, or the sum of all the calculations of subsidence.


The [[hover panel]] will display the following information:
The [[hover panel]] will display the following information:
* The amount of subsidence taking place over the configured amount of years.
* The amount of subsidence taking place over the configured amount of years.
* The current surface water level, and to what level is will have changed after the subsidence has taken place.
* The current surface water level, and to what level it will have changed after the subsidence has taken place.
* The [[subsidence calculation#Indexation|indexation]] policy currently configured for this water level area.
* The [[subsidence calculation#Indexation|indexation]] policy currently configured for this water level area.


===Ground water level output===
===Ground water level output===
The output of the [[grid overlay|grid]] of each ground water overlay is the final distance from the ground water level to the surface of the land in meters.
The output of the [[grid overlay|grid]] of each ground water result type is the final distance from the ground water level to the surface of the land in meters.


The [[hover panel]] will display the following information:
The [[hover panel]] will display the following information:
Line 63: Line 91:


===Final water level===
===Final water level===
Both the subsidence and the ground water overlays can also write the final surface water level to an [[attribute]] of an [[area]]. The area where the attribute will be written to is the area which has provided the original water level for the overlay.
The overlay can also write the final surface water level to an [[attribute]] of an [[area]]. The area where the attribute will be written to is the area which has provided the original water level for the overlay.


==Affecting the overlay==
==Affecting the overlay==
Line 69: Line 97:


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


===Compaction===
===Compaction===
Line 75: Line 103:


==Configuring the overlay==
==Configuring the overlay==
When the subsidence overlay (or a ground water level overlay) is added to a project, there is some minimum information required for a calculation.
When the subsidence overlay is added to a project, there is some minimum information required for a calculation.


===Peat soil===
===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.
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 for ground water overlays.''
''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 ribbon|header=3D World|bar=Terrain}}
{{Editor ribbon|header=3D World|bar=Terrain}}
Line 89: Line 117:


===Water level areas===
===Water level areas===
Subsidence and ground water is only calculated within water level areas, regardless of what data is present in the [[project]]. These areas are defined by the fact that they have a WATER_LEVEL [[attribute]].
Subsidence is only calculated within water level 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 [[area]]s with [[attribute]]s, or by manually drawing the appropriate [[area]]s and adding [[attribute]]s to those.
There are 2 ways of getting this data into your project: by importing it (i.e. your own data) into the [[project]] as [[area]]s with [[attribute]]s, or by manually drawing the appropriate [[area]]s and adding [[attribute]]s to those.
Line 120: Line 148:
For more information on which values can be adjusted, see [[Subsidence calculation#Configuring overlays|Subsidence calculation (section on configuring)]].
For more information on which values can be adjusted, see [[Subsidence calculation#Configuring overlays|Subsidence calculation (section on configuring)]].


The subsidence and ground water overlays do not interact with one another. Each overlay contains a "complete" model of all subsidence and ground water level information. If an adjustment, such as the amount of simulation years, is changed for one overlay, it is not automatically changed for another overlay.
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.

Revision as of 09:11, 30 July 2018

Template:Learned

What is the subsidence overlay

The subsidence overlay
The ground water overlay

The subsidence overlay is a grid overlay. It shows which places in the 3D world are subject to subsidence due to oxidation and/or compaction of peat. The calculations can give result about the subsidence, and the effects it has on ground water levels.

The subsidence overlay can be used to calculate the amount of subsidence which takes place on peat soil, specifically due to peat oxidation and compaction. The calculations are specific for peat soil. Separate formulas for other soil types have not yet been implemented. Although it's possible to use the overlay to give an impression of subsidence resulting from other factors, the results will be less accurate. This means that results have a greater margin of error for different use-cases.

It is possible to add multiple subsidence overlays to a project. By varying their configuration slightly, it is possible to calculate multiple scenario's or time-frames simultaneously.


How the overlay calculates

Subsidence is currently composed of 2 forms of reduction of peat: oxidation and compaction. These forms of subsidence are both relevant for the complete picture of subsidence, but are, in principle, calculated via separate formulas. The results of these formulas are added together to get the total amount of subsidence.

Oxidation

Peat, when exposed to oxygen, can oxidize. In this process the peat combines with the air to form CO2, reducing the total mass and volume of the peat. The amount of oxidation depends on the clay thickness, because clay may insulate the peat, preventing it from oxidizing. It also depends on the (lowest) ground water level in relation to the surface of the land.

For information on the exact calculation of subsidence due to oxidation, see the article on Subsidence calculation (section on Oxidation).

Ground water levels

Ground water levels strongly affect how much peat can oxidize. Ground water levels, in turn, are affected by surface water levels, which can be changed during a session. Based on changes in surface water level, the ground water level changes as well.

For information on the exact calculation of ground water level changes, see the article on Subsidence Calculation (section on Ground Water ).

Compaction

Peat is a porous and relatively soft terrain type, meaning it can be compressed. Based on the amount of peat in the ground, the density of the top layer, and the net height increase.

For information on the exact calculation of subsidence due to compaction, see the article on Subsidence calculation (section on Compaction).

Multi-year calculations

Subsidence is calculated in 1-year steps. For each year, the amount of subsidence is calculated. That amount is then used to recalculate the input parameters for the overlay. The next 1-year step is then calculated.

Result types

The overlay offers the following result types:

Result type Unit Description
SUBSIDENCE m change in land height The amount that the ground has lowered as a result of subsidence, both oxidation and compaction. A positive number means the ground has lowered.
OXIDATION m change in land height The amount that the ground has lowered as a result of peat oxidation.
COMPACTION m change in land height The amount that the ground has lowered as a result of compaction.
HI_GROUND_WATER m distance from surface to ground water The distance between the ground surface and the highest ground water level. This number is lower than that of the lowest ground water level. A positive value means the ground water is below the surface of the land. A negative value would theoretically mean the ground water has risen above the surface of the ground.
LOW_GROUND_WATER m distance from surface to ground water The distance between the ground surface and the lwowest ground water level. This number is higher than that of the highest ground water level. A positive value means the ground water is below the surface of the land. A negative value would theoretically mean the ground water has risen above the surface of the ground.

Legend

The legend of the subsidence overlays is automatically calculated, based on the amount of years being calculated by the overlay. The colors will remain constant based on average subsidence per year. I.e. if the amount of years is doubled, the values in the legend, corresponding to specific colors, are doubled as well. Because the legend displays total amounts of subsidence rather than averages, the displayed range of amounts changes when the amount of calculation years changes.

The legend of the ground water overlays is constant, and will display a color from blue through yellow to red to indicate how wet the soil is. The closer the ground water is to the surface of the land, the bluer the overlay. In contrast to the subsidence legends, the ranges of ground water amounts do not change.

Output

The output of all result types of the overlay is in meters. The results can be exported as GeoTiff.

Subsidence output

The output of the grid of each subsidence result type is the subsidence in meters. Depending on the exact result type used, the output is the amount of subsidence as the result of one specific calculation, or the sum of all the calculations of subsidence.

The hover panel will display the following information:

  • The amount of subsidence taking place over the configured amount of years.
  • The current surface water level, and to what level it will have changed after the subsidence has taken place.
  • The indexation policy currently configured for this water level area.

Ground water level output

The output of the grid of each ground water result type is the final distance from the ground water level to the surface of the land in meters.

The hover panel will display the following information:

  • The level to which the ground water will have changed, after the subsidence has taken place.

Final water level

The overlay can also write the final surface water level to an attribute of an area. The area where the attribute will be written to is the area which has provided the original water level for the 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

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

Compaction

During a session, a stakeholder can raise or lower land. They can do this directly, via land sculpting actions, or by constructing dikes. 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.

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).

Template:Editor ribbon

How to change soil sensitivity to subsidence:
  1. Hover over the 3D world 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 world

Water level areas

Subsidence is only calculated within water level 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.

Template:Editor ribbon

How to import water level 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 level area manually:
  1. Add a new area to the project
  2. Draw the area into the 3D World
  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 3D world
  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 3D world
  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.