Basic skills tutorial: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
(44 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{stub}}
The best way for building experience with the {{software}} is by actively using it. Especially after a training, staying active in the {{software}} is the best option for consolidating what you've learned. To help with this process, this page offers a number of assignments. All of these assignments are part of the topics that were dealt with during the quick start training.
 
The best way for building experience with the Tygron Engine is by actively using it. Especially after a training, staying active in the Engine is the best option for consolidating what you've learned. To help with this proces, this page offers a number of assignments. All of these assignments are part of the topics that were dealt with during the quick start training.


These assignments can be done in the project "ClimateGame5". This project is available in all domains.  
These assignments can be done in the project "ClimateGame5". This project is available in all domains.  
Line 7: Line 5:
===Starting the project===
===Starting the project===
After logging in, you will find yourself in the main menu. Select "Edit Project", and then select the "Climategame 5" project. It will begin to load. When the editor has loaded, you will see an interface with a ribbon menu at the top, and the [[3D World]] in the center. If you don't want to save the adjustments you make in these practice assigment, you are now ready to begin. However,  if you do want to save all the adjustments you practice with these assignments you need to make a personal copy of the Climategame5 project.
After logging in, you will find yourself in the main menu. Select "Edit Project", and then select the "Climategame 5" project. It will begin to load. When the editor has loaded, you will see an interface with a ribbon menu at the top, and the [[3D World]] in the center. If you don't want to save the adjustments you make in these practice assigment, you are now ready to begin. However,  if you do want to save all the adjustments you practice with these assignments you need to make a personal copy of the Climategame5 project.
{{Editor steps|preamble=Save you own practice project|Select "File" in the [[ribbon]].|Save As [[left panel]], adjust the name to a self chosen project name.|Select "Save".}}
{{Editor steps|preamble=Save your own practice project|Select "File" in the [[ribbon]].|Save As [[left panel]], adjust the name to a self chosen project name.|Select "Save".}}
This new created project can be edited and saved whenever you want. You are now ready to begin these assignments.
This new created project can be edited and saved whenever you want. You are now ready to begin these assignments.


Line 13: Line 11:
These assignments will guide you step-by-step through some simple use-cases.
These assignments will guide you step-by-step through some simple use-cases.


The first two assignments are linked by a common question that is asked for the support team. ''I have drawn a building in the 3D world and now it's gone. How is that possible?'' Probably the answer is that you try to draw a building from the action menu instead of from the constructions. After completing the following two assignments, the difference is clear between drawing constructions and drawing an action that may be a building, for example.
===Creat a new user account===
[[File:User_aanmaken.png|thumb|right|Add a new user]] A frequently asked question is how to create a new user in one's own domain. Notice, this action can only be performed by the domain admin. The domain admin is the person who is listed as the main contact person for Tygron.
 
# Add a new user to the domain
# Adjust the rights for the new user to Editor
# Provide the new user a password
 
If you need more information to execute these assignments go to the specific wiki pages with the indepth information.
# How to add a [[Account Management#Adding and removing users|new user]]


===Adjust the 3D world in the editor===
===Adjust the 3D world in the editor===
These two assignments are linked by a common question that is asked often to the support team. ''I have drawn a building in the 3D world and now it's gone. How is that possible?'' [[File:Remove_construction.jpg|thumb|right|Remove construction]] Probably the answer is that you try to draw a building from the action menu instead of from the constructions. [[File:Build_Building.jpg|thumb|right|Place new construction]] After completing the following two assignments, the difference is clear between drawing constructions and drawing an action that may be a building, for example. [[File:Floor_height.jpg|thumb|right|Adjust Floor height]]


In this assignment you will adjust the 3D world. After this practice you can edit your base project in case you need to change the 3D world after loading a new project in the wizard.  
In this first assignment you will adjust the 3D world. After this practice you can edit your base project in case you need to change the 3D world after loading a new project in the wizard.  
The assignment consists of three parts.
The assignment consists of three parts.
# Remove a construction in the 3D world to create an empty spot where you can put a new construction.
# Remove a construction in the 3D world to create an empty spot where you can put a new construction.
Line 33: Line 40:
===Adjust the 3D world in a session===
===Adjust the 3D world in a session===


In this assignment you will adjust the action menu. After this practice you can edit the 3D world during a session or during a testrun.  
In this second assignment you will adjust the action menu. [[File:Action_.jpg|thumb|right|Building action in action menu]] After this practice you can edit the 3D world during a session or during a testrun.  
The assignment consist of four parts.
The assignment consist of four parts.
# Add a new action menu to the Uni real Estate Stakholder and name it Education
# Add a new action menu to the Uni Real Estate stakeholder and name it Leisure
# Add a build Education Luxury option to the action menu
# Add a build Sports centre option to the action menu
# Build an Education Luxary building in the 3D world
# Build an Sports Centre building in the 3D world
# (Notice the test run has started) Stop the testrun and notice the new build construction disappears.
# (Notice the test run has started) Stop the testrun and notice the new build construction disappears.


If you need more information to execute these assignments go to the specific wiki pages with the indepth information.
If you need more information to execute these assignments go to the specific wiki pages with the indepth information.
# [[Actions#Adding_and_removing_action_menu.27s|How add a action menu]]
# [[Actions#Adding_and_removing_action_menu.27s|How add an action menu]]
# [[Actions#Adding_and_removing_actions|How to add a construction to the action menu]]
# [[Actions#Adding_and_removing_actions|How to add a construction to the action menu]]
# [[Constructions#Draw_area|How to build a construction]]
# [[User_Interface#Actions|How to build a construction]]
# [[Test_Run|What is a Testrun]]
# [[Test_Run|What is a Testrun]]


For more information on this topic, visit the following pages:
For more information on this topic, visit the following pages:
* [[Actions]]
* [[Actions]]
<br style='clear:both'>


===Adding, removing and adjusting an indicator===
===Adding, removing and adjusting an indicator===
In this next assignment you will learn more about adding, removing and adjusting indicator related actions in the Climategame project. The indicator is a calculation model available in any project. Once added, it will automatically be shown in the topbar of the project and start to calculate and influence the score of the stakeholder for whom it was added. In this example you can to be working in the Climategame project as the Waterboard stakeholder. You can check in the right upper corner of the top bar if you are working in the project as the correct stakeholder.
In this next assignment you will learn more about adding, removing and adjusting indicator related actions in the Climategame project. The indicator is a calculation model available in any project. [[File:Add_Indicator.jpg|thumb|right|Indicator panel.]] Once added, it will automatically be shown in the topbar of the project and will start to calculate and influence the score of the stakeholder for whom it was added. In this example you should be working in the Climategame 5 project as the Waterboard stakeholder. You can check in the right upper corner of the top bar if you are working in the project as the correct stakeholder.


# Add the shared indicator,Traffic Noise, to the project. This is a indicator that is added to the whole project and can be added or removed per stakeholder.
# Add the shared indicator,Traffic NO2, to the project. This is a indicator that is added to the whole project and can be added or removed per stakeholder.
# Add the personal indicator, Housing, to the Waterboard stakeholder. This is a indicator specific for a stakeholder, in this case the Waterboard.
# Add the personal indicator, Housing, to the Waterboard stakeholder. This is a indicator specific for a stakeholder, in this case the Waterboard.


If you need more information to execute these assignments go to the specific wiki pages with the indepth information.
If you need more information to execute these assignments go to the specific wiki pages with the indepth information.
# How to add a [[Indicators#Adding/removing_indicators|shared indicator]]
# How to add an [[Indicators#Adding/removing_indicators|indicator]]
# How to add a [[Indicators#Adding/removing indicators|personal indicator]]
<br>


For the next step you are going to make sure the Traffic Noise indicator is added to the waterboard stakeholder and the municipality stakeholder. The SSH and Student Housing may not have the Traffic Noise indicator. If necessary remove the Traffic Noise indicator from both stakeholders.
For the next step you are going to make sure the Traffic NO2 indicator is added to the waterboard stakeholder and the municipality stakeholder. [[File:Indicator_weights_beforeJPG.jpg|thumb|right|Indicator weights Waterboard before.]] [[File:Indicator_weights_afterJPG.jpg|thumb|right|Indicator weights Waterboard after.]] The SSH and Student Housing may not have the Traffic Noise indicator. If necessary remove the Traffic Noise indicator from both stakeholders.
# Check if the municipality also possesses the Traffic Noise indicator
# Check if the municipality also possesses the Traffic NO2 indicator
# Remove the Traffic Noise indicator for the SSH and student Housing if
# Remove the Traffic NO2 indicator for the SSH and student Housing  


Depending on the previous assignment, you will now adjust the weighting of the indoctors per stakeholder.
If you need more information to execute these assignments go to the specific wiki pages with the indepth information.
#   
# How to [[Stakeholders#Adding a stakeholder Indicator|adjust indicators per stakeholder]]<br>
 
Depending on the previous assignment, you will now adjust the weighting of the indicators per stakeholder.This is relevant when two or more stakeholder share the same indicator, but the weighting of the indicator differs per stakeholder. In this case, both Waterboard and the Municipality share the Traffic NO2 indicator but for the Municipality this indicator is much more important than it is for the waterboard. Side note, notice the Heat stress indicator is also visible in the Indicator Weights table for the Waterboard. This is because it is marked as inactive in the first level. You can ignor this for now, it is off topic for this assingment.
 
#  Adjust the weighting of the indicators for the Municipality to: Traffic NO2 35%,  Livability 50% and Budget 15%
Adjust the weighting of the indicators for the Waterboard to: Traffic NO2 15%,  Water storage 50%, Budget 25%, Building Waterboard to 9% and Heat stress to 1%
 
If you need more information to execute these assignments go to the specific wiki pages with the indepth information.
# How to [[Stakeholders#Adjusting Indicator Weights|adjust the indicator weight per stakeholder]]


For more information on this topic, visit the following pages:
For more information on this topic, visit the following pages:
* [[Indicators]]
* [[Indicators]]
* [[Stakeholders]]
* [[Stakeholders]]
 
<br style='clear:both'>


===Loading in GeoJSON===
===Loading in GeoJSON===


In this assignment you will load in a [[GeoJSON]] file into the editor. A file has been prepared with a number of shapes which overlap with some of the roads in the project. The file also contains (fictional) traffic intensity values. By loading in this file into the editor, the [[Function Values|building values]] of the roads can be adjusted to have the traffic intensities as defined in the file.
In this assignment you will load in a [[GeoJSON]] file into the editor.[[File:Area_overlay.jpg|thumb|right|Area visible in overlay]] A file has been prepared with a waterlevel area that can be imported in the Climategame 5 project. The file also contains (fictional) attribute values. By loading in this file into the editor, the new waterlevel area is added with the attribute values as defined in the file.


Download the excample traffic intensities file. It can be found here: [http://support.tygron.com/w/downloads/tutorial/roads-intensity-shapes.zip Road Intensity file]. Unpack it before starting.
In preparation download the example area file. It can be found here: [//support.tygron.com/w/downloads/tutorial/climategame_5-areas.zip waterlevel area file]. Unpack it before starting.


{{Editor steps|preamble=Loading traffic intensities|Drag the GeoJSON file ("roads-intensity-shapes.geojson") into the editor.|Select "Import Building Values".|Select "only buildings with Category: ROADS".|Make sure "TRAFFIC_FL" is checked.|Enter "TRAFFIC_FLOW" in the field next to "TRAFFIC_FL".|Select "Send".}}
# Import the GeoJSON file as an area
# Verify the desired attributes are selected and finish the import process
# Make the area visible in an overlay


To see the loaded traffic intensities, it is possible to simply view the roads in the 3D world. The affected roads will have more cars on them then they had before. For greater insight into the effects of the new data, it is also possible to add an [[overlay]] for [[Traffic_Noise_(Overlay)|traffic noise]] or [[Traffic_Flow_(Overlay)|traffic intensity]].
If you need more information to execute these assignments go to the specific wiki pages with the indepth information.
# How to [[GeoJSON#How to load a GeoJSON file into the {{software}}|add a GeoJSON file]]
# How to [[Overlay#Adding and removing overlays|add an overlay]]


For more information on this topic, visit the following pages:
For more information on this topic, visit the following pages:
* [[GeoJSON]]
* [[GeoJSON]]
* [[Function Values]]
* [[Area]]
* [[Attribute]]
* [[Overlay]]

Revision as of 11:16, 15 October 2019

The best way for building experience with the Tygron Platform is by actively using it. Especially after a training, staying active in the Tygron Platform is the best option for consolidating what you've learned. To help with this process, this page offers a number of assignments. All of these assignments are part of the topics that were dealt with during the quick start training.

These assignments can be done in the project "ClimateGame5". This project is available in all domains.

Starting the project

After logging in, you will find yourself in the main menu. Select "Edit Project", and then select the "Climategame 5" project. It will begin to load. When the editor has loaded, you will see an interface with a ribbon menu at the top, and the 3D World in the center. If you don't want to save the adjustments you make in these practice assigment, you are now ready to begin. However, if you do want to save all the adjustments you practice with these assignments you need to make a personal copy of the Climategame5 project.

Save your own practice project:
  1. Select "File" in the ribbon.
  2. Save As left panel, adjust the name to a self chosen project name.
  3. Select "Save".

This new created project can be edited and saved whenever you want. You are now ready to begin these assignments.

Guided Assignments

These assignments will guide you step-by-step through some simple use-cases.

Creat a new user account

Add a new user

A frequently asked question is how to create a new user in one's own domain. Notice, this action can only be performed by the domain admin. The domain admin is the person who is listed as the main contact person for Tygron.

  1. Add a new user to the domain
  2. Adjust the rights for the new user to Editor
  3. Provide the new user a password

If you need more information to execute these assignments go to the specific wiki pages with the indepth information.

  1. How to add a new user

Adjust the 3D world in the editor

These two assignments are linked by a common question that is asked often to the support team. I have drawn a building in the 3D world and now it's gone. How is that possible?

Remove construction

Probably the answer is that you try to draw a building from the action menu instead of from the constructions.

Place new construction

After completing the following two assignments, the difference is clear between drawing constructions and drawing an action that may be a building, for example.

Adjust Floor height

In this first assignment you will adjust the 3D world. After this practice you can edit your base project in case you need to change the 3D world after loading a new project in the wizard. The assignment consists of three parts.

  1. Remove a construction in the 3D world to create an empty spot where you can put a new construction.
  2. Add a new construction of the category Education of the Education Luxury type.
  3. Edit the new Education Luxury building to a building with a floorheight of 10 floors.

If you need more information in order to execute these assignments go to the specific wiki pages with the indepth information.

  1. How to remove a construction in the 3D world
  2. How to add a construction in the 3D world
  3. How to edit a construction in the 3D world

For more information on this topic, visit the following pages:

Adjust the 3D world in a session

In this second assignment you will adjust the action menu.

Building action in action menu

After this practice you can edit the 3D world during a session or during a testrun.

The assignment consist of four parts.

  1. Add a new action menu to the Uni Real Estate stakeholder and name it Leisure
  2. Add a build Sports centre option to the action menu
  3. Build an Sports Centre building in the 3D world
  4. (Notice the test run has started) Stop the testrun and notice the new build construction disappears.

If you need more information to execute these assignments go to the specific wiki pages with the indepth information.

  1. How add an action menu
  2. How to add a construction to the action menu
  3. How to build a construction
  4. What is a Testrun

For more information on this topic, visit the following pages:


Adding, removing and adjusting an indicator

In this next assignment you will learn more about adding, removing and adjusting indicator related actions in the Climategame project. The indicator is a calculation model available in any project.

File:Add Indicator.jpg
Indicator panel.

Once added, it will automatically be shown in the topbar of the project and will start to calculate and influence the score of the stakeholder for whom it was added. In this example you should be working in the Climategame 5 project as the Waterboard stakeholder. You can check in the right upper corner of the top bar if you are working in the project as the correct stakeholder.

  1. Add the shared indicator,Traffic NO2, to the project. This is a indicator that is added to the whole project and can be added or removed per stakeholder.
  2. Add the personal indicator, Housing, to the Waterboard stakeholder. This is a indicator specific for a stakeholder, in this case the Waterboard.

If you need more information to execute these assignments go to the specific wiki pages with the indepth information.

  1. How to add an indicator


For the next step you are going to make sure the Traffic NO2 indicator is added to the waterboard stakeholder and the municipality stakeholder.

File:Indicator weights beforeJPG.jpg
Indicator weights Waterboard before.
File:Indicator weights afterJPG.jpg
Indicator weights Waterboard after.

The SSH and Student Housing may not have the Traffic Noise indicator. If necessary remove the Traffic Noise indicator from both stakeholders.

  1. Check if the municipality also possesses the Traffic NO2 indicator
  2. Remove the Traffic NO2 indicator for the SSH and student Housing

If you need more information to execute these assignments go to the specific wiki pages with the indepth information.

  1. How to adjust indicators per stakeholder

Depending on the previous assignment, you will now adjust the weighting of the indicators per stakeholder.This is relevant when two or more stakeholder share the same indicator, but the weighting of the indicator differs per stakeholder. In this case, both Waterboard and the Municipality share the Traffic NO2 indicator but for the Municipality this indicator is much more important than it is for the waterboard. Side note, notice the Heat stress indicator is also visible in the Indicator Weights table for the Waterboard. This is because it is marked as inactive in the first level. You can ignor this for now, it is off topic for this assingment.

  1. Adjust the weighting of the indicators for the Municipality to: Traffic NO2 35%, Livability 50% and Budget 15%
  2. Adjust the weighting of the indicators for the Waterboard to: Traffic NO2 15%, Water storage 50%, Budget 25%, Building Waterboard to 9% and Heat stress to 1%

If you need more information to execute these assignments go to the specific wiki pages with the indepth information.

  1. How to adjust the indicator weight per stakeholder

For more information on this topic, visit the following pages:


Loading in GeoJSON

In this assignment you will load in a GeoJSON file into the editor.

Area visible in overlay

A file has been prepared with a waterlevel area that can be imported in the Climategame 5 project. The file also contains (fictional) attribute values. By loading in this file into the editor, the new waterlevel area is added with the attribute values as defined in the file.

In preparation download the example area file. It can be found here: waterlevel area file. Unpack it before starting.

  1. Import the GeoJSON file as an area
  2. Verify the desired attributes are selected and finish the import process
  3. Make the area visible in an overlay

If you need more information to execute these assignments go to the specific wiki pages with the indepth information.

  1. How to add a GeoJSON file
  2. How to add an overlay

For more information on this topic, visit the following pages: