Overlay: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
No edit summary
 
(61 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<!--{{learned|what an overlay is|how overlays relate to the {{software}} interface|how to access overlays in a project|which overlays exist|how to add or remove overlays|}}
[[File:Api_current_situation_calculation.png|thumb|right|400px|[[Overlay]] in comparison to [[Measurement]]s, [[Indicator]]s and [[Global]]s]]
==What are 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.  
An overlay is a layer drawn over the 3D world to illustrate different properties. They do not contain all the information of a given visualization, but serve as a supplement. 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 {{software}} 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 {{software}} as part of the [[interface]]. Properties such as [[ownership]] and [[zoning]] are important pieces of information to the [[user]], but would be very overwhelming to display at all times. Instead, a user 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 show an overlay in the viewer app.]]
[[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 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.]]
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.]]


===Parent Overlay===
===Parent Overlay===
Overlays can be grouped together as multiple Child Overlays under a single Parent Overlay. This allows for a large amount of Overlays to be organized into an easier-to-use hierarchy. Hovering over any of the Overlays in the [[Overlay menu]] will show additional icons for the Child Overlays of that Overlay, if any exist.
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 type Overlay]]s are always Child Overlays of other Overlays.
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.


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.
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.
Line 19: Line 18:


==List of available Overlays==
==List of available Overlays==
{| {{STDT|overlay sortable}}
{{Overlays|suppresscategory=true|allowselflinks=true|
|-
{{Overlays|type=row|overlay=City                  |icon=normal               |category= Default       | otype=None                 | display=The default view without any overlay}}
! style="width:50px" | Icon !! style="width:150px; text-align:left;" | Name !! style="width:100px; text-align:left;" | Category !! style="width:100px; text-align:left;" | Type !! style="width:450px; text-align:left;" | Displays
{{Overlays|type=row|overlay=Ownership             |icon=ownership            |category= Administrative | otype=Feature               | display=Ownership of constructions/ plots}}
{{Overlay table row |normal| [[City_(Overlay)|City]] | Default | None | The default view without any overlay}}
{{Overlays|type=row|overlay=Ownership Grid        |icon=ownership_grid      |category= Administrative | otype=[[Grid overlay|Grid]] | display=Ownership of constructions/ plots}}
{{Overlay table row |ownership| [[Ownership (Overlay)|Ownership]] | Default | Feature | Ownership of constructions/ plots}}
{{Overlays|type=row|overlay=Municipalities        |icon=municipalities      |category= Administrative | otype=Feature               | display=Municipalities in the project area}}
{{Overlay table row |municipalities| [[Municipalities (Overlay)|Municipalities]] | Administrative | Feature | Municipalities in the project area}}
{{Overlays|type=row|overlay=Neighborhoods         |icon=neighborhoods        |category= Administrative | otype=Feature               | display=Neighborhoods in the project area}}
{{Overlay table row |neighborhoods| [[Neighborhoods (Overlay)|Neighborhoods]] | Administrative | Feature | Neighborhoods in the project area}}
{{Overlays|type=row|overlay=Vacancy               |icon=vacancy              |category= Administrative | otype=Feature               | display=Constructions marked as vacant are highlighted}}
{{Overlay table row |vacancy| [[Vacancy (Overlay)|Vacancy]] | Administrative | Feature | Constructions marked as vacant are highlighted}}
{{Overlays|type=row|overlay=Zipcodes             |icon=zip_codes            |category= Administrative | otype=Feature               | display=Postal codes}}
{{Overlay table row |zip_codes| [[Zipcodes (Overlay)|ZipCodes]] | Administrative | Feature | Postal codes}}
{{Overlays|type=row|overlay=Zoning               |icon=zoning              |category= Administrative | otype=Feature               | display=Zoning (related to zoning plans)}}
{{Overlay table row |zoning| [[Zoning (Overlay)|Zoning]] | Administrative | Feature | Zoning (related to zoning plans)}}
{{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}}
{{Overlay table row |heat_stress| [[Heat stress (Overlay)| Heat]] | Environmental | [[Grid overlay|Grid]] | Urban heat stress}}
{{Overlays|type=row|overlay= Heat                |icon=heat_stress          |category= Environmental | otype=[[Grid overlay|Grid]] | display=Urban heat stress}}
{{Overlay table row |livability| [[Livability (Overlay)| Livability]] | Environmental | [[Grid overlay|Grid]] | Livability score}}
{{Overlays|type=row|overlay= Livability           |icon=livability          |category= Environmental | otype=[[Grid overlay|Grid]] | display=Livability score}}
{{Overlay table row |traffic_density| [[Traffic Flow (Overlay) | Traffic Flow]] | Environmental | [[Grid overlay|Grid]] | Traffic density}}
{{Overlays|type=row|overlay= Traffic Density      |icon=traffic_density      |category= Environmental | otype=[[Grid overlay|Grid]] | display=Traffic density}}
{{Overlay table row |traffic_noise| [[Traffic Noise (Overlay) | Traffic Noise]] | Environmental | [[Grid overlay|Grid]] | Impact of traffic noise polution on surrounding area}}
{{Overlays|type=row|overlay= Traffic Noise       |icon=traffic_noise        |category= Environmental | otype=[[Grid overlay|Grid]] | display=Impact of traffic noise polution on surrounding area}}
{{Overlay table row |traffic_no2| [[Traffic NO2 (Overlay) | Traffic NO2]] | Environmental | [[Grid overlay|Grid]] | Impact of traffic NO2 polution on surrounding area}}
{{Overlays|type=row|overlay= Traffic NO2         |icon=traffic_no2          |category= Environmental | otype=[[Grid overlay|Grid]] | display=Impact of traffic NO2 polution on surrounding area}}
{{Overlay table row |aerius| [[Aerius (Overlay) | Aerius]] | Environmental | [[Grid overlay|Grid]] | Impact of traffic<!--, industry and construction--> on NOX and NH3 polution on Natura 2000 areas in the Netherlands}}
{{Overlays|type=row|overlay=Flooding              |icon=flooding            |category= Water          | otype=[[Grid overlay|Grid]] | display=Impact of flooding on inundation}}
{{Overlay table row |heightmap| [[Digital Terrain Model (Overlay)|Digital Terrain Model]] | Landscape | [[Grid overlay|Grid]] | Height of the terrain (DTM)}}
{{Overlays|type=row|overlay=Groundwater          |icon=groundwater          |category= Water          | otype=[[Grid overlay|Grid]] | display=Underground water tables}}
{{Overlay table row |heightmap| [[Digital Surface Model (Overlay)|Digital Surface Model]] | Landscape | [[Grid overlay|Grid]] | Height of the terrain and building heights (DSM)}}
{{Overlays|type=row|overlay=Rainfall              |icon=rainfall            |category= Water          | otype=[[Grid overlay|Grid]] | display=Impact of rainfall on inundation}}
{{Overlay table row |underground| [[Underground Overlay|Underground]] | Landscape | Feature | Underground composition}}
{{Overlays|type=row|overlay=Subsidence            |icon=subsidence          |category= Water          | otype=[[Grid overlay|Grid]] | display=Areas subject to subsidence}}
{{Overlay table row |rainfall| [[Rainfall (Overlay)|Rainfall]] | Water | [[Water Overlay|Water]], [[Grid overlay|Grid]] | Impact of rainfall on inundation}}
{{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.}}
{{Overlay table row |flooding| [[Flooding (Overlay)|Flooding]] | Water | [[Water Overlay|Water]], [[Grid overlay|Grid]] | Impact of flooding on inundation}}
{{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.}}
{{Overlay table row |groundwater| [[Groundwater (Overlay)|Groundwater]] | Water | [[Water Overlay|Water]], [[Grid overlay|Grid]] | Underground water tables}}
{{Overlays|type=row|overlay=Average              |icon=avg                  |category= Distance      | otype=[[Grid overlay|Grid]] | display=Smoothened values of grid cells}}
{{Overlay table row |subsidence| [[Subsidence Overlay|Subsidence]] | Water | [[Grid overlay|Grid]] | Areas subject to subsidence}}
{{Overlays|type=row|overlay=Distance              |icon=distance            |category= Distance      | otype=[[Grid overlay|Grid]] | display=Defined contour around an object}}
{{Overlay table row |subsidence| [[Waterwijzer Overlay|Waterwijzer]] | Water | [[Grid overlay|Grid]] | Loss of earnings for crops based on ground water levels and type of soil.}}
{{Overlays|type=row|overlay=Sight Distance        |icon=sight_distance      |category= Distance      | otype=[[Grid overlay|Grid]] | display=Combined distance zone with line of sight}}
{{Overlay table row |watershed| [[Watershed (Overlay)|Watershed]] | Water | [[Grid overlay|Grid]] | Discharge areas based on DTM or Water overlay's flow direction.}}
{{Overlays|type=row|overlay=Travel Distance      |icon=travel_distance      |category= Distance      | otype=[[Grid overlay|Grid]] | display=Contour based on travel distance}}
{{Overlay table row |distance_sight| [[Distance Sight (Overlay)|Distance Sight]] | Distance | [[Grid overlay|Grid]] | Combined distance zone with line of sight}}
{{Overlays|type=row|overlay=Area                  |icon=area                |category= Custom        | otype=Feature              | display=Selection of [[Area]]s}}
{{Overlay table row |distance_zone| [[Distance Zone (Overlay)|Distance Zone]] | Distance | [[Grid overlay|Grid]] | Defined contour around an object}}
{{Overlays|type=row|overlay=Attribute            |icon=attribute            |category= Custom        | otype=Feature              | display=Presence of a specific attribute in a data layer}}
{{Overlay table row |disturbance_distance| [[Disturbance Distance Overlay|Disturbance Distance]] | Distance | [[Grid overlay|Grid]] | Contour based on sound disturbance}}
{{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.}}
{{Overlay table row |safety_distance| [[Safety Distance (Overlay)|Safety Distance]] | Distance | [[Grid overlay|Grid]] | Contour based on safety distance}}
{{Overlays|type=row|overlay=GeoTIFF              |icon=geo_tiff            |category= Custom        | otype=[[Grid overlay|Grid]] | display=External data in GeoTIFF format}}
{{Overlay table row |travel_distance| [[Travel Distance (Overlay)|Travel Distance]] | Distance | [[Grid overlay|Grid]] | Contour based on travel distance}}
{{Overlays|type=row|overlay=Image                |icon=image                |category= Custom        | otype=[[Grid overlay|Grid]] | display=A custom image}}
{{Overlay table row |network_overview| [[Network Overview (Overlay)|Network Overview]] | Network | Feature | Lines, loads and cluster topography of a network}}
{{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.}}
{{Overlay table row |network_ownership| [[Network Ownership (Overlay)|Network Ownership]] | Network | Feature | Ownership of lines, loads and clusters of a network}}
{{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.}}
{{Overlay table row |areas| [[Areas (Overlay)|Areas]] | Custom | Feature | Selection of Areas}}
{{Overlays|type=row|overlay=Digital Surface Model |icon=heightmap            |category= Topography    | otype=[[Grid overlay|Grid]] | display=Height of the terrain and building heights (DSM)}}
{{Overlay table row |attribute| [[Attribute (Overlay)|Attribute]] | Custom | Feature | Presence of a specific attribute in a data layer}}
{{Overlays|type=row|overlay=Digital Terrain Model |icon=heightmap            |category= Topography    | otype=[[Grid overlay|Grid]] | display=Height of the terrain (DTM)}}
{{Overlay table row |avg| [[Average_Overlay|Average]] | Custom | [[Grid overlay|Grid]] | Smoothened values of grid cells}}
{{Overlays|type=row|overlay=Function              |icon=function            |category= Topography    | otype=Feature               | display=Highlights specific [[functions]]/ [[building]]s}}
{{Overlay table row |custom_color_areas| [[Custom Color Area (Overlay)|Custom Color Area]] | Custom | Feature | One or more areas for which a separate color and name can be set}}
{{Overlays|type=row|overlay=Source                |icon=source              |category= Topography    | otype=Feature               | display=Datasets/sources currently in use for generating the project}}
{{Overlay table row |function_highlight| [[Function Highlight (Overlay)|Function Highlight]] | Custom | Feature | Highlights specified functions/ constructions}}
{{Overlays|type=row|overlay=Underground          |icon=underground          |category= Topography    | otype=Feature               | display=Underground composition}}
{{Overlay table row |geo_tiff| [[GeoTiff Overlay|Geotiff]] | Custom | [[Grid overlay|Grid]] | External data in Geotiff format}}
{{Overlays|type=row|overlay=Network Distance      |icon=network_distance    |category= Networks      | otype=Feature              | display=Distance to lines of a network}}
{{Overlay table row |image| [[Image (Overlay)|Image]] | Custom | [[Grid overlay|Grid]] | A custom image}}
{{Overlays|type=row|overlay=Network Overview      |icon=network_overview    |category= Networks      | otype=Feature              | display=Lines, loads and cluster topography of a network}}
{{Overlay table row |source| [[Source (Overlay)|Source]] | Custom | Feature | Datasets/sources currently in use for generating the project}}
{{Overlays|type=row|overlay=Network Ownership    |icon=network_ownership    |category= Networks      | otype=Feature               | display=Ownership of lines, loads and clusters of a network}}
|}
}}


==How-to's==
{{article end
|howtos=
'''General:'''
<div style="column-count:2">
* [[How to add and remove an Overlay]]
* [[How to add and remove an Overlay]]
 
* [[How to add your own Overlay Icon]]
==Notes==
* [[How to sort Overlays]]
<!--[[File:Additional_info.jpg|200px|thumb|right|Example of the Difference Overlay for Heatstress]]-->
* [[How to edit an overlay legend]]
* The following overlays are available by default when creating a new project: [[City_Overlay|City]], [[Neighborhoods_(Overlay)|Neighborhoods]], [[Ownership_(Overlay)|Ownership]] and [[Zoning_(Overlay)|Zoning]]
* [[How to use the Overlay Overview]]
* Grid overlays have the ability to show the [[Difference (Overlay)|difference]] between the maquette and the original state. The difference visualization uses its own legend. The option to show the difference can be turned on or off per Grid Overlay.
</div>
* Overlays can be given [[attributes]]. Some of these attributes are used by their calculation model.
'''Grid Overlay specific:'''
 
<div style="column-count:2">
{{Template:Overlay nav}}
* [[How to configure a Grid Overlay's legend]]
{{Template:Editor current situation nav}}
* [[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}}


[[Category:Items]]
[[Category:Items]]

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