Global: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
|||
| (79 intermediate revisions by 6 users not shown) | |||
| Line 1: | Line 1: | ||
[[File:Api_current_situation_calculation.png|thumb|right|400px|[[Global]]s in comparison to [[Overlay]]s, [[Indicator]]s and [[Panel]]s]] | |||
A global is a value that exists in the project but is not necessarily connected to a specific component. The global can be used, for example in Excel calculations and influence the calculation of an Excel indicator. A global is similar to an [[attribute]] but for the entire project rather than for a specific component. The name of the global is also the global [[ID]] that can be used in queries. | |||
==Global== | ==Global uses== | ||
Globals can be used, broadly speaking, to store and recall values. The most common application of this is in combination with [[excel]] sheets. Using [[TQL]], the value of a global can be loaded into an excel sheet and used in calculations. The values of globals can also be [[TQL#Numeric_values|set using TQL]] from excels. Globals can also be used to directly influence the budget of a specific [[Stakeholder|stakeholder]]. Lastly, globals can be made visible in the [[3D Visualization]]. | |||
==Properties of globals== | |||
A global is always made up of a name and a number. Based on the purpose of the global the number represents an amount or a value which is specified by the name. | |||
===Output=== | ===Output=== | ||
By | By using a <code>SELECT_GLOBAL_WHERE_NAME_IS_GLOBALID</code> query you can obtain the value of a global. This global's value can then be used in [[Excel|Excel]] calculations. | ||
It is also possible to connect the global to the budget of a specific stakeholder to directly influence the budget during a session. | It is also possible to connect the global to the budget of a specific stakeholder to directly influence the budget during a session. Positive values increase the budget, while negative values decrease it. | ||
===Input=== | ===Input=== | ||
There are 4 ways that a global's value can be set: | |||
* Each global has a starting value. At the start of a session, the global is set to this value. | |||
* A global can be updated using a TQL update statement, of the form <code>UPDATE_GLOBAL_WHERE_NAME_IS_X</code>. | |||
* A global's value can be changed by making use of a SET_GLOBAL_VALUE [[event]]. | |||
* A global can be directly linked to a TQL select statement, by setting the TQL property to a valid query. | |||
Most methods are one-time updates. However, linking a global to a TQL select query or using a TQL update statement in Excel causes continuous updates every [[Simulation Core|calculation cycle]], overwriting singular actions like [[event]]s. | |||
= | {{article end | ||
{{ | |howtos= | ||
* [[How to add and remove Globals]] | |||
* [[How to edit Global properties]] | |||
|seealso= | |||
[[File:YoutubeLogo1.jpg|link=https://youtu.be/IpQxzjzi1d0|thumb|left|200px|Panels en Globals (Dutch only)]] | |||
{{clear}} | |||
|api=*[[Api session items globals]] | |||
*[[Api session event editor global]] | |||
}} | |||
{{Editor current situation nav}} | |||
{{Editor | |||
[[Category:Items]][[Category:Global]] | |||
Latest revision as of 14:11, 8 July 2026
A global is a value that exists in the project but is not necessarily connected to a specific component. The global can be used, for example in Excel calculations and influence the calculation of an Excel indicator. A global is similar to an attribute but for the entire project rather than for a specific component. The name of the global is also the global ID that can be used in queries.
Global uses
Globals can be used, broadly speaking, to store and recall values. The most common application of this is in combination with excel sheets. Using TQL, the value of a global can be loaded into an excel sheet and used in calculations. The values of globals can also be set using TQL from excels. Globals can also be used to directly influence the budget of a specific stakeholder. Lastly, globals can be made visible in the 3D Visualization.
Properties of globals
A global is always made up of a name and a number. Based on the purpose of the global the number represents an amount or a value which is specified by the name.
Output
By using a SELECT_GLOBAL_WHERE_NAME_IS_GLOBALID query you can obtain the value of a global. This global's value can then be used in Excel calculations.
It is also possible to connect the global to the budget of a specific stakeholder to directly influence the budget during a session. Positive values increase the budget, while negative values decrease it.
Input
There are 4 ways that a global's value can be set:
- Each global has a starting value. At the start of a session, the global is set to this value.
- A global can be updated using a TQL update statement, of the form
UPDATE_GLOBAL_WHERE_NAME_IS_X. - A global's value can be changed by making use of a SET_GLOBAL_VALUE event.
- A global can be directly linked to a TQL select statement, by setting the TQL property to a valid query.
Most methods are one-time updates. However, linking a global to a TQL select query or using a TQL update statement in Excel causes continuous updates every calculation cycle, overwriting singular actions like events.
How-to's
See also
API Endpoints
Current Situation
- Buildings • Terrains • Administrative • Areas • Networks • Overlays • Indicators • Panels • Globals • Queries • Geo Import
- Buildings
- Function • Function Override • Section • Category • Custom Geometry • Category Value • Function Value • Function Values Table • List of Functions
- Traffic
- Unit Type • Unit Data • Unit Data Override
- Terrain
- Height sector • Elevation model • Elevation GeoTIFF • Elevation Grid Overlay • Ground Price • Terrain Type • Terrain Type Override • List of Terrain Types
- Administrative
- Neighborhood • Zone • Permission Popup • Plot • Zip Code
- Queries
- Net Cluster • Net Function • Net Line • Net Load • Net Node • Net Setting
- Editor