Sight Distance Overlay: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
No edit summary
 
(29 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{learned|what the Distance Sight Overlay is|which information is displayed on the Distance Sight Overlay|}}
[[File:Distance_sight_overlay.jpg|right|thumb|Sight Distance Overlay]]
The [[Sight Distance Overlay]] is a [[Grid Overlay]] which combines the distance calculation of the [[Distance Overlay]] with a line-of-sight calculation. The [[Overlay]] calculates whether specific [[Grid cell]]s have a line of sight to [[Item]]s which define a distance zone around them, and if so will record the distance to any such [[Item]].
{{clear}}


==What the Distance Sight Overlay is==
==Configuration==
[[File:Sight_Distance_overlay.jpg|thumb|450px|left|Distance Sight Overlay]]
The Sight Distance Overlay's calculation model has a number of aspects which can be configured:
This Distance Sight Overlay combines the Distance Zone as defined by [[constructions]] with the direct line of sight for these constructions. The distance zone is always a circle situated around the affected construction(s). <br> The radius of this circle can be adjusted in the function value table.The Distance Sight Overlay becomes available for all stakeholders when added to a project. This overlay can be activated by clicking the corresponding icon on the minimap. When activated the Distance Sight Overlay displays 3 colors, red, yellow and green. Different colors mean different distances of the object with the distance zone to other objects in the 3D World.
* The distances to calculate the lines-of-sight across
* The height from which to compute the lines-of-sight


;Color Red
===Keys===
Nearby = - 217
A single [[Overlay Key]] can be defined. This defines which [[Attribute]] the Sight Distance Overlay should look for in data in the [[Project]]. When found, the [[Item]] on which it is found is considered a source for drawing a line-of-sight from. The value of that [[Attribute]] is the maximum distance a line-of-sight may extend from that [[Item]].
;Color Yellow
{{Overlay keys|suppresscategory=true|
Average distance = 0
  {{:Distance zone m (Sight Distance Overlay)}}
;Color Green
}}
Far away = 127
<br clear=all>


==Additional information displayed in hover panel==
===Attributes===
[[File:Distance_sight_hover.jpg|thumb|450px|left|The distance of the selected object which has a distance zone is displayed]]
The Sight Distance Overlay has one configurable model [[Attribute]] which defines a minimum height from which the line-of-sight should be calculated.
When clicking on a specific location on the map, the hover panel gives additional information of the distance from the clicked location to the object which has a distance zone.
{{overlay attributes|suppresscategory=true|allowselflinks=true|
<br clear=all>
{{:Distance zone m (Sight Distance Overlay)}}
{{:Attribute timeframes (Sight Distance Overlay)}}
{{:Observer height m (Sight Distance Overlay)}}
{{:Source height m (Sight Distance Overlay)}}
}}


==Adding and removing the Distance Sight Overlay==
==Calculation==
The Sight Distance Overlay performs a line-of-sight calculation between any two cells.


{{Editor ribbon|header=GEO DATA|bar=Overlays}}
For each [[Grid cell]], all other grid cells within a {{Max distance overlay}} meter radius are checked whether they are considered a source for a line-of-sight calculation. If so, all cells between the computed cell and the source cell are checked for their [[Digital surface model|computed height]]. If that height would block the line-of-sight between the source cell and computed cell, the check for that particular calculation ends. If the line-of-sight is uninterrupted for all intermediate cells, the value computed for the computed cell is the distance between the source and the computed cell.


{{Editor steps|title=add the Distance Sight Overlay|Select in the editor 'Geo Data' from the ribbon|Select 'Overlays' from the ribbon bar|Select the Distance Sight Overlay from the drop down menu}}
If multiple lines-of-sight are computed for any given cell, and thus multiple resulting distances are computed, the lowest distance is returned.
<br clear=all>
<gallery>
Image:Select_geodata.jpg|Select Geo Data
Image:Overlays_ribbon.jpg|Select Overlays
Image:Add_the_ds.jpg|Select the Distance Sight Overlay
</gallery>


{{Editor steps|title=remove the Distance Sight Overlay|Select in the editor 'Geo Data' from the ribbon|Select 'Overlays' from the ribbon bar|Select the Distance Sight 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}}
Cells without a computed line-of-sight to any source have a {{nodata}} value.
<gallery>
Image:Select_geodata.jpg|Select Geo Data
Image:Select_the_overlay.jpg|Select the desired overlay from the list in the [[right panel]]
Image:Remove_the_ds_overlay.jpg|Select Remove from the bottom of the [[left panel]]
Image:confirm_remove.jpg| Confirm the removal
</gallery>
==Modifying the Legend of the Distance Sight Overlay==
{{Editor ribbon|header=GEO DATA|bar=Overlays}}


{{Editor steps|title=Modify the Legend of the Distance Sight Overlay|Select the Distance Sight Overlay from list of overlays in the [[right panel]]| Select the Legend bar in the [[left panel]]| Notice the distance values with corresponding colors| Select the "Has Custom Legend" option| Select "Add" at the bottom of the [[left panel]]| A new Entry will appear | Edit the name, value and color of the new entry| Notice that the entry is automatically sorted}}
==Results==
<gallery>
The results of the [[Grid Overlay]] is a grid which shows, for each location, whether there is a line-of-sight to any [[Item]] configured to compute a line-of-sight from. And if so, what the minimum distance is to any such [[Item]].
Image:Select_the_overlay.jpg|Select Distance Sight Overlay
{{result types|
Image:Legend_bar.jpg|Select Legend bar
{{:Sight result type (Sight Distance Overlay)}}
Image:Has_custom_legend.jpg|Select "Has Custom Legend"
}}
Image:Add_new_entry.jpg|Add new entry
 
Image:New_entry.jpg|Edit the name, value and color of the entry
 
</gallery>
{{article end
<br clear=all>
|notes=
* Although the terminology implies a computation of whether it's possible to look out from a defined source onto an arbitrary location, the calculations are applicable in reverse as well. Lines-of-sight can also be interpreted as a consideration from which locations a defined source can be seen.
* Features including the [[Elevation model]], and the heights of [[Building]]s, are taken into consideration. However, [[Slanting roof height (Function Value)|slanting roof]]s, and [[Building]]s which are only composed of [[furniture]] such as wind turbines and trees, are explicitly ''not'' taken into account.
|howtos=
* [[How to add and remove an Overlay]]
* [[How to edit an overlay legend]]
|seealso=
* [[Average Overlay]]
* [[Distance Overlay]]
* [[Travel Distance Overlay]]
}}
 
{{SightDistanceOverlay nav}}
{{Overlay nav}}

Latest revision as of 15:50, 2 February 2024

Sight Distance Overlay

The Sight Distance Overlay is a Grid Overlay which combines the distance calculation of the Distance Overlay with a line-of-sight calculation. The Overlay calculates whether specific Grid cells have a line of sight to Items which define a distance zone around them, and if so will record the distance to any such Item.

Configuration

The Sight Distance Overlay's calculation model has a number of aspects which can be configured:

  • The distances to calculate the lines-of-sight across
  • The height from which to compute the lines-of-sight

Keys

A single Overlay Key can be defined. This defines which Attribute the Sight Distance Overlay should look for in data in the Project. When found, the Item on which it is found is considered a source for drawing a line-of-sight from. The value of that Attribute is the maximum distance a line-of-sight may extend from that Item.

Attributes

The Sight Distance Overlay has one configurable model Attribute which defines a minimum height from which the line-of-sight should be calculated.

Calculation

The Sight Distance Overlay performs a line-of-sight calculation between any two cells.

For each Grid cell, all other grid cells within a 2000 meter radius are checked whether they are considered a source for a line-of-sight calculation. If so, all cells between the computed cell and the source cell are checked for their computed height. If that height would block the line-of-sight between the source cell and computed cell, the check for that particular calculation ends. If the line-of-sight is uninterrupted for all intermediate cells, the value computed for the computed cell is the distance between the source and the computed cell.

If multiple lines-of-sight are computed for any given cell, and thus multiple resulting distances are computed, the lowest distance is returned.

Cells without a computed line-of-sight to any source have a NO_DATA value.

Results

The results of the Grid Overlay is a grid which shows, for each location, whether there is a line-of-sight to any Item configured to compute a line-of-sight from. And if so, what the minimum distance is to any such Item.


Notes

  • Although the terminology implies a computation of whether it's possible to look out from a defined source onto an arbitrary location, the calculations are applicable in reverse as well. Lines-of-sight can also be interpreted as a consideration from which locations a defined source can be seen.
  • Features including the Elevation model, and the heights of Buildings, are taken into consideration. However, slanting roofs, and Buildings which are only composed of furniture such as wind turbines and trees, are explicitly not taken into account.

How-to's

See also