Basic skills tutorial: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
(Redirected page to Basics tutorial)
Tag: New redirect
 
(54 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{stub}}
#REDIRECT [[basics tutorial]]


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.
This page offers a number of assignments that help you get acquinted with some of the basics of the Tygron Platform


These assignments can be done in the project "ClimateGame5". This project is available in all domains.  
These assignments can be done in the [[Demo Basics Project]]. This project is available in all domains.  


===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 with the {{software|client}}, you will find yourself in the main menu. Select "Edit Project", and then select the [[Demo Basics 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 Visualization]] in the center. If you don't want to save the adjustments you make in these practice assignment, 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 [[Demo Basics 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 13:
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.


===Creat a new user account===
===Create a new user account===
A much asked question is how to creat a new user in a 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. Only the domain admin can add more users and also more domain admins if desired.
[[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
# Add a new user to the domain
Line 20: Line 20:
# Provide the new user a password
# 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.
If you need more information to execute these assignments go to the specific wiki pages with the in-depth information.
# How to add a [[Account Management#Adding and removing users|new user]]
# [[How to add a User]]


===Adjust the 3D world in the editor===
===Adjust the project in the editor===
These 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.  
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 Visualization and now it's gone. How is that possible?'' [[File:Remove_construction.jpg|thumb|right|Remove building]] Probably the answer is that you try to draw a building from the action menu instead of from the buildings. [[File:Build_Building.jpg|thumb|right|Place new building]] After completing the following two assignments, the difference is clear between drawing buildings and drawing an action that may be a building, for example. [[File:Floor_height.jpg|thumb|right|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.  
In this first assignment you will adjust the project. After this practice you can edit your base project in case you need to change the project 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 building in the project to create an empty spot where you can put a new building.
# Add a new construction of the category Education of the Education Luxury type.
# Add a new building of the category Education of the Education Luxury type.
# Edit the new Education Luxury building to a building with a floorheight of 10 floors.
# Edit the new Education Luxury building to a building with 10 floors.


If you need more information in order to execute these assignments go to the specific wiki pages with the indepth information.
If you need more information in order to execute these assignments go to the specific wiki pages with the in-depth information.
# [[Constructions#Removing_constructions|How to remove a construction in the 3D world]]
# [[How to add and remove buildings]]
# [[Constructions#Adding_constructions|How to add a construction in the 3D world]]
# [[How to edit building properties]]
# [[Constructions#Changing_constructions|How to edit a construction in the 3D world]]
# [[How to draw selections for buildings]]


For more information on this topic, visit the following pages:
For more information on this topic, visit the following pages:
* [[Constructions]]
* [[Buildings]]


===Adjust the 3D world in a session===
===Adjust the project 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 project 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 project
# (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 building 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 in depth 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 building to the action menu]]
# [[Constructions#Draw_area|How to build a construction]]
# [[Function|How to build a building]]
# [[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===
===Loading in GeoJSON===
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.
 
# 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.
 
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 a [[Indicators#Adding/removing indicators|personal 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. The SSH and Student Housing may not have the Traffic Noise indicator. If necessary remove the Traffic Noise indicator from both stakeholders.
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 [[Water level area (Water Overlay)|water level area]] that can be imported in the [[Demo Basics Project]]. The file also contains (fictional) attribute values. By loading in this file into the editor, the new water level area is added with the attribute values as defined in the file.
# Check if the municipality also possesses the Traffic NO2 indicator
# 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.
In preparation download the example area file.
# How to [[Stakeholders#Adding a stakeholder Indicator|adjust indicators per stakeholder]]


Depending on the previous assignment, you will now adjust the weighting of the indctors 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.
# Import the GeoJSON file as an area
# Adjust the weighting of the indicators for the Municipality to: Traffic NO2 35%,  Livability 50% and Budget 15%
# Verify the desired attributes are selected and finish the import process
# Adjust the weighting of the indicators for the Waterboard to: Traffic NO2 25%,  Water storage 50% and Budget 25%
# 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.
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]]
# 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:
* [[Indicators]]
* [[GeoJSON]]
* [[Stakeholders]]
* [[Area]]
 
* [[Attribute]]
===Loading in GeoJSON===
* [[Overlay]]
 
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.
 
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.
 
{{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".}}
 
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]].


For more information on this topic, visit the following pages:
[[Category: tutorials]]
* [[GeoJSON]]
* [[Function Values]]

Latest revision as of 09:27, 13 July 2023

Redirect to:

This page offers a number of assignments that help you get acquinted with some of the basics of the Tygron Platform

These assignments can be done in the Demo Basics Project. This project is available in all domains.

Starting the project

After logging in with the Tygron Client, you will find yourself in the main menu. Select "Edit Project", and then select the Demo Basics 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 Visualization in the center. If you don't want to save the adjustments you make in these practice assignment, 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 Demo Basics 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.

Create 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 in-depth information.

  1. How to add a User

Adjust the project 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 Visualization and now it's gone. How is that possible?

Remove building

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

Place new building

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

Adjust Floor height

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

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

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

  1. How to add and remove buildings
  2. How to edit building properties
  3. How to draw selections for buildings

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

Adjust the project 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 project 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 project
  4. (Notice the test run has started) Stop the Testrun and notice the new build building disappears.

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

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

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 water level area that can be imported in the Demo Basics Project. The file also contains (fictional) attribute values. By loading in this file into the editor, the new water level area is added with the attribute values as defined in the file.

In preparation download the example area file.

  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: