Rainfall Overlay: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
Line 41: Line 41:
|-
|-
| Underground container
| Underground container
| If the underground container is not filled to maximum capacity, an amount of water is transferred from the surface container to the underground container, based on the formula for vertical infiltration.
| If the underground container is not filled to maximum capacity, an amount of water is transferred from the surface container to the underground container, based on the formula for vertical infiltration described below.
''Note: after calculating vertical infiltration, the flow calculations continue, both for the surface containers and the underground containers.''
''Note: after calculating vertical infiltration, the flow calculations continue, both for the surface containers and the underground containers.''
|-
|-
| Surface water or surface container
| Surface water or surface container
| The containers (surface water containers and surface containers) adjacent to the container being calculated are candidates for receiving water from this container. The height of each candidate container is considered. Water cannot flow from the current container to a candidate of greater height. For each candidate with a height lower than that of the current container, the surface runoff is calculated using the Manning formula described below. The single candidate container for which the surface runoff calculated is greatest will actually receive that amount of water from the current container. The other containers will be unaffected by this container during this calculation step (but may receive water from other containers.)
| Water may flow into the surface water container or into other underground containers, based on the flow-by-height principle and the Manning formula (for surface runoff) described below.
 
''To prevent issues with water "slushing" around in rare edge-cases, the direction of flow for surface containers on extremely flat land is "fixed" after the first few calculations. This means that some containers will only ever exchange water in 1 direction.''
|}
|}


Line 68: Line 66:
|-
|-
| Surface water or underground container
| Surface water or underground container
| The containers (surface water containers and underground containers) adjacent to the container being calculated are candidates for receiving water from this container. The height of each candidate container is considered. Water cannot flow from the current container to a candidate of greater height. For each candidate with a height lower than that of the current container, the horizontal infiltration is calculated using the formula described below. The single candidate container for which the horizontal infiltration calculated is greatest will actually receive that amount of water from the current container. The other containers will be unaffected by this container during this calculation step (but may receive water from other containers.)
| Water may flow into the surface water container or into other underground containers, based on the flow-by-height principle and the formula for horizontal infiltration described below.
 
''To prevent issues with water "slushing" around in rare edge-cases, the direction of flow for surface containers on extremely flat land is "fixed" after the first few calculations. This means that some containers will only ever exchange water in 1 direction.''
|}
|}
=====Horizontal infiltration=====
=====Horizontal infiltration=====
Line 88: Line 84:
|-
|-
| Surface water or underground container
| Surface water or underground container
| The containers (surface containers) adjacent to the container being calculated are candidates for receiving water from this container. The height of each candidate container is considered. Water cannot flow from the current container to a candidate of greater height. For each candidate with a height lower than that of the current container, the surface runoff is calculated using the Manning formula described below. The single candidate container for which the surface runoff calculated is greatest will actually receive that amount of water from the current container. The other containers will be unaffected by this container during this calculation step (but may receive water from other containers.)
| Water may flow into the surface water container or into other underground containers, based on the flow-by-height principle and the formula for underground
 
''To prevent issues with water "slushing" around in rare edge-cases, the direction of flow for surface containers on extremely flat land is "fixed" after the first few calculations. This means that some containers will only ever exchange water in 1 direction.''
|}
|}
====Sewer====
====Sewer====


====Building storage====
====Building storage====
===Formulas===
====Flow by height====
When a flow-by-height calculation is performed, the Engine takes into consideration for each container whether any adjacent containers have a height lower than or equal to the current container's height. All containers which meet this requirement are candidates for receiving water flow. The candidate container for which the flow would be greatest is the single container which actually receives water from the current container. All candidate containers, whether they receive water from the current container or not, can still receive water from other containers.
''To prevent issues with water "slushing" around in rare edge-cases, the direction of flow for surface containers on extremely flat land is "fixed" after the first few calculations. This means that some containers will only ever exchange water in 1 direction.''
====Manning formula (surface runoff)====
====Vertical infiltration====
====Horizontal infiltration====

Revision as of 13:12, 16 May 2017

What is the rainfall overlay

Calculation steps

Here there should be an overview of all the calculations steps. BOB: Flowchart?

Rainfall

Water is created in the form of rainfall. The amount of water created per calculation step is based on the amount of calculation steps for the simulation, the duration of the rain, and the amount of rains which falls during that time. Water is never "stored" as rainfall. Directly after being created by rainfall, water can be placed in one of the follow containers:

Container Condition
Sewer If there is a SEWER area present, which is defined by the presence of a non-zero SEWER_STORAGE attribute, and there is a building present with the SEWERED attribute ("Connected to Sewer") set to 1, and the sewer container is not yet full, the water is moved directly into the sewer.
Building storage If there is a building present with the WATER_STORAGE_M attribute ("Water Storage (m3/m2) )") set to a value greater than 0, and the building container is not yet full, the water is moved directly into the building container.
Surface water If there is surface water present (i.e. a terrain with the WATER attribute set to 1), the water is moved into the surface water container.
Surface container If there is no building connected to an empty sewer, no building with water storage, and no water terrain, the water is placed in a surface container.

Surface containers

Water in a surface container is resting on the surface of the world.

The storage capacity of surface containers is effectively infinite.

For some calculations, the height of this container is relevant. The height is defined as the terrain height, plus the height of the water in the container.

During a calculation step, the water can move to one of the following containers:

Container Condition
Underground container If the underground container is not filled to maximum capacity, an amount of water is transferred from the surface container to the underground container, based on the formula for vertical infiltration described below.

Note: after calculating vertical infiltration, the flow calculations continue, both for the surface containers and the underground containers.

Surface water or surface container Water may flow into the surface water container or into other underground containers, based on the flow-by-height principle and the Manning formula (for surface runoff) described below.


Surface runoff / Manning formula
Vertical infiltration

Underground containers

Water in underground containers is water which has infiltrated into the ground, and is now resting on, (or is part of) the ground water.

The storage capacity of underground containers is based on the WATER_STORAGE_PERCENTAGE of the terrain in that location, the ground water level and the height of the surface.

For some calculations, the height of this container is relevant. The height is defined as the ground water level height, plus the height due to the amount of water in the container. This also takes into account the WATER_STORAGE_PERCENTAGE. They lower this percentage, the faster the container's height increases.

During the calculation step, water can move to the following containers.

Container Condition
Surface water or underground container Water may flow into the surface water container or into other underground containers, based on the flow-by-height principle and the formula for horizontal infiltration described below.
Horizontal infiltration

Surface water

Water in surface water containers is water which has been stored on existing bodies of water. These bodies are often intended to house some amount of water in them in cases of rainfall.

The storage capacity of surface water containers is effectively infinite.

For some calculations, the height of this container is relevant. The height is defined as the ground water level height, plus the height due to the amount of water in the container. This also takes into account the WATER_STORAGE_PERCENTAGE. The lower this percentage, the faster the container's height increases.

During the calculation step, water can move to the following containers.

Container Condition
Surface water or underground container Water may flow into the surface water container or into other underground containers, based on the flow-by-height principle and the formula for underground

Sewer

Building storage

Formulas

Flow by height

When a flow-by-height calculation is performed, the Engine takes into consideration for each container whether any adjacent containers have a height lower than or equal to the current container's height. All containers which meet this requirement are candidates for receiving water flow. The candidate container for which the flow would be greatest is the single container which actually receives water from the current container. All candidate containers, whether they receive water from the current container or not, can still receive water from other containers.

To prevent issues with water "slushing" around in rare edge-cases, the direction of flow for surface containers on extremely flat land is "fixed" after the first few calculations. This means that some containers will only ever exchange water in 1 direction.

Manning formula (surface runoff)

Vertical infiltration

Horizontal infiltration