Trees and foliage tutorial: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
mNo edit summary
 
(54 intermediate revisions by the same user not shown)
Line 7: Line 7:
==Tree and foliage data in general==
==Tree and foliage data in general==
There are a number of use-cases in which having accurate green data is relevant. In urban development, green is become more and more of a required spatial aspect. But also for topics like biodiversity and heat stress the impact of the presence of green is significant. It is therefor important to have as accurate data as possible related to the presence of green in an urban environment for a variety of simulation use-cases.
There are a number of use-cases in which having accurate green data is relevant. In urban development, green is become more and more of a required spatial aspect. But also for topics like biodiversity and heat stress the impact of the presence of green is significant. It is therefor important to have as accurate data as possible related to the presence of green in an urban environment for a variety of simulation use-cases.
The {{software}} will, when a new [[Project]] of a real location is generated, automatically attempt to obtain open data about trees. However, depending on the use-case more accurate datasets may be required and available. In these cases, knowing how to properly manage data about trees (or foliage thereof) will improve the quality of calculations and thus the results.


For this tutorial, there will be a focus on using trees and foliage data with and for the [[Heat Overlay]], but the principles translate over to other use-cases as well.
For this tutorial, there will be a focus on using trees and foliage data with and for the [[Heat Overlay]], but the principles translate over to other use-cases as well.


==Preparation==
===Trees and foliage data in the {{software}}===
For the purpose of this tutorial, 2 datasets are needed, which can be obtained from the [[Demo Heat Stress Project]] as is. The [[Heat Overlay]] will also need to have one of its settings changed, both so that there is a baseline from which a change can be seen after the process completes, but also to correctly connect the [[Heat Overlay]] with the intended datasource.
In the {{software}}, trees are stored as a specific [[Function]] (or collection of [[Function]]s) of [[Building]]s. By default, the {{software}} generates trees with the [[Function]] of "Default decidiuous trees". Trees can exist as either small polygons (effectively points) to symbolize a single tree in a fixed location, or as a broader polygon to symbolize a group of trees (such as a treeline or a forest).
 
===Downloading trees data from the Project===
In the ribbon, ensure the "Current Situation" is selected.


In the "Buildings" dropdown, select "Export Geo Data".
The visualization of trees governed by a single [[Attribute]] or [[Function Value]]: [[Floor height m (Function Value)|FLOOR_HEIGHT_M]]. This [[Attribute]], in amounts of meters, will affect how tall the tree is visualized.


In the popup that appears, its possible to indicate which [[Building]]s data specifically needs to be exported.
For the [[Heat Overlay]], it isn't the trees data directly which is required for the calculations, but actually the foliage of the trees. The foliage casts significant shadows and thus affects the impact of solar radiation. By default, because there isn't a general datasource for foliage, the {{software}}'s [[Heat Overlay]] can instead derive an estimation of foliage from the trees data. This is done by effectively buffering the tree polygon with a certain amount of meters. That amount is determined by the [[Foliage crown factor (Function Value)|FOLIAGE_CROWN_FACTOR]], which is the ratio of foliage radius to tree height. This allows for a spatial dataset of foliage to be estimated based on the presence of trees.


Opt to export [[Building]]s with a specific Attribute by checking the "With Attribute" option.
For more information about how trees relate to the [[Heat Overlay]], consult the documentation:
* [[Foliage height calculation model (Heat Overlay)]]
* [[Shade calculation model (Heat Overlay)]]


As Attribute, select the [[Attribute]] [[Foliage crown factor (Function Value)|FOLIAGE_CROWN_FACTOR]]. This is an [[Attribute]] which is only associated with trees.
{{page break}}
 
==Preparation==
Opt to check for the value of the [[Attribute]], by t=checking the "With Value"  option as well.
For the purpose of this tutorial, 2 datasets are needed, which can be obtained from the [[Public Share]] as is. The [[Heat Overlay]] will also need to have one of its settings changed, both so that there is a baseline from which a change can be seen after the process completes, but also to correctly connect the [[Heat Overlay]] with the intended datasource.
 
Ensure the value check is set to X > 0. This will only export [[Building]]s which have a [[Foliage crown factor (Function Value)|FOLIAGE_CROWN_FACTOR]] of more than 0.
 
Find the export option "Download GeoJSON File", and click on "Export File".
 
Place the file somewhere on your computer where you will be able to find it again later.
 
The resulting GeoJSON file is one which contains all the trees from the [[Project]].


===Downloading foliage data from the Project===
===Obtaining trees and foliage data===
Go to:
{{editor location|geoshare|Public Share (top-right of the Geoshare window)}}


The [[Demo Heat Stress Project]] also contains a number of [[Overlay]]s which perform an estimation of foliage based on satellite imagery. The result is a specific [[Overlay]] with a foliage estimation, which can be downloaded as a separate file.
This provides access to the [[Public Share]].


In the ribbon, ensure the "Current Situation" is selected.
[[File:public-share-small.jpg|650px|frame|center|The Public Share.]]


Click on "Overlays", so the list of [[Overlay]]s appears in the [[left panel].
{{page break}}
Navigate to the following directory: tutorials/tutorial_trees_and_foliage/


Select the "Foliage Height" Overlay.
[[File:public-share-tutorial-trees-and-foliage-small.jpg|650px|frame|center|The Public Share offers a number of files relevant for this tutoruial.]]


In the [[right pane]], click on "Export Grid Data".
The "trees data" [[GeoJSON]] file contains a vector dataset with some tree data of the environment of the [[Demo Heat Stress Project]].


In the popup that appears, its possible to indicate how the grid data specifically needs to be exported.
The "foliage data" [[GeoTIFF]] file contains a grid dataset with information about foliage heights in and around the [[Demo Heat Stress Project]].


Leave all settings as they are. Find the option "Download GeoTIFF File", and click on "Export File".
{{page break}}
For all files, select them by clicking on them, and then access them by clicking on "Web Link". This will open the file in the web browser, and prompt a download.


Place the file somewhere on your computer where you will be able to find it again later.
[[File:public-share-tutorial-trees-and-foliage-weblink-highlight.jpg|350px|frame|center|The web link will open the file in the web browser, and either prompt a download or easily allow for a download.]]


The resulting GeoTIFF file is one which contains a grid of foliage from the [[Project]].
{{page break}}


===Clearing the Heat Overlay===
===Resetting foliage source of the Heat Overlay===
Finally, it is necessary to ensure the Heat Overlay now operates from a basis where it does not have any foliage information, so that the results of importing data can be verified.
Finally, it is necessary to ensure the Heat Overlay now operates from a basis where it does not have any foliage information, so that the results of importing data can be verified.


In the ribbon, ensure the "Current Situation" is selected.
Go to:


Click on "Overlays", so the list of [[Overlay]]s appears in the [[left panel].
{{editor location|overlay|PE Temperature}}


Select the "PE Temperature" Overlay.
[[File:tutorial trees pe temperature overlay-small.jpg|650px|frame|center|Select the PE Temperature Overlay.]]


In the [[right panel]], click on "Configuration Wizard". This opens the [[Heat Overlay Wizard (Heat Overlay)|Heat Overlay Wizard]].
In the [[right panel]], click on "Configuration Wizard". This opens the [[Heat Overlay Wizard (Heat Overlay)|Heat Overlay Wizard]].


[[File:tutorial trees pe temperature overlay wizard button.jpg|650px|frame|center|Open the Wizard by clicking the button.]]
{{page break}}
Continue to the step regarding Foliage.
Continue to the step regarding Foliage.
[[File:tutorial trees pe temperature overlay wizard step foliage.jpg|650px|frame|center|The step for foliage. In the demo it is set to refer to another Overlay.]]


Opt to use "Tree Functions" height and foliage crown factor.
Opt to use "Tree Functions" height and foliage crown factor.
[[File:tutorial trees pe temperature overlay wizard step foliage2.jpg|650px|frame|center|Change the setting to refer to the tree Functions.]]


Close the Configuration Wizard.
Close the Configuration Wizard.


{{page break}}
Click on "Update now" in the [[right panel]] to force the Overlay to recalculate.
Click on "Update now" in the [[right panel]] to force the Overlay to recalculate.
[[File:tutorial trees pe temperature overlay update now highlight.jpg|650px|frame|center|Click on "Update now" to recalculate all [[Overlay]]s in the Project.]]


Notice the results for the Project have changed. This is because the calculation now relies on a different dataset.
Notice the results for the Project have changed. This is because the calculation now relies on a different dataset.
[[File:tutorial trees pe temperature overlay result 0-small.jpg|650px|frame|center|The results of the [[Heat Overlay]] now that we changed the foliage setting.]]
{{page break}}


==Using trees data==
==Using trees data==
Line 81: Line 92:
Before new trees data can be imported, the existing trees data should be removed. Otherwise, the original data may persist together with the new to-be-imported data, and throw off the results of calculations relying on the trees.
Before new trees data can be imported, the existing trees data should be removed. Otherwise, the original data may persist together with the new to-be-imported data, and throw off the results of calculations relying on the trees.


In the ribbon, ensure the "Current Situation" is selected.
Go to:
 
{{editor location|Buildings|dropdown=Edit multiple Buildings}}


In the "Buildings" dropdown, select "Select Multiple Buildings".
[[File:tutorial trees select multiple buildings.jpg|650px|frame|center|Find the "Select Multiple Buildings" option.]]


In the [[bottom panel]], an interface now allows for the mass-manipulation of multiple [[Building]]s at the same time, based on [[Function]] and extent.
In the [[bottom panel]], an interface now allows for the mass-manipulation of multiple [[Building]]s at the same time, based on [[Function]] and extent.


[[File:tutorial trees select multiple buildings bp.jpg|650px|frame|center|The panel which appears at the bottom of the screen.]]
{{page break}}
As category, select "Specific Function".
As category, select "Specific Function".


As Function, select "Default Decidiuous Trees". This is the default type of trees and means this operation will only affect trees.
As Function, select "Default Decidiuous Trees". This is the default type of trees and means this operation will only affect trees.
[[File:tutorial trees function select trees-small.jpg|650px|frame|center|Find "Default Decidiuous Trees" in the "Nature" category.]]


As action, select "REMOVE"
As action, select "REMOVE"


[[File:tutorial trees select multiple buildings bp2.jpg|650px|frame|center|The configured action for multiple Buildings.]]
{{page break}}
Click on "Entire Map"
Click on "Entire Map"
[[File:tutorial trees select multiple buildings bp entire map.jpg|350px|frame|center|Use the "Entire Map"option to clear the applicable Buildings everywhere in the Project.]]


A prompt will appear. Confirming it will delete the 160 or so trees from the Project, leaving it without any trees data.
A prompt will appear. Confirming it will delete the 160 or so trees from the Project, leaving it without any trees data.


[[File:tutorial trees select multiple buildings confirm.jpg|350px|frame|center|The confirmation prompt to perform the operation.]]
{{editor location|Overlay|PE Temperature}}
Click on "Update now" in the [[right panel]] to force the Overlay to recalculate.
[[File:tutorial trees pe temperature overlay update now highlight.jpg|650px|frame|center|Use this option again to recalculate all Overlays.]]
{{page break}}
Notice the results for the entire Project are now significantly hot. This is because there is now no foliage data for the [[Heat Overlay]] to work with.
[[File:tutorial trees pe temperature overlay result 1-small.jpg|650px|frame|center|The results of the PE Temperature Overlay after removing the trees, thus leaving the simulation without foliage.]]
{{page break}}
===Importing trees data===
===Importing trees data===
In the ribbon, ensure the "Current Situation" is selected.


In the "Buildings" dropdown, select "Import Geo Data". This opens the [[Geo Data Wizard]].
Go to:


{{editor location|buildings|dropdown=Import Geo data}}
This opens the [[Geo Data Wizard]].
[[File:tutorial trees geo import.jpg|650px|frame|center|Find the "Geo Data Import" option for [[Building]]s.]]
{{page break}}
As import method, select "GeoJSON file".
As import method, select "GeoJSON file".


[[File:tutorial trees geo import1-small.jpg|650px|frame|center|Select "GeoJSON file".]]
{{page break}}
As GeoJSON file, click on "select local file". Select the previously downloaded trees geojson file.
As GeoJSON file, click on "select local file". Select the previously downloaded trees geojson file.


[[File:tutorial trees geo import2-small.jpg|650px|frame|center|Select the GeoJSON file you downloaded previously.]]
{{page break}}
Take note of the "View features" step, where the locations of all trees are shown.
Take note of the "View features" step, where the locations of all trees are shown.
[[File:tutorial trees geo import3-small.jpg|650px|frame|center|View the features to confirm whether the dataset is correct and where to expect the (new) data.]]


Also take note of the "buffer size" slider. when the dataset consists of points, all points will be buffered with the size indicated by the slider. By default all such points end up as polygons of exactly 1m² in size. Any polygons in the dataset will remain as-is.
Also take note of the "buffer size" slider. when the dataset consists of points, all points will be buffered with the size indicated by the slider. By default all such points end up as polygons of exactly 1m² in size. Any polygons in the dataset will remain as-is.


{{page break}}
Skip through the step for filtering features (all features are desired), adding or updating features (the default is to add, which is what we nat to do), and the naming scheme (names are not relevant for calculations).
Skip through the step for filtering features (all features are desired), adding or updating features (the default is to add, which is what we nat to do), and the naming scheme (names are not relevant for calculations).


[[File:tutorial trees geo import4-small.jpg|150px|frame|center|Filtering allows a subset of features to be imported, which is useful if the dataset contains, for example, removed trees as well.]]
[[File:tutorial trees geo import5-small.jpg|150px|frame|center|Naming of the resulting features is not relevant for the purpose of calculations.]]
{{page break}}
In the "Select Attributes" step, take note of the [[Attribute]] [[Floor height m (Function Value)|FLOOR_HEIGHT_M]]. This [[Attribute]] determines the height of the trees which are imported. If the dataset of trees has a different [[Attribute]] which indicates the tree height of features, find that [[Attribute]] in the list of [[Attribute] names, and then edit the name of the [[Attribute]] as it is imported using the text input fields in the middle of the screen.
In the "Select Attributes" step, take note of the [[Attribute]] [[Floor height m (Function Value)|FLOOR_HEIGHT_M]]. This [[Attribute]] determines the height of the trees which are imported. If the dataset of trees has a different [[Attribute]] which indicates the tree height of features, find that [[Attribute]] in the list of [[Attribute] names, and then edit the name of the [[Attribute]] as it is imported using the text input fields in the middle of the screen.
[[File:tutorial trees geo import6 highlight-small.jpg|150px|frame|center|Take special note that whichever attribute represents the height of trees is imported as FLOOR_HEIGHT_M.]]


{{page break}}
In the "Assign Functions" step, keep "One Function" selected, and click on "Select" to select the default function.
In the "Assign Functions" step, keep "One Function" selected, and click on "Select" to select the default function.


Select "Default Decidiuous Trees", and continue to the next step.
Select "Default Decidiuous Trees", and continue to the next step.
[[File:tutorial trees geo import7-small.jpg|650px|frame|center|Select the appropriate tree Function.]]


{{page break}}
For the "Owner", select the Municipality.
For the "Owner", select the Municipality.
[[File:tutorial trees geo import8-small.jpg|650px|frame|center|The Municipal stakeholder is a good default for most import operations.]]


Continue to the last step of the Wizard and click on "Finalize" to add the data to the [[Project]].
Continue to the last step of the Wizard and click on "Finalize" to add the data to the [[Project]].


In the ribbon, ensure the "Current Situation" is selected.
Go to:


Click on "Overlays", so the list of [[Overlay]]s appears in the [[left panel].
{{editor location|Overlay|PE Temperature}}


Select the "PE Temperature" Overlay.
Click on "Update now" in the [[right panel]] to force the Overlay to recalculate.


Click on "Update now" in the [[right panel]] to force the Overlay to recalculate.
[[File:tutorial trees pe temperature overlay update now highlight.jpg|650px|frame|center|Recalculate all [[Overlay]]s in the Project again.]]


{{page break}}
Notice that in the areas where tree data was loaded in, the calculated temperature has dropped significantly.
Notice that in the areas where tree data was loaded in, the calculated temperature has dropped significantly.
[[File:tutorial trees pe temperature overlay result 2-small.jpg|650px|frame|center|The results of this data are especially notable outside the city centre, as that is where the data exists.]]


Also inspect the "Foliage" child Overlay of the [[Heat Overlay]], which shows the presence of foliage.
Also inspect the "Foliage" child Overlay of the [[Heat Overlay]], which shows the presence of foliage.


==Importing foliage grid data==
[[File:tutorial trees pe temperature overlay result foliage1-small.jpg|650px|frame|center|The locations of foliage can be seen to better understand the results of the calculation.]]
 
{{page break}}
==Using foliage grid data==
Instead of relying on point data for trees, from which the {{software}} then extrapolates foliage coverage, it is also possible to supply a dataset of foliage directly. This is a grid of foliage heights which the [[Heat Overlay]] can then use for its calculations.
Instead of relying on point data for trees, from which the {{software}} then extrapolates foliage coverage, it is also possible to supply a dataset of foliage directly. This is a grid of foliage heights which the [[Heat Overlay]] can then use for its calculations.


In the ribbon, ensure the "Current Situation" is selected.
===Importing foliage grid data===
 
{{editor location|Overlays|dropdown=Custom, GeoTIFF Overlay}}


Move over "Overlays", so the dropdown appears. In the dropdown, move over "Custom", and then select "GeoTiff" Overlay.
[[File:tutorial trees add geotiff overlay.jpg|650px|frame|center|Adding a new [[GeoTIFF Overlay]] from the dropdown.]]


A GeoTiff Overlay is now added to the list of Overlays, and selected.
A GeoTiff Overlay is now added to the list of Overlays, and selected.
Line 145: Line 215:
In the [[right panel]], switch to the "TIFFs" tab.
In the [[right panel]], switch to the "TIFFs" tab.


At the bottom of the [[right pane]], click on "Add".
[[File:tutorial trees tiffs tab.jpg|350px|frame|center|The TIFFs tab.]]
 
{{page break}}
At the bottom of the [[right panel]], click on "Add".
 
[[File:tutorial trees tiffs add.jpg|350px|frame|center|Click on "Add" to add GeoTIFFs to the Overlay to display.]]


A window appears which can be used to manage [[GeoTiff]] assets in a [[Project]].
A window appears which can be used to manage [[GeoTiff]] assets in a [[Project]].


[[File:tutorial trees tiff manager-small.jpg|350px|frame|center|This screen allows for managing all GeoTIFFs uploaded to the Project.]]
{{page break}}
Click on "Add local file", and select the previously downloaded GeoTIFF file.
Click on "Add local file", and select the previously downloaded GeoTIFF file.
[[File:tutorial trees tiff manager add local.jpg|350px|frame|center|Add local file allows the uploading of a file from the computer to the Project.]]


(Note that if the import of the file fails because you're working directly in the Demo Project, you can continue the rest of the steps with the already present "filteredtrees.tiff")
(Note that if the import of the file fails because you're working directly in the Demo Project, you can continue the rest of the steps with the already present "filteredtrees.tiff")
Line 155: Line 235:
Select the imported tiff in the listing, and click "Ok".
Select the imported tiff in the listing, and click "Ok".


[[File:tutorial trees tiff manager2-small.jpg|350px|frame|center|After the import completes, the GeoTIFF can be selected and confirmed.]]
{{page break}}
The tiff is now added to the listing.
The tiff is now added to the listing.


[[File:tutorial trees tiff list.jpg|350px|frame|center|The GeoTIFF is added to the Overlay.]]
{{page break}}
===Connecting foliage grid to Heat Overlay===
===Connecting foliage grid to Heat Overlay===


In the ribbon, ensure the "Current Situation" is selected.
Go to:


Click on "Overlays", so the list of [[Overlay]]s appears in the [[left panel].
{{editor location|Overlays|PE Temperature}}
 
Select the "PE Temperature" Overlay.


In the [[right panel]], click on "Configuration Wizard". This opens the [[Heat Overlay Wizard (Heat Overlay)|Heat Overlay Wizard]].
In the [[right panel]], click on "Configuration Wizard". This opens the [[Heat Overlay Wizard (Heat Overlay)|Heat Overlay Wizard]].


Continue to the step regarding Foliage.
Continue to the step regarding Foliage.
[[File:tutorial trees pe temperature overlay wizard step foliage2.jpg|650px|frame|center|The foliage step of the Heat Overlay's configuration wizard.]]


Opt to use a Grid Overlay to define the Foliage.
Opt to use a Grid Overlay to define the Foliage.


[[File:tutorial trees pe temperature overlay wizard step foliage.jpg|650px|frame|center|Change the configuration to refer to a Grid Overlay.]]
{{page break}}
In the next step, select the newly added "GeoTIFF", which contains the foliage data.
In the next step, select the newly added "GeoTIFF", which contains the foliage data.
[[File:tutorial trees foliage pe temperature overlay wizard step foliage3.jpg|650px|frame|center|Select the [[GeoTIFF Overlay]] added earlier.]]


Close the Wizard, and click on "Update now" in the [[right panel]].
Close the Wizard, and click on "Update now" in the [[right panel]].


[[File:tutorial trees pe temperature overlay update now highlight.jpg|650px|frame|center|Again recalculate all [[Overlay]]s.]]
{{page break}}
Notice that in the areas with more foliage coverage according to the tiff, the calculated temperature has dropped significantly.
Notice that in the areas with more foliage coverage according to the tiff, the calculated temperature has dropped significantly.
[[File:tutorial trees pe temperature overlay result 2-small.jpg|650px|frame|center|The temperature across the Project has changed.]]


Also inspect the "Foliage" child Overlay of the [[Heat Overlay]], which shows the presence of foliage.
Also inspect the "Foliage" child Overlay of the [[Heat Overlay]], which shows the presence of foliage.
[[File:tutorial trees pe temperature overlay result foliage1-small.jpg|650px|frame|center|The map of foliage is a lot more detailed.]]


{{Tutorial completed
{{Tutorial completed
| learned=how to import trees and foliage data, with an emphasis for use with the [[Heat Overlay]].
| learned=how to import trees and foliage data, with an emphasis for use with the [[Heat Overlay]]
}}
}}

Latest revision as of 12:51, 16 May 2023

Prerequisites

The following prerequisites should be met before starting this tutorial:

  • The tutorial makes use of the Demo Heat Stress Project. If possible, a copy should be created because one of the steps involves uploading a new file. If this is undesirable, a file already present in the Project can be used. 

Preparations

Take the following steps as preparation for following this tutorial:

Tree and foliage data in general

There are a number of use-cases in which having accurate green data is relevant. In urban development, green is become more and more of a required spatial aspect. But also for topics like biodiversity and heat stress the impact of the presence of green is significant. It is therefor important to have as accurate data as possible related to the presence of green in an urban environment for a variety of simulation use-cases.

The Tygron Platform will, when a new Project of a real location is generated, automatically attempt to obtain open data about trees. However, depending on the use-case more accurate datasets may be required and available. In these cases, knowing how to properly manage data about trees (or foliage thereof) will improve the quality of calculations and thus the results.

For this tutorial, there will be a focus on using trees and foliage data with and for the Heat Overlay, but the principles translate over to other use-cases as well.

Trees and foliage data in the Tygron Platform

In the Tygron Platform, trees are stored as a specific Function (or collection of Functions) of Buildings. By default, the Tygron Platform generates trees with the Function of "Default decidiuous trees". Trees can exist as either small polygons (effectively points) to symbolize a single tree in a fixed location, or as a broader polygon to symbolize a group of trees (such as a treeline or a forest).

The visualization of trees governed by a single Attribute or Function Value: FLOOR_HEIGHT_M. This Attribute, in amounts of meters, will affect how tall the tree is visualized.

For the Heat Overlay, it isn't the trees data directly which is required for the calculations, but actually the foliage of the trees. The foliage casts significant shadows and thus affects the impact of solar radiation. By default, because there isn't a general datasource for foliage, the Tygron Platform's Heat Overlay can instead derive an estimation of foliage from the trees data. This is done by effectively buffering the tree polygon with a certain amount of meters. That amount is determined by the FOLIAGE_CROWN_FACTOR, which is the ratio of foliage radius to tree height. This allows for a spatial dataset of foliage to be estimated based on the presence of trees.

For more information about how trees relate to the Heat Overlay, consult the documentation:

Preparation

For the purpose of this tutorial, 2 datasets are needed, which can be obtained from the Public Share as is. The Heat Overlay will also need to have one of its settings changed, both so that there is a baseline from which a change can be seen after the process completes, but also to correctly connect the Heat Overlay with the intended datasource.

Obtaining trees and foliage data

Go to:

Editor → Current Situation (Ribbon tab) → Geo Import (Ribbon bar) → Geo Share (Dropdown) → Public Share (top-right of the Geoshare window) (Window)

This provides access to the Public Share.

The Public Share.

Navigate to the following directory: tutorials/tutorial_trees_and_foliage/

The Public Share offers a number of files relevant for this tutoruial.

The "trees data" GeoJSON file contains a vector dataset with some tree data of the environment of the Demo Heat Stress Project.

The "foliage data" GeoTIFF file contains a grid dataset with information about foliage heights in and around the Demo Heat Stress Project.

For all files, select them by clicking on them, and then access them by clicking on "Web Link". This will open the file in the web browser, and prompt a download.

The web link will open the file in the web browser, and either prompt a download or easily allow for a download.

Resetting foliage source of the Heat Overlay

Finally, it is necessary to ensure the Heat Overlay now operates from a basis where it does not have any foliage information, so that the results of importing data can be verified.

Go to:

Editor → Current Situation (Ribbon tab) → Overlays (Ribbon bar) → PE Temperature (Left panel)
Select the PE Temperature Overlay.

In the right panel, click on "Configuration Wizard". This opens the Heat Overlay Wizard.

Open the Wizard by clicking the button.

Continue to the step regarding Foliage.

The step for foliage. In the demo it is set to refer to another Overlay.

Opt to use "Tree Functions" height and foliage crown factor.

Change the setting to refer to the tree Functions.

Close the Configuration Wizard.

Click on "Update now" in the right panel to force the Overlay to recalculate.

Click on "Update now" to recalculate all Overlays in the Project.

Notice the results for the Project have changed. This is because the calculation now relies on a different dataset.

The results of the Heat Overlay now that we changed the foliage setting.

Using trees data

An accurate dataset of trees will allow for an accurate counting of surface area used for the purposes of urban green. It can also be used by models such as the Heat Overlay to extrapolate foliage from, which affects the calculations for heat stress.

Removing existing trees from the Project

Before new trees data can be imported, the existing trees data should be removed. Otherwise, the original data may persist together with the new to-be-imported data, and throw off the results of calculations relying on the trees.

Go to:

Editor → Current Situation (Ribbon tab) → Buildings (Ribbon bar) → Edit multiple Buildings (Dropdown)
Find the "Select Multiple Buildings" option.

In the bottom panel, an interface now allows for the mass-manipulation of multiple Buildings at the same time, based on Function and extent.

The panel which appears at the bottom of the screen.

As category, select "Specific Function".

As Function, select "Default Decidiuous Trees". This is the default type of trees and means this operation will only affect trees.

Find "Default Decidiuous Trees" in the "Nature" category.

As action, select "REMOVE"

The configured action for multiple Buildings.

Click on "Entire Map"

Use the "Entire Map"option to clear the applicable Buildings everywhere in the Project.

A prompt will appear. Confirming it will delete the 160 or so trees from the Project, leaving it without any trees data.

The confirmation prompt to perform the operation.
Editor → Current Situation (Ribbon tab) → Overlays (Ribbon bar) → PE Temperature (Left panel)

Click on "Update now" in the right panel to force the Overlay to recalculate.

Use this option again to recalculate all Overlays.

Notice the results for the entire Project are now significantly hot. This is because there is now no foliage data for the Heat Overlay to work with.

The results of the PE Temperature Overlay after removing the trees, thus leaving the simulation without foliage.

Importing trees data

Go to:

Editor → Current Situation (Ribbon tab) → Buildings (Ribbon bar) → Import Geo data (Dropdown)

This opens the Geo Data Wizard.

Find the "Geo Data Import" option for Buildings.

As import method, select "GeoJSON file".

Select "GeoJSON file".

As GeoJSON file, click on "select local file". Select the previously downloaded trees geojson file.

Select the GeoJSON file you downloaded previously.

Take note of the "View features" step, where the locations of all trees are shown.

View the features to confirm whether the dataset is correct and where to expect the (new) data.

Also take note of the "buffer size" slider. when the dataset consists of points, all points will be buffered with the size indicated by the slider. By default all such points end up as polygons of exactly 1m² in size. Any polygons in the dataset will remain as-is.

Skip through the step for filtering features (all features are desired), adding or updating features (the default is to add, which is what we nat to do), and the naming scheme (names are not relevant for calculations).

Filtering allows a subset of features to be imported, which is useful if the dataset contains, for example, removed trees as well.
Naming of the resulting features is not relevant for the purpose of calculations.

In the "Select Attributes" step, take note of the Attribute FLOOR_HEIGHT_M. This Attribute determines the height of the trees which are imported. If the dataset of trees has a different Attribute which indicates the tree height of features, find that Attribute in the list of [[Attribute] names, and then edit the name of the Attribute as it is imported using the text input fields in the middle of the screen.

Take special note that whichever attribute represents the height of trees is imported as FLOOR_HEIGHT_M.

In the "Assign Functions" step, keep "One Function" selected, and click on "Select" to select the default function.

Select "Default Decidiuous Trees", and continue to the next step.

Select the appropriate tree Function.

For the "Owner", select the Municipality.

The Municipal stakeholder is a good default for most import operations.

Continue to the last step of the Wizard and click on "Finalize" to add the data to the Project.

Go to:

Editor → Current Situation (Ribbon tab) → Overlays (Ribbon bar) → PE Temperature (Left panel)

Click on "Update now" in the right panel to force the Overlay to recalculate.

Recalculate all Overlays in the Project again.

Notice that in the areas where tree data was loaded in, the calculated temperature has dropped significantly.

The results of this data are especially notable outside the city centre, as that is where the data exists.

Also inspect the "Foliage" child Overlay of the Heat Overlay, which shows the presence of foliage.

The locations of foliage can be seen to better understand the results of the calculation.

Using foliage grid data

Instead of relying on point data for trees, from which the Tygron Platform then extrapolates foliage coverage, it is also possible to supply a dataset of foliage directly. This is a grid of foliage heights which the Heat Overlay can then use for its calculations.

Importing foliage grid data

Editor → Current Situation (Ribbon tab) → Overlays (Ribbon bar) → Custom, GeoTIFF Overlay (Dropdown)
Adding a new GeoTIFF Overlay from the dropdown.

A GeoTiff Overlay is now added to the list of Overlays, and selected.

In the right panel, switch to the "TIFFs" tab.

The TIFFs tab.

At the bottom of the right panel, click on "Add".

Click on "Add" to add GeoTIFFs to the Overlay to display.

A window appears which can be used to manage GeoTiff assets in a Project.

This screen allows for managing all GeoTIFFs uploaded to the Project.

Click on "Add local file", and select the previously downloaded GeoTIFF file.

Add local file allows the uploading of a file from the computer to the Project.

(Note that if the import of the file fails because you're working directly in the Demo Project, you can continue the rest of the steps with the already present "filteredtrees.tiff")

Select the imported tiff in the listing, and click "Ok".

After the import completes, the GeoTIFF can be selected and confirmed.

The tiff is now added to the listing.

The GeoTIFF is added to the Overlay.

Connecting foliage grid to Heat Overlay

Go to:

Editor → Current Situation (Ribbon tab) → Overlays (Ribbon bar) → PE Temperature (Left panel)

In the right panel, click on "Configuration Wizard". This opens the Heat Overlay Wizard.

Continue to the step regarding Foliage.

The foliage step of the Heat Overlay's configuration wizard.

Opt to use a Grid Overlay to define the Foliage.

Change the configuration to refer to a Grid Overlay.

In the next step, select the newly added "GeoTIFF", which contains the foliage data.

Select the GeoTIFF Overlay added earlier.

Close the Wizard, and click on "Update now" in the right panel.

Again recalculate all Overlays.

Notice that in the areas with more foliage coverage according to the tiff, the calculated temperature has dropped significantly.

The temperature across the Project has changed.

Also inspect the "Foliage" child Overlay of the Heat Overlay, which shows the presence of foliage.

The map of foliage is a lot more detailed.

Tutorial completed

Congratulations. You have now completed this tutorial. In it, you have learned how to import trees and foliage data, with an emphasis for use with the Heat Overlay.