Average Overlay: Difference between revisions
No edit summary |
No edit summary |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 19: | Line 19: | ||
Once [[#Rasterized Vector data|rasterized]], the configured result type determines the operation applied on these values. | Once [[#Rasterized Vector data|rasterized]], the configured result type determines the operation applied on these values. | ||
Additional parameters | 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. | ||
===Averaged Input Type=== | ===Averaged Input Type=== | ||
| Line 33: | Line 33: | ||
====Grid==== | ====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 | 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| | {{Overlay prequels| | ||
{{:Input prequel (Average Overlay)}} | {{:Input prequel (Average Overlay)}} | ||
| Line 39: | Line 39: | ||
===Average Result Type=== | ===Average Result Type=== | ||
The configured [[Result type (Average Overlay)|Average Overlay result type]] determines how a | 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| | {{result types| | ||
| Line 49: | Line 49: | ||
===Rasterized Vector data=== | ===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. | The Average Overlay currently supports the following MapLinks (in order): [[Net Line]]s, [[Address]]es, [[Building]]s, [[Terrain]]s, [[Area]]s, [[Neighborhood]]s. | ||
| Line 95: | Line 95: | ||
* [[Api session event editor overlay set result type]] | * [[Api session event editor overlay set result type]] | ||
* [[Api session event editor overlay set attribute]] | * [[Api session event editor overlay set attribute]] | ||
* [[Api session event editor overlay set avg distance]] | |||
* [[Api session event editor overlay set prequel]] | |||
}} | }} | ||
{{AverageOverlay nav}} | {{AverageOverlay nav}} | ||
{{Overlay nav}} | {{Overlay nav}} | ||
Latest revision as of 07:38, 10 July 2026
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
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 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:
- 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
See also
API Endpoints
- 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
External links