Indicator: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
No edit summary
 
(39 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[File:Api_current_situation_calculation.png|thumb|right|400px|[[Overlay]] in comparison to [[Measurement]]s, [[Indicator]]s and [[Global]]s]]
[[File:Api_current_situation_calculation.png|thumb|right|400px|[[Overlay]] in comparison to [[Measurement]]s, [[Indicator]]s and [[Global]]s]]
Indicators are named after Key Performance Indicators, which serve as a means to identify potential improvements, and as a metric for the degree to which those improvements have been successful.
Indicators are named after Key Performance Indicators, which serve as a means to identify potential improvements and as a metric for the degree to which those improvements have been successful.


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. Indicators can also be inspected by clicking on its element in the top bar, which opens the ''indicator panel''.
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. Indicators can also be inspected by clicking on its element in the top bar, which opens the [[indicator panel]].
 
The progress made on an indicator depends on the ''absolute score'' setting of the indicator:
* When selected, the progress is based on the absolute score.
* When not selected, the progress is relative to the calculate score in the current situation. Such an indicator will measure the relative improvements.


In the indicator panel, the indicator's full name is shown in the title, along with a description and indicator progress on the left. On the right part of this panel a calculated score and an ''explanation'' are shown. The score and ''explanation'' are produced by the indicator's [[Excel Sheet]]. Basically, this excel sheet should be able to calculate a score and an ''explanation'' and place this in designated excel sheet cells. The excel sheet is also able to obtain information from a project using [[TQL|Tygron Query Language (TQL)]] statements. For more in depth information on indicator excel sheets, see [[Excel]] and [[Excel indicator]].
In the indicator panel, the indicator's full name is shown in the title, along with a description and indicator progress on the left. On the right part of this panel a calculated score and an ''explanation'' are shown. The score and ''explanation'' are produced by the indicator's [[Excel Sheet]]. Basically, this excel sheet should be able to calculate a score and an ''explanation'' and place this in designated excel sheet cells. The excel sheet is also able to obtain information from a project using [[TQL|Tygron Query Language (TQL)]] statements. For more in depth information on indicator excel sheets, see [[Excel]] and [[Excel indicator]].


[[File:Tql_webinar.png|link=https://www.tygron.com/nl/2019/05/22/tql-en-upgrades/]]     [[File:Indicators.jpg|link=https://youtu.be/9lXiqef12aI|230px|]]
[[File:Interface_game_indicator_panel.jpg|250px|left|thumb|The [[indicator panel]]. The left side displays the name, importance, and description of the indicator, as well as a graph showing its progress over time. The right side displays more information on the current situation and how to improve it.]]


See also the [https://www.youtube.com/watch?v=Vv1XA3HCOyQ&t=734s F.A.Q. webinar] for an explanation about Indicators.
[[File:Interface_indicator_panel_green.jpg|250px|thumb|center|The [[indicator panel]] of a green indicator from the [[GeoShare]]. For this indicator, the score graph is turned off. The indicator only calculates a score for [[Neighborhoods]] that are active.]]
 
{{clear}}
==Relation to stakeholders==
==Influencing Indicators==
By default, when adding an indicator, it is visible and accessible by all stakeholders, through an icon in the [[top bar]]. Access to an indicator can be restricted when it is made personal; a link to a stakeholder can be configured for an indicator. This stakeholder is then considered the owner of the indicator.
During a session, users' actions can influence Indicators, directly by spatial adjustments and [[TQL|spatial TQL statements]] and indirectly through [[Grid Overlay]] results and subsequent [[TQL|Grid TQL statements]]. It is up to the users to adjust their actions to improve the score on their Indicators. Also note that an action can also have effects on personal indicators of other stakeholders. 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.
 
For more information on adding and removing indicators to stakeholders, see [[stakeholders]].
 
This relationship between an indicator and its personal stakeholder can be queried using TQL:
* Stakeholder name: <code>SELECT_NAME_WHERE_INDICATOR_IS_17_AND_RELATION_IS_OWNER</code>
* Stakeholder id: <code>SELECT_ID_WHERE_INDICATOR_IS_17_AND_RELATION_IS_OWNER</code>
 
<gallery widths=200px heights=200px>
File:Personal_heat_indicator.png| A personal heat indicator for the municipality. It is only visible in the top bar for this specific stakeholder.
</gallery>


===Influencing Indicators===
[[File:Improving_green_indicator.jpg|thumb|left|250px|Improving the green indicator by planning a forest of deciduous trees. The improvement is shown in green in the [[Action log panel]].]]
During a session, users' actions can influence Indicators, directly by spatial adjustments and [[TQL|spatial TQL statements]] and indirectly through [[Grid Overlay]] results and subsequent [[TQL|Grid TQL statements]]. It is up to the users to adjust their actions to improve the score on their Indicators. Also note that an action can also have effects on personal indicators of other stakeholders. 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.
{{clear}}
The current situation (original) and maquette (planned) situation can be compared by switching between these situations using the buttons in the [[top bar]].
[[File:Current_situation_green_indicator.jpg|thumb|left|250px|Current situation of the green indicator when planning a forest of deciduous trees. Notice the selected ''original'' button in the [[top bar]].]]
[[File:Maquette_situation_green_indicator.jpg|thumb|center|250px|Maquette situation of the green indicator when planning a forest of deciduous trees. Notice the selected ''planned'' button in the [[top bar]].]]
{{clear}}


==Indicators on the {{geoshare}}==
==Indicators on the GeoShare==
You can also import indicators from the {{geoshare}}. There is a set of indicators made available in the public domain of the {{geoshare}}. It is also possible to import indicators from {{geoshare}} of your [[domain]]. All indicators from the default public share have a page on the wiki with an additional explanation, which indicates if you need to add or edit something to your project when you import that indicator. For Example, some indicators make use of multiple [[Global]]s, an [[Overlay]] or [[Area]]s that needs to be implemented in order for the indicator to work.
You can also import indicators from the {{geoshare}}. There is a set of indicators made available in the {{Public Share}}. It is also possible to import indicators from {{geoshare}} of your [[domain]]. All indicators from the default public share have a page on the wiki with an additional explanation, which indicates if you need to add or edit something to your project when you import that indicator. For Example, some indicators make use of multiple [[Global]]s, an [[Overlay]] or [[Area]]s that needs to be implemented in order for the indicator to work.
<gallery heights=300px widths=300px>
<gallery heights=300px widths=300px>
File:Share_public_indicators_editor.png|The default indicators shown in the indicators tab in the editor.
File:Share_public_indicators_editor.png|The default indicators shown in the indicators tab in the editor.
Line 34: Line 32:


The available default indicators are listed below.
The available default indicators are listed below.
Some of these indicators already perform specific calculations and can be directly used in the project. They can also be [[Excel indicator|modified and extended with adjusted calculation]]s. It is also possible to implement your own indicator, using an [[Excel|Excel file]]. This Excel file should be imported into your project and assigned to an indicator. Each added indicator is initially empty, and will require some work to set up, but it is highly customizable.
Some of these indicators already perform specific calculations and can be directly used in the project. They can also be [[Excel indicator|modified and extended with adjusted calculation]]s.  
 
It is also possible to implement your own indicator, using an [[Excel|Excel file]]. This Excel file should be imported into your project and assigned to an indicator. Each added indicator is initially empty, and will require some work to set up, but it is highly customizable.
 
==Relation to stakeholders==
By default, when adding an indicator, it is visible to and accessible by all stakeholders, through an icon in the [[top bar]]. Access to an indicator can be restricted when it is made personal; a link to a stakeholder can be configured for an indicator. This stakeholder is then considered the owner of the indicator.
 
For more information on adding and removing indicators to stakeholders, see [[stakeholders]].


====Personal Indicators====
This relationship between an indicator and its personal stakeholder can be queried using TQL with the [[Relation (TQL Param)|Relation parameter]]:
The following indicators are personal indicators by default:
* Stakeholder name: <code>SELECT_NAME_WHERE_INDICATOR_IS_17_AND_RELATION_IS_OWNER</code>
{|class=wikitable
* Stakeholder id: <code>SELECT_ID_WHERE_INDICATOR_IS_17_AND_RELATION_IS_OWNER</code>
! Type
! Main Article
! Description
|-
| Budget
| [[Budget (Indicator)]]
| The amount of money available to a stakeholder. Most actions in the {{software}} 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.
|}


====Shared indicators====
When using an excel for an Excel Indicator, you can also access the stakeholder directly using:
The following indicators are shared by default:  
* Stakeholder name: <code>SELECT_NAME_WHERE_STAKEHOLDER_IS_ID</code>
* Stakeholder id: <code>SELECT_ID_WHERE_STAKEHOLDER_IS_ID</code>


{|class=wikitable
[[File:Personal_heat_indicator.png|thumb|right| A personal heat indicator for the municipality. It is only visible in the top bar for this specific stakeholder.]]
! Type
! Main Article
! Description
|-
| Density
| [[Density indicators]]
| The Density indicator exists of three indices which defined density in an area. These are:
* FSI - Floor Space Index or Floor Area Ration
* GSI - Ground Space Index
* OSR - Open Space Ration
|-
| Green
| [[Green (Indicator)]]
| The public green indicator represents the ratio between houses and nature within a district.
|-
| Heat Stress
| [[Heat (Indicator)]]
| Heat stress is the amount of green and water in an area versus the paved surfaces. More trees and open water areas increase the score for Heat stress. Buildings and concrete decrease the score for Heat stress.
|-
| Heat Reduction
| [[Heat Reduction (Indicator)]]
| The Heat Reduction indicator computes the effect of urban green on heat reduction. This indicator is a simplified version of an RIVM calculation model and was created for a pilot with that institution.
|-
| Housing target
| [[Housing target (Indicator)]]
| The housing target indicator calculates the number of houses that are added to a the project current situation and relates this to the total amount of houses that need to be building (target).
|-
| Parking
| [[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
| [[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.
|-
| Traffic Noise
| [[Traffic Noise (Indicator)]]
| The amount of houses that have to much Traffic Noise (in dB).
|}


{{article end
{{article end
|seealso=
* [[Excel Indicator]]
* [[TQL]]
|howtos=
|howtos=
* [[How to add, remove and duplicate an Indicator]]
* [[How to add, remove and duplicate an Indicator]]
* [[How to edit Indicator properties]]
* [[How to edit Indicator properties]]
* [[How to edit Indicator targets]]
* [[How to edit Indicator targets]]
* [[How to configure a Query for an Excel Indicator]]
* [[How to implement an Excel Indicator]]
* [[How to make the Green Garden Indicator]]
* [[How to manually adjust Indicators in Excel]]
* [[How to use the Query Tool to test queries from an Excel Indicator spreadsheet]]
* [[How to change Function Values for a Function]], to adjust the effects actions have on Indicators.
* [[How to change Function Values for a Function]], to adjust the effects actions have on Indicators.
* [[How to implement an Excel Indicator]]
* [[How to make an Indicator visible to only one stakeholder]]
|seealso=
|videos=
* [[Excel indicator]]
{{video|youtube=Vv1XA3HCOyQ&t=734s}}
* [[Excel]]
|external=
* [https://www.youtube.com/watch?v=Vv1XA3HCOyQ&t=734s TQL and Indicators Webinar]
}}
}}


{{Template:Editor current situation nav}}
{{Editor current situation nav}}
 
{{Indicator nav}}
[[Category:Items]][[Category:Indicator]]
[[Category:Items]][[Category:Indicator]]

Latest revision as of 09:19, 12 February 2024

Overlay in comparison to Measurements, Indicators and Globals

Indicators are named after Key Performance Indicators, which serve as a means to identify potential improvements and as a metric for the degree to which those improvements have been successful.

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. Indicators can also be inspected by clicking on its element in the top bar, which opens the indicator panel.

The progress made on an indicator depends on the absolute score setting of the indicator:

  • When selected, the progress is based on the absolute score.
  • When not selected, the progress is relative to the calculate score in the current situation. Such an indicator will measure the relative improvements.

In the indicator panel, the indicator's full name is shown in the title, along with a description and indicator progress on the left. On the right part of this panel a calculated score and an explanation are shown. The score and explanation are produced by the indicator's Excel Sheet. Basically, this excel sheet should be able to calculate a score and an explanation and place this in designated excel sheet cells. The excel sheet is also able to obtain information from a project using Tygron Query Language (TQL) statements. For more in depth information on indicator excel sheets, see Excel and Excel indicator.

The indicator panel. The left side displays the name, importance, and description of the indicator, as well as a graph showing its progress over time. The right side displays more information on the current situation and how to improve it.
The indicator panel of a green indicator from the GeoShare. For this indicator, the score graph is turned off. The indicator only calculates a score for Neighborhoods that are active.

Influencing Indicators

During a session, users' actions can influence Indicators, directly by spatial adjustments and spatial TQL statements and indirectly through Grid Overlay results and subsequent Grid TQL statements. It is up to the users to adjust their actions to improve the score on their Indicators. Also note that an action can also have effects on personal indicators of other stakeholders. 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.

Improving the green indicator by planning a forest of deciduous trees. The improvement is shown in green in the Action log panel.

The current situation (original) and maquette (planned) situation can be compared by switching between these situations using the buttons in the top bar.

Current situation of the green indicator when planning a forest of deciduous trees. Notice the selected original button in the top bar.
Maquette situation of the green indicator when planning a forest of deciduous trees. Notice the selected planned button in the top bar.

Indicators on the GeoShare

You can also import indicators from the GeoShare. There is a set of indicators made available in the Public Share. It is also possible to import indicators from GeoShare of your domain. All indicators from the default public share have a page on the wiki with an additional explanation, which indicates if you need to add or edit something to your project when you import that indicator. For Example, some indicators make use of multiple Globals, an Overlay or Areas that needs to be implemented in order for the indicator to work.

The available default indicators are listed below. Some of these indicators already perform specific calculations and can be directly used in the project. They can also be modified and extended with adjusted calculations.

It is also possible to implement your own indicator, using an Excel file. This Excel file should be imported into your project and assigned to an indicator. Each added indicator is initially empty, and will require some work to set up, but it is highly customizable.

Relation to stakeholders

By default, when adding an indicator, it is visible to and accessible by all stakeholders, through an icon in the top bar. Access to an indicator can be restricted when it is made personal; a link to a stakeholder can be configured for an indicator. This stakeholder is then considered the owner of the indicator.

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

This relationship between an indicator and its personal stakeholder can be queried using TQL with the Relation parameter:

  • Stakeholder name: SELECT_NAME_WHERE_INDICATOR_IS_17_AND_RELATION_IS_OWNER
  • Stakeholder id: SELECT_ID_WHERE_INDICATOR_IS_17_AND_RELATION_IS_OWNER

When using an excel for an Excel Indicator, you can also access the stakeholder directly using:

  • Stakeholder name: SELECT_NAME_WHERE_STAKEHOLDER_IS_ID
  • Stakeholder id: SELECT_ID_WHERE_STAKEHOLDER_IS_ID
A personal heat indicator for the municipality. It is only visible in the top bar for this specific stakeholder.