Combo Overlay tutorial: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
mNo edit summary
Line 21: Line 21:


{{editor location|Overlays|dropdown=Custom|3=Combo}}
{{editor location|Overlays|dropdown=Custom|3=Combo}}
The [[Combo Overlay]] will, by itself, not show any significantly relevant results. This is because no inputs have yet been set, nor has a relevant formula been entered.


The [[Combo Overlay]] accepts a set of inputs, which are [[Grid Overlay]]s.
The [[Combo Overlay]] accepts a set of inputs, which are [[Grid Overlay]]s.
Set Grid Overlay A to the added Traffic Noise Overlay.
Next, set the formula to:
{{code|A}}
Then, click on ""Update now" to recalculate the [[Overlay]]s.
The result is that for each [[Grid Cell]], the value of the input Overlay A, which is set to the [[Traffic Noise Overlay]], is used directly as the result.
Notice that the [[legend]] of the [[Traffic Noise Overlay]] is directly applied as well. this is because the legend of the first input is automatically read out by the [[Combo Overlay]] as the default legend for the [[Combo Overlay]] itself.
Just like with the [[Traffic Noise Overlay]] itself, it is possible to click on any location in the [[3d visualization]] and see the exact value calculated there.
Using the [[combo Overlay]], it is possible to manupulate those calculated values. One often used principle is to "mask" data, which basically means to explicitly obscure or let through some values.
Modify the formula of the [[combo Overlay]], so that it reads as follows:
{{code|IF(GT(A,55),A,NO_DATA)}}
The formula now contains two logical operations, as well as a NO_DATA constant. The formula can be read as follows:
If ( IF ) it is true that A is greater than 55 ( GT ), in that case we use the value A. Otherwise, we return the value of NO_DATA, which is a constant meaning no value exists at that point.
Click on "Update now" to recalculate the [[Overlay]]s.
The results of the [[Combo Overlay]] have now changed. Only in the places where the [[Traffic Noise Overlay]] computed a noise level of more than 55 decibels have results now been retained. In all other locations, the results have been discarded.
===Rasterizing and combining data===
[[Combo Overlay]]s are, in and of themselves, effective tools for manipulating data. However, their effectiveness only goes as far as the input which can be provided to them. Therefor, it is also important to know how to turn other data in the {{software}} into [[Grid Overlay]]s as well.


===Notes===
===Notes===
* The legend of the first input is automatically read out by the [[Combo Overlay]] as the default legend. It is still possible to create a custom legend.
* The editor interface will generally present the first 3 inputs (A, B, and C) of the [[Combo Overlay]]. However, a total of 10 inputs can be added and used, by switching to the "inputs" tab.
* The editor interface will generally present the first 3 inputs (A, B, and C) of the [[Combo Overlay]]. However, a total of 10 inputs can be added and used, by switching to the "inputs" tab.
* It is possible to link multiple [[Combo Overlay]]s together by setting one as input for another. This way, intermediate results can be computed and presented, but also more complex calculations can be created and/or split up into managable sub-calculations.
* It is possible to link multiple [[Combo Overlay]]s together by setting one as input for another. This way, intermediate results can be computed and presented, but also more complex calculations can be created and/or split up into managable sub-calculations.

Revision as of 11:23, 23 May 2023

Prerequisites

The following prerequisites should be met before starting this tutorial:

  • This tutorial relies on base knowledge about the editor interface and the creation of Overlays. If you have not yet followed the tutorials related to those subjects please do so first.
  • This tutorial can be followed with any project of any arbitrary location, preferably with both roads and traintracks. 

Preparations

Take the following steps as preparation for following this tutorial:

  • Start your project. This can be a pre-existing project, or a newly created project.

Introduction to the Combo Overlay

The Combo Overlay is a Grid Overlay which allows for the creation of custom spatial calculation models. It is comparable to raster calculators which can be found in other GIS packages such as QGIs. The principle on which it operates is that for each grid cell, other Grid Overlays may provide values, and the combo Overlay uniformly applies a (simple or complex) formula to compute a new resulting value for that grid cell, and does so for all grid cells.

Creating a simple masking calculation

To get started with a Combo Overlay, it is basically always neccesary to have some other Grid Overlay in the same Project to run a calculation on.

Add a Traffic Noise Overlay.

Editor → Current Situation (Ribbon tab) → Overlays (Ribbon bar) → Environmental (Dropdown) → Traffic Noise

This Traffic Noise Overlay will serve as the primary input to work with. It computes results based on built-in formulas for noise from traffic. Although it's possible to tweak the inputs and the legend of the resulting Overlay, the principles of the calculation and the results thereof are immutable.

Add a Combo Overlay.

Editor → Current Situation (Ribbon tab) → Overlays (Ribbon bar) → Custom (Dropdown) → Combo

The Combo Overlay will, by itself, not show any significantly relevant results. This is because no inputs have yet been set, nor has a relevant formula been entered.

The Combo Overlay accepts a set of inputs, which are Grid Overlays.

Set Grid Overlay A to the added Traffic Noise Overlay.

Next, set the formula to:

A

Then, click on ""Update now" to recalculate the Overlays.

The result is that for each Grid Cell, the value of the input Overlay A, which is set to the Traffic Noise Overlay, is used directly as the result.

Notice that the legend of the Traffic Noise Overlay is directly applied as well. this is because the legend of the first input is automatically read out by the Combo Overlay as the default legend for the Combo Overlay itself.

Just like with the Traffic Noise Overlay itself, it is possible to click on any location in the 3d visualization and see the exact value calculated there.

Using the combo Overlay, it is possible to manupulate those calculated values. One often used principle is to "mask" data, which basically means to explicitly obscure or let through some values.

Modify the formula of the combo Overlay, so that it reads as follows:

IF(GT(A,55),A,NO_DATA)

The formula now contains two logical operations, as well as a NO_DATA constant. The formula can be read as follows:

If ( IF ) it is true that A is greater than 55 ( GT ), in that case we use the value A. Otherwise, we return the value of NO_DATA, which is a constant meaning no value exists at that point.

Click on "Update now" to recalculate the Overlays.

The results of the Combo Overlay have now changed. Only in the places where the Traffic Noise Overlay computed a noise level of more than 55 decibels have results now been retained. In all other locations, the results have been discarded.

Rasterizing and combining data

Combo Overlays are, in and of themselves, effective tools for manipulating data. However, their effectiveness only goes as far as the input which can be provided to them. Therefor, it is also important to know how to turn other data in the Tygron Platform into Grid Overlays as well.

Notes

  • The editor interface will generally present the first 3 inputs (A, B, and C) of the Combo Overlay. However, a total of 10 inputs can be added and used, by switching to the "inputs" tab.
  • It is possible to link multiple Combo Overlays together by setting one as input for another. This way, intermediate results can be computed and presented, but also more complex calculations can be created and/or split up into managable sub-calculations.