Grid Overlay: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
 
(129 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{stub}}
A Grid Overlay is a calculated [[overlay]]. It uses a 2-dimensional grid for calculation, data storage and visualization. The calculation divides the entire [[project]] into a grid of equally sized square cells, with possible size per cell ranging from 0.25m² up to 100m², depending on the size of the project area. This amounts to anywhere from thousands to millions of cells per [[Overlay |overlay]].
==What is a grid overlay==
A grid overlay is a calculated [[overlay]]. It uses a 2-dimensional grid for calculation, data storage, and visualization. The calculation divides the entire [[3D world]] up into a grid of equally sized square cells, with possible size per cell ranging from 0.25m² up to 100m², depending on the size of the project area. This amounts to anywhere from thousands to millions of cells per overlay.


For each cell, a calculation is performed, the specifics of which depend on the overlay being calculated. This can be as simple as displaying (possibly inherently) rasterized data, such as [[Geotiff (Overlay)|geotiff overlays]] or the [[Heightmap_(Overlay)|heightmap]], or as complex as multi-step [[Rainfall (Overlay)|rainfall calculations]].
For each cell, a calculation is performed, the specifics of which depend on the overlay being calculated. This can be as simple as displaying (possibly inherently) rasterized data, such as [[GeoTIFF Overlay]]s or the [[Heightmap Overlay|heightmap]], or as complex as multi-step [[Rainfall Overlay|rainfall calculations]].


The results of a grid overlay can be {{inlink|Visualization|visualized}} in the [[3D world]], exported as a [[geotiff]], or queried using [[TQL]].
The results of a Grid Overlay can be {{inlink|Visualization|inspected}} in the [[3D Visualization]], exported as a [[GeoTIFF]], or queried using [[TQL]].


==Calculations==
==Calculations==
Depending on the exact overlay being calculated, the specifics of the calculation may differ, but the general approach is identical for each overlay.
Depending on the exact overlay being calculated, the specifics of the calculation may differ, but the general approach is identical for each [[Overlay]].


Each calculation relies on some data, which may be set as properties or attributes of the overlay, or may be based on the features present in an individual cell. This data is read from their respective locations as input for the calculation. Data from surrounding cells may also be included, in which their distance may also be factored in.
Each calculation relies on some data, which may be set as properties or attributes of the overlay, or may be based on the features present in an individual cell. This data is read from their respective locations as input for the calculation. Data from surrounding cells may also be included, in which their distance may also be factored in. If input for calculations may exist in multiple kinds of data, it depends on the exact calculation which data layer has preference. In general (for example, for attributes for an [[Average Overlay]]), the data layers are checked in the following order:
# [[Net Line]]s
# [[Address]]es and [[Building]]s
# [[Terrain]]s
# [[Area]]s
# [[Neighborhood]]s
# [[Plot]]s (Only for [[Ownership Grid Overlay]])


With all the data obtained, a new values or set of values is calculated for the cell, and stored as result data for that cell. The calculation may specify this processing repeating a large number of times, for example when iterating through time steps.
With all the data obtained, a new values or set of values is calculated for the cell, and stored as result data for that cell. The calculation may specify this processing repeating a large number of times, for example when iterating through time steps.


When the calculation is completed, a final result value is stored in the cell. The value stored in the cell itself is a unitless number. The exact meaning of the number is dependent on the overlay which defines the calculation. A calculation for [[Traffic Noise (Overlay)|noise]] will present its result in decibels. A calculation for [[Subsidence (Overlay)|subsidence]] in meters.
When the calculation is completed, a final result value is stored in the cell. The value stored in the cell itself is a unitless number. The exact meaning of the number is dependent on the overlay which defines the calculation. A calculation for [[Traffic Noise Overlay|traffic noise]] will present its result in decibels. A calculation for [[Subsidence Overlay|subsidence]] in meters.


==Using grid results==
==Using grid results==
The results of a grid overlay calculation can be used in multiple ways.
The results of a grid overlay calculation can be used in multiple ways.
===Visualization===
===Visualization===
The results of the overlay are displayed in the 3D world. By selecting the overlay in the session interface, the world will be colored based on the calculated values. This allows the end-user to inspect the results visually and geographically.
[[File:overlay_style_wms_arrow.png|thumb|right|Overlay visualized in QGIS with an additional parameter STYLES=ARROW]]
The results of the overlay are displayed in the [[3D Visualization]]. By selecting the overlay in the session interface, the overlay grid texture will be drawn on top of the height map and [[building]] models. This allows the end-user to inspect the results visually and geographically.


The legend displayed while the overlay is active can be configured to fit the magnitude and intent of the colors of the overlay.
The legend displayed while the overlay is active can be configured to fit the magnitude and intent of the colors of the overlay.
The overlay grid textures are obtained as images from the WMS endpoint of a [[session]]. A style parameter defined by the Grid Overlay's Result Type determines the way the Grid Data is drawn as an image.
The following styles can be used:
{|class=wikitable
!Style
!Description
|-
|INTERPOLATED
| The default style for most [[Grid Overlay]] result types.
|-
| NEAREST
| Used for descriptive result types that should not be interpolated. For example: [[Base types result type (Water Overlay)|base types result]]s, [[Ownership Grid Overlay|ownership]], [[Destinations result type (Travel Distance Overlay)|destination]]s and areas.
|-
| ARROW
| Used for [[Direction result type (Watershed Overlay)|directional]] result types.
|-
| COLOR
| Used for the [[Color result type (WMS Overlay)|WMS Color]] result.
|-
| FLOAT32
| Provides numerical data. Usable by [[WMS Overlay]]s as numerical input.
|-
| DIFFERENCE
| An additional style which visualizes a comparison between the CURRENT and MAQUETTE result of a Grid Overlay. The difference legend instead of the normal legend will be used for colorization.
|}


===TQL===
===TQL===
Line 27: Line 59:


===Export===
===Export===
The results can be exported as a [[geotiff]] file. This is a georeferenced image consisting of a grid of cells. Each cell has a value, which is displayed as a color on the spectrum of black to white. It's also possible to load a geotiff into a [[GIS]] application, allowing you to further process the results of the calculations performed in the {{software}}.
The results can be exported as a [[GeoTIFF]] or ASCII file, allowing you to further process the results of the calculations performed in the {{software}}.
{{Editor steps|title=export grid calculation results |Select any grid overlay in the editor.|On the [[right panel]], select "Export as GeoTiff".}}
See the article on [[Geo_Data#Export_raster_data|Geo data]] for more information.
 
The results can also be obtained by using the [[WMS]] endpoint of a [[project]] [[session]]. See also {{inlink|Visualization}} for the allowed styles.
 
===Save===
The results of the calculation can be saved in the form of an inactive copy of the overlay. This creates an exact duplicate of the overlay, including it's attributes, legend, and current results. The duplicate will be {{inlink|Active|inactive}}, so that when further calculations take place the duplicate still retains the results it had when it was created. The original overlay is unaffected, meaning if it was (still) active it would still be recalculated when new calculations take place. Because the duplicate is not active, saving an overlay will not affect the time it takes for the project to recalculate.
 
==Grid recalculation==
[[File:Update_now.JPG|thumb|right|Recalculate link]]
During a [[Test_Run| test run]], grids are automatically recalculated whenever a change is made to the state of the [[project]], including non-geographical data such as [[global]]s or [[attribute]]s. While editing, a grid is also updated when [[project]] data is changed and [[Calculation_panel#Auto-update_indicators|Auto-update]] is on. However, some parameters can be changed in the editor which cannot be changed during a session, such as the properties or attributes of overlays. To prevent more complex overlays slowing down editing work, a grid overlay is not always automatically recalculated when these kinds of parameters are changed. To force the grids to recalculate, the "Update Now" option can be used on any grid overlay. This will force all grids to recalculate.
 
Some overlays could be a delaying factor in the project. For more information see the [[troubleshooting]] page.
 
See also: [[How to force Grid Overlays to recalculate]].
 
===Delayed calculation===
During business hours ({{business hours}}), there is a maximum calculation time of 0.5 hour. If a calculation takes longer than that, it will time out after 1 hour. Outside of business hours, calculations will not time out. If necessary, it is possible to postpone the recalculation of overlays until after business hours.
 
See also: [[How to delay Grid Overlay calculations]].


==Settings==
==Settings==
Line 37: Line 87:


====Grid size====
====Grid size====
The more cells that need to be calculated, the more resources (and in the end: time) it will take to complete the calculation. Depending on the use-case and the calculation being performed, it may be desirable to change the grid size used for the grid overlays. The world is divvied up into cells of the specified size.
[[File:Select_send.jpg|thumb|right]]
The project data is rasterized with cells of the specified size. The more cells that need to be calculated, the more resources (and in the end: time) it will take to complete the calculation. Depending on the use-case and the calculation being performed, it may be desirable to change the grid size used for the grid overlays.  
To change the grid cell size, see [[How to adjust a project's Grid Settings|configuring grid settings]].
 
The maximum amount of cells any given overlay or result type can have is {{max cells}} individual cells. For any given overlay, this includes the results of all timeframes of that overlay.
Per project it is possible to have an [[Overlay]] with result types where the maximum amount of grid cells is {{max cells|group}} for the Overlay and the result types in total. You can have multiple Overlays + result type groups in your project. For example a [[Flooding Overlay]] with result types (max {{max cells|group}} grid cells) and also a [[Heat Overlay]] with result types (also max {{max cells|group}} grid cells). You can then for example add the [[Rainfall Overlay]] with result types (also max {{max cells|group}} grid cells) etc.
 
The maximum a mount of cells in a [[Project]] in total is {{max cells|project}} individual cells. This includes all timeframes of all Grid Overlays, both active and inactive. Exceeding this amount will prevent the {{software}} from performing any further calculations of the [[Project]] until the amount of cells is reduced.


''Note: if you select a grid size which does not neatly divide your project size, the south- and eastern edges of the project may not be covered by the grid, and not taken into account during a calculation.
''Note: if you select a grid size which does not neatly divide your project size, the south- and eastern edges of the project may not be covered by the grid, and not taken into account during a calculation.
Line 45: Line 102:


===Individual settings===
===Individual settings===
[[File:Change_color.jpg|thumb|right|Editing an overlay's legend]]
Each individual grid overlay also has a few settings which can be set per grid overlay. These settings should be tweaked based on the actual meaning, intent, and impact, of the displayed results.
Each individual grid overlay also has a few settings which can be set per grid overlay. These settings should be tweaked based on the actual meaning, intent, and impact, of the displayed results.


====Legend====
====Active====
The visualization of the grid overlay in the [[3D world]] can be changed by providing a legend for the grid overlay. The legend of a grid overlay consists of a list of values with related captions and colors. When that specific value is output by a grid cell, that grid cell is colored in the defined color. If the value lies between two defined values, the color will lie proportionally between the colors related to the defined values.
Whether the grid overlay is active or not. When an overlay is inactive, the output of the overlay is not recalculated when an update or recalculation takes place. This means the results calculated by a grid overlay can be stored and inspected in a project without the computational overhead of performing the underlying calculation anew. This also means that the overlay's output may not represent the most recent evaluation of the state of the project. Instead, this option can be used to create results based on multiple scenarios, and to compare those to one another or to calculations which are updated along with changes in the project.


====Difference option====
See also: [[How_to_set_an_Overlay_to_active_or_inactive|How to set an Overlay to active or inactive]].
Depending on the [[action]]s an end-user can take during a session, the difference between two [[maptype|states]] of a calculated overlay may not be directly visible. To help gain insight into the differences in the results of grid calculations, a grid overlay may be given a difference option. This means the end-user can activate a variant of the overlay which shows the amount of change between the original values, and the values resulting from the planned actions. This is effectively a separate grid with its own values, based on the actual calculation. The difference overlay can be further configured with its own legend.


==Configuring grid overlays==
====Legend====
{{Editor ribbon|header=Geo Data|bar=Overlays}}
The visualization of the grid overlay in the [[3D Visualization]] can be changed by providing a legend for the grid overlay. The legend of a grid overlay consists of a list of values with related captions and colors. When that specific value is output by a grid cell, that grid cell is colored in the defined color. If the value lies between two defined values, the color will lie proportionally between the colors related to the defined values.


===Configuring grid settings===
See also: [[How to configure a Grid Overlay's legend]].
When any grid overlay has been added to a project, it is possible to change the settings for the grid calculations. The grid settings are shared across all overlays, so adjusting the settings via one grid overlay will affect all grid overlays in the project.
{{Editor steps|title=configure the grid overlay settings|Select any grid overlay in the editor.|On the [[right panel]], select "Change Grid".|Change the cell size to the desired size.|Change accuracy threshold to the desired threshold.|Select "Send".}}
{{Editor steps|title=revert the grid overlay settings to default values|Select any grid overlay in the editor.|On the [[right panel]], select "Change Grid".|Select "Reset to Default".|Select "Send".}}


===Configuring grid legend and visualization===
====Difference option====
To start defining the visualization for the grid overlay, first activate the custom overlay function for the overlay.
Depending on the [[action]]s an end-user can take during a session, the difference between two [[Map Type|states]] of a calculated overlay may not be directly visible. To help gain insight into the differences in the results of grid calculations, a grid overlay may be given the option to inspect the difference in results between the [[Map Type|original]] and [[Map Type|planned situation]]. This means the end-user can activate a variant of the overlay which shows the amount of change between the original values, and the values resulting from the planned actions. This is effectively a separate grid with its own values, based on the actual calculation. The difference overlay can be further configured with its own legend. The difference result calculation is performed server side by providing the [[Grid Overlay#Visualization|DIFFERENCE style]] when requesting a grid overlay image.
{{Editor steps|title=activate the custom legend|Select the grid overlay you wish to configure in the editor.|On the [[right panel]], select the "Legend" tab.|Make sure "Has Custom Legend" is checked.}}


Next, make sure that each color or value you wish to use is defined in the list of legend items.
See also: [[How to enable the difference option for a Grid Overlay]].
{{Editor steps|title=add a new legend item|Select the grid overlay you wish to configure in the editor.|On the [[right panel]], select the "Legend" tab.|Select "Add" at the bottom of the [[right panel]].|The new legend item is now added with a value of 0.}}


{{Editor steps|title=remove legend item|Select the grid overlay you wish to configure in the editor.|On the [[right panel]], select the "Legend" tab.|Select the legend item you wish to remove.|Select "Remove" at the bottom of the [[right panel]].|The legend item is now removed.}}
{{Editor steps|title=edit a legend item|Select the grid overlay you wish to configure in the editor.|On the [[right panel]], select the "Legend" tab.|Select the legend item you wish to adjust.|Change the "value" to the value at which you want to show the color.<br>Note that the legend items are automatically sorted by value.|Click on the color dropdown and select the color you wish to show.|Change the text in the top input field of the legend item to change the caption for this color in the legend.}}
===Configuring difference option===
You can configure whether the end-user can activate a difference overlay or not on a per-overlay basis.
{{Editor steps|title=activate the difference option|Select the grid overlay in the editor.|On the [[right panel]], make sure "Show Difference Option" is checked.}}
{{Editor steps|title=deactivate the difference option|Select the grid overlay in the editor.|On the [[right panel]], make sure "Show Difference Option" is unchecked.}}
==Grid recalculation==
During a session, grids are automatically recalculated whenever a change is made to the state of the [[3D world]], including non-geographical data such as [[global]]s or [[attribute]]s. While editing, a grid is also updated when 3D world data is changed. However, some parameters can be changed in the editor which cannot be changed during a session, such as the properties or attributes of overlays. To prevent more complex overlays slowing down editing work, a grid overlay is not always automatically recalculated when these kinds of parameters are changed. To force the grids to recalculate, the "Refresh grid" option can be used on any grid overlay. This will force all grids to recalculate.


{{Editor steps|title=export grid calculation results |Select any grid overlay in the editor.|On the [[right panel]], select "Refresh Grid".}}
{{article end
|notes=
* The maximum amount of grid cells in a [[Project]] is also dependant on the license in which the [[Project]] is used, as well as the size of the [[Project]]'s extent.  
|howtos=
<div style="column-count:3">
*[[How to adjust a project's Grid Settings]]
*[[How to force Grid Overlays to recalculate]]
*[[How to delay Grid Overlay calculations]]
*[[How to configure a Grid Overlay's legend]]
*[[How to enable the difference option for a Grid Overlay]]
*[[How to use the Overlay Overview]]
*[[How to set an Overlay to active or inactive]]
* [[How to sort Overlays]]
*[[How to export a Grid Overlay as GeoJSON]]
*[[How to export a Grid Overlay as GeoTIFF]]
*[[How to export a Grid Overlay as ASCII]]
*[[How to export a Grid Overlay as png]]
*[[How to export a Grid Overlay to the GeoShare]]
* [[How to smooth Grid Overlay results]]
* [[How to fill NO DATA values in a grid overlay by interpolation using and Average Overlay]]
* [[How to create an Average Overlay based on another Grid Overlay]]
* [[How to create an overlay for visualizing your own geographical vector information]]
* [[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 create a traffic density Grid Overlay]]
* [[How to make a Grid Overlay of residence walls]]
* [[How to make a Grid Overlay of residences]]
* [[How to use a Grid Overlay to change the elevation model]]
* [[How to configure the Distance Zone Overlay to count features]]
</div>
}}
{{Overlay nav}}

Latest revision as of 12:21, 26 April 2024

A Grid Overlay is a calculated overlay. It uses a 2-dimensional grid for calculation, data storage and visualization. The calculation divides the entire project into a grid of equally sized square cells, with possible size per cell ranging from 0.25m² up to 100m², depending on the size of the project area. This amounts to anywhere from thousands to millions of cells per overlay.

For each cell, a calculation is performed, the specifics of which depend on the overlay being calculated. This can be as simple as displaying (possibly inherently) rasterized data, such as GeoTIFF Overlays or the heightmap, or as complex as multi-step rainfall calculations.

The results of a Grid Overlay can be inspected in the 3D Visualization, exported as a GeoTIFF, or queried using TQL.

Calculations

Depending on the exact overlay being calculated, the specifics of the calculation may differ, but the general approach is identical for each Overlay.

Each calculation relies on some data, which may be set as properties or attributes of the overlay, or may be based on the features present in an individual cell. This data is read from their respective locations as input for the calculation. Data from surrounding cells may also be included, in which their distance may also be factored in. If input for calculations may exist in multiple kinds of data, it depends on the exact calculation which data layer has preference. In general (for example, for attributes for an Average Overlay), the data layers are checked in the following order:

  1. Net Lines
  2. Addresses and Buildings
  3. Terrains
  4. Areas
  5. Neighborhoods
  6. Plots (Only for Ownership Grid Overlay)

With all the data obtained, a new values or set of values is calculated for the cell, and stored as result data for that cell. The calculation may specify this processing repeating a large number of times, for example when iterating through time steps.

When the calculation is completed, a final result value is stored in the cell. The value stored in the cell itself is a unitless number. The exact meaning of the number is dependent on the overlay which defines the calculation. A calculation for traffic noise will present its result in decibels. A calculation for subsidence in meters.

Using grid results

The results of a grid overlay calculation can be used in multiple ways.

Visualization

Overlay visualized in QGIS with an additional parameter STYLES=ARROW

The results of the overlay are displayed in the 3D Visualization. By selecting the overlay in the session interface, the overlay grid texture will be drawn on top of the height map and building models. This allows the end-user to inspect the results visually and geographically.

The legend displayed while the overlay is active can be configured to fit the magnitude and intent of the colors of the overlay.

The overlay grid textures are obtained as images from the WMS endpoint of a session. A style parameter defined by the Grid Overlay's Result Type determines the way the Grid Data is drawn as an image.

The following styles can be used:

Style Description
INTERPOLATED The default style for most Grid Overlay result types.
NEAREST Used for descriptive result types that should not be interpolated. For example: base types results, ownership, destinations and areas.
ARROW Used for directional result types.
COLOR Used for the WMS Color result.
FLOAT32 Provides numerical data. Usable by WMS Overlays as numerical input.
DIFFERENCE An additional style which visualizes a comparison between the CURRENT and MAQUETTE result of a Grid Overlay. The difference legend instead of the normal legend will be used for colorization.

TQL

The results of the calculation can be queries using TQL. Queries can either retrieve data of the grid directly, such as the average value in a given location, or use it as a filter for other queries, by specifying a value the grid should have before taking that location into account.

Export

The results can be exported as a GeoTIFF or ASCII file, allowing you to further process the results of the calculations performed in the Tygron Platform. See the article on Geo data for more information.

The results can also be obtained by using the WMS endpoint of a project session. See also Visualization for the allowed styles.

Save

The results of the calculation can be saved in the form of an inactive copy of the overlay. This creates an exact duplicate of the overlay, including it's attributes, legend, and current results. The duplicate will be inactive, so that when further calculations take place the duplicate still retains the results it had when it was created. The original overlay is unaffected, meaning if it was (still) active it would still be recalculated when new calculations take place. Because the duplicate is not active, saving an overlay will not affect the time it takes for the project to recalculate.

Grid recalculation

Recalculate link

During a test run, grids are automatically recalculated whenever a change is made to the state of the project, including non-geographical data such as globals or attributes. While editing, a grid is also updated when project data is changed and Auto-update is on. However, some parameters can be changed in the editor which cannot be changed during a session, such as the properties or attributes of overlays. To prevent more complex overlays slowing down editing work, a grid overlay is not always automatically recalculated when these kinds of parameters are changed. To force the grids to recalculate, the "Update Now" option can be used on any grid overlay. This will force all grids to recalculate.

Some overlays could be a delaying factor in the project. For more information see the troubleshooting page.

See also: How to force Grid Overlays to recalculate.

Delayed calculation

During business hours (9-17, GMT+1, during weekdays), there is a maximum calculation time of 0.5 hour. If a calculation takes longer than that, it will time out after 1 hour. Outside of business hours, calculations will not time out. If necessary, it is possible to postpone the recalculation of overlays until after business hours.

See also: How to delay Grid Overlay calculations.

Settings

Grid overlays offer a number of settings to configure them to fit your use-case.

Shared settings

The grid overlays share a few settings, which influence the accuracy of the calculations. Depending on the calculation performed and the use-case forming the project's context, it may be desirable to tweak the settings used for the grid overlays. For performance reasons it is not possible to set grid overlay settings to different values for different overlays in the same project.

Grid size

Select send.jpg

The project data is rasterized with cells of the specified size. The more cells that need to be calculated, the more resources (and in the end: time) it will take to complete the calculation. Depending on the use-case and the calculation being performed, it may be desirable to change the grid size used for the grid overlays. To change the grid cell size, see configuring grid settings.

The maximum amount of cells any given overlay or result type can have is 1 billion individual cells. For any given overlay, this includes the results of all timeframes of that overlay. Per project it is possible to have an Overlay with result types where the maximum amount of grid cells is 2 billion for the Overlay and the result types in total. You can have multiple Overlays + result type groups in your project. For example a Flooding Overlay with result types (max 2 billion grid cells) and also a Heat Overlay with result types (also max 2 billion grid cells). You can then for example add the Rainfall Overlay with result types (also max 2 billion grid cells) etc.

The maximum a mount of cells in a Project in total is 50 billion individual cells. This includes all timeframes of all Grid Overlays, both active and inactive. Exceeding this amount will prevent the Tygron Platform from performing any further calculations of the Project until the amount of cells is reduced.

Note: if you select a grid size which does not neatly divide your project size, the south- and eastern edges of the project may not be covered by the grid, and not taken into account during a calculation.

Grid Accuracy Threshold

As the grid size decreases (and thus more cells exist in the project), calculations will take longer to complete. Under normal circumstances, when a calculation is based on geographical parameters, all contents of the cell are checked and all objects relevant to the calculation are taken into consideration based on how much of the cell is covered by it. When the grid size falls below this threshold, the method for determining these parameters changes. Instead, the exact center of the cell is checked, and if relevant data is found it is taken into consideration as if it were present in the entire cell. This is less accurate, but allows the calculation to complete faster.

Individual settings

Editing an overlay's legend

Each individual grid overlay also has a few settings which can be set per grid overlay. These settings should be tweaked based on the actual meaning, intent, and impact, of the displayed results.

Active

Whether the grid overlay is active or not. When an overlay is inactive, the output of the overlay is not recalculated when an update or recalculation takes place. This means the results calculated by a grid overlay can be stored and inspected in a project without the computational overhead of performing the underlying calculation anew. This also means that the overlay's output may not represent the most recent evaluation of the state of the project. Instead, this option can be used to create results based on multiple scenarios, and to compare those to one another or to calculations which are updated along with changes in the project.

See also: How to set an Overlay to active or inactive.

Legend

The visualization of the grid overlay in the 3D Visualization can be changed by providing a legend for the grid overlay. The legend of a grid overlay consists of a list of values with related captions and colors. When that specific value is output by a grid cell, that grid cell is colored in the defined color. If the value lies between two defined values, the color will lie proportionally between the colors related to the defined values.

See also: How to configure a Grid Overlay's legend.

Difference option

Depending on the actions an end-user can take during a session, the difference between two states of a calculated overlay may not be directly visible. To help gain insight into the differences in the results of grid calculations, a grid overlay may be given the option to inspect the difference in results between the original and planned situation. This means the end-user can activate a variant of the overlay which shows the amount of change between the original values, and the values resulting from the planned actions. This is effectively a separate grid with its own values, based on the actual calculation. The difference overlay can be further configured with its own legend. The difference result calculation is performed server side by providing the DIFFERENCE style when requesting a grid overlay image.

See also: How to enable the difference option for a Grid Overlay.