Average Overlay: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
← Older edit
Frank@tygron.nl (talk | contribs)
Tygron, Tygron_admin, Bureaucrats, Interface administrators, Administrators
46,429 edits
No edit summary
 
(140 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{stub}}
[[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 another [[Grid Overlay]].
==What the Average overlay is==
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]].


==Purpose of the Average Overlay==
====Spatial Features====
A typical use-case of the Average Overlay is to display model data used in visualize parameters part of a simulation model (e.g. the rainfall overlay). A parameter assigned to a grid-cell can be related to one or more polygon layers. Such layers can be buildings, terrain, areas or neighborhoods.  
A parameter assigned to a grid-cell can be related to one or more types of features in the [[project map]]: [[Building]]s, [[Address]]es, [[Terrain]]s, [[Area]]s, [[Neighborhood]]s and [[Net Line]]s. The way this value is selected depends on the [[Average Overlay#Averaged Input Type|Averaged Input Type]] and [[Average Overlay#Calculation|calculation parameters]].


==Create an Average Overlay==
====Interpolate NODATA====
The Average overlay can also be [[Avg interpolated result type (Average Overlay)|configured]] to replace {{nodata}} values with interpolated non {{nodata}} values using surrounding cells within a specified distance.
{{clear}}


{{Editor ribbon|header=Geo Data|bar=Overlays}}
==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 about the actual value in that specific grid cell.
{{clear}}


{{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}}
==Calculation==
The Average Overlay works by first rasterizing input values. These values can be obtained from Vector data or a [[Grid Overlay]].


===Average Overlay Wizard===
Once [[#Rasterized Vector data|rasterized]], the configured result type determines the operation applied on these values.
Below an explanation of the steps in the Average Overlay Wizard.


===Selection type===
Additional parameters define the [[Distance m (Average Overlay)|operation range]], the [[Default value (Average Overlay)|default value]] if none is rasterized, and the [[Attribute timeframes (Average Overlay)|number of timeframes]] for attributes with multiple values.
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.


===Select attribute value===
===Averaged Input Type===
Select the attribute from the list of all the attributes your project contains.
You can also configure in what way a value for this overlay will be [[Rasterization (Average Overlay)|rasterized]].  
===Layer===


Attributes can be assigned to one of more layers of the 3D model: [[Constructions|Buildings]], [[Terrains]], [[Areas]] and [[Neighborhoods]]. In this step you can select the following options for assigning parameter values:
====Key====
# Filter occurrence in Layers: an attribute value is selected from order of occurrence in the polygon data layer value mentioned above
* '''First''': Selects the first value encountered among all considered Vector data types. See [[Average Overlay#Rasterized Vector data|Rasterized Vector data]] for the order.
# Minimum values in Layers. The minimum value is selected from all layers above
* '''Min''': Selects the minimum value among all considered Vector data types.
# Maximum values in Layers. The maximum value is selected from all layers above
* '''Max''': Selects the maximum value among all considered Vector data types.
# Specific Layer only. A specific layer can be selected.
* '''Single layer''': Only Vector data of the configured [[Maplink (Average Overlay)]] is rasterized.
===Optional step (when selected Create Grid Overlay in Step 1): a smoothing distance value


Press finish to generate the average overlay
{{Overlay keys| {{:Key (Average Overlay)}}}}


====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 inherits the number of [[timeframe]]s from the Input Overlay. If their grid sizes differ, the input grid is automatically resized.
{{Overlay prequels|
{{:Input prequel (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}}
===Average Result Type===
The configured [[Result type (Average Overlay)|Average Overlay result type]] determines how a cell's value is calculated. The following result types are supported for the Average Overlay:
 
{{result types|
{{:Avg result type (Average Overlay)}}
{{:Min result type (Average Overlay)}}
{{:Max result type (Average Overlay)}}
{{:Avg interpolated result type (Average Overlay)}}
}}
 
===Rasterized Vector data===
Rasterized vector data depends on the [[Maplink (Average Overlay)]] and [[Average Overlay#Average Input Type|Average Input Type]]. If the input type is 'Grid', no vector data is used. Otherwise, all MapLink layers are considered if MapLink is null; otherwise, only the specified MapLink is rasterized.
 
The Average Overlay currently supports the following MapLinks (in order): [[Net Line]]s, [[Address]]es, [[Building]]s, [[Terrain]]s, [[Area]]s, [[Neighborhood]]s.
 
{{Overlay property|
{{:Rasterization (Average Overlay)}}
{{:Maplink (Average Overlay)}}
}}
 
===Calculation===
The way of averaging is defined by several [[Model attributes (Average Overlay)|Attribute]]s, and can most easily be set using the ''Average Overlay Wizard''.
 
The calculation can be configured via the following attributes:
{{overlay attributes|
  {{:Attribute timeframes (Average Overlay)}}
  {{:Default value (Average Overlay)}}
  {{:Distance m (Average Overlay)}}
  {{:Surface only (Average Overlay)}}
}}
 
{{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 an 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]]
* [[How to remove a waterway from the heightmap]]
* [[How to create an Overlay showing the presence of structures]]
* [[How to create an Overlay which highlights unused land]]
|external=
* [https://www.tygron.com/en/idea/extended-combo-and-average-overlay-functionalities  Extended Combo and average overlay functionalities.]
|api=
* [[Api session event editor overlay set rasterization]]
* [[Api session event editor overlay set result type]]
* [[Api session event editor overlay set attribute]]
* [[Api session event editor overlay set avg distance]]
* [[Api session event editor overlay set prequel]]
}}
{{AverageOverlay nav}}
{{Overlay nav}}

Latest revision as of 07:38, 10 July 2026

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 another Grid Overlay.

Spatial Features

A parameter assigned to a grid-cell can be related to one or more types of features in the project map: Buildings, Addresses, Terrains, Areas, Neighborhoods and Net Lines. The way this value is selected depends on the Averaged Input Type and calculation parameters.

Interpolate NODATA

The Average overlay can also be configured to replace 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 about 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 define the operation range, the default value if none is rasterized, and the number of timeframes for attributes with multiple values.

Averaged Input Type

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

Key

  • 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.
Icon Key Unit Range Description Default value
KEY m -3.4028235E38 to 3.4028235E38 Key used to retrieve a value from one or more Layers for a specific grid cell. Grid cell value will be averaged over the selected distance. 0

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 inherits the number of timeframes from the Input Overlay. If their grid sizes differ, the input grid is automatically resized.

Name Prequel Underlying data Unit Range No data Description
INPUT INPUT Average Prequel - infinity to infinity The Grid Overlay that provides the Average Overlay with its initial values.


Average Result Type

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

Icon Result type Unit Mode Description
AVG A cell's value is the average of itself and its surrounding cells.
MIN A cell's value is the minimum of itself and its surrounding cells.
MAX A cell's value is the maximum of itself and its surrounding cells.
AVG_INTERPOLATED Replace NO_DATA cells using their surrounding cells.

Rasterized Vector data

Rasterized vector data depends on the Maplink (Average Overlay) and Average Input Type. If the input type is 'Grid', no vector data is used. Otherwise, all MapLink layers are considered if MapLink is null; otherwise, only the specified MapLink is rasterized.

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

Icon Property Description Default value
Rasterization The rasterization method of an Average Overlay FIRST
Maplink The attribute maplink (layer) used to select an Key when rasterizing a Average Overlay None (null)

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:

Icon Attribute Unit Range Description Default value
ATTRIBUTE_TIMEFRAMES integer 1 to 1000 The amount of timeframes to display when basing input on Attribute arrays. 1
DEFAULT_VALUE The default value used for a cell when no spatial data overlaps that cell. 0
DISTANCE_M m 0 to 2000.0 The radius within which an average value must be computed. 100
SURFACE_ONLY boolean 0 to 1 Whether the configured attribute should only be sampled from the Surface layer. 1

Notes

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 Overlays to your project by selecting them in the Input Overlay step of a Wizard.

How-to's

Average Overlay Variants:

See also

API Endpoints

Average Overlay
Group
Attributes
Attribute timeframes • Default value • Distance m • Surface only
Keys
Key
Models
Attribute • Grid
Prequels
Input
Properties
Maplink • Rasterization
Result types
Avg • Min • Max • Avg interpolated


Overlays
Categorization
Grid • Overlay Type • Parent • Result Child • Result Parent • Result type • Key
Default
City
Administrative
Ownership • Ownership Grid • Zipcodes • Zoning • Neighborhoods • Municipalities • Scenario
Environmental
Heat Stress • Shadow • Traffic Density • Traffic Noise • Traffic NO2 • Livability
Water
Rainfall • Flooding • Groundwater • Watershed
Grid Calculation
Average • Combo • Distance • Sight Distance • Travel Distance • Inference • Iteration
Geo Data
GeoTIFF • WCS • WMS • Image • Area • Attribute • Function
Topography
Satellite • Digital Surface Model • Digital Terrain Model • Building Floors • Underground • Source
Network
Network Distance • Network Overview • Network Ownership


Retrieved from "https://support.tygron.com/w/index.php?title=Average_Overlay&oldid=90566"