Demo Basics Project 1 and How to add rain barrels to your project: Difference between pages

From Tygron Support wiki
(Difference between pages)
Jump to navigation Jump to search
 
No edit summary
 
Line 1: Line 1:
=Indicators=
A rain barrel can be added to a project as an action to improve drainage capacities. Besides that it can also help to improve the awareness of residents towards neighbourhood water management. This how-to will explain how to add a rain barrel to your project and use it as an upgrade.


{| class="wikitable"
{{editor location|Function Values}}
|+ Information
{{editor steps|title=add a rain garden to your project
! Steps
|Hover over the buildings button and select ''Edit Function Values''.
| 5
|Select the ''standard garden'' in the Function Values list (if the standard garden is not in the list yet, you need to add it by pressing the ''Add'' button next to Function and select the ''standard garden'').
|-
|Duplicate the ''standard garden'' by selecting ''Duplicate''.
! Time indication
|Adjust the name of ''standard garden (2)'' into ''Garden with Rain barrel'' by double clicking on the name.
| 60 minutes
|[[How_to_change_Function_Values_for_a_Function|Adjust the function values]] to the desired settings.
|-
}}
! Institution
{{editor location|Upgrade}}
| Tygron
{{editor steps|title=add a rain barrel as an upgrade
|-
|Go to the [[upgrades|Upgrade Types]] ribbon and add a new Upgrade by pressing the ''Add'' button in the bottom left corner.
! Language
|A new Upgrade Type appears, modify the Upgrade Type in the right-sided panel.
| English
|Rename the Upgrade in ''Rain Barrel Garden Upgrade''.
|}
|Press Add Pair in the bottom panel.
|Change the function in the bottom panel by selecting ''standard garden'' as the Input Function and ''Garden with Rain Barrel'' as the Resulting Function.
|A new Upgrade has been created.
}}
[[File:Rain Barrel.JPG|right|thumb|500px|The Rain Barrel Upgrade]]
{{editor location|Actions}}
{{editor steps|title=add a rain barrel as an action
|Go to the [[actions]] ribbon and add a new action by pressing the ''Add'' button in the bottom left corner.
|A new action menu appears, modify the action in the right-sided panel.
|Rename the Action in ''Rain Barrel''.
|Change the image by clicking on the ''Image'' and selecting the ''category_waterbasket.png'' as image.
|Assign the Action to the desired Stakeholder by selecting them in the Level dropdown menu.
|Select Actions in the ribbon on the right-side panel
|Select ''Rain Barrel Garden Upgrade'' in the upgrades drop-down menu.
|A new action has been created.
}}




In a project case you have goals and objectives. For example, to build more houses, to improve the water system to prevent flooding or to create more green, open public space. These objectives are implemented in the project as indicators. These indicators represent the goals and contain targets and calculation models to calculate the effects of the scenarios in the 3D world and to check if the target is met or not.
==Notes==
{{clear}}
*The [[Function_Value|function values]] used for the Rain Barrel Garden are free to be selected by the user
Do you prefer to watch [https://www.youtube.com/watch?v=9lXiqef12aI a video tutorial]? This is the tutorial about the default indicators in the Tygron platform. This course does go a little bit deeper into the options you have to use [[Excel_(Indicator)]] than the video.
*It's important to emphasize that the rain barrel upgrade is an example. The user can define its own functions, both the in and output, dependently on the Use Case.
All indicators are based on Excel sheets and therefore it is possible to create your own indicators. In the Tygron Index (https//store.tygron.com/) there are more indicators you can download to import in your project. It is also possible to upload your own indicators to share with other members of the Tygron community. More information about how to create your own indicators can be found on the Tygron Support wiki and in the webinar about indicators and TQL. We share the links to this information at the end of this course. In this course we do not get into how to create your own indicators, we do however show a glimpse of an Excel indicator to inform you about the principles of these calculation models.
{{clear}}
Very important to take into account, THERE IS NO UNDO BUTTON IN THE EDITOR. All actions performed in this tutorial will be permanent if you save your project. If you don’t want the performed actions to be permanent either don’t save your project or immediately change the settings back to the way they were before the actions you will perform.
These are some examples of why you want to edit the baseline project manually. Take note that when you edit the baseline project you are working in the CURRENT SITUATION tab.


===Step 1===
==See also==
[[File:ImageIndicator.jpg|thumb|right|400px|Overview of indicators in the {{software}}.]]
* [[How to create Functions]]
Open the Indicators option in the Header. Now we go add, remove and edit a default indicator. When you select the Indicators option you will get an overview of all indicators that are present in the project in the left panel. When you hover over the Indicators option a menu opens up with some default indicators.
* [[How to add Functions for editing]]
You can pick one of these indicators and as soon as you picked one you will see the indicator is added to the top bar in the 3D world interface.
Pick another indicator and add this to the project but this time you use the dropdown menu in the left bottom of the left panel and select an indicator followed by selecting Add. Again the Indicator is added to the top bar and to the list of indicators in the left panel. Repeat this with two more indicators, for example also add the building indicator if you didn’t do that already.
Now select an indicator in the left panel and select remove in the left bottom corner. The indicator can now be removed from the entire project. To edit the indicator you can select one in the left panel so the options for this specific indicator will be displayed in the right panel. In this example, we use the building indicator. In the right panel, you can edit the name and the image and give a description of what this indicator calculates. In the middle panel, the target for this indicator can be set. In this case the target is divided in types of buildings. Per building type, a target can be set. Based on the type of building you either fill out the number of houses or the amount of floor space. How this is divided can be checked on this Tygron Support wiki page [[Housing (Indicator)]].
Select some building types and enter some targets in the middle panel.
Next, select the indicator in the 3D world interface by clicking on the indicator in the top bar. A new panel opens up and here you see the target you have set and the description you could enter in the right panel.
 
 
===Step 2===
There is a difference between personal and shared indicators. A personal indicator is an indicator that is appointed to a specific stakeholder. For example, both the municipality and the project developer can have a building indicator. The municipality needs to develop new public space and green while the project developer needs to build new social- and market houses. You can select the building indicator and appoint a specific stakeholder for that indicator in the right upper menu in the right panel. Now the indicator is specific for the selected stakeholder so you can set a separate target for both of the stakeholders.
You can also choose to use one or more shared indicators. This is mostly used for indicators that relate to the entire project area. For example the green indicator or the heat stress indicator. Both indicators calculate the situation for the project area and it doesn’t matter which stakeholder you are, it is as green for the municipality as it is for the project developer. The same for the heat stress indicator, this indicator calculates the amount of heat stress in the project area regardless of who you represent. What does matter in this case is if you are able to influence the indicator from your stakeholder role and how important of a target this is for you. For example, the municipality needs to develop public space and has much importance to work on the green indicator. They can do that by performing actions within their ability and therefore it is logical that the municipality will have a green indicator with a relative high indicator weight. The project developer is also benefiting from having a green environment but is limited in the possibilities to build green space. Land to build on is expensive and a house does provide more profit than a park for the project developer. On the other hand, if he provides some houses with small green spaces in between he can earn more profit because the houses are situated in an area with high livability. This stakeholder can also have a green indicator but the indicator weight is relatively low.
Make sure you have at least two personal indicators and two shared indicators in your project.
 
===Step 3===
Set the indicator weights. You can give the indicators an indicator weight to express the importance of an indicator.
 
This is done per stakeholder. Here you divide the importance of all indicators a stakeholder has to focus on. It could be that a stakeholder has 4 indicators but not all indicators are equally important. For example, for the project developer, the budget and the building indicator will be more or less equally important while the green indicator is far less important. To set the difference per stakeholder for indicators, go to the MULTI STAKEHOLDER tab and select the Stakeholders Option. In the left panel select the stakeholder you want to set the indicator weights for and select Level info beneath the stakeholder name. In the right panel, you will see a table in the right bottom corner where the indicator is display followed by a value.
The values are combined 1 or so to say 100% and can never be over 100%. By default, the importance is divided equally. You can change the importance and therefore decide what indicators need to be fulfilled in the scenarios to be a successor acceptable and which ones are less important and are nice to have fulfilled partially.
In the dropdown menu in the indicator weights table you can select all other indicators that are present in the project to assign this indicator to this specific stakeholder as well. You can also delete one or more indicators from the table so the indicator will be removed as an indicator for this specific stakeholder. You need to set the indicator weights per stakeholder by selecting the next stakeholder in the left panel and go to Level info to divide all indicators and the indicator weights for all indicators in the entire project.
You can switch to the different stakeholder roles and quickly check if the importance is correct per indicator by selecting a stakeholder role in the right upper corner and hover over the indicators in the top bar in the 3D world interface.
 
===Step 4===
As explained before you can download and upload more indicators form the [https://store.tygron.com/ Tygron Index]. Each indicator has a description to get informed on what this indicator calculates. The indicators also have a manual where you get instructions on how to configure the indicator if needed. In the manual a more explicit description is given and the calculation model is explained.
Go to the Index and download and import a new indicator in your project. Select the COMMUNITY tab and the Index option. A new panel will pop up and now you have entered the Tygron Index.
Select one of the indicators and place it in your cart. If you want you can add more indicators to your cart before you proceed to checkout.
If you have all indicators you want in you cart proceed to the checkout. Here you can enter your email address and place your order. 
The selected indicators will be send to your email address for you to download the excels. The downloaded excel can be imported by drag and drop imported in your project.
In the final screen of the Tygron Index you can also see the downloadable Excel sheet. You can also choose to import the indicator directly from the Index screen.
The Indicator is now imported directly in the project. You can select the Indicator option in the new popup panel and the indicator will be added to the top bar in the 3D world interface and the left panel of the indicator option.
====Question 1====
Download the green index or use the default one and indicate what the score is of ''Platteweg''
{{collapse|title=Answer|3656|float=left|width=50em}}
{{clear}}
 
Based on which indicator you have selected it could be needed to follow some instructions in the manual to configure the indicator a little bit.
 
===Step 5 Excel and TQL===
Before starting this step, it's advised to first take a look at [[Indicator_Tutorial_(Solar_Panels)|this page]]
{{clear}}
As told before, in this course we do not get into how to create your own Excel indicator, however, we do explain in general how an Excel sheet is used to create indicators.
Every Excel sheet has some standard values that are needed in order to communicate with the Tygron Platform. There needs to be an input, these are the queries you can create with the Tygron Query Language (TQL) tool. Output, this is done in the form of the EXPLANATION cell and a SCORE cell.
Every Excel Indicator that can be downloaded in the Tygron Index that is offered by Tygron has the same build-up to make it clear and helps you to repeat it for your own indicator. Feel free to download an indicator and open the (debug) sheet to get an example of how an indicator can be built.
If you do the written tutorial, combined with the webinar, you can use the template excel which is situated like the sheet below.
The grey and orange area in this example Indicator is meant for requesting information from the Tygron Platform using queries (TQL). The light blue area is meant for calculations - for instance, adding and subtracting data from the Platform. The area on the far right is the HTML table meant for presenting the results.
In the Orange cells you can add the queries you create with the TQL tool.
These queries request a number from the project that can be used for the calculations you enter in the light blue part. For example, you can request the number of luxury apartments in the project area. The query will be displayed and can be copied in your excel sheet in the orange cell. You can make the query as specific as you want. You could make the request for luxury apartments more specific by adding a neighborhood clause for example and only the luxury apartments in that specific neighborhood will be provided by the Platform as an input in that cell.
 
====Question 2====
Using the TQL tool, what is the height of the Neigborhood Wethouder Venteweg?
{{collapse|title=Answer|TQL:SELECT_HEIGHT_WHERE_NEIGHBORHOOD_IS_0 and gives -1,6|float=left|width=50em}}
{{clear}}
Every time you start a new scenario or change something in the project area by performing an action, the Excel sheet will be calculated again and the updated input will be provided, calculated in the calculation and the new output will be generated and shown in the indicator panel in the 3D world interface.
If you are interested in experimenting with this please execute the written tutorial [[Indicator Tutorial (Solar Panels)]] in combination with [https://www.tygron.com/nl/2019/05/22/tql-en-indicators the webinar]
 
===See Also===
*[[Excel]]
*[[Excel (Indicator)]]
*[[Tygron Query Language]]
 
{{Overlay demo basics}}

Revision as of 10:08, 5 July 2021

A rain barrel can be added to a project as an action to improve drainage capacities. Besides that it can also help to improve the awareness of residents towards neighbourhood water management. This how-to will explain how to add a rain barrel to your project and use it as an upgrade.

Editor → Current Situation (Ribbon tab) → Buildings (Ribbon bar) → Edit Function Values (Dropdown)
How to add a rain garden to your project:
  1. Hover over the buildings button and select Edit Function Values.
  2. Select the standard garden in the Function Values list (if the standard garden is not in the list yet, you need to add it by pressing the Add button next to Function and select the standard garden).
  3. Duplicate the standard garden by selecting Duplicate.
  4. Adjust the name of standard garden (2) into Garden with Rain barrel by double clicking on the name.
  5. Adjust the function values to the desired settings.
Editor → Future Design (Ribbon tab) → Upgrade Types (Ribbon bar) → The Upgrade Type to edit (Left panel)
How to add a rain barrel as an upgrade:
  1. Go to the Upgrade Types ribbon and add a new Upgrade by pressing the Add button in the bottom left corner.
  2. A new Upgrade Type appears, modify the Upgrade Type in the right-sided panel.
  3. Rename the Upgrade in Rain Barrel Garden Upgrade.
  4. Press Add Pair in the bottom panel.
  5. Change the function in the bottom panel by selecting standard garden as the Input Function and Garden with Rain Barrel as the Resulting Function.
  6. A new Upgrade has been created.
The Rain Barrel Upgrade
Editor → Future Design (Ribbon tab) → Actions (Ribbon bar) → The Action Menu to edit (Left panel) → Actions tab (Right panel)
How to add a rain barrel as an action:
  1. Go to the actions ribbon and add a new action by pressing the Add button in the bottom left corner.
  2. A new action menu appears, modify the action in the right-sided panel.
  3. Rename the Action in Rain Barrel.
  4. Change the image by clicking on the Image and selecting the category_waterbasket.png as image.
  5. Assign the Action to the desired Stakeholder by selecting them in the Level dropdown menu.
  6. Select Actions in the ribbon on the right-side panel
  7. Select Rain Barrel Garden Upgrade in the upgrades drop-down menu.
  8. A new action has been created.


Notes

  • The function values used for the Rain Barrel Garden are free to be selected by the user
  • It's important to emphasize that the rain barrel upgrade is an example. The user can define its own functions, both the in and output, dependently on the Use Case.

See also