Basic water model use case (Water Overlay): Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
 
(60 intermediate revisions by 7 users not shown)
Line 1: Line 1:
For all effective uses of any variant of the water overlay, you must first set up a basic water model. This water model includes both your hydrological system, as well as the parameters used to perform any calculations. The behavior of any water, whether it's pre-existing, expected inflow, or due to natural event or calamity, is affected by the presence of features which can capture or steer water in other directions. The more real-world [[Hydrologic features (Water Overlay)|hydrological feature]]s and [[Hydraulic structures (Water Overlay)|hydrological construction]]s are loaded in, the more accurately the water flow can be simulated.
For all effective uses of any variant of the water overlay, you must first set up a basic water model. This water model includes both your hydrological system, as well as the parameters used to perform any calculations. The behavior of any water, whether it is pre-existing, expected in- or outflow, or due to a natural event or calamity, is affected by the presence of features which can capture or steer water in other directions. The more real-world [[Hydrologic features (Water Overlay)|hydrological feature]]s and [[Hydraulic structures (Water Overlay)|hydrological building]]s are correctly configured, the more accurately the water flow can be simulated.


==Requirements==
==Requirements==
Before getting started, there are a few requirements which must be met first.
Before getting started, there are a few requirements which must be met.


===Determine what overlay you need===
===Determine what overlay you need===
The first step is to determine which variant of the [[Water Overlay]] best suits your needs. This depends largely on what primary calculation you wish to perform.
The first step is to determine which variant of the available [[Water Overlay| Water Overlays]] best suits your needs. This depends largely on what type of calculation you wish to perform.


===Create your project===
===Create your project===
The Water Overlay will be able to calculate most accurately if your project has been created with the following criteria in mind:
The Water Overlay will be able to calculate most accurately if your project has been created with the following criteria in mind:
* Your project has been loaded in with a high-resolution DEM. This can be configured during the [[Terrain_height#Terrain_height_in_the_Tygron_Platform|new project wizard]].
* Your project has been loaded in with a high-resolution DEM. This can be configured in the [[New Project Wizard]].
* Your project is large enough to account for [[edge effects|edge effects]].
* Your project is large enough to account for [[edge effects (Water Overlay)|edge effects]].
 
Additionally, consider the following:
* When creating a new project in the [[New Project Wizard]], consider using the [[Project sources#AHN|AHN3]] dataset. Where coverage is available, the AHN4 dataset will be more accurate and up to date. Where coverage is not available, the default AHN3 should be used. AHN2 is no longer advised.
* Additionally, when creating a new project, consider whether you want to use the [[Project sources#IMWA|IMWA]] dataset for [[hydraulic structures (Water Overlay)|hydrological structures]]. Although this dataset is not complete, some information about buildings which serve as [[culvert (Water Overlay)|culvert]]s or other relevant objects can be loaded in from this datasource. If more complete or accurate data is available to be loaded in into the project after it is created, it may be desirable to disregard this source so that hydrological buildings are not doubly included.


===Prepare your data===
===Prepare your data===
The next step is preparing your data. Note that data can be skipped if you do not have this data, or the data is not applicable for your project.
The next step is preparing your data. Note that this step can be skipped if you do not have any data applicable to your project area.


The following data should be prepared. Click on any topic for more information.
The following data can  be prepared as [[GeoJSON]]s. Click on any of the data types for more information.
{|class=wikitable
{|class=wikitable
!Data
!Data
Line 21: Line 25:
!Alternative/default
!Alternative/default
|-
|-
|[[Water level area (Water Overlay)|Water area]]s
|[[Water area (Water Overlay)|Water area]]s
|Water areas set the water level of all open water in the area they envelop.
|Water areas set the water level of all open water within their boundaries.
|In the configuration wizard, it is possible to generate a single water area for the entire project area.
|It is also possible to initialize the surface water levels using a [[Surface level prequel (Water Overlay)]].
|}
 
The following data should be prepared as [[GeoJSON]]s. Click on any of the data types for more information.
{|class=wikitable
!Data
!Description
!Alternative/default
|-
|-
|[[Weir (Water Overlay)|Weir]]s
|[[Weir (Water Overlay)|Weir]]s
Line 30: Line 41:
|-
|-
|[[Culvert (Water Overlay)|Culvert]]s
|[[Culvert (Water Overlay)|Culvert]]s
|Culverts allow for water to flow between bodies of water, with a maximum amount dictated by the size of the culvert.
|Culverts allow for water to flow between bodies of water, at a maximum rate determined by their size.
|For projects in the Netherlands some culverts may be loaded in as part of the [[GEO_Data|project creation process]].
|For project areas inside the Netherlands culverts may be imported automatically as part of the [[GEO_Data|project creation process]].
|-
|-
|[[Pump (Water Overlay)|Pump]]s
|[[Pump (Water Overlay)|Pump]]s
|Pumps move water from locations with a lower water level to locations with a higher water level.
|Pumps move water from locations with lower towards higher water levels.
|There are no default pumps in a project.
|There are no default pumps in a project.
|-
|-
|[[Inlet (Water Overlay)|Inlets and outlets]]
|[[Inlet (Water Overlay)|Inlets and outlets]]
|Inlets are points where water can be added to the water system. Outlets are points where water can leave the water system.
|Inlets are point locations where water can be added to the water system. Outlets are point locations where water can leave the water system.
|There are no default inlets or outlets in a project.
|There are no default inlets or outlets in a project.
|-
|-
|[[Sewer area (Water Overlay)|Sewer area]]s
|[[Sewer area (Water Overlay)|Sewer area]]s
|Sewer areas form controlled storage for water which ends up on constructions landing on sewer areas.
|Sewer areas serve as controlled storage of water flowing on top of buildings located inside these sewer areas.
|In the configuration wizard, it is possible to generate sewer areas based on the neighborhoods in the project area.
|In the configuration wizard it is possible to generate sewer areas based on the neighborhoods in the project area.
|-
|-
|[[Sewer overflow (Water Overlay)|Sewer overflow]]s
|[[Sewer overflow (Water Overlay)|Sewer overflow]]s
|Sewer overflows are a way for water to flow out of the sewer, and back onto the surface water system.
|Sewer overflows are a way for water to leave the sewers and flow back into the surface water system.
|There are no default sewer overflows in a project, even when sewers are loaded in or generated.
|There are no default sewer overflows in a project, but these can be generated in the presence of both water areas and sewers (either generated or imported).
<!--
<!--
|-
|[[Ground water]]
|Only relevant for groundwater overlays. Will set the height of the saturated zone's water in the underground.
|The groundwater overlay will assume the entire ground is saturated. Other overlays will not use the underground water model.
|-
|-
|[[Aquifer]]s
|[[Aquifer]]s
Line 59: Line 66:
-->
-->
|}
|}
Note that it is preferable to use the {{software}}'s naming convention for [[attribute]]s (such as [[culvert threshold (Water Overlay)|CULVERT_THRESHOLD]]) when preparing [[GeoJSON]] files, to prevent multiple structures or features from having the same keys and conflicting with each other in the [[Water Overlay]]'s setup.
The following data can be supplied using other [[Grid overlay|grid overlays]]. Click on any data type for more information.
{|class=wikitable
!Data
!Description
!Alternative/default
|-
|[[Groundwater Prequel (Water Overlay)|Groundwater]]
|Will set the datum height of the saturated zone in the underground.
|The groundwater datum height will be initiated using [[Water area (Water Overlay)|Water areas]]' [[Water level (Water Overlay) or the general model attribute [[Ground water depth m (Water Overlay)|GROUND_WATER_DEPTH_M].
|}
===Verify your data===
After preparing the data, it is important to undertake a few additional checks to make sure the model functions as much as expected as possible. These checks can best be performed directly after preparing the data.
; Missing attributes
: When your datasets have been created, take a moment to check how many features in your data have either missing attributes or placeholder values for attributes. Make sure that for each data type, you are aware of how the {{software}} will react when data is missing, or set to an unrealistic (or realistic) placeholder value.
; Pumps and inlets/outlets
: If you have pumps in your model, divide them into two groups: [[pump (Water Overlay)|pump]]s and [[inlet (Water Overlay)|inlet]]s. Pumps are the structures within your project area, which move water from one location in your hydrological model to another location in your hydrological model. Inlets (and outlets) are pumps at the edge of the hydrological model (in a topological sense), where water appears in your hydrological model, or is removed from your hydrological model. They form the "edges".


==Steps==
; Building shapes
: Make sure that all buildings which should be line-shaped are actually line-shaped. Buildings such as [[weir (Water Overlay)|weir]]s are commonly stored as points, while the {{software}} requires them to be lines, so that it can be determined exactly where the water flows to and from.
 
; Buildings in unblocked waterways (can also be checked after loading in)
: Also make sure that when a line-shaped building exists in a waterway, the water which is ment to flow via the building has no alternative way of flowing past the building. In practice, this often means blocking the waterway in which the building lies, in the location of the building, such that flowing through the building is the only way water can flow past the obstruction. Consider the following options:
:* You can manually create an obstruction in the [[elevation (Water Overlay)|DEM]] by adjusting the elevation model
:* You can draw a [[breach (Water Overlay)|breach]] in the waterway with a [[breach height (Water Overlay)|BREACH_HEIGHT]] set to the height of the surrounding land.
 
; Building placement in waterways (can also be checked after loading in)
: Make sure all [[Hydraulic_structures_(Water_Overlay)|hydrological buildings]] are placed such that their relevant centers are well in the waterways they apply to. If the endpoint of a culvert or other line-based building is on the edge or slope of a waterway, exact topography may cause the building to be less well connected to the actual water, requiring water to rise to a higher level before it is affected by the building. In general, topology matters more than exact topography, so moving building endpoints should not cause considerable deviations from realism.
 
; Overlapping buildings of the same type (can also be checked after loading in)
: If there are multiple buildings in the same location, such as parallel culverts, make sure their endpoints do not overlap/end up in the same cell. If such culverts exist, consider the following options:
:* Move the culverts, so that their endpoints are no longer in the same cell
:* Merge the culverts, by creating a single one with appropriate attributes to mimic the combined function of the two separate culverts.
 
; Overlapping buildings of different types (can also be checked after loading in)
: If there are multiple buildings in the same location, such as a culvert with a weir directly on the end, they should be adjusted as well to prevent multiple endpoints ending up in the same cell. In these situations, consider the following options:
:* Move the buildings, such that water first passes through the first building into an intermediate water basin, and then flows on through the other building.
:* Merge the buildings, such that only as single building exists but which constricts/facilitates the waterflow mimicking/approximating the combined effect of the two separate buildings.
 
==Notes==
Take note of the following while configuring the basic water model:
 
; Calculations based on default data.
:The [[Rainfall (Overlay)|rainfall]] and [[Groundwater (Overlay)|groundwater]] variants of the Water Overlay already form basic water models when they are added to a project without further configuration. However, all data and configurations explicitly performed will enhance the model greatly.
 
; Pre-existing buildings
: If you have prepared your own dataset of hydrological structures, make sure to delete any pre-existing structures of the same type before loading in your dataset. You can perform this action in the [[Water Overlay Wizard|wizard]]. Otherwise, there may be buildings in locations where there shouldn't be.
 
; Further corrections
: After the calculation completes you may still see some odd results. This may indicate there might be an issue somewhere in the model still. Depending on the severity of the anomaly, consider [[How to correct your Water Overlay data|investigating and correcting]]  the cause of the issue, and rerun the calculation.
 
==Creating the basic water model==


{{Editor steps|title=create a basic water model
{{Editor steps|title=create a basic water model
|Add the overlay, as described here: [[How-to add and remove an overlay]].
|Add the overlay, as described here: [[How to add and remove an Overlay]].
|Open the overlay's [[Water Overlay Wizard|wizard]], and perform each step if possible. When in doubt on what to configure exactly, a step can be skipped.
|Open the overlay's [[Water Overlay Wizard|wizard]], and perform each step if possible. When in doubt on what to configure exactly, a step can be skipped.
}}
}}


==Notes==
After creating a basic water model, a number of additional configurations may be relevant for your use-case:
The [[Rainfall (Overlay)|rainfall]] and [[Groundwater (Overlay)|groundwater]] variants of the Water Overlay already form basic water models when they are added to a project without further configuration.
; Limit rain
: If your use case involves rain and water areas, it is possible and recommended to limit the rain to regions which are covered by water areas. This can be done in the step of the configuration wizard related to simulation time and weather effects.
 
; Maximum depth of water bottom
: If your use case involves detailed flow through waterways, and no detailed waterway information is available, it is highly recommended to set the [[max water bottom m (Water Overlay)|MAX_WATER_BOTTOM_M]] attribute of the [[Water Overlay]] to a value such that all waterways are deep enough for water to flow through.
 
; Ground water
: If groundwater is not an important factor in your calculation, and you are using a groundwater overlay variant (or if groundwater is important and you are ''not'' using a groundwater overlay variant), make sure the [[ground water (Water Overlay)|GROUND_WATER]] attribute of the [[Water Overlay]] is set to '''None'''.
 
; Cell size
: The [[grid cell size]] should be set to a maximum value approximately equal to the width of a small waterway. Generally, a size in the range of 1-4 meters is proper. Note that a smaller grid size will lead to a longer calculation time.
 
 


{{WaterOverlay usecases nav}}
{{WaterOverlay usecases nav}}

Latest revision as of 15:25, 23 February 2023

For all effective uses of any variant of the water overlay, you must first set up a basic water model. This water model includes both your hydrological system, as well as the parameters used to perform any calculations. The behavior of any water, whether it is pre-existing, expected in- or outflow, or due to a natural event or calamity, is affected by the presence of features which can capture or steer water in other directions. The more real-world hydrological features and hydrological buildings are correctly configured, the more accurately the water flow can be simulated.

Requirements

Before getting started, there are a few requirements which must be met.

Determine what overlay you need

The first step is to determine which variant of the available Water Overlays best suits your needs. This depends largely on what type of calculation you wish to perform.

Create your project

The Water Overlay will be able to calculate most accurately if your project has been created with the following criteria in mind:

  • Your project has been loaded in with a high-resolution DEM. This can be configured in the New Project Wizard.
  • Your project is large enough to account for edge effects.

Additionally, consider the following:

  • When creating a new project in the New Project Wizard, consider using the AHN3 dataset. Where coverage is available, the AHN4 dataset will be more accurate and up to date. Where coverage is not available, the default AHN3 should be used. AHN2 is no longer advised.
  • Additionally, when creating a new project, consider whether you want to use the IMWA dataset for hydrological structures. Although this dataset is not complete, some information about buildings which serve as culverts or other relevant objects can be loaded in from this datasource. If more complete or accurate data is available to be loaded in into the project after it is created, it may be desirable to disregard this source so that hydrological buildings are not doubly included.

Prepare your data

The next step is preparing your data. Note that this step can be skipped if you do not have any data applicable to your project area.

The following data can be prepared as GeoJSONs. Click on any of the data types for more information.

Data Description Alternative/default
Water areas Water areas set the water level of all open water within their boundaries. It is also possible to initialize the surface water levels using a Surface level prequel (Water Overlay).

The following data should be prepared as GeoJSONs. Click on any of the data types for more information.

Data Description Alternative/default
Weirs Weirs allow for water to flow between bodies of water, with the amount of water increasing as the water level increases. There are no default weirs in a project.
Culverts Culverts allow for water to flow between bodies of water, at a maximum rate determined by their size. For project areas inside the Netherlands culverts may be imported automatically as part of the project creation process.
Pumps Pumps move water from locations with lower towards higher water levels. There are no default pumps in a project.
Inlets and outlets Inlets are point locations where water can be added to the water system. Outlets are point locations where water can leave the water system. There are no default inlets or outlets in a project.
Sewer areas Sewer areas serve as controlled storage of water flowing on top of buildings located inside these sewer areas. In the configuration wizard it is possible to generate sewer areas based on the neighborhoods in the project area.
Sewer overflows Sewer overflows are a way for water to leave the sewers and flow back into the surface water system. There are no default sewer overflows in a project, but these can be generated in the presence of both water areas and sewers (either generated or imported).

Note that it is preferable to use the Tygron Platform's naming convention for attributes (such as CULVERT_THRESHOLD) when preparing GeoJSON files, to prevent multiple structures or features from having the same keys and conflicting with each other in the Water Overlay's setup.

The following data can be supplied using other grid overlays. Click on any data type for more information.

Data Description Alternative/default
Groundwater Will set the datum height of the saturated zone in the underground. The groundwater datum height will be initiated using Water areas' [[Water level (Water Overlay) or the general model attribute [[Ground water depth m (Water Overlay)|GROUND_WATER_DEPTH_M].

Verify your data

After preparing the data, it is important to undertake a few additional checks to make sure the model functions as much as expected as possible. These checks can best be performed directly after preparing the data.

Missing attributes
When your datasets have been created, take a moment to check how many features in your data have either missing attributes or placeholder values for attributes. Make sure that for each data type, you are aware of how the Tygron Platform will react when data is missing, or set to an unrealistic (or realistic) placeholder value.
Pumps and inlets/outlets
If you have pumps in your model, divide them into two groups: pumps and inlets. Pumps are the structures within your project area, which move water from one location in your hydrological model to another location in your hydrological model. Inlets (and outlets) are pumps at the edge of the hydrological model (in a topological sense), where water appears in your hydrological model, or is removed from your hydrological model. They form the "edges".
Building shapes
Make sure that all buildings which should be line-shaped are actually line-shaped. Buildings such as weirs are commonly stored as points, while the Tygron Platform requires them to be lines, so that it can be determined exactly where the water flows to and from.
Buildings in unblocked waterways (can also be checked after loading in)
Also make sure that when a line-shaped building exists in a waterway, the water which is ment to flow via the building has no alternative way of flowing past the building. In practice, this often means blocking the waterway in which the building lies, in the location of the building, such that flowing through the building is the only way water can flow past the obstruction. Consider the following options:
  • You can manually create an obstruction in the DEM by adjusting the elevation model
  • You can draw a breach in the waterway with a BREACH_HEIGHT set to the height of the surrounding land.
Building placement in waterways (can also be checked after loading in)
Make sure all hydrological buildings are placed such that their relevant centers are well in the waterways they apply to. If the endpoint of a culvert or other line-based building is on the edge or slope of a waterway, exact topography may cause the building to be less well connected to the actual water, requiring water to rise to a higher level before it is affected by the building. In general, topology matters more than exact topography, so moving building endpoints should not cause considerable deviations from realism.
Overlapping buildings of the same type (can also be checked after loading in)
If there are multiple buildings in the same location, such as parallel culverts, make sure their endpoints do not overlap/end up in the same cell. If such culverts exist, consider the following options:
  • Move the culverts, so that their endpoints are no longer in the same cell
  • Merge the culverts, by creating a single one with appropriate attributes to mimic the combined function of the two separate culverts.
Overlapping buildings of different types (can also be checked after loading in)
If there are multiple buildings in the same location, such as a culvert with a weir directly on the end, they should be adjusted as well to prevent multiple endpoints ending up in the same cell. In these situations, consider the following options:
  • Move the buildings, such that water first passes through the first building into an intermediate water basin, and then flows on through the other building.
  • Merge the buildings, such that only as single building exists but which constricts/facilitates the waterflow mimicking/approximating the combined effect of the two separate buildings.

Notes

Take note of the following while configuring the basic water model:

Calculations based on default data.
The rainfall and groundwater variants of the Water Overlay already form basic water models when they are added to a project without further configuration. However, all data and configurations explicitly performed will enhance the model greatly.
Pre-existing buildings
If you have prepared your own dataset of hydrological structures, make sure to delete any pre-existing structures of the same type before loading in your dataset. You can perform this action in the wizard. Otherwise, there may be buildings in locations where there shouldn't be.
Further corrections
After the calculation completes you may still see some odd results. This may indicate there might be an issue somewhere in the model still. Depending on the severity of the anomaly, consider investigating and correcting the cause of the issue, and rerun the calculation.

Creating the basic water model

How to create a basic water model:
  1. Add the overlay, as described here: How to add and remove an Overlay.
  2. Open the overlay's wizard, and perform each step if possible. When in doubt on what to configure exactly, a step can be skipped.

After creating a basic water model, a number of additional configurations may be relevant for your use-case:

Limit rain
If your use case involves rain and water areas, it is possible and recommended to limit the rain to regions which are covered by water areas. This can be done in the step of the configuration wizard related to simulation time and weather effects.
Maximum depth of water bottom
If your use case involves detailed flow through waterways, and no detailed waterway information is available, it is highly recommended to set the MAX_WATER_BOTTOM_M attribute of the Water Overlay to a value such that all waterways are deep enough for water to flow through.
Ground water
If groundwater is not an important factor in your calculation, and you are using a groundwater overlay variant (or if groundwater is important and you are not using a groundwater overlay variant), make sure the GROUND_WATER attribute of the Water Overlay is set to None.
Cell size
The grid cell size should be set to a maximum value approximately equal to the width of a small waterway. Generally, a size in the range of 1-4 meters is proper. Note that a smaller grid size will lead to a longer calculation time.