Average Overlay: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(27 intermediate revisions by one other user not shown)
Line 2: Line 2:
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]].
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]].


Another 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 types of features in the [[project area]]: [[Building]]s, [[Address]]es, [[Terrain]]s, [[Area]]s, [[Neighborhood]]s and [[Net Line]]s.
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.


Thirdly the Average overlay supports replacing {{nodata}} values with interpolated non {{nodata}} values using surrounding cells within a specified distance.
Thirdly the Average overlay supports replacing {{nodata}} values with interpolated non {{nodata}} values using surrounding cells within a specified distance.
Line 13: Line 13:


==Calculation==
==Calculation==
The Average Overlay works by first computing a grid of input values. This depends on the input;
The Average Overlay works by first rasterizing input values. These values can be obtained from Vector data or a [[Grid Overlay]].
* Certain Vector data in the [[Project]] is rasterized into [[grid cell]]s, depending on the configured [[MapLink (Average Overlay)]]. Cells that do not contain Vector data are given a [[Default value (Average Overlay)|Default value]].
* Grid is (re)rasterized if the dimensions are different from the requested dimensions, or used directly otherwise.


Next, it depends on the operator configured for the Average Overlay what happens next:
Once [[#Rasterized Vector data|rasterized]], the configured result type determines the operation applied on these values.
for each [[grid cell]], the values of all cells within a given [[Distance m (Average Overlay)|radius]] from that one cell are summed up, and divided by the total amount of cells found in that radius. The output value of that one cell is that computed average.  


The Average Overlay can be configured to fine-tune the exact data which should serve as input, and how the calculation should take place.
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.


===Average Operator===
===Averaged Input Type===
The Average Operator determines how a cells value is calculated. The following operators are supported for the Average Overlay:
You can also configure in what way a value for this overlay will be [[Rasterization (Average Overlay)|rasterized]]:
* ''AVG'': Averages rasterized values within the configured [[Distance m (Average Overlay)|radius]].
* ''MAX'': Selects the maximum value of rasterized values within the configured [[Distance m (Average Overlay)|radius]].
* ''MIN'': Selects the minimum value of rasterized values within the configured [[Distance m (Average Overlay)|radius]].
* ''AVG_INTERPOLATED'': Replaces a cell's rasterized value when it contains {{nodata}}, when its neighboring cell does contain a value. This process will be repeated multiple rounds based on the configured [[Distance m (Average Overlay)]] and the grid cell size.
 
===Averaged Value Type===
You can also configure in what way a value for this overlay will be selected:
* '''First''': Selects the first value encountered among all considered Vector data types. See [[Average Overlay#Rasterized Vector data|Rasterized Vector data]] for the order.
* '''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.
* '''Min''': Selects the minimum value among all considered Vector data types.
* '''Max''': Selects the maximum 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.
* '''Single layer''': Only Vector data of the configured [[MapLink (Average Overlay)]] is rasterized.
* '''Grid''': Indicates that this overlay uses its configured [[Input prequel (Average Overlay)]] as input instead of Vector data.
* '''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)}}
}}
 
===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:
 
{{result types|suppresscategory=true|allowselflinks=true|
{{: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===
Line 42: Line 45:
The Average Overlay currently supports the following MapLinks (in order): [[Net Line]]s, [[Address]]es, [[Building]]s, [[Terrain]]s, [[Area]]s, [[Neighborhood]]s.
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|suppresscategory=true|
===Input===
{{:Rasterization (Average Overlay)}}
The Average Overlay requires an initial input, which it can then average out over a specified range. The input can be either an [[Attribute]] of vector data, or a [[Grid Overlay]]. The following options are available:
{{:Maplink (Average Overlay)}}
; Attribute First Layer
}}
: Use the first value found among the layers of vector data which have the specified [[Attribute]]. If no such [[Attribute]] exists in a specific location, the used value is 0.
 
; Attribute Min Layer / Max Layer
: Use either the lowest or the highest value found among the layers of vector data which have the specified [[Attribute]]. If no such [[Attribute]] exists in a specific location, the used value is 0.
 
; Attribute Specific Layer
: Use the defined [[Attribute]]'s value from the specific layer of vector data specified. Exactly one layer can be specified. If no such [[Attribute]] exists in a specific location, the used value is 0.
 
; Grid Overlay
: Use the values of another [[Grid Overlay]] when specified as input. No [[Attribute]] needs to be specified. {{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.


===Calculation===
===Calculation===
Line 65: Line 58:
   {{:Default value (Average Overlay)}}
   {{:Default value (Average Overlay)}}
   {{:Distance m (Average Overlay)}}
   {{:Distance m (Average Overlay)}}
  {{:No data interpolation (Average Overlay)}}
}}
}}
==Input Overlay==
Input Overlays are Average Overlays that supply additional insights in the data used for complex Overlay models (e.g the [[Water Overlay]] or [[Heat Stress Overlay]]). Input Overlays can be made visible in the [[3D Visualization]] by selecting them in the Wizard or adding them manually.
==Average Overlay Variants==
There are four options to choose from:
* [[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]].


{{article end
{{article end
|notes=
|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=
|howtos=
* [[How to add and remove an Overlay]]
* [[How to add and remove an Overlay]]
* [[How to edit an overlay legend]]
* [[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=
|external=
* [https://www.tygron.com/en/idea/extended-combo-and-average-overlay-functionalities  Extended Combo and average overlay functionalities.]
* [https://www.tygron.com/en/idea/extended-combo-and-average-overlay-functionalities  Extended Combo and average overlay functionalities.]
}}
}}
 
{{AverageOverlay nav}}
{{Overlay 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.
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 cells value is calculated. The following result types are supported for the Average Overlay:

Icon Result type Unit Mode Description
Overlay icon average avg.png AVG A cell's value is the average of itself and its surrounding cells.
Overlay icon average min.png MIN A cell's value is the minimum of itself and its surrounding cells.
Overlay icon average max.png MAX A cell's value is the maximum of itself and its surrounding cells.
Overlay icon average avg interpolated.png AVG_INTERPOLATED Replace NODATA cells using its surrounding cells.

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.

Icon Property Description Default value
Distancewizard icon rasterization.png Rasterization The rasterization method of a Average Overlay FIRST
Distancewizard icon maplink.png Maplink The attribute maplink (layer) used to select an Attribute 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
AverageWizard icon attribute timeframes.png ATTRIBUTE_TIMEFRAMES integer The amount of timeframes to display when basing input on Attribute arrays. 1
AverageWizard icon default value.png DEFAULT_VALUE The default value used for a cell when no spatial data overlaps that cell. 0
AverageWizard icon distance m.png DISTANCE_M m 0 to 2000.0 The radius within which an average value must be computed. 100

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

External links

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


Overlays
Categorization
Grid • Parent • Result Child • Result Parent • Result type
Default
City
Administrative
Ownership • Ownership Grid • Zipcodes • Zoning • Neighborhoods • Municipalities • Vacancy
Environmental
Heat Stress • Traffic Density • Traffic Noise • Traffic NO2 • Livability
Water
Rainfall • Flooding • Groundwater • Subsidence • 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 • Underground • Source
Network
Network Distance • Network Overview • Network Ownership


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