Handout Quickstart: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
No edit summary
 
(56 intermediate revisions by 6 users not shown)
Line 1: Line 1:
This handout can be used for a quickstart training about the {{software}}.
This handout can be used for a quickstart training on the basics of the {{software}}.
{{clear}}
{{clear}}
'''How to use:''' Advise is to print this handout and use it during the advanced training to take notes on. Afterwards, you will have a summart of what you have learned during the training. {{clear}}
'''How to use:''' Advice is to print this handout and use it during the training to take notes. Afterwards, you will have a summary of what you have learned during the training.
'''Note:''' This handout is not a complete standalone tutorial but provides a guide for during a training. To learn more about the  
'''Project:''' The steps in the handout can be applied on any project. {{clear}}
'''Note:''' This handout is not a complete standalone tutorial but provides a guide during a training. For a tutorial on the subjects in this handout see the [[Demo_Basics_Project_0|Demo Basics project]], the [[New Project Wizard]] page and the [[Account management]] pages.


{{clear}}
{{clear}}
The subjects in this hand out are:
The subjects in this hand out are:
* Domain management
* Domain management
* Create new project
* Create a new project
* Save, versions and user rights and User interface
* Save, versions and user rights and user interface
* Overlays
* Overlays
* Buildings
* Buildings
Line 16: Line 17:
===Domain management===
===Domain management===
* Log in with your user name and password on the {{software}}, the [[Roadmap#engine.tygron.com_.28Long_Term_Support.29|LTS]].
* Log in with your user name and password on the {{software}}, the [[Roadmap#engine.tygron.com_.28Long_Term_Support.29|LTS]].
* Click in the main menu on Options. When you are domain manager, you will see more options since you have extra rights such as adding new users and removing projects from the domain.
* Click in the [[Main_Menu|main menu]] on Options. When you are [[Domain_Admin_(User_Account_Type)|domain admin]], you will see more options since you have extra rights such as [[How_to_add_a_User|adding new users]] and removing projects from the domain.
[[File:Options_main_menu.png]]
* Click on My Account. In this menu you can change the (automatically generated) password.
* Click on My Account. In this menu you can change the (automatically generated) password.
* You can also change the rights of projects which you have created. A project can have read rights (right to only open the project, but not save edits), writhe (rights to edit and save edits) and none (the project is not visible for users and they cannot access it). Also it is possible to change the version of your project.
* You can also change the rights of projects which you have created. A project can have Read rights (right to open the project and edit, but not save edits), Write (right to edit and save edits) and None (the project is not visible for other users and they cannot access it). It is also possible to change the [[Version_Control|version]] of your project.
[[File:My_account_main_menu.png]]
{{page break}}


=== Create New Project ===
=== Create a New Project ===
* Click in the [[Main_Menu|Main Menu]] on New Project
* Click in the [[Main_Menu|Main Menu]] on New Project
[[File:New_project_main_menu_handout.PNG]]
[[File:New_project_main_menu_handout.PNG]]
* Provide a name for the New Project (max 20 characters) and click on Empty Project.  
* Provide a name for the New Project (max 20 characters) and click on Empty Project.  
[[File:Name_new_project_handout.png|500px]]
[[File:Name_new_project_handout.png|500px]]
* For the location, fill in a location of your choice and click on Enter. Move the square with the left mouse button. The area of the map in the square will be your 3D world. With the sliders on the right side, it is possible to enlarge the square. However, the smaller the square is, the faster the 3D world will be generated. For the following steps, choose a size of max 2 x 2 km.  
* For the location, fill in a location of your choice and click on Enter. Move the square with the left mouse button. The area of the map in the square will be your [[project area]]. With the sliders on the right side, it is possible to enlarge the square. However, the smaller the square is, the faster the [[project]] will be generated. For the following steps, choose a size of max 2 x 2 km.  
* Then click on Advanced Options
* Then click on Advanced Options
[[File:New_project_handout.PNG|700px]]
[[File:New_project_handout.PNG|700px]]
* Here you can check datasets that are used to generate the 3D world.
* Here you can check datasets that are used to generate the [[project]].
[[File:Advanced_options_water.png]]
[[File:Advanced_options_panel.jpg|700px]]
* Finally click on generate map to generate the 3D world from [[Project_Sources|open data]].
* Finally click on generate map to generate the [[project]] from [[Project_Sources|open data]].
 
{{page break}}
===Save, versions and user rights and User interface===
===Save, versions and user rights and user interface===
* Once you first get in the project, the project starts with a Cinematic (flythrough over the project area).
* Once you first get in the project, the project starts with a [[Cinematic|Cinematic]] (fly through over the project area).
* The Editor interface (recognizable by the white menus around the 3D world) is divided into the Ribbon, the Left Panel, Right Panel and Bottom Panel.
* The [[Editor]] interface (recognizable by the white menus around the [[3D Visualization]]) is divided into the Ribbon, the Left Panel, Right Panel and Bottom Panel.
[[File:Q1-2016-EditorPanel.jpg|700px]]
* Click on the File button in the upper left corner to go to the main menu of the project.  
* Click on the File button in the upper left corner to go to the main menu of the project.  
* In the Edit rights section you can change the rights. By default the owner is the only person which has access to the project and can edit and save the project. Change the rights in the Other users domain section in order for other users in your domain to access your project. When you have a Support question and would like Tygron to take a look into your project, you can change the rights for Tygron Support. By default Tygron does not have access to your project.  
[[File:File_project.png]]
* In the Save menu you can save the project.  
* In the Edit rights section you can change the rights. By default the owner is the only person which has access to the project and can edit and save the project. Change the rights in the Other users domain section in order for other users in your domain to access your project. When you have a Support question and would like Tygron to take a look at your project, you can change the rights for Tygron Support. By default Tygron does not have access to your project.  
* In the Versions menu you can add a new version. Change (if desired) the name of the version. It is strongly advised to work with different versions when editing a project, so you will always have a fallback.  
* In the Save menu you can save the project. Note: Save as will create a copy of your project, save will save the changes you have made in the current project you are editing.
[[File:Project_rights.png]]
* In the Versions menu you can add a new [[Version_Control|version]]. Change (if desired) the name of the version. It is strongly advised to work with different versions when editing a project because there is no undo button available.
* Click on the arrow to go back to the project.  
* Click on the arrow to go back to the project.  
* In the interface you will see the Current Situation tab, in where you can edit the current situation of the model. In the black bar on the right you will see the 2D maps, named Overlays.
[[File:Project_versions.png]]
* Click on the Future design tab to see new buttons. With the menus in this tab it is possible to create scenarios by building and demolishing.  
* In the interface you will see the [[Current_Situation|Current Situation tab]], in where you can edit the current situation of the model.  
* If you have a question while using the software, go to the Community tab to open the Wiki to find the documentation. If your question is not answered with information on the Wiki, go to the Forum to post your question.  
[[File:Current_sitatuation_tab.png|700px]]
* Click on the [[Future_Design|Future design tab]] to see new buttons in the ribbon. With the options in this tab it is possible to create scenarios for analysis of your future design.  
[[File:Future_design_tab.png|700px]]
* If you have a question while using the software, go to the [[Community|Community tab]] to open the Wiki to find the documentation. If your question is not answered with information on the Wiki, go to the Forum to post your question.
[[File:Community_tab.png|700px]]
{{page break}}


===Overlays===
===Overlays===
Overlays are 2D maps, visible on top of the 3D world.
[[Overlay]]s are 2D maps, rendered on top of the [[3D Visualization]].
* By default, several overlays are added to the Overlay bar. Click on the Neighborhoods overlay to see the CBS wijk- en buurtkaart. By clicking on one of the neighborhoods you will see statistigs about the neighborhood from the CBS in the hover panel.  
 
* By clicking on the house icon (named the City OVerlay), you will return to the normal 3D world.  
* By default, several overlays are added to the Overlay bar on the rights side of the [[viewer ]]interface. Click on the [[Neighborhoods_Overlay|Neighborhoods overlay]] to see the CBS Wijk- en Buurtkaart. By clicking on one of the Neighborhoods you will see statistics about the Neighborhood from the CBS in the hover panel.  
[[File:Overlay_neighborhood.png|700px]]
* By clicking on the house icon (named the City Overlay), you will stop displaying overlays and return to the normal visualization.  
* The bord icon shows the Property overlay.  
* The bord icon shows the Property overlay.  
* There are a lot more overlays which can be added. This can be done as follows: Click on the Current Situation tab and hover over the Overlays button. Then add for example the Traffic noise from the Environment category. Now a map wich whose the noise distrubacen by traffic is added.
[[File:Overlay_bar_small.png|200px]]
* This overlay is a dynamic overlay or grid overlay. The map is divided into grid cells. On each grid cell a value is calculated (in this case the noise disturbance of the traffic in dB). The smaller the grid cells are, the more accurate the overlay is. Change the grid cell size of the overlay by selecting hte overlay from the left panel and then clicking on CHange grid in the right panel.  
* There are a lot more Overlays which can be added. This can be done as follows: click on the Current Situation tab and hover over the Overlays button. Then add for example [[Traffic_Noise_Overlay|Traffic noise]] from the Environment category. Now a map which shows the noise disturbance by traffic is added.
* When Auto updae is on, the overlay is automatically being recaluclated. When auto update is off, after changing the grid cell value click on Update now in the right panel (below CHange grid).
[[File:Add_traffic_noise_overlay.PNG|700px]]
* This overlay is a dynamic overlay or [[Grid_Overlay|grid overlay]]. The map is divided into grid cells. On each grid cell a value is calculated (in this case the traffic noise disturbance in dB). The smaller the grid cells are, the more accurate the overlay is. Change the grid cell size of the overlay by selecting the overlay from the left panel and then clicking on Change grid in the right panel.  
[[File:Change_grid_cell_size.png|700px]]
* When [[Calculation_panel#Auto-update_indicators|Auto update]] is on, the overlay is automatically being recalculated. When auto update is off, after changing the grid cell value click on Update now in the right panel (below Change grid).
* Again, hover over the Overlay button and select the [[Rainfall_Overlay|Rainfall Overlay]] from the Water category to add this Rainfall overlay to the project. The Rainfall overlay can be configured with the [[Water_Overlay_Wizard|Configuration wizard]].
[[File:Add_rainfall_to_project.PNG|700px]]
* The Rainfall overlay is also a grid overlay which you can play as an animation where you can see the course of the rain shower per [[Timeframes_(Water_Overlay)|time frame]] (customizable). You do this by clicking the Play button in the legend.
[[File:Play_overlay.png|700px]]
* For more information about Overlays, see also this video tutorial: https://www.tygron.com/nl/2018/12/07/overlay-in-de-editor/
{{page break}}
 
===Buildings===
The 3D objects in the [[project area]] are called [[Building]]s. These buildings have attributes, originating from, among other things, open data from which the calculation models ([[Overlay]]s and [[Indicator]]s) calculate results.
* Click on the City Overlay to activate the normal 3D visualization. Click on a building in the [[3D Visualization]] and see more information in the hover panel.
* Next click in the [[Current Situation]] tab on the [[Building]]s button. 
[[File:Buildings_button.png|700px]]
* Now click on a building in the [[3D Visualization]]. You will see that a blue line is visible around the selected building. In the left panel you will see the address and the corresponding sections of the building. In the right panel you will see different tabs with attribute information about this specific building.
[[File:Select_building_in_project.png|700px]]
* Click on a road, so that it is outlined in blue. Go to the right panel, tab Details and change the [[Cars per hour (Function Value)|Cars per hour]] to a higher value. Note that you are changing the current situation. Now the amount of cars that drive on this road per hour is changed. If Auto update is on, the Traffic noise overlay is automatically updated. Click on this overlay to see the results and then go back to the City Overlay.
[[File:Change_traffic_flow.png|700px]]
* It is also possible to change the [[Function|function]]. Note that you are changing the current situation. Click in the General tab on the image Change function.
[[File:Change_function.png|700px]]
* In the panel that appears, select a new function for this road from the road function library and click on Ok. Notice that the function is now changed.
[[File:Choose_function.png]]
{{page break}}
 
===Indicators===
[[Indicator]]s are calculation models which calculate results from the information in your project. An indicator is created in an Excel sheet which is uploaded to the project.
 
* In the Current situation tab, click on the button Indicators and select the Green indicator. This indicator is now added to the black [[top bar]] in the [[viewer ]]interface and to the left panel in the [[editor ]]interface.
[[File:Add_indicator.png|700px]]
 
* Select the Green indicator from the left panel and see in the right and bottom panel information about this indicator.
[[File:Target_green_indicator.png|700px]]
* Click on the [[indicator]] in the black [[top bar]] in the [[viewer ]]interface to open the indicator and see the calculated results. When you are creating a scenario (or changing the current situation), the effects are being calculated and shown in this indicator panel.
[[File:Green_indicator_panel.png|400px]]
* Hover over the indicator button and click on Find Indicators. You are now redirected to the Public [[GeoShare]] where you can find more indicators. On the Public GeoShare you can add your own indicators for other users to use.
[[File:Find_indicators.png|700px]]
{{page break}}
 
===Actions===
With [[Action]]s you can create future scenarios. Results of these scenarios can be visualized in the [[3D Visualization]] as [[Overlay]]s, and in the [[viewer ]]interface as [[Indicator]]s.
 
* Click on the [[Future Design]] tab, and then on the [[Action]]s button. Check the Show only my [[Stakeholder]] option.
[[File:Actions_stakeholder.png|400px]]
* Unfold the action Green and notice the icon in the Action bar is highlighted. The action menus in the left menu are corresponding with the actions in the Action bar.
[[File:Action_bar_project.png]]
* To use an Action, select the [[Function|function]] in the Action bar and draw a shape in the [[3D Visualization]]. Then click on ''Build''.
[[File:Build_action.png]]
* A [[Test_Run|test run]] is started, in where scenarios can be tested. The menus in the [[Editor]] are now greyed out. It is not possible to edit the project in the [[Current Situation ]] anymore when the test run is active.
[[File:Action_testrun.png]]
* To create a new menu with multiple functions (or any other edit in your project), first stop the test run by clicking on the Stop button. Next click on Add in the left bottom corner. A new Action Menu is added to the left panel.
[[File:New_action_menu.png]]
* Select this new Action menu and click in the panel on the tab Actions. Select the functions which you would like to build. These are then added to the action menu.
[[File:Choose_function_actions.png|700px]]


5. Als Auto update aan staat, wordt de overlay automatisch herberekend. Als auto update uit staat, kun je na het veranderen van de grid grootte klikken op Update now in het rechterpaneel (onder Change grid).
For more information about creating Actions, Measures and Upgrades, see this webinar: https://www.tygron.com/nl/2019/05/22/actions-measures-en-upgrades/
6. Ga nu naar de  Current Situation tab, hover over de knop Overlays en klik op Add Rainfall om de Rainfall overlay toe te voegen. In het linkermenu zie je dat de Regenwater Overlast overlay is toegevoegd aan je project.

Latest revision as of 11:42, 9 January 2024

This handout can be used for a quickstart training on the basics of the Tygron Platform.

How to use: Advice is to print this handout and use it during the training to take notes. Afterwards, you will have a summary of what you have learned during the training.

Project: The steps in the handout can be applied on any project.

Note: This handout is not a complete standalone tutorial but provides a guide during a training. For a tutorial on the subjects in this handout see the Demo Basics project, the New Project Wizard page and the Account management pages.

The subjects in this hand out are:

  • Domain management
  • Create a new project
  • Save, versions and user rights and user interface
  • Overlays
  • Buildings
  • Indicators
  • Actions

Domain management

  • Log in with your user name and password on the Tygron Platform, the LTS.
  • Click in the main menu on Options. When you are domain admin, you will see more options since you have extra rights such as adding new users and removing projects from the domain.

Options main menu.png

  • Click on My Account. In this menu you can change the (automatically generated) password.
  • You can also change the rights of projects which you have created. A project can have Read rights (right to open the project and edit, but not save edits), Write (right to edit and save edits) and None (the project is not visible for other users and they cannot access it). It is also possible to change the version of your project.

My account main menu.png

Create a New Project

New project main menu handout.PNG

  • Provide a name for the New Project (max 20 characters) and click on Empty Project.

Name new project handout.png

  • For the location, fill in a location of your choice and click on Enter. Move the square with the left mouse button. The area of the map in the square will be your project area. With the sliders on the right side, it is possible to enlarge the square. However, the smaller the square is, the faster the project will be generated. For the following steps, choose a size of max 2 x 2 km.
  • Then click on Advanced Options

New project handout.PNG

  • Here you can check datasets that are used to generate the project.

Advanced options panel.jpg

Save, versions and user rights and user interface

  • Once you first get in the project, the project starts with a Cinematic (fly through over the project area).
  • The Editor interface (recognizable by the white menus around the 3D Visualization) is divided into the Ribbon, the Left Panel, Right Panel and Bottom Panel.

Q1-2016-EditorPanel.jpg

  • Click on the File button in the upper left corner to go to the main menu of the project.

File project.png

  • In the Edit rights section you can change the rights. By default the owner is the only person which has access to the project and can edit and save the project. Change the rights in the Other users domain section in order for other users in your domain to access your project. When you have a Support question and would like Tygron to take a look at your project, you can change the rights for Tygron Support. By default Tygron does not have access to your project.
  • In the Save menu you can save the project. Note: Save as will create a copy of your project, save will save the changes you have made in the current project you are editing.

Project rights.png

  • In the Versions menu you can add a new version. Change (if desired) the name of the version. It is strongly advised to work with different versions when editing a project because there is no undo button available.
  • Click on the arrow to go back to the project.

Project versions.png

  • In the interface you will see the Current Situation tab, in where you can edit the current situation of the model.

Current sitatuation tab.png

  • Click on the Future design tab to see new buttons in the ribbon. With the options in this tab it is possible to create scenarios for analysis of your future design.

Future design tab.png

  • If you have a question while using the software, go to the Community tab to open the Wiki to find the documentation. If your question is not answered with information on the Wiki, go to the Forum to post your question.

Community tab.png

Overlays

Overlays are 2D maps, rendered on top of the 3D Visualization.

  • By default, several overlays are added to the Overlay bar on the rights side of the viewer interface. Click on the Neighborhoods overlay to see the CBS Wijk- en Buurtkaart. By clicking on one of the Neighborhoods you will see statistics about the Neighborhood from the CBS in the hover panel.

Overlay neighborhood.png

  • By clicking on the house icon (named the City Overlay), you will stop displaying overlays and return to the normal visualization.
  • The bord icon shows the Property overlay.

Overlay bar small.png

  • There are a lot more Overlays which can be added. This can be done as follows: click on the Current Situation tab and hover over the Overlays button. Then add for example Traffic noise from the Environment category. Now a map which shows the noise disturbance by traffic is added.

Add traffic noise overlay.PNG

  • This overlay is a dynamic overlay or grid overlay. The map is divided into grid cells. On each grid cell a value is calculated (in this case the traffic noise disturbance in dB). The smaller the grid cells are, the more accurate the overlay is. Change the grid cell size of the overlay by selecting the overlay from the left panel and then clicking on Change grid in the right panel.

Change grid cell size.png

  • When Auto update is on, the overlay is automatically being recalculated. When auto update is off, after changing the grid cell value click on Update now in the right panel (below Change grid).
  • Again, hover over the Overlay button and select the Rainfall Overlay from the Water category to add this Rainfall overlay to the project. The Rainfall overlay can be configured with the Configuration wizard.

Add rainfall to project.PNG

  • The Rainfall overlay is also a grid overlay which you can play as an animation where you can see the course of the rain shower per time frame (customizable). You do this by clicking the Play button in the legend.

Play overlay.png

Buildings

The 3D objects in the project area are called Buildings. These buildings have attributes, originating from, among other things, open data from which the calculation models (Overlays and Indicators) calculate results.

  • Click on the City Overlay to activate the normal 3D visualization. Click on a building in the 3D Visualization and see more information in the hover panel.
  • Next click in the Current Situation tab on the Buildings button.

Buildings button.png

  • Now click on a building in the 3D Visualization. You will see that a blue line is visible around the selected building. In the left panel you will see the address and the corresponding sections of the building. In the right panel you will see different tabs with attribute information about this specific building.

Select building in project.png

  • Click on a road, so that it is outlined in blue. Go to the right panel, tab Details and change the Cars per hour to a higher value. Note that you are changing the current situation. Now the amount of cars that drive on this road per hour is changed. If Auto update is on, the Traffic noise overlay is automatically updated. Click on this overlay to see the results and then go back to the City Overlay.

Change traffic flow.png

  • It is also possible to change the function. Note that you are changing the current situation. Click in the General tab on the image Change function.

Change function.png

  • In the panel that appears, select a new function for this road from the road function library and click on Ok. Notice that the function is now changed.

Choose function.png

Indicators

Indicators are calculation models which calculate results from the information in your project. An indicator is created in an Excel sheet which is uploaded to the project.

  • In the Current situation tab, click on the button Indicators and select the Green indicator. This indicator is now added to the black top bar in the viewer interface and to the left panel in the editor interface.

Add indicator.png

  • Select the Green indicator from the left panel and see in the right and bottom panel information about this indicator.

Target green indicator.png

  • Click on the indicator in the black top bar in the viewer interface to open the indicator and see the calculated results. When you are creating a scenario (or changing the current situation), the effects are being calculated and shown in this indicator panel.

Green indicator panel.png

  • Hover over the indicator button and click on Find Indicators. You are now redirected to the Public GeoShare where you can find more indicators. On the Public GeoShare you can add your own indicators for other users to use.

Find indicators.png

Actions

With Actions you can create future scenarios. Results of these scenarios can be visualized in the 3D Visualization as Overlays, and in the viewer interface as Indicators.

Actions stakeholder.png

  • Unfold the action Green and notice the icon in the Action bar is highlighted. The action menus in the left menu are corresponding with the actions in the Action bar.

Action bar project.png

Build action.png

  • A test run is started, in where scenarios can be tested. The menus in the Editor are now greyed out. It is not possible to edit the project in the Current Situation anymore when the test run is active.

Action testrun.png

  • To create a new menu with multiple functions (or any other edit in your project), first stop the test run by clicking on the Stop button. Next click on Add in the left bottom corner. A new Action Menu is added to the left panel.

New action menu.png

  • Select this new Action menu and click in the panel on the tab Actions. Select the functions which you would like to build. These are then added to the action menu.

Choose function actions.png

For more information about creating Actions, Measures and Upgrades, see this webinar: https://www.tygron.com/nl/2019/05/22/actions-measures-en-upgrades/