Overlay: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(296 intermediate revisions by 13 users not shown)
Line 1: Line 1:
{{being updated}}
[[File:Api_current_situation_calculation.png|thumb|right|400px|[[Overlay]] in comparison to [[Measurement]]s, [[Indicator]]s and [[Global]]s]]
{{learned|what an overlay is|how overlays relate to the Tygron Engine interface|how to access overlays in a project|which overlays exist|how to add or remove overlays|}}
An overlay is a layer visualized on top of the [[terrain]] and [[building]]s in the 3D visualization. Overlays can provide spatial insight into specific subject, such as the variation of height and ownership. The visualized properties can originate from the current state of the project or from a result of a spatial calculation.  
==What are overlays==
An overlay is a layer drawn over a visualization to illustrate different properties. They do not contain all the information of a given visualization, but serve as a supplement to a base. By adding these properties onto the same view, the additional information can immediately be made understandable in the same way. A reason to split information off into other layers in this fashion can be to avoid overwhelming a user with too much information.


==How do overlays relate to the Tygron Engine interface==
However, most overlays that can be added to a project use an underlying calculation model, which rasterize the spatial data and apply calculations to it to produce various (intermediate) results. These computational overlays can range from simple distance and average operations to complex water simulations. For these more complex Overlays with multiple results, additional [[Result Child Overlay]]s can be added. The calculation main and child results will always be governed by the main overlay, also called the [[Result Parent Overlay]].
Overlays are implemented in the Tygron Engine as part of the [[interface]]. Properties such as [[ownership]] and [[zoning]] are important pieces of information to the [[player]], but would be very overwhelming to display at all times. Instead, a player can activate on overlay to make these pieces of information visible. In principle, all spatially varied information is accessible as an overlay.


{{clear}}
==How to access overlays in a project==
==How to access overlays in a project==
[[File:Overlays-Icons.jpg|thumb|left|How to access overlays]]
[[File:Overlays-Icons.png|thumb|left|Overlay buttons in the [[Navigation Panel]] can be clicked to show that specific [[Overlay]]. The [[Parent Overlay]]s are indicated with the yellow rectangles and the [[Child Overlay]]s with the red rectangle]]
Overlays available to stakeholders appear as buttons just below the minimap. To switch to a specific overlay, use the button to switch to the designated overlay. To switch back to the default view, switch to the "City" overlay. Some overlays are default available when a project is created, see [[Overlays#Default_available_overlay_types| default available overlay types]]. Some overlays are very closely related to indicators (heat stress and livability) and can not be used separately.
Overlays available to stakeholders appear as buttons on the right side of the interface. Clicking on any of these buttons will switch the view to the specific overlay. Clicking on the "City" overlay will switch the view back to default. Some overlays are {{inlink|Default Overlays|automatically added}} when a project is created. Some overlays are closely related to indicators, such as [[Heat (Overlay)|Heatstress]] and [[Livability (Overlay)|Livability.]]
<br clear=all>


==Default available overlay types==
===Parent Overlay===
Multiple types of overlay exist in the Tygron Engine. All overlays which are available by default when creating a project are described below.
Overlays can be grouped together using a Parent-Child hierarchy. Hovering over any of the Overlays in the [[Navigation Panel]] will show additional icons for the Child Overlays of that Overlay.


====City====
Every Overlay is considered a Parent Overlay, unless it has a Parent Overlay set, in which case it becomes a Child Overlay of that Parent Overlay. Overlays with Child Overlays cannot be a Child Overlay to another Overlay. [[Result Child Overlay]]s are always Child Overlays of other Overlays.
[[File:City-Overlay2.jpg|thumb|left|Default City overlay]]
: ''The default view. This displays the [[project detail area]] in natural colors. Hovering over a location displays properties of the [[constructions|construction]] or [[land]] type in that location.''
<br clear=all>
====Zoning====
[[File:Zoning-Overlay2.jpg|thumb|left|Default Zoning overlay]]
: ''This overlay is available by default. This overlay displays the [[zoning|zoning plan]] for the entire project detail area. This is helpful when considering indicators which are scored per zone, and when looking to construct a building which is restricted to certain zones.
<br clear=all>
====Property====
[[File:Property-Overlay2.jpg|thumb|left|Default Property overlay]]
: ''This overlay is available by default. This overlay displays the [[ownership]] of properties across the entire project area, using each stakeholder's colors. This is important when considering which stakeholder may perform actions such as constructing or demolishing at a given location, or whom to negotiate with for [[land transactions]].
<br clear=all>


==Optional overlay types==
When a parent overlay is removed, it's child overlays are not removed, unless the child overlay is a result child type overlay. Otherwise, they simply have no parent overlay set anymore and become a parent overlay themselves.
After creation of a new project it is also possible to add one of more optional overlays, as described below:
{{clear}}


====Traffic Flow====
==List of available Overlays==
[[File:Traffic_Flow-Overlay.jpg|thumb|left|Optional Traffic Flow overlay]]
{{Overlays|suppresscategory=true|allowselflinks=true|
: ''Main article: [[Traffic Flow (Overlay)| Traffic Flow (Overlay)]].
{{Overlays|type=row|overlay=City                  |icon=normal              |category= Default        | otype=None                  | display=The default view without any overlay}}
: ''This overlay displays the flow of traffic through roads. It becomes available for all stakeholders when added to a project.
{{Overlays|type=row|overlay=Ownership            |icon=ownership            |category= Administrative | otype=Feature              | display=Ownership of constructions/ plots}}
<br clear=all>
{{Overlays|type=row|overlay=Ownership Grid        |icon=ownership_grid      |category= Administrative | otype=[[Grid overlay|Grid]] | display=Ownership of constructions/ plots}}
<!--====Underground====
{{Overlays|type=row|overlay=Municipalities        |icon=municipalities      |category= Administrative | otype=Feature              | display=Municipalities in the project area}}
: ''Main article: [[Underground (Overlay)| Underground (Overlay)]].
{{Overlays|type=row|overlay=Neighborhoods        |icon=neighborhoods        |category= Administrative | otype=Feature              | display=Neighborhoods in the project area}}
: ''This overlay displays [[constructions]] which are in the underground. The overlay becomes available for all stakeholders when added to a project.''
{{Overlays|type=row|overlay=Vacancy              |icon=vacancy              |category= Administrative | otype=Feature              | display=Constructions marked as vacant are highlighted}}
====Safety Zone====
{{Overlays|type=row|overlay=Zipcodes              |icon=zip_codes            |category= Administrative | otype=Feature              | display=Postal codes}}
: ''Main article: [[Safety Zone (Overlay)| Safety Zone (Overlay)]].
{{Overlays|type=row|overlay=Zoning                |icon=zoning              |category= Administrative | otype=Feature              | display=Zoning (related to zoning plans)}}
: ''This overlay displays the Safety Zone as defined by [[constructions]]. The overlay becomes available for all stakeholders when added to a project.''-->
{{Overlays|type=row|overlay= Aerius              |icon=aerius              |category= Environmental  | otype=[[Grid overlay|Grid]] | display=Impact of traffic<!--, industry and construction--> on NOX and NH3 polution on Natura 2000 areas in the Netherlands}}
====Heat====
{{Overlays|type=row|overlay= Heat                 |icon=heat_stress          |category= Environmental  | otype=[[Grid overlay|Grid]] | display=Urban heat stress}}
[[File:Heat-Overlay.jpg|thumb|left|Optional Heat overlay, linked to Heat indicator]]
{{Overlays|type=row|overlay= Livability          |icon=livability          |category= Environmental  | otype=[[Grid overlay|Grid]] | display=Livability score}}
: ''Main article: [[Heat (Overlay)| Heat (Overlay)]].
{{Overlays|type=row|overlay= Traffic Density      |icon=traffic_density      |category= Environmental  | otype=[[Grid overlay|Grid]] | display=Traffic density}}
: ''This overlay displays the Heat Stress. The overlay displays the average temperature deviation (positive or negative) for the project area, giving an indication of where the most heat-stress is occurring. This overlay only becomes available for each stakeholder with an [[Indicator_Weights|interest]] in the [[Heat_(Indicator)|Heat Stress indicator]]. In other words, the overlay is only visible when the heat indicator is also active for the selected stakeholder.''
{{Overlays|type=row|overlay= Traffic Noise        |icon=traffic_noise        |category= Environmental  | otype=[[Grid overlay|Grid]] | display=Impact of traffic noise polution on surrounding area}}
<br clear=all>
{{Overlays|type=row|overlay= Traffic NO2          |icon=traffic_no2          |category= Environmental  | otype=[[Grid overlay|Grid]] | display=Impact of traffic NO2 polution on surrounding area}}
====Livability====
{{Overlays|type=row|overlay=Flooding              |icon=flooding            |category= Water          | otype=[[Grid overlay|Grid]] | display=Impact of flooding on inundation}}
[[File:Livability-Overlay.jpg|thumb|left|Optional Livability overlay, linked to Livability indicator]]
{{Overlays|type=row|overlay=Groundwater          |icon=groundwater          |category= Water         | otype=[[Grid overlay|Grid]] | display=Underground water tables}}
: ''Main article: [[Livability (Overlay)| Livability (Overlay)]].
{{Overlays|type=row|overlay=Rainfall              |icon=rainfall            |category= Water          | otype=[[Grid overlay|Grid]] | display=Impact of rainfall on inundation}}
: ''This overlay displays the average livability for each part of the project detail area, giving an indication whether the livability is good, average or bad. This overlay becomes available for each stakeholder with an [[Indicator_Weights|interest]] in the [[Livability_(Indicator)|livability indicator]]. In other words, the overlay is only visible when the livability indicator is also active for the selected stakeholder.''
{{Overlays|type=row|overlay=Subsidence            |icon=subsidence          |category= Water          | otype=[[Grid overlay|Grid]] | display=Areas subject to subsidence}}
<br clear=all>
{{Overlays|type=row|overlay=Watershed            |icon=watershed            |category= Water          | otype=[[Grid overlay|Grid]] | display=Discharge areas based on DTM or Water overlay's flow direction.}}
<!--====Water Stress====
{{Overlays|type=row|overlay=Waterwijzer          |icon=waterwijzer          |category= Water          | otype=[[Grid overlay|Grid]] | display=Crop yield loss based on ground water levels and type of soil.}}
This overlay is deprecated.
{{Overlays|type=row|overlay=Average              |icon=avg                  |category= Distance      | otype=[[Grid overlay|Grid]] | display=Smoothened values of grid cells}}
====Terrain Sewer====
{{Overlays|type=row|overlay=Distance              |icon=distance            |category= Distance      | otype=[[Grid overlay|Grid]] | display=Defined contour around an object}}
This overlay is deprecated.-->
{{Overlays|type=row|overlay=Sight Distance        |icon=sight_distance      |category= Distance      | otype=[[Grid overlay|Grid]] | display=Combined distance zone with line of sight}}
====Terrain Flooding====
{{Overlays|type=row|overlay=Travel Distance      |icon=travel_distance      |category= Distance      | otype=[[Grid overlay|Grid]] | display=Contour based on travel distance}}
[[File:Terrain_Flooding-Overlay.jpg|thumb|left|Optional Terrain Flooding overlay]]
{{Overlays|type=row|overlay=Area                  |icon=area                |category= Custom        | otype=Feature              | display=Selection of [[Area]]s}}
: ''Main article: [[Terrain Flooding (Overlay)| Terrain Flooding (Overlay)]].
{{Overlays|type=row|overlay=Attribute            |icon=attribute            |category= Custom        | otype=Feature              | display=Presence of a specific attribute in a data layer}}
: ''This overlay displays active [[Terrains#Flooding_Terrain|flooding terrains]]. This overlay becomes available for each stakeholder.''
{{Overlays|type=row|overlay=Combo                |icon=combo                |category= Custom        | otype=[[Grid overlay|Grid]] | display=Combines up to three grid overlays using mathematical functions and boolean operators.}}
<br clear=all>
{{Overlays|type=row|overlay=GeoTIFF              |icon=geo_tiff            |category= Custom        | otype=[[Grid overlay|Grid]] | display=External data in GeoTIFF format}}
====Terrains====
{{Overlays|type=row|overlay=Image                |icon=image                |category= Custom        | otype=[[Grid overlay|Grid]] | display=A custom image}}
[[File:Terrains-Overlay.jpg|thumb|left|Optional Terrains overlay]]
{{Overlays|type=row|overlay=WCS                  |icon=wcs                  |category= Custom        | otype=[[Grid overlay|Grid]] | display=Stores the GeoTIFF result of a Web Coverage Service as a Grid Overlay.}}
: ''Main article: [[Terrains (Overlay)| Terrains (Overlay)]].
{{Overlays|type=row|overlay=WMS                  |icon=wms                  |category= Custom         | otype=[[Grid overlay|Grid]] | display=Stores the result of a Web Image Service as a Grid Overlay.}}
: ''The Terrains overlay displays a combination of selected active terrains. This overlay becomes available for each stakeholder.''
{{Overlays|type=row|overlay=Digital Surface Model |icon=heightmap            |category= Topography    | otype=[[Grid overlay|Grid]] | display=Height of the terrain and building heights (DSM)}}
<br clear=all>
{{Overlays|type=row|overlay=Digital Terrain Model |icon=heightmap            |category= Topography    | otype=[[Grid overlay|Grid]] | display=Height of the terrain (DTM)}}
<!--====Pipe network Financial====
{{Overlays|type=row|overlay=Function              |icon=function            |category= Topography    | otype=Feature              | display=Highlights specific [[functions]]/ [[building]]s}}
====Pipe network Technical====-->
{{Overlays|type=row|overlay=Source                |icon=source              |category= Topography    | otype=Feature              | display=Datasets/sources currently in use for generating the project}}
====Function Highlight====
{{Overlays|type=row|overlay=Underground          |icon=underground          |category= Topography    | otype=Feature              | display=Underground composition}}
[[File:Function_Highlight-Overlay.jpg|thumb|left|Optional Function Highlight overlay]]
{{Overlays|type=row|overlay=Network Distance      |icon=network_distance    |category= Networks      | otype=Feature              | display=Distance to lines of a network}}
: ''Main article: [[Function Highlight (Overlay)]].
{{Overlays|type=row|overlay=Network Overview      |icon=network_overview    |category= Networks      | otype=Feature              | display=Lines, loads and cluster topography of a network}}
: ''This overlay highlights all constructions in the 3D world, for which the specific function has been selected, such as all shops in an area.''
{{Overlays|type=row|overlay=Network Ownership    |icon=network_ownership    |category= Networks      | otype=Feature              | display=Ownership of lines, loads and clusters of a network}}
<br clear=all>
}}
====Custom Color Areas====
[[File:Custom_Color_Areas-Overlay.jpg|thumb|left|Optional Custom Color Areas overlay]]
: ''Main article: [[Custom Color Area (Overlay)]].
: ''This overlay shows colored areas in the 3D world, in locations defined in the editor.''
<br clear=all>
====Vacancy====
[[File:Vacancy-Overlay.jpg|thumb|left|Optional Vacancy overlay]]
: ''Main article: [[Vacancy (Overlay)]].
: ''This overlay shows all constructions in the project area which have been set as vacant in the Editor.''
<br clear=all>
====Image====
[[File:Image-Overlay.jpg|thumb|left|Optional Image overlay]]
: ''Main article: [[Image (Overlay)]].
: ''This overlay projects a custom image over the project area.''
<br clear=all>
====Online GIS data====
[[File:GIS-Overlay.jpg|thumb|left|Optional Online GIS data overlay, based on public available noise pollution data (PDOK)]]
: ''Main article: [[Online GIS data (Overlay)]].
: ''This option enables users to import private or public available GIS data sets as an overlay.''
<br clear=all>


==Adding and removing overlays==
{{article end
{{Editor ribbon|header=3D World|bar=Overlays}}
|howtos=
'''General:'''
<div style="column-count:2">
* [[How to add and remove an Overlay]]
* [[How to add your own Overlay Icon]]
* [[How to sort Overlays]]
* [[How to edit an overlay legend]]
* [[How to use the Overlay Overview]]
</div>
'''Grid Overlay specific:'''
<div style="column-count:2">
* [[How to configure a Grid Overlay's legend]]
* [[How to set an Overlay to active or inactive]]
* [[How to delay Grid Overlay calculations]]
* [[How to force Grid Overlays to recalculate]]
* [[How to create an overlay for visualizing your own geographical vector information]]
* [[How to use a Grid Overlay to change the elevation model]]
* [[How to smooth Grid Overlay results]]
</div>
'''In/out:'''
<div style="column-count:2">
* [[How to export a Grid Overlay as ASCII]]
* [[How to export a Grid Overlay as GeoJSON]]
* [[How to export a Grid Overlay as GeoTIFF]]
* [[How to export a Grid Overlay as png]]
* [[How to show Overlays in Power BI]]
</div>
|notes=
* The following overlays are added automatically when creating a new project: [[City_Overlay|City]], [[Neighborhoods_(Overlay)|Neighborhoods]] and [[Ownership_(Overlay)|Ownership]]. Depending on the [[Project Source|project sources]], [[Zoning_(Overlay)|Zoning]] and [[Underground Overlay]] can also be added.
* [[Grid overlay]]s have the ability to show the [[Difference (Overlay)|difference]] between the maquette and the current state. The difference visualization uses its own legend, which can also be manually adjusted. The option to show the difference can be turned on or off per Grid Overlay.
* Overlays can be given [[Attribute]]s. Some of these Attributes are used by their calculation model.
* Some overlays can have the option to visualize different (intermediate) results of its calculation. These are configured using the [[Result_type|result types]]. For example, for the [[Water Overlay]] the [[Result_type_(Water_Overlay)|result types]] include the [[surface last value result type (Water Overlay)|surface last value result type]] and the [[ground watertable result type (Water Overlay)|groundwater result type]] for water above and below ground respectively.
* Some overlays store multiple [[Timeframes_(Water_Overlay)|timeframes]] of results. Examples are the [[Water Overlay]] and the [[Heat Overlay]]. Each timeframe is a complete snapshot of results of the entire project area. These results can be viewed in sequence. When these overlays are visualized in the [[Web_Interface|2D map]], the last timeframe is shown.
|seealso=
*[[Grid Overlay]]
}}
{{Overlay nav}}
{{Editor current situation nav}}


Adding and removing overlays is a generic process, however, certain overlays are dependent on other assets being present too, such as indicators, terrains, vacancy, images, etc. For more information please refer to the respective main articles for the specific overlays.
[[Category:Items]]
 
{{Editor steps|title=add an overlay|Select in the editor '3D World' from the ribbon|Select 'Overlays' > 'Edit overlays' from the ribbon bar|Select the desired overlay'*' from the drop down menu on the bottom of the left panel|Select 'Add' from the bottom of the left panel|Fill in parameters on the right panel, as required for some overlays|The overlay icon will now appear under the mini map'**'}}
 
<gallery>
File:Select3DWorld.jpg|1. Select 3D World
File:SelectEditOverlay.jpg|2. Select Overlays > Edit overlays
File:SelectDropDown.jpg|3. Select desired overlay from drop down menu on the bottom of the left panel
File:SelectAddOverlay.jpg|4. Select 'Add' from the bottom of the left panel
File:OverlayParameters.jpg|5. Fill in parameters on the right panel (required for some overlays)
File:OverlayIconPresent.jpg|6. The overlay icon will  now appear under the mini map
</gallery>
 
{{Editor steps|title=remove an overlay|Select in the editor '3D World' from the ribbon|Select 'Overlays' > 'Edit overlays' from the ribbon bar|Select the desired overlay'*' from the list of active overlays'**' on the left panel|Select 'remove' from the bottom of the left panel|Confirm the removal in the pop up confirmation message}}
 
<gallery>
File:Select3DWorld.jpg|1. Select 3D World
File:SelectEditOverlay.jpg|2. Select Overlays > Edit overlays
File:SelectOverlay.jpg|3. Select desired overlay from the list of active overlays on the left panel
File:SelectRemoveOverlay.jpg|4. Select 'Remove' from the bottom of the left panel
File:ConfirmRemovalOverlay.jpg|5. Confirm the removal in the pop up confirmation message
</gallery>
 
'*' The default City, Zoning and Property overlays are already present when creating a new project in the editor. However, they can be removed and added later again.
 
'**'The Heat and Livability overlays can only be added to selected stakeholders as part of the heat and livability indicators, assigned to said stakeholders. These overlays are automatically added when adding the paired indicator, and removed along with the indicator again. See also: [[Indicators]].

Latest revision as of 15:33, 29 February 2024

Overlay in comparison to Measurements, Indicators and Globals

An overlay is a layer visualized on top of the terrain and buildings in the 3D visualization. Overlays can provide spatial insight into specific subject, such as the variation of height and ownership. The visualized properties can originate from the current state of the project or from a result of a spatial calculation.

However, most overlays that can be added to a project use an underlying calculation model, which rasterize the spatial data and apply calculations to it to produce various (intermediate) results. These computational overlays can range from simple distance and average operations to complex water simulations. For these more complex Overlays with multiple results, additional Result Child Overlays can be added. The calculation main and child results will always be governed by the main overlay, also called the Result Parent Overlay.

How to access overlays in a project

Overlay buttons in the Navigation Panel can be clicked to show that specific Overlay. The Parent Overlays are indicated with the yellow rectangles and the Child Overlays with the red rectangle

Overlays available to stakeholders appear as buttons on the right side of the interface. Clicking on any of these buttons will switch the view to the specific overlay. Clicking on the "City" overlay will switch the view back to default. Some overlays are automatically added when a project is created. Some overlays are closely related to indicators, such as Heatstress and Livability.

Parent Overlay

Overlays can be grouped together using a Parent-Child hierarchy. Hovering over any of the Overlays in the Navigation Panel will show additional icons for the Child Overlays of that Overlay.

Every Overlay is considered a Parent Overlay, unless it has a Parent Overlay set, in which case it becomes a Child Overlay of that Parent Overlay. Overlays with Child Overlays cannot be a Child Overlay to another Overlay. Result Child Overlays are always Child Overlays of other Overlays.

When a parent overlay is removed, it's child overlays are not removed, unless the child overlay is a result child type overlay. Otherwise, they simply have no parent overlay set anymore and become a parent overlay themselves.

List of available Overlays

Notes

  • The following overlays are added automatically when creating a new project: City, Neighborhoods and Ownership. Depending on the project sources, Zoning and Underground Overlay can also be added.
  • Grid overlays have the ability to show the difference between the maquette and the current state. The difference visualization uses its own legend, which can also be manually adjusted. The option to show the difference can be turned on or off per Grid Overlay.
  • Overlays can be given Attributes. Some of these Attributes are used by their calculation model.
  • Some overlays can have the option to visualize different (intermediate) results of its calculation. These are configured using the result types. For example, for the Water Overlay the result types include the surface last value result type and the groundwater result type for water above and below ground respectively.
  • Some overlays store multiple timeframes of results. Examples are the Water Overlay and the Heat Overlay. Each timeframe is a complete snapshot of results of the entire project area. These results can be viewed in sequence. When these overlays are visualized in the 2D map, the last timeframe is shown.

How-to's

General:

Grid Overlay specific:

In/out:

See also