Result type (Water Overlay): Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
Line 23: Line 23:
! Display mode
! Display mode
! Description
! Description
! Overlay relevance
! [[File:Overlay_rainfall.png|Rainfall overlay]]
! [[File:Overlay_flooding.png|Flooding overlay]]
! [[File:Overlay_groundwater.png|Groundwater overlay]]
|-
|-
|[[File:overlay_icon_water_base_types.png|25px|center]]
|[[File:overlay_icon_water_base_types.png|25px|center]]
Line 30: Line 32:
|{{inlink|Start_resulttype|Start}}
|{{inlink|Start_resulttype|Start}}
|Categorization of the individual cells based on how they are processed by the water model, displaying which cells are considered to be specific features.<br>
|Categorization of the individual cells based on how they are processed by the water model, displaying which cells are considered to be specific features.<br>
|[[File:Overlay_rainfall.png]][[File:Overlay_flooding.png]][[File:Overlay_groundwater.png]]
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_debug_uv.png|25px|center]]
|[[File:overlay_icon_water_debug_uv.png|25px|center]]
Line 37: Line 41:
|[[#Last_resulttype|Last]]
|[[#Last_resulttype|Last]]
|The wave part of each flux component in the 2-D Saint-Venant system
|The wave part of each flux component in the 2-D Saint-Venant system
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_debug_walls.png|25px|center]]
|[[File:overlay_icon_water_debug_walls.png|25px|center]]
Line 43: Line 50:
|[[Result_type_(Water_Overlay)#Start_resulttype|Start]]
|[[Result_type_(Water_Overlay)#Start_resulttype|Start]]
|Cells marked as walls based on their slope in x- and y-direction and the [[Min_slope_model_attribute_(Water_Overlay)|minimum slope]] required.
|Cells marked as walls based on their slope in x- and y-direction and the [[Min_slope_model_attribute_(Water_Overlay)|minimum slope]] required.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_evaporated.png|25px|center]]
|[[File:overlay_icon_water_evaporated.png|25px|center]]
Line 49: Line 59:
|{{inlink|Total_resulttype|Total}}
|{{inlink|Total_resulttype|Total}}
|The amount of water that has evaporated. The value is the sum of the quantities evaporated from the surface and the underground.
|The amount of water that has evaporated. The value is the sum of the quantities evaporated from the surface and the underground.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_gpu_overview.png|25px|center]]
|[[File:overlay_icon_water_gpu_overview.png|25px|center]]
Line 55: Line 68:
|{{inlink|Maximum_resulttype|Maximum}}
|{{inlink|Maximum_resulttype|Maximum}}
|Shows which GPU cluster calculated which part of the overlay.
|Shows which GPU cluster calculated which part of the overlay.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_ground_last_storage.png|25px|center]]
|[[File:overlay_icon_water_ground_last_storage.png|25px|center]]
Line 61: Line 77:
|{{inlink|Last_resulttype|Last}}
|{{inlink|Last_resulttype|Last}}
|The (effective) amount of water in the underground unsaturated zone.
|The (effective) amount of water in the underground unsaturated zone.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_ground_last_value.png|25px|center]]
|[[File:overlay_icon_water_ground_last_value.png|25px|center]]
Line 67: Line 86:
|{{inlink|Last_resulttype|Last}}
|{{inlink|Last_resulttype|Last}}
|The distance between the surface and the groundwater level.
|The distance between the surface and the groundwater level.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_ground_max_storage.png|25px|center]]
|[[File:overlay_icon_water_ground_max_storage.png|25px|center]]
Line 73: Line 95:
|{{inlink|Maximum_resulttype|Maximum}}
|{{inlink|Maximum_resulttype|Maximum}}
|The (effective) amount of water in the underground unsaturated zone.
|The (effective) amount of water in the underground unsaturated zone.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_ground_max_value.png|25px|center]]
|[[File:overlay_icon_water_ground_max_value.png|25px|center]]
Line 79: Line 104:
|{{inlink|Maximum_resulttype|Maximum}}
|{{inlink|Maximum_resulttype|Maximum}}
|The distance between the surface and the groundwater level.
|The distance between the surface and the groundwater level.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_ground_watertable.png|25px|center]]
|[[File:overlay_icon_water_ground_watertable.png|25px|center]]
Line 85: Line 113:
|{{inlink|Last_resulttype|Last}}
|{{inlink|Last_resulttype|Last}}
|The groundwater level, relative to [[datum]].
|The groundwater level, relative to [[datum]].
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_impacted_buildings.png|25px|center]]
|[[File:overlay_icon_water_impacted_buildings.png|25px|center]]
Line 91: Line 122:
|{{inlink|Maximum_resulttype|Maximum}}
|{{inlink|Maximum_resulttype|Maximum}}
|Constructions impacted by excess water.
|Constructions impacted by excess water.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_sewer_last_value.png|25px|center]]
|[[File:overlay_icon_water_sewer_last_value.png|25px|center]]
Line 97: Line 131:
|{{inlink|Last_resulttype|Last}}
|{{inlink|Last_resulttype|Last}}
|The amount of water stored in the sewer.
|The amount of water stored in the sewer.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_sewer_max_value.png|25px|center]]
|[[File:overlay_icon_water_sewer_max_value.png|25px|center]]
Line 103: Line 140:
|{{inlink|Maximum_resulttype|Maximum}}
|{{inlink|Maximum_resulttype|Maximum}}
|The amount of water stored in the sewer.
|The amount of water stored in the sewer.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_substance_a.png|25px|center]]
|[[File:overlay_icon_water_substance_a.png|25px|center]]
Line 109: Line 149:
|{{inlink|Last_resulttype|Last}}
|{{inlink|Last_resulttype|Last}}
|The amount of {{inlink|SUBSTANCE_A_constructions|substance A}} present. The value is the sum of the quantities on the surface, and in the underground.
|The amount of {{inlink|SUBSTANCE_A_constructions|substance A}} present. The value is the sum of the quantities on the surface, and in the underground.
 
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_substance_b.png|25px|center]]
|[[File:overlay_icon_water_substance_b.png|25px|center]]
Line 116: Line 158:
|{{inlink|Last_resulttype|Last}}
|{{inlink|Last_resulttype|Last}}
|The amount of {{inlink|SUBSTANCE_B_constructions|substance B}} present. The value is the sum of the quantities on the surface, and in the underground.
|The amount of {{inlink|SUBSTANCE_B_constructions|substance B}} present. The value is the sum of the quantities on the surface, and in the underground.
 
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_substance_c.png|25px|center]]
|[[File:overlay_icon_water_substance_c.png|25px|center]]
Line 123: Line 167:
|{{inlink|Last_resulttype|Last}}
|{{inlink|Last_resulttype|Last}}
|The amount of {{inlink|SUBSTANCE_C_constructions|substance C}} present. The value is the sum of the quantities on the surface, and in the underground.
|The amount of {{inlink|SUBSTANCE_C_constructions|substance C}} present. The value is the sum of the quantities on the surface, and in the underground.
 
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_substance_d.png|25px|center]]
|[[File:overlay_icon_water_substance_d.png|25px|center]]
Line 130: Line 176:
|{{inlink|Last_resulttype|Last}}
|{{inlink|Last_resulttype|Last}}
|The amount of {{inlink|SUBSTANCE_D_constructions|substance D}} present. The value is the sum of the quantities on the surface, and in the underground.
|The amount of {{inlink|SUBSTANCE_D_constructions|substance D}} present. The value is the sum of the quantities on the surface, and in the underground.
 
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_surface_direction.png|25px|center]]
|[[File:overlay_icon_water_surface_direction.png|25px|center]]
Line 137: Line 185:
|{{inlink|Last_resulttype|Last}}
|{{inlink|Last_resulttype|Last}}
|The direction in which water is flowing across the surface.
|The direction in which water is flowing across the surface.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_surface_duration.png|25px|center]]
|[[File:overlay_icon_water_surface_duration.png|25px|center]]
Line 143: Line 194:
|{{inlink|Total_resulttype|Total}}
|{{inlink|Total_resulttype|Total}}
|The amount of time the water depth on the surface exceeds {{inlink|SHOW_DURATION_FLOOD_LEVEL_M}}.
|The amount of time the water depth on the surface exceeds {{inlink|SHOW_DURATION_FLOOD_LEVEL_M}}.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_surface_elevation.png|25px|center]]
|[[File:overlay_icon_water_surface_elevation.png|25px|center]]
Line 149: Line 203:
|{{inlink|Start_resulttype|Start}}
|{{inlink|Start_resulttype|Start}}
|The rasterized version of the [[terrain height]] for use in the water overlay's calculations.
|The rasterized version of the [[terrain height]] for use in the water overlay's calculations.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_surface_flow.png|25px|center]]
|[[File:overlay_icon_water_surface_flow.png|25px|center]]
Line 155: Line 212:
|{{inlink|Last_resulttype|Last}}
|{{inlink|Last_resulttype|Last}}
|The amount of water which has flowed through a given location.
|The amount of water which has flowed through a given location.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_surface_last_speed.png|25px|center]]
|[[File:overlay_icon_water_surface_last_speed.png|25px|center]]
Line 161: Line 221:
|{{inlink|Last_resulttype|Last}}
|{{inlink|Last_resulttype|Last}}
|The (horizontal) speed of water flow.  
|The (horizontal) speed of water flow.  
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_surface_last_value.png|25px|center]]
|[[File:overlay_icon_water_surface_last_value.png|25px|center]]
Line 167: Line 230:
|{{inlink|Last_resulttype|Last}}
|{{inlink|Last_resulttype|Last}}
|The amount of water on the surface.
|The amount of water on the surface.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_surface_max_speed.png|25px|center]]
|[[File:overlay_icon_water_surface_max_speed.png|25px|center]]
Line 172: Line 238:
|m/s
|m/s
|{{inlink|Maximum_resulttype|Maximum}}
|{{inlink|Maximum_resulttype|Maximum}}
|The (horizontal) speed of water flow .  
|The (horizontal) speed of water flow.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_surface_max_value.png|25px|center]]
|[[File:overlay_icon_water_surface_max_value.png|25px|center]]
Line 179: Line 248:
|{{inlink|Maximum_resulttype|Maximum}}
|{{inlink|Maximum_resulttype|Maximum}}
|The amount of water on the surface.
|The amount of water on the surface.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|-
|-
|[[File:overlay_icon_water_water_stress.png|25px|center]]
|[[File:overlay_icon_water_water_stress.png|25px|center]]
Line 185: Line 257:
|{{inlink|Maximum_resulttype|Maximum}}
|{{inlink|Maximum_resulttype|Maximum}}
|The amount of water on the surface, similar to {{inlink|SURFACE_MAX_VALUE}}. However, for {{inlink|Water|water terrains}}, the water level must rise by at least {{inlink|ALLOWED_WATER_INCREASE_M}}. Otherwise, the reported value in those locations is 0.
|The amount of water on the surface, similar to {{inlink|SURFACE_MAX_VALUE}}. However, for {{inlink|Water|water terrains}}, the water level must rise by at least {{inlink|ALLOWED_WATER_INCREASE_M}}. Otherwise, the reported value in those locations is 0.
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|style="text-align:center;"|'''X'''
|}
|}


Revision as of 09:09, 9 April 2019

The water model performs complex calculations, and multiple types of results can be provided. In principle, each overlay can be configured to display a single result type.

Unique result

Each result type would consist of a unique output of data after a calculation, and is accompanied by its own legend. When the result type of the overlay is changed, the legend is updated automatically, but the data may not be recalculated automatically. This may result in the visual output of the overlay changing, because the unchanged data is displayed with a new legend. When changing the result type, it is recommended to force a recalculation of the overlay before interpreting the output.

Multiple result child overlays

Each overlay can only display a single result type. When using a water overlay, it is often desirable to output multiple types of overlay, relevant to a project's use case. To support this usecase, it is possible to add result child overlays to a water overlay. These can then store and display different results coming forth from the same water overlay calculation. The advantages of using result child overlays are that for any given water overlay, the calculation of the overlay only occurs once, rather than multiple times equal to the amount of desired result types. Additionally, the configuration for the calculation is only defined in a single overlay, which makes it easier to verify and configure the used simulation parameters.

It is currently only possible to add result child overlays via the configuration wizard, in the output overlays step.

Editor

Template:Editor ribbon

Inspect and export

To find out how to inspect and export water overlay results, see inspect and export.

List of Result Types

Icon Result type Unit Display mode Description Rainfall overlay Flooding overlay Groundwater overlay
Overlay icon water base types.png
 BASE_TYPES Nominal value Start Categorization of the individual cells based on how they are processed by the water model, displaying which cells are considered to be specific features.
 X X X
Overlay icon water debug uv.png
 DEBUG_UV m3s-2 Last The wave part of each flux component in the 2-D Saint-Venant system X X X
Overlay icon water debug walls.png
 DEBUG_WALLS none Start Cells marked as walls based on their slope in x- and y-direction and the minimum slope required. X X X
Overlay icon water evaporated.png
 EVAPORATED m (mm)¹ Total The amount of water that has evaporated. The value is the sum of the quantities evaporated from the surface and the underground. X X X
Overlay icon water gpu overview.png
 GPU_OVERVIEW nominal integer Maximum Shows which GPU cluster calculated which part of the overlay. X X X
Overlay icon water ground last storage.png
 GROUND_LAST_STORAGE m (mm)¹ Last The (effective) amount of water in the underground unsaturated zone. X X X
Overlay icon water ground last value.png
 GROUND_LAST_VALUE m (mm)¹ Last The distance between the surface and the groundwater level. X X X
Overlay icon water ground max storage.png
 GROUND_MAX_STORAGE m (mm)¹ Maximum The (effective) amount of water in the underground unsaturated zone. X X X
Overlay icon water ground max value.png
 GROUND_MAX_VALUE m (mm)¹ Maximum The distance between the surface and the groundwater level. X X X
Overlay icon water ground watertable.png
 GROUND WATERTABLE m + datum Last The groundwater level, relative to datum. X X X
Overlay icon water impacted buildings.png
 IMPACTED_BUILDINGS nominal integer Maximum Constructions impacted by excess water. X X X
Overlay icon water sewer last value.png
 SEWER_LAST_VALUE m (mm)¹ Last The amount of water stored in the sewer. X X X
Overlay icon water sewer max value.png
 SEWER_MAX_VALUE m (mm)¹ Maximum The amount of water stored in the sewer. X X X
File:Overlay icon water substance a.png
 SUBSTANCE_A x/m² Last The amount of substance A present. The value is the sum of the quantities on the surface, and in the underground. X X X
File:Overlay icon water substance b.png
 SUBSTANCE_B x/m² Last The amount of substance B present. The value is the sum of the quantities on the surface, and in the underground. X X X
File:Overlay icon water substance c.png
 SUBSTANCE_C x/m² Last The amount of substance C present. The value is the sum of the quantities on the surface, and in the underground. X X X
File:Overlay icon water substance d.png
 SUBSTANCE_D x/m² Last The amount of substance D present. The value is the sum of the quantities on the surface, and in the underground. X X X
Overlay icon water surface direction.png
 SURFACE_DIRECTION geo angle (0-360°) Last The direction in which water is flowing across the surface. X X X
Overlay icon water surface duration.png
 SURFACE_DURATION s (min)¹ Total The amount of time the water depth on the surface exceeds SHOW_DURATION_FLOOD_LEVEL_M. X X X
Overlay icon water surface elevation.png
 SURFACE_ELEVATION m + datum Start The rasterized version of the terrain height for use in the water overlay's calculations. X X X
Overlay icon water surface flow.png
 SURFACE_FLOW m³/m² Last The amount of water which has flowed through a given location. X X X
Overlay icon water surface last speed.png
 SURFACE_LAS_SPEED m/s Last The (horizontal) speed of water flow. X X X
Overlay icon water surface last value.png
 SURFACE_LAST_VALUE m (mm)¹ Last The amount of water on the surface. X X X
Overlay icon water surface max speed.png
 SURFACE_MAX_SPEED m/s Maximum The (horizontal) speed of water flow. X X X
Overlay icon water surface max value.png
 SURFACE_MAX_VALUE m (mm)¹ Maximum The amount of water on the surface. X X X
Overlay icon water water stress.png
 WATER_STRESS m (mm)¹ Maximum The amount of water on the surface, similar to SURFACE_MAX_VALUE. However, for water terrains, the water level must rise by at least ALLOWED_WATER_INCREASE_M. Otherwise, the reported value in those locations is 0. X X X

Template:Unit disclaimer (Water Overlay)

Result types can differ in the kind of data they display, the layer (surface or underground) of which they display that information, and how that data is recorded. Different result types can monitor data in the following ways:

  • Start: The data is determined at the start of the simulation, and does not change afterwards.
  • Last: The data is the latest value determined at the timestep the data is recorded. The values can increase and decrease between different timesteps. This mode is primarily used for monitoring progression.
  • Maximum: The data is the highest value determined up until the timestep the data is recorded. The values can only increase or stay the same, but will never decrease. This mode is primarily used to gain insight into impact; the most severe situation any point had to endure.
  • Total: The result of a running tally, counting the relevant data up until the timestep the data is recorded. The value can only increase or stay the same, but will never decrease. This mode is primarily used to gain insight into quantities rather than duration.

Notes

  • Although it is possible to duplicate the overlay, and set the copy of the overlay to a different result type, we strongly advice to use child overlays instead. Downsides of the duplication approach are:
  1. the simulation has to run in full multiple times, causing a severe increase in calculation time.
  2. when changes to the overlay's configuration have to be made those changes need to be made to all water overlays.
  • Result child overlays do not recalculate if either they or their parent is set to inactive.
  • If a calculation overlay is removed, all result child overlays of that overlay are removed as well. Separate overlays set as child overlays (such as input overlay) of the overlay will not be removed.

See also

Retrieved from "https://support.tygron.com/w/index.php?title=Result_type_(Water_Overlay)&oldid=20980"