Average Overlay: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
No edit summary
 
(90 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{being updated}}
[[File:Average_overlay_example.JPG|thumb|250px|left|The Average Overlay of the urbanization attribute.]]
{{learned|what the Average overlay is|which additional information is displayed in the hover panel|how to add or remove the Average overlay}}
The Average Overlay is a multi purpose [[Grid overlay|Grid Overlay]] which displays (smoothed) values. These values can originate from spatial features, such as [[building]]s, [[terrain]]s, [[area]]s and [[neighborhood]]s. Alternatively, the values can originate from an other [[Grid Overlay]].
==What the Average overlay is==


[[File:Average_overlay_example.JPG|thumb|250px|left|The average overlay of the urbanization attribute.]]
A parameter assigned to a grid-cell can be related to one or more types of features in the [[project area]]: [[Building]]s, [[Address]]es, [[Terrain]]s, [[Area]]s, [[Neighborhood]]s and [[Net Line]]s.


The Average overlay shows (smoothed) values of a grid cell. With the Average overlay it is possible to create a custom dynamic [[Grid_Overlay|Grid overlay]].
Thirdly the Average overlay supports replacing {{nodata}} values with interpolated non {{nodata}} values using surrounding cells within a specified distance.
<br clear=all>
{{clear}}


==Additional information displayed in hover panel==
[[File:Average_hover_panel.JPG|thumb|250px|left|The Average Overlay of the urbanization attribute and additional information in the hover panel.]]
When clicking on a specific location in the map of the Average Overlay, the hover panel gives additional information over the actual value in that specific grid cell.
{{clear}}


==Additional information displayed in hover panel==
==Calculation==
[[File:Average_hover_panel.JPG|thumb|250px|left|The average overlay of the urbanization attribute and additional information in the hover panel.]]
The Average Overlay works by first rasterizing input values. These values can be obtained from Vector data or a [[Grid Overlay]].
When clicking on a specific location in the map of the average overlay, the hover panel gives additional information over the actual value in that specific grid cell.
 
<br clear=all>
Once [[#Rasterized Vector data|rasterized]], the configured result type determines the operation applied on these values.


==Purpose of the Average Overlay==
Additional parameters determine for example the [[Distance m (Average Overlay)|range of the operation]], the [[Default value (Average Overlay)|default value]] in case none was rasterized and the [[Attribute timeframes (Average Overlay)|amount of timeframes]] that should be created when rasterizing an attribute with potentially more than one value.
A typical use-case of the Average Overlay is to visualize parameters of a simulation model (e.g. the [[Rainfall _(Overlay)|rainfall overlay]]). A parameter assigned to a grid-cell can be related to one or more layers of the 3D model: [[Constructions|Buildings]], [[Terrains]], [[Areas]] and [[Neighborhoods]].
==Create an Average Overlay==


{{Editor ribbon|header=Geo Data|bar=Overlays}}
===Averaged Input Type===
You can also configure in what way a value for this overlay will be [[Rasterization (Average Overlay)|rasterized]]:
* '''First''': Selects the first value encountered among all considered Vector data types. See [[Average Overlay#Rasterized Vector data|Rasterized Vector data]] for the order.
* '''Min''': Selects the minimum value among all considered Vector data types.
* '''Max''': Selects the maximum value among all considered Vector data types.
* '''Single layer''': Only Vector data of the configured [[MapLink (Average Overlay)]] is rasterized.
* '''Grid''': Use the values of another [[Grid Overlay]] when specified as input, instead of an [[Attribute]]. {{nodata}} values of the referenced Overlay result in {{nodata}} values in the grid. The Average Overlay will have [[timeframe]]s equal to the amount of [[timeframe]]s of the Input Overlay. In case the input Grid Overlay does not have the same grid size as the Average Overlay, the input Grid Overlay 's value grid is automatically resized.
{{Overlay prequels|suppresscategory=true|
{{:Input prequel (Average Overlay)}}
}}


{{Editor steps|title=add the Average overlay|Select in the editor 'Geo Data' from the ribbon|Select 'Overlays' from the ribbon bar|Select the 'Add AVG' overlay|Follow the steps in the configuration wizard (Average Overlay Wizard) in the panel on the right to set create the Average overlay}}
===Average Result Type===
The configured [[Result type (Average Overlay)|Average Overlay result type]] determines how a cells value is calculated. The following result types are supported for the Average Overlay:


===Average Overlay Wizard===
{{result types|suppresscategory=true|allowselflinks=true|
Below an explanation of the steps in the Average Overlay Wizard.
{{:Avg result type (Average Overlay)}}
{{:Min result type (Average Overlay)}}
{{:Max result type (Average Overlay)}}
{{:Avg interpolated result type (Average Overlay)}}
}}


====Selection type====
===Rasterized Vector data===
If you wish to create a spatial smooting, choose Create an average Grid Overlay, if you wish to Gain insight into Grid Cell Values, choose the latter option.
The Vector data that is rasterized is determined by two values: the configured layer [[MapLink (Average Overlay)]] of the Average overlay and the configured [[Average Overlay#Average Type|Average Type]]. If the Average Type is set to Grid, no vector data is rasterized for this overlay. When the MapLink is set to null, and the Average Type is set to anything other than Grid, all MapLink layers are considered. When the MapLink layer is set to a specific MapLink, only that type of data is rasterized.


====Select attribute value====
The Average Overlay currently supports the following MapLinks (in order): [[Net Line]]s, [[Address]]es, [[Building]]s, [[Terrain]]s, [[Area]]s, [[Neighborhood]]s.
Select the attribute from the list of all the attributes your project contains, you want to create an overlay from.


====Select Layer====
{{Overlay property|suppresscategory=true|
{{:Rasterization (Average Overlay)}}
{{:Maplink (Average Overlay)}}
}}


Attributes can be assigned to one of more layers in the 3D model: [[Constructions|Buildings]], [[Terrains]], [[Areas]] and [[Neighborhoods]]. In this step you can select the following options for choosing which attribute values you would like to see:
===Calculation===
*Filter occurrence in Layers: an attribute value is selected from order of occurrence in the model data layers mentioned above
The way of averaging is defined by several [[Attribute]]s, and can most easily be set using the ''Average Overlay Wizard''.
*Minimum values in Layers. The minimum value is selected from all layers above
*Maximum values in Layers. The maximum value is selected from all layers above
*Specific Layer only. A specific layer can be selected.


====Optional step: select distance====
The calculation can be configured via the following attributes:
This step is optional and shows only when selected the create grid overlay option in step 1. in this step a smoothing distance value can be chosen.
{{overlay attributes|suppresscategory=true|allowselflinks=true|
<br>
  {{:Attribute timeframes (Average Overlay)}}
After following these steps, you have created an Average overlay. Perhaps it is an idea to also customize the legend of the overlay so that it is clear what you want to show with the overlay. 
  {{:Default value (Average Overlay)}}
<br>
  {{:Distance m (Average Overlay)}}
}}


{{Editor steps|title=remove the Average overlay|Select in the editor 'Geo Data' from the ribbon|Select '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}}
{{article end
|notes=
[[File:wateroverlay_wizard_input_overlay_step.jpg|thumb|right|Input overlay step in the [[Water Overlay]] wizard.]]
* ''Input Overlays'' are overlays that can provide insight in the data used for complex Overlay models (e.g the [[Water Overlay]]). These input Overlays can be added automatically as [[Average Overlay]]s to your project by selecting them in the ''Input Overlay'' step of a Wizard.
|seealso=
*[[Model attributes (Average Overlay)]]
*[[Attribute model (Average Overlay)]]
*[[Grid model (Average Overlay)]]
|howtos=
* [[How to add and remove an Overlay]]
* [[How to edit an overlay legend]]
Average Overlay Variants:
* [[How to create an Average Overlay based on another Grid Overlay]].
* [[How to fill NO_DATA values in a grid overlay by interpolation using and Average Overlay]].
* [[How to create an Average Overlay based on feature attributes]].
* [[How to configure an Average Overlay to gain insight into grid cell values]].
* [[How to smooth Grid Overlay results]]
|external=
* [https://www.tygron.com/en/idea/extended-combo-and-average-overlay-functionalities  Extended Combo and average overlay functionalities.]
}}
{{AverageOverlay nav}}
{{Overlay nav}}

Latest revision as of 13:46, 15 March 2024

The Average Overlay of the urbanization attribute.

The Average Overlay is a multi purpose Grid Overlay which displays (smoothed) values. These values can originate from spatial features, such as buildings, terrains, areas and neighborhoods. Alternatively, the values can originate from an other Grid Overlay.

A parameter assigned to a grid-cell can be related to one or more types of features in the project area: Buildings, Addresses, Terrains, Areas, Neighborhoods and Net Lines.

Thirdly the Average overlay supports replacing NO_DATA values with interpolated non NO_DATA values using surrounding cells within a specified distance.

Additional information displayed in hover panel

The Average Overlay of the urbanization attribute and additional information in the hover panel.

When clicking on a specific location in the map of the Average Overlay, the hover panel gives additional information over the actual value in that specific grid cell.

Calculation

The Average Overlay works by first rasterizing input values. These values can be obtained from Vector data or a Grid Overlay.

Once rasterized, the configured result type determines the operation applied on these values.

Additional parameters determine for example the range of the operation, the default value in case none was rasterized and the amount of timeframes that should be created when rasterizing an attribute with potentially more than one value.

Averaged Input Type

You can also configure in what way a value for this overlay will be rasterized:

  • First: Selects the first value encountered among all considered Vector data types. See Rasterized Vector data for the order.
  • Min: Selects the minimum value among all considered Vector data types.
  • Max: Selects the maximum value among all considered Vector data types.
  • Single layer: Only Vector data of the configured MapLink (Average Overlay) is rasterized.
  • Grid: Use the values of another Grid Overlay when specified as input, instead of an Attribute. NO_DATA values of the referenced Overlay result in NO_DATA values in the grid. The Average Overlay will have timeframes equal to the amount of timeframes of the Input Overlay. In case the input Grid Overlay does not have the same grid size as the Average Overlay, the input Grid Overlay 's value grid is automatically resized.


Average Result Type

The configured Average Overlay result type determines how a cells value is calculated. The following result types are supported for the Average Overlay:

Rasterized Vector data

The Vector data that is rasterized is determined by two values: the configured layer MapLink (Average Overlay) of the Average overlay and the configured Average Type. If the Average Type is set to Grid, no vector data is rasterized for this overlay. When the MapLink is set to null, and the Average Type is set to anything other than Grid, all MapLink layers are considered. When the MapLink layer is set to a specific MapLink, only that type of data is rasterized.

The Average Overlay currently supports the following MapLinks (in order): Net Lines, Addresses, Buildings, Terrains, Areas, Neighborhoods.

Calculation

The way of averaging is defined by several Attributes, and can most easily be set using the Average Overlay Wizard.

The calculation can be configured via the following attributes: