Basic water model use case (Water Overlay) - Revision history

Frank@tygron.nl at 11:33, 5 May 2026

2026-05-05T11:33:20Z

← Older revision		Revision as of 11:33, 5 May 2026
Line 93:		Line 93:
	; Buildings in unblocked waterways (can also be checked after loading in)		; 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:		: 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 manually create an obstruction in the [[elevation model (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.		:* 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.

Frank@tygron.nl: /* Prepare your data */

2023-02-23T15:25:01Z

Prepare your data

← Older revision		Revision as of 15:25, 23 February 2023
Line 27:		Line 27:
	\|[[Water area (Water Overlay)\|Water area]]s		\|[[Water area (Water Overlay)\|Water area]]s
	\|Water areas set the water level of all open water within their boundaries.		\|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)]] ~~or [[Water height prequel (Water Overlay)\|Water height prequel]] overlay~~.		\|It is also possible to initialize the surface water levels using a [[Surface level prequel (Water Overlay)]].
	\|}		\|}

Frank@tygron.nl at 15:24, 23 February 2023

2023-02-23T15:24:44Z

← Older revision		Revision as of 15:24, 23 February 2023
Line 27:		Line 27:
	\|[[Water area (Water Overlay)\|Water area]]s		\|[[Water area (Water Overlay)\|Water area]]s
	\|Water areas set the water level of all open water within their boundaries.		\|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 [[~~Water~~ level prequel (Water Overlay)~~\|Water datum prequel~~]] or [[Water height prequel (Water Overlay)\|Water height prequel]] overlay.		\|It is also possible to initialize the surface water levels using a [[Surface level prequel (Water Overlay)]] or [[Water height prequel (Water Overlay)\|Water height prequel]] overlay.
	\|}		\|}

Frank@tygron.nl: /* Prepare your data */

2023-02-23T15:16:38Z

Prepare your data

← Older revision		Revision as of 15:16, 23 February 2023
Line 27:		Line 27:
	\|[[Water area (Water Overlay)\|Water area]]s		\|[[Water area (Water Overlay)\|Water area]]s
	\|Water areas set the water level of all open water within their boundaries.		\|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 [[Water ~~datum~~ prequel (Water Overlay)\|Water datum prequel]] or [[Water height prequel (Water Overlay)\|Water height prequel]] overlay.		\|It is also possible to initialize the surface water levels using a [[Water level prequel (Water Overlay)\|Water datum prequel]] or [[Water height prequel (Water Overlay)\|Water height prequel]] overlay.
	\|}		\|}

Maxim@tygron.com at 16:15, 7 October 2022

2022-10-07T16:15:27Z

Rudolf@tygron.nl at 07:51, 3 March 2022

2022-03-03T07:51:11Z

← Older revision		Revision as of 07:51, 3 March 2022
Line 13:		Line 13:

	Additionally, consider the following:		Additionally, consider the following:
	* When creating a new project in the [[Wizard~~\|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.		* 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 constructions 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 constructions are not doubly included.		* 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 constructions 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 constructions are not doubly included.

Frank@tygron.nl: /* Creating the basic water model */

2022-02-09T09:58:04Z

Creating the basic water model

← Older revision		Revision as of 09:58, 9 February 2022
Line 132:		Line 132:
	: 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.		: 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 ~~height~~ of water bottom		; 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.		: 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.

Frank@tygron.nl at 09:55, 9 February 2022

2022-02-09T09:55:21Z

← Older revision		Revision as of 09:55, 9 February 2022
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 construction]]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 available [[Water Overlay\| Water Overlays]] 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===
Line 13:		Line 13:

	Additionally, consider the following:		Additionally, consider the following:
	* When creating a new project in the [[Wizard\|new project wizard]], consider using the [[Project sources#AHN\|AHN3]] dataset ~~rather than the default AHN2~~. Where coverage is available, the ~~AHN3~~ dataset will be more accurate. Where coverage is not available, the default ~~AHN2~~ should be used.		* When creating a new project in the [[Wizard\|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 constructions 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 constructions are not doubly included.		* 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 constructions 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 constructions are not doubly included.

Line 19:		Line 19:
	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 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 as [[GeoJSON]]s. Click on any of the data types 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 27:		Line 27:
	\|[[Water area (Water Overlay)\|Water area]]s		\|[[Water area (Water Overlay)\|Water area]]s
	\|Water areas set the water level of all open water within their boundaries.		\|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 [[Water datum prequel (Water Overlay)\|Water datum prequel]] or [[Water height prequel (Water Overlay)\|Water height prequel]] 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

Frank@tygron.nl at 09:44, 9 February 2022

2022-02-09T09:44:32Z

← Older revision		Revision as of 09:44, 9 February 2022
Line 129:		Line 129:

	; Ground water		; 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 ~~used appropriately~~.		: 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		; Cell size

Frank@tygron.nl at 09:41, 9 February 2022

2022-02-09T09:41:49Z

← Older revision		Revision as of 09:41, 9 February 2022
Line 68:		Line 68:
	\|-		\|-
	\|[[Groundwater Prequel (Water Overlay)\|Groundwater]]		\|[[Groundwater Prequel (Water Overlay)\|Groundwater]]
	\|Will set the datum height of the saturated zone~~'s water~~ in the underground.		\|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].		\|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].
	\|}		\|}

← Older revision		Revision as of 16:15, 7 October 2022
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 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 ~~construction~~]]s are correctly configured, 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==
Line 14:		Line 14:
	Additionally, consider the following:		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.		* 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 ~~constructions~~ 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 ~~constructions~~ are not doubly included.		* 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===
Line 53:		Line 53:
	\|-		\|-
	\|[[Sewer area (Water Overlay)\|Sewer area]]s		\|[[Sewer area (Water Overlay)\|Sewer area]]s
	\|Sewer areas serve as controlled storage of water flowing on top of ~~constructions~~ located inside these 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.
	\|-		\|-
Line 88:		Line 88:
	: 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".		: 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".

	; ~~Construction~~ shapes		; Building shapes
	: Make sure that all ~~constructions~~ which should be line-shaped are actually line-shaped. ~~Constructions~~ 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.		: 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.

	; ~~Constructions~~ in unblocked waterways (can also be checked after loading in)		; Buildings in unblocked waterways (can also be checked after loading in)
	: Also make sure that when a line-shaped ~~construction~~ exists in a waterway, the water which is ment to flow via the ~~construction~~ has no alternative way of flowing past the ~~construction~~. In practice, this often means blocking the waterway in which the ~~construction~~ lies, in the location of the ~~construction~~, such that flowing through the ~~construction~~ is the only way water can flow past the obstruction. Consider the following options:		: 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 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.		:* 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.

	; ~~Construction~~ placement in waterways (can also be checked after loading in)		; Building placement in waterways (can also be checked after loading in)
	: Make sure all [[Hydraulic_structures_(Water_Overlay)\|hydrological ~~constructions~~]] 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 ~~construction~~ is on the edge or slope of a waterway, exact topography may cause the ~~construction~~ to be less well connected to the actual water, requiring water to rise to a higher level before it is affected by the ~~construction~~. In general, topology matters more than exact topography, so moving ~~construction~~ endpoints should not cause considerable deviations from realism.		: 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 ~~constructions~~ of the same type (can also be checked after loading in)		; Overlapping buildings of the same type (can also be checked after loading in)
	: If there are multiple ~~constructions~~ 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:		: 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		:* 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.		:* Merge the culverts, by creating a single one with appropriate attributes to mimic the combined function of the two separate culverts.

	; Overlapping ~~constructions~~ of different types (can also be checked after loading in)		; Overlapping buildings of different types (can also be checked after loading in)
	: If there are multiple ~~constructions~~ 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:		: 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 ~~constructions~~, such that water first passes through the first ~~construction~~ into an intermediate water basin, and then flows on through the other ~~construction~~.		:* 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 ~~constructions~~, such that only as single ~~construction~~ exists but which constricts/facilitates the waterflow mimicking/approximating the combined effect of the two separate ~~constructions~~.		:* 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==		==Notes==
Line 115:		Line 115:
	: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.		: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 ~~constructions~~		; 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 ~~constructions~~ in locations where there shouldn't be.		: 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		; Further corrections