Indicator: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
Line 194: Line 194:
====Excelsheet====
====Excelsheet====
[[File:Excelsheet.png|frame|right|The "Excelsheet" field.]]
[[File:Excelsheet.png|frame|right|The "Excelsheet" field.]]
: ''The Excelsheet section showes which Excelsheet is active for the specific indicator. The select Excelsheet button opens an overview panel of all the Excelsheets in the project. The [[Debug Excelsheet|Debug Excelsheet]] and [[CallTree Recordings|CallTree Recordings]] can be used for debugging the Excelsheet. This is mostly done when an error messages appears about the your Excelsheet. The Open in Web Browser link displays the target and score of the indicator in a seperate web page.''<br clear=right>
: ''The Excelsheet section showes which Excelsheet is active for the specific indicator. The select Excelsheet button opens an overview panel of all the Excelsheets in the project. The [[Debug Excelsheet|Debug Excelsheet]] and [[CallTree Recordings|CallTree Recordings]] can be used for debugging the Excelsheet. This is mostly done when an error messages appears about the Excelsheet. The Open in Web Browser link displays the target and score of the indicator in a seperate web page.''<br clear=right>


====Description====
====Description====

Revision as of 12:01, 1 May 2019

Template:Learned

Indicators

Indicators are the themes for which targets exist in a 3D World. They are named after Key Performance Indicators, by which organizations evaluate their success. Key Performance Indicators serve as a means to identify potential improvements, and as a metric for the degree to which those improvements have been successful.

How indicators relate to the Tygron Platform

Indicators are a primary part of your project, and serve as the guiding element by which users can determine whether they are making progress. Just like Key Performance Indicators, indicators in the Tygron Platform serve as a means to identify how to improve the situation for your stakeholder, and to what degree those improvements are affected by specific actions. By having the right indicators in a project, users are encouraged to take actions which would match the actions of the stakeholder in real life, and to quickly recognize the effects actions have on their own goals and the goals of other stakeholders.

Indicators in the Tygron Platform

Indicators are visible at the top of the interface. Each indicator is represented by a short name, and (with exception of the budget) is accompanied by a small progress bar to indicate how well you are performing on that indicator.

Each indicator has a name, a description, a color and a target. The target is the most important part of the indicator, because that is what drives a stakeholder to perform (or abstain from) an action. Each action a stakeholder takes is meant to advance their indicators.

Indicators and their relation to stakeholders

It is not necessarily so that each stakeholder has access to each indicator. Indicators which are not relevant to a stakeholder should not displayed. For example, a project developer has very specific business driven goals, which differ from (or even conflict with) the goals of a municipality. The indicators can be adjusted for every stakeholder individually and for the common goals the targets and weight of the indicator differ. So it is possible two stakeholder have the same goal, green for example and in this case, for the municipality it is more important to take action on implementing green than it is for the project developer. The difference in weight of the indicators can be adjusted in the indicator weights.

For more information on adding and removing indicators to stakeholders, see stakeholders.

The top bar of the interface. The current active indicators are Budget, Green and Building.


Indicator types

A number of indicatos are available in the Tygron Platform. The available indicators are listed below. Some of these indicators already perform specific calculations and can be directly used in the project, but they also can be modified and extended with customized calculations. It is also possible to implement your own indicators with your own defined calculations. This can be done for the Excel indicator. Because the Excel indicator is initially empty, it requires more work to set up, but also allow for more flexibility through customization.

Stakeholder specific indicators

This is an indicator that is specifically linked to a certain stakeholder. When you add this indicator it will only be visible for the stakeholder you add it to. For Example the Budget indicator only shows the budget amount for the specific stakeholder and it's target. After all, the budget of a stakeholder can differ and is a personal goal.

Budget
Main article: Budget (Indicator).
The amount of money available to a stakeholder. Most actions in the Tygron Platform require money by default. Actions which require spending more money than the stakeholder has available are sometimes allowed. However, should the stakeholder end up with a negative budget, their final score will be zero until their budget turns positive.
Building
Main article: Building (Indicator).
The amount of constructions that a stakeholder must reach. The targets for this indicator are subdivided into different types of constructions, such as luxury housing, offices, green and leisure. This indicator is unique in that a stakeholder will be penalized for exceeding their goal. Constructions are measured in units or by floor space.

Progress indicator

Lastly, each stakeholder also has a Progress indicator when you are in a Project session. This indicator cannot be altered directly. It sums up the scores achieved on the other indicators, based on their indicator weight. The progress indicator is a stakeholders total score.


Shared indicators

This is an indicator that is available for multiple stakeholders. When you add this indicator it will be visible for all stakeholders unless you remove it form a specific stakeholder. For Example the Green indicator shows the amount of green in the entire project area and is the same amount for all stakeholders. The weight and the target of the indicator can differ per stakeholder and that is how you can indicate the difference of this goal per stakeholder.

Green
Main article: Green (Indicator).
Green is the amount of green in an area. More trees and open (grassland) areas increase the score for green. Buildings and concrete decrease the score for green.
Heat Stress
Main article: Heat (indicator).
Heat stress is the amount of green and water in an area versus the paved serfaces. More trees and open water areas increase the score for Heat stress. Buildings and concrete decrease the score for Heat stress.
Parking
Main article: Parking (Indicator).
Parking is the amount of parking spaces in an area. Many buildings have an associated need for parking spaces nearby. By building parking facilities, the score on the parking indicator can be increased.
Livability
Main article: Livability (Indicator).
Livability is the extent to which an area is pleasant to live in. More open spaces, luxury buildings and green increase livability. Densification, poor quality buildings and lack of nature decrease livability.
Water Storage
Main article: Water Storage (Indicator).
The amount of water storage capacity in an area. A greater capacity for storing water means an area becomes more resilient when faced with rain. Areas of open water, water-permeable surfaces and other means of storage increase the score for water storage.
Traffic NO2
Main article: Traffic NO2 (Indicator).
The number of buildings that has trouble with a too high concentration of NO2 due to the traffic in that particular area.
Traffic Noise
Main article: Traffic Noise (Indicator).
The number of buildings that has trouble with too much noise (decibel) due to the traffic in that particular area.
Excel Indicator
Main article: Excel (Indicator).
This is an indicator which calculates a score and explanation using a Microsoft Excel file. This file can be written locally and uploaded to the Tygron Platform. In order to obtain information from a running session on the Tygron Platform, a query language has been developed. By using the 'named cell' functionality of Microsoft Excel, information can be sent back and forth to the Tygron Platform.

Index indicators

The Index in the indicatorpanel.

You can also get indicators in the Tygron Index. Here you can download indicators that are created by serveral Tygron Platform users and/or upload your own indicators. For the up to date overview of available indicators on our Index please check the Index page or enter the Index from the Community hub in your project. A brief overview of indicators in the Index is given below. All indicators on the Index have a page with an additional explanation on the wiki which indicates if you need to add or edit something to your project when you donwload and use the new indicator. For Example some indicators make use of a global, an overlay or an area that needs to be implemented in order for the indicator to work.

The Index in the Community hub.


Category Indicators
Built environment Student Housing Indicator
Risk contour indicator
Housing target indicator
Education Student Housing Indicator
Environment Traffic health impact
Risk contour indicator
Climate adaption indicator
Heat risk indicator
Health Risk contour indicator
Heat risk indicator
Participation Protest indicator
Transport Traffic health impact
Water Climate adaption indicator


Influencing indicators

During a session, users are able to influence indicators by taking actions. Almost every action has an effect on at least one indicator. It is up to the users to apply their actions appropriately to increase the score on their indicators. It is important to note that the effects of an action may extend to indicators which are not relevant to the acting stakeholder. For example, if a project developer creates a large office park where there previously was a forest, the amount of green will go down, which will negatively affect the goals of a municipality.

Indicator targets

The most important aspect of an indicator is its target. By working towards reaching the target of an indicator, a stakeholder can increase the total team score. Reaching their indicator targets is the reason stakeholders perform actions. When a stakeholder has reached the target for a specific indicator, they no longer need to perform actions for that specific target. Most projects have a balance wherein it is difficult, but not impossible, to reach the targets for all indicators. Together with the indicator weight and a stakeholder's assignment, they form a stakeholders objective.

Editing Indicators

In the editor, you can add, remove and change indicators as desired.

Adding/removing indicators

Template:Editor ribbon

The left panel for indicators in the editor.

Adding an indicator means making an indicator available for use in the project. By default, an indicator is automatically connected to the active stakeholder. This indicator may still need to be connected to another stakeholder. It is important to make sure the indicators are added to the stakeholders for whom they are applicable. For more information about adding indicators to stakeholders, please see stakeholders. When a shared indicator is removed, it is automatically removed from all stakeholders. When a stakeholder is removed, no indicators are removed from the project.


Adding and removing indicators can be done by following these steps:

How to add an indicator to the project:
  1. Select the type of indicator you wish to add.
  2. If applicable, select the stakeholder for whom to add the stakeholder.
  3. Select "Add".
How to remove an indicator from the project:
  1. Select the indicator you want to remove.
  2. Select "Remove".


Changing indicators

Template:Editor ribbon

The right panel for indicators in the editor.

Stakeholder

The dropdown menu for the stakeholder.
The stakeholder of the indicator. Stakeholder-specific indicators have a connection with a single stakeholder. When editing a stakeholder-specific indicator, you can change this by selecting a different stakeholder from the dropdown menu.

Name

The field for the "name".
The full name of indicator. This is the name that will appear as the title of the indicator in the project. You can change this by altering the text in the "Name" field.

Short name

The field for the "short name".
The short name of indicator. This will appear in areas where multiple indicators are summed up. You can change this by altering the text in the "Short name" field.

Absolute score

The checkbox for the "absolute score".

If the checkbox for absolute score is checked, the absolute score of the indicator is used. The score is a value between 0 and 100%. What exactly 0% is, is adjustable with this checkbox. If the checkbox is not checked, 0% is the state of the current situation. The indicator therefore always starts at 0. If you make changes to the current situation by demolishing or building constructions, a new score is calculated based on the impact of the changes to the current situation. If you use the absolute score, a score is already calculated for the current situation, therefore the indicator can already have a value of for example 60%. By making changes to the current situation, the score changes. Here the 0% is thus defined by the formulas in the excelsheet of the indicator.

Graph

The checkbox to show the "score graph".

If the checkbox for show score graph is checked, the score graph is visible in the Indicator panel. This score graph is especially useful when playing a timeline game in where the graph shows how the score changes over time. If the checkbox is unchecked, the score graph is not visible. By leaving the text in the description box empty, the full space in the indicator panel can be used for example for showing the output of an Excel indicator.

Color

The "color" square.
The color of the indicator. The color will be used to display the indicator in graphs and charts. You can change this selecting the color field. A panel will appear in which you can specify the desired color.

Active

The "active" checkbox.
Whether the indicator is active. Inactive indicators remain connected to stakeholders, but are unseen and have no effect. You will most likely want this checkbox checked. Toggle between the indicator being active and inactive by clicking the check box.

Image

The "image" selection field.
The indicator image, as displayed on the top bar, next to the indicator progression bar. It is possible to upload a custom image to the Tygron Platform. This image has to be uploaded as a .png file, and has to be exactly 39 x 39 pixels small.

Excelsheet

The "Excelsheet" field.
The Excelsheet section showes which Excelsheet is active for the specific indicator. The select Excelsheet button opens an overview panel of all the Excelsheets in the project. The Debug Excelsheet and CallTree Recordings can be used for debugging the Excelsheet. This is mostly done when an error messages appears about the Excelsheet. The Open in Web Browser link displays the target and score of the indicator in a seperate web page.

Description

The text area for the "description".
The description of the indicator. Most indicators have a default description, but by customizing this text it is possible to guide the users towards specific actions, provide hints or refer to other sources of information. You can change this by altering the text in the "Description" area.

Changing indicator targets

The "targets" table.

The target for the indicator is the most important property. By setting the target, you are directly instructing the stakeholder what they should strive for in the project. Depending on the selected indicator type, one or more values can be entered for targets. For example: for a budget indicator, you only need to set the amount of money the stakeholder should have remaining. For the building indicator, you can enter a separate target for each type of building. You can change the targets of an indicator in the "Target for current level" table. In the "Description" column, you can see the description of which row represents which aspect of the target of an indicator. You can enter a numeric target value in the "Target" column. This value must lie within the range indicated by the "Minimum" and "Maximum" columns.

Changing the effect of actions on indicators

It is possible to adjust the effects actions have on indicators. For more information on this, please see functions.