Basic skills tutorial: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
No edit summary
(Redirected page to Basics tutorial)
Tag: New redirect
 
(77 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.


===Adjust the 3D world in the editor===
===Create 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.


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.  
# 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 in-depth information.
# [[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?'' [[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 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.
<br>1) 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.
<br>2) 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.
<br>3) 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.
<br>1) [[Constructions#Removing_constructions|How to remove a construction in the 3D world]]
# [[How to add and remove buildings]]
<br>2) [[Constructions#Adding_constructions|How to add a construction in the 3D world]]
# [[How to edit building properties]]
<br>3) [[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 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 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.
<br>1) 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
<br>2) Add a build Education Luxury option to the action menu
# Add a build Sports Centre option to the action menu
<br>3) Build an Education Luxary building in the 3D world
# Build an Sports Centre building in the project
<br>4) (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.
<br>1) [[Actions#Adding_and_removing_action_menu.27s|How add a action menu]]
# [[Actions#Adding_and_removing_action_menu.27s|How add an action menu]]
<br>2) [[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]]
<br>3) [[Constructions#Draw_area|How to build a construction]]
# [[Function|How to build a building]]
<br>4) [[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 an indicator===
 
In this assignment you will add a standard indicator to the project. This indicator is a calculation model available in any project. Once added, it will automatically start to calculate and influence the score of the stakeholder for whom it was added.
 
{{Editor steps|preamble=Adding a new indicator|Select "Indicators" &rarr; "Indicators" in the [[ribbon]].|At the bottom of the [[left panel]], select the "Traffic Noise" indicator type.|Select "Add". Notice the indicator is added to the [[topbar]].}}
 
The indicator can now be selected in the [[topbar]]. This means that the current stakeholder will see it during a session. However, when you switch to the perspective of a different stakeholder the indicator will not be directly visible. This is because the indicator has not yet been added to the perspective of other stakeholders.
 
{{Editor steps|preamble=Adding an exisiting indicator to a stakeholder|In the top right of the editor, switch to a different stakeholder perspective. Select "Stakeholders" &rarr; "Stakeholders" in the [[ribbon]].|In the [[left panel]], select the current perspective's stakeholder.|Notice that under the stakeholder's entry, a list of levels appear. Select the first level.|At the bottom of the [[right panel]], use the dropdown menu to select "Traffic Noise".|Select "Add".|Notice the indicator is added to the [[topbar]].}}
 
For more information on this topic, visit the following pages:
* [[Indicators]]
* [[Stakeholders]]
 
===Adding and removing a construction===
 
In this assignment you will create a construction in the base-state of the world. This means that the construction will be present at the start of the session. This will occur in 2 steps: first the construction will be made part of the project, and then it will also be assigned a location in the world.
 
After that, you will remove a construction from the base-state of the world. This means the construction will not be present at the start of the session. It will not be removed from the world separately, but will be removed entirely.
{{Editor steps|preamble=Creating buildings|Select "Geo data" &rarr; "Buildings" in the [[ribbon]].|Select "Add" in the bottom of the [[left panel]].|See the properties of the building appear in the [[right panel]].|Select "Draw Area".|Find a location in the world which is not colored grey. Places which are not grey are valid to draw.|Create a selection in the world which is at least partially green.|In the [[brush panel]], select "Apply Selection".}}
 
{{Editor steps|preamble=Removing buildings|Select "Geo data" &rarr; "Buildings" in the [[ribbon]].|Select a building by selecting it in the list in the [[left panel]], or by selecting it in the world.|Select "Remove".|Confirm that you wish to remove this construction.}}
 
For more information on this topic, visit the following pages:
* [[Constructions]]
* [[Brush panel]]
 


===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 [[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.


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.


{{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]]
 
[[Category: tutorials]]

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: