|
|
| Line 1: |
Line 1: |
| __NOTOC__
| |
| {{Template:Subsidence Module buttons}}
| |
| <!--
| |
| {{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}}
| |
|
| |
| ==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]] |
| [[File:Groundwater-Overlay.jpg|thumb|200px|left|The ground water overlay]] | | [[File:Groundwater-Overlay.jpg|thumb|200px|left|The ground water overlay]] |
| Line 16: |
Line 10: |
| <br style='clear:left;'> | | <br style='clear:left;'> |
|
| |
|
| ==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#Oxidation Calculation|Subsidence calculation (section on Oxidation)]].
| |
|
| |
| ====Groundwater levels====
| |
| Groundwater levels strongly affect how much peat can oxidize. Groundwater levels, in turn, are affected by surface water levels, which can be changed during a session. Based on changes in surface water level, the groundwater level changes as well.
| |
|
| |
| For information on the exact calculation of groundwater level changes, see the article on [[Subsidence calculation#Ground Water change calculation|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#Compaction calculation|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.
| |
|
| |
| ===Loss of earnings of crops===
| |
| The loss of earnings of crops can now be added as result types. The loss of earnings is divided into 4 categories; indirect damage, damage due to wetness, damage due to drought and damage due to irrigation with salinated water. The computations are done by the [https://waterwijzerlandbouw.wur.nl/ ''Waterwijzer Landbouw module''] , with which the {{software}} communicates through its API. The calculated increase or decrease of the highest and lowest groundwater levels due to subsidence are taken into account before communicating the water levels to the ''Waterwijzer Landbouw module''.
| |
|
| |
| In short, the loss of earnings is based on:
| |
| * Type of crop indicated by the CROP_CODE attribute of a building. By default, dutch agricultural plots have this attribute defined. This CROP_CODE is converted by the {{software}} to an id accepted by the ''Waterwijzer Landbouw'' API. The official conversion table can be found [https://waterwijzerlandbouw.wur.nl/downloads/VertalingGewassen-1.1.0.pdf here].
| |
| * Type of underground soil, indicated by the BOFEK_ID attribute of a terrain type. By default, dutch underground terrain types have this attribute defined.
| |
| * Weather station; The selectable dutch weather stations are: De Bilt, De Kooy, Eelde, Vlissingen and Maastricht.
| |
| * Climate scenario; Only one of two can be selected: Current situation (1981-2010) and WH 2050 (2036-2065)
| |
| * The adjusted highest and lowest groundwater level: These are provided by the Subsidence calculations described in the sections above.
| |
| * Irrigation and salinity: these are currently set to 0 and not adjustable in the {{software}}.
| |
| -->
| |
| ==Result types== | | ==Result types== |
| The overlay offers the following result types: | | The overlay offers the following result types: |
| Line 77: |
Line 39: |
| |} | | |} |
|
| |
|
| ===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 groundwater overlays is constant, and will display a color from blue through yellow to red to indicate how wet the soil is. The closer the groundwater is to the surface of the land, the bluer the overlay. In contrast to the subsidence legends, the range of values for groundwater do not change.
| | ==How to's== |
| | * [[How to add and remove an Overlay]] |
| | * [[How to edit an overlay legend|Edit an overlay legend]] |
|
| |
|
| <gallery heights=62px mode="packed">
| | {{Template:Subsidence Module buttons}} |
| Image:Subsidence30-legend.jpg|Subsidence legend for 30 years
| |
| Image:Subsidence60-legend.jpg|Subsidence legend for 60 years
| |
| Image:GLG-legend.jpg|Groundwater legend
| |
| </gallery>
| |
| | |
| ==Output==
| |
| 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===
| |
| 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 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 [[subsidence calculation#Indexation|indexation]] policy currently configured for this water level area.
| |
| | |
| ===Groundwater level output===
| |
| The output of the [[grid overlay|grid]] of each groundwater result type is the final distance from the groundwater level to the surface of the land in meters.
| |
| | |
| The [[hover panel]] will display the following information:
| |
| * The level to which the groundwater 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]], [[stakeholder]]s can affect the data in the project. They can do this through, for example, [[action]]s or [[event]]s. 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 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 [[construction]]s with a "drainage" [[function value]]. Drainage sets the groundwater 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 [[List_of_actions#Sculpting|land sculpting actions]], or by constructing [[levee]]s. 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.
| |
| | |
| [[File:Subsidence_overlay_wizard.PNG|750px]]
| |
| | |
| ====Areas====
| |
| In 3 steps, some geographical information will be configured, related to surface- and groundwater. Options presented allow for importing data, or generating some parameters based on general assumptions.
| |
| | |
| ====Constructions====
| |
| 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.
| |
| | |
| ====Overlays====
| |
| 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 overlay]]s, which display the values of specific geographical input attributes as an overlay in the [[3D world]]. This provides insight into the exact values used to perform the subsidence calculations.
| |
| | |
| ===Manually===
| |
| 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 groundwater 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 groundwater level result types(s).''
| |
| | |
| {{Editor location|Terrain}} | |
| | |
| {{editor steps|title=change soil sensitivity to subsidence|Hover over the 3D world and click to find the underground soil type|Select that underground soil type in the [[left panel]]|In the [[right panel]], switch to the [[attribute]]s tab|[[Attribute#How_to_add_and_remove_attributes|Add the attribute]] "SUBSIDENCE" with value 1}}
| |
| | |
| {{editor steps|title=change the soil type|Select "peat" in the [[left panel]]|Select the "General" tab in the [[right panel]]|[[Terrain#Drawing terrain in the 3D world|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 [[area]]s with [[attribute]]s, or by manually drawing the appropriate [[area]]s and adding [[attribute]]s to those.
| |
| | |
| {{Editor location|Areas}}
| |
| | |
| {{Editor steps|title=import water level areas|Drag your GeoJSON file into the editor|Select "Import as [[area]]s|Rename the water level attribute to "WATER_LEVEL"|Select "Send"}}
| |
| | |
| {{Editor steps|title=create a water level area manually|[[area#Adding and removing areas|Add a new area]] to the project|[[area#Adjust Area|Draw the area]] into the [[3D World]]|[[attribute#How to add and remove attributes|Add the attribute]] "WATER_LEVEL" to the area, with a value of, for example, "-10"|Select "refresh grid"}}
| |
| | |
| ====Refresh overlays====
| |
| When data has been loaded in or changed in the [[editor]], the [[grid overlay|grid]] is not updated automatically, so you will not immediately see your changes. To force the grid to update, you can [[grid overlay#refresh grid|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.
| |
| | |
| =====Groundwater levels=====
| |
| By default, the groundwater 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 groundwater geotiff, and use a groundwater level attribute of areas instead.
| |
| | |
| {{Editor steps|title=add your own groundwater data|Select the overlay|In the [[right panel]], select the "keys" tab|Uncheck the "Include Ground Water Tiff" checkbox|Select or create an area, part of the [[3D world]]|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.
| |
| | |
| {{Editor steps|title=add clay thickness data|Select the overlay|Select or create an area, part of the [[3D world]]|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#Configuring overlays|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.
| |
| -->
| |
| {{Template:Overlay nav}}
| |
| [[Category:Overlays with result types]]
| |
