Rainfall Overlay: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
Line 151: Line 151:


===Including subsidence===
===Including subsidence===
[[File:Subsidence_attribute.JPG|400px|thumb|right|Create a new attribute containing the recalculated water levels.]]
[[File:Include_subsidence.JPG|400px|thumb|right|Include the subsidence overlay and select the new water level attribute.]]
For the calculation of the effects of a severe rainfall, effects of subsidence can be included, such as the recalculated water levels and the changed ground levels. For now, ground water levels affected by the subsidence are not included.   
For the calculation of the effects of a severe rainfall, effects of subsidence can be included, such as the recalculated water levels and the changed ground levels. For now, ground water levels affected by the subsidence are not included.   


{{Editor steps|title=include subsidence|Add the [[Subsidence_(Overlay)|subsidence overlay]]. Take note of when to use and how to configure the subsidence overlay.|In the [[right panel]], select the "Keys" tab|Select the "Area attribute: output level (m)". Choose a new attribute, for example the WATER_LEVEL_OUTPUT attribute, to write the new water levels to. Be careful not to write the new water levels to the already existing water level attribute, otherwise the subsidence model will be recalculated with incorrect values when refreshing this overlay.
{{Editor steps|title=include subsidence|Add the [[Subsidence_(Overlay)|subsidence overlay]]. Take note of when to use and how to configure the subsidence overlay.|In the [[right panel]], select the "Keys" tab|Select the "Area attribute: output level (m)". Choose a new attribute, for example the WATER_LEVEL_OUTPUT attribute, to write the new water levels to. |In the Rainfall overlay in the [[right panel]], select the "Keys" tab.|Choose the overlay for the subsidence model you want to use in the "Include Subsidence" form.|Also select the newly created attribute containing the water levels in the "Area Attribute: Water Level (m)" form.|Go to the "General" tab and recalculate the grid.}}
|In the Rainfall overlay in the [[right panel]], select the "Keys" tab.|Choose the overlay for the subsidence model you want to use in the "Include Subsidence" form.|Also select the newly created attribute containing the water levels in the "Area Attribute: Water Level (m)" form.|Go to the "General" tab and recalculate the grid.}}


Now the rainfall overlay will include the effects of the subsidence. You can play around with this and compare several overlays with different inputs, for example by generating two rainfall overlays where one uses the subsidence and one overlay without the effects of the subsidence.
Be careful not to write the new water levels calculated in the [[Subsidence_(Overlay)|subsidence overlay]] to the already existing water level attribute, otherwise the subsidence model will be recalculated with incorrect values when refreshing this overlay.  
You can play around with the two overlays and compare several rainfall overlays with different inputs, for example by generating two rainfall overlays where one uses the subsidence and one overlay without the effects of the subsidence.

Revision as of 14:06, 26 July 2017

Template:Learned

What is the rainfall overlay

The rainfall overlay is a grid overlay, which calculates where and how water would flow in situations where severe rainfall takes place. It does so by simulating water falling onto the 3D world over the course of thousands of steps. During each step, water can, among other things, land on the ground, flow over the surface, infiltrate into the ground, flow underground, and end up in surface water.

By repeating these simulation steps thousands of times, the influx and flows of water are accurately approximated.

What can the rainfall overlay be used for

The rainfall overlay is currently fit for simulating the flow and effects of severe rainfall on flat or mildly hilly areas, for map sizes of up to 5km. Larger maps, or calculations which involve an impulse of water such as levee breaches are not yet recommended.

The overlay can be configured to display various results of the simulated rainfall. See below for the complete list of result types.

Result types

  • BASE_GROUNDWATER_DISTANCE: shows the distance between the groundwater level. For now, the height of the ground level is including the buildings and other objects on the ground (the height to the surface). This will be changed to the terrain height in a following release.
  • BASE_TYPES: shows the division of the grid cells in water, land or sewer areas that are connected to the sewer. Playing with the grid cell size, will make this division between areas/terrain types more or less accurate, which affects the calculation of the flooding.
  • EVAPORATED: shows how much water is evaporated after the rainfall in the defined simulation time. For more information on how this layer is calculated, see the Rainfall overlay calculations page.
  • SEWER_LAST_VALUE: The amount of water remaining in the sewer after the simulation is over
  • SEWER_MAX_VALUE: The largest amount of water that was in the sewer at any time during the simulation
  • SURFACE_DURATION: The total amount of time the surface has water on it
  • SURFACE_FLOW: The total amount of water which has flowed across the surface
  • SURFACE_LAST_VALUE: The amount of water remaining on the surface after the simulation is over
  • SURFACE_MAX_VALUE: The largest amount of water that was on the surface at any time during the simulation. Differs from WATER_STRESS in that water stored on bodies of water is always included.
  • UNDERGROUND_FLOW: The total amount of water which has flowed underground
  • UNDERGROUND_LAST_VALUE: the amount of water which has flowed underground after the rain simulation is over.
  • UNDERGROUND_MAX_VALUE: the largest amount of water that flowed underground at any time during the simulation
  • WATER_STRESS: The maximum amount of excess water at any time during the simulation. Differs from SURFACE_MAX_VALUE because water stored on bodies of water are not immediately deemed "excess", this depends on the threshold value which can be defined in the last step of the rain overlay wizard. If the amount of water exceeds this threshold value, the amount of water is visible on the water bodies.


Also, the influence of subsidence can be included in the calculations, see therefore the section about including the subsidence overlay.

Rain overlay wizard

Configuring the rainfall overlay

The rainfall overlay consists of several result types that show different analyses of the area after or during the extreme rainfall. The overlay can therefore be added to the project multiple times, to present different outcomes or scenarios and compare these, for example for different rainfalls. For information on adding and removing the overlay to and from the project, see the page about overlays in general.

To improve the accuracy of the model:

  • Use a grid size of max 2m for calculating the correct flow.
  • Select the high resolution heightmap in the Wizard under advanced options, to use a high detailed height map (1 point per 0.5m).

To further enhance the way the calculations are made and make the model more accurate, the overlay itself can be configured. To guide the user along these configurations, the rain overlay wizard provides the steps to add data about the water system and/or configure hydrological coefficients used in the calculations.

Data required

No data is explicitly required. The overlay is designed to provide initial calculations based on default values and minimal assumptions. However, the model can be refined with your own data regarding the water system:

  • Water level areas (peilgebieden)
  • Hydrological constructions (stuwen)
  • Ground water level (grondwaterstanden)
  • Sewers (rioleringsgebieden)

Rainfall

The wizard exists of several steps. First the intensity and the length of the rain definition is set. The simulation time of the model compromises the length of the rainfall and the time it takes before it is dry. Also, the simulated rainfall will be equally distributed over the time. In the following steps, data about the water system can be provided.

Water level areas

Here you can add your own dataset of "level areas" with a set water level. This file is loaded in as a geojson file as areas. The following attributes are needed for the calculations.

Attribute Description Example Remark
NAME The name of the water level area. PG 256 This attribute is not loaded in as attribute, but can be used as name to identify the resulting area in the Engine later on.
WATER_LEVEL The height of the water, in meters, measured from Amsterdam Ordnance Datum (mNAP). 1.6 For a water level area with infinite storage, this can be set to an extreme negative number (e.g. -9999). However, note that this would also place this area far below level areas with a proper height set.
OUTLET The amount of water which disappears from this level area in cubic meters per second (m3/s). 0.007 This could also be the outlet of a gemaal

If you do not have any water level dataset, you can also generate a water level area. This will create one waterlevel area which covers the entire 3D world, with no OUTLET value and a WATER_LEVEL of -1000. In the wizard the attributes which contain values for the water level and outlet need to be set. If they have different names, these can be chosen in the select attribute table.

Hydrological constructions

For example weirs form connections between water level areas, where the water is transported from higher to lower water level areas. The weir (or other hydrological construction) dataset is also loaded in as a geojson file. The following attributes need to be present.

Attribute Description Example Remark
NAME The name of the weir. PG 256 This attribute is not loaded in as attribute, but can be used as name to identify the resulting contruction in the Engine later on.
WEIR_HEIGHT_M The height of the weir, in meters, measured from Amsterdam Ordnance Datum (mNAP). 1.8 When using this model outside of the Netherlands, the height is in the same scale as the Terrain height of the project. When an extreme negative value is used, the construction acts like a culvert.
WEIR_SPEED The speed at which water is moved from one level area to the other, in cubic meters per second (m3/s). 0.007 Once the water level exceeds the height of the weir, the water flows at this constant speed until the water level no longer exceeds the height of the weir.

This file is loaded in as constructions. For now, the underground construction drainage system can be used. If no weirs exist, there are no connections between water level areas and water is not transferred between them.

Weirs must overlap with at most 2 water level areas. If a weir overlaps with more that 2 water level areas, 2 areas are selected at random which the weir pumps between. If a weir overlaps with only 1 water level area, only its outlet function is processed. Weirs which do not overlap with any water level areas have no effect.

Ground Water level data

This step in the rain overlay wizard provides the possibility to upload a GeoTiff file with ground water levels. By default the ground water level of the water level areas is used. If you choose for the option to upload a GeoTiff file, you can add you own GxG map with the distances between the ground level and the ground water level in meters. Or you can use one of the already loaded in GxG maps.

Sewers

The next step allows for the sewer areas to be uploaded. The file is loaded in as a geojson file as areas. The following attributes are needed:

Attribute Description Example Remark
NAME The name of the sewer. Sewer North-East This attribute is not loaded in as attribute, but can be used as name to identify the resulting area in the Engine later on.
SEWER_PUMP_SPEED The speed at which water is pumped out of the sewer, in cubic meters per hour (m3/h). 1 All areas which are not plots of this kind should either not have PERCEEL as an attribute, or should have it set to 0(*).
SEWER_STORAGE The amount of water which can be stored in this sewer, in meters (m). 0.007 The total amount of storage for this sewer is the surface area of the constructions which are connected to the sewer in this particular sewer area, times this attribute.

If no sewers exist, the model has no water flowing into sewer containers for storage. Therefore, you can automatically generate these areas. For more information on how the generation of these areas is done or about the sewer system in general, see the Rainfall overlay calculations page.

Hydrological coefficients

In the next steps of the wizard, hydrological coefficients regarding the surface and the underground terrains, can be edited. For each of these coefficients, representative values are already entered in the forms.

  • Water infiltration (m per day): the speed by which the water infiltrates the underground. The speed is also determined by the underground water infiltration factor. From these two values, the lowest value is used.
  • Water manning: the Gauckler Manning coefficient, often denoted as n, is an empirically derived coefficient, which is dependent on many factors, including surface roughness and sinuosity. For more information about this formula see the Rainfall overlay calculations page.
  • Water evaporation factor: this factor will be multiplied with the general reference evaporation.
  • Reference Evaporation (mm per day): The Makking reference evaporation factor. This value ranges from 0.5 mm per day in the winter till 3 mm per day in the summer for the weather station ‘ De Bilt’ in the Netherlands.
  • Water storage fraction: the percentage of underground volume that can be used for the storage of water. This number is determined by the difference between the ground water level and the surface height times the surface area.
  • Vertical to horizontal infiltration factor: This factor will be multiplied with the vertical infiltration speed, to obtain the horizontal infiltration speed.
File:Visualisatie wateroverlast.JPG
Schematic visualization of the water flow over the water level areas and hydrological constructions.

Building functions

Since constructions in the Engine have an effect on the flow of the water, for example if a building has a green roof, attributes concerning these values can be adjusted in this step of the wizard. Representative values are already entered in the table. The same values can also be adjusted in the function values window.

Visualization of the water system

In the last step you can choose for a result type, as listed above. If you have provided the water level areas and the hydrological constructions to the Engine, along with the required attributes, a schematic visualization of the water flow from the various water level areas and the hydrological constructions is visible. The red spheres stand for water flowing to (an)other water level area. The green spheres stand for receiving water from (an)other water level area. The speed of the spheres is based on the WEIR_SPEED and the OUTLET values. If no spheres are visible, the water flows very gently between these water level areas. The pop-ups in the 3D world are panels which mark the middle of the water level area or the place of the hydrological constructions. In these panels, the provided attributes, such as the WATER_LEVEL_M or the WEIR_HEIGHT can also be edited. Play around with this to see how the water flow changes.

Including subsidence

File:Subsidence attribute.JPG
Create a new attribute containing the recalculated water levels.
File:Include subsidence.JPG
Include the subsidence overlay and select the new water level attribute.

For the calculation of the effects of a severe rainfall, effects of subsidence can be included, such as the recalculated water levels and the changed ground levels. For now, ground water levels affected by the subsidence are not included.

How to include subsidence:
  1. Add the subsidence overlay. Take note of when to use and how to configure the subsidence overlay.
  2. In the right panel, select the "Keys" tab
  3. Select the "Area attribute: output level (m)". Choose a new attribute, for example the WATER_LEVEL_OUTPUT attribute, to write the new water levels to.
  4. In the Rainfall overlay in the right panel, select the "Keys" tab.
  5. Choose the overlay for the subsidence model you want to use in the "Include Subsidence" form.
  6. Also select the newly created attribute containing the water levels in the "Area Attribute: Water Level (m)" form.
  7. Go to the "General" tab and recalculate the grid.

Be careful not to write the new water levels calculated in the subsidence overlay to the already existing water level attribute, otherwise the subsidence model will be recalculated with incorrect values when refreshing this overlay. You can play around with the two overlays and compare several rainfall overlays with different inputs, for example by generating two rainfall overlays where one uses the subsidence and one overlay without the effects of the subsidence.