Function: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
No edit summary
(12 intermediate revisions by the same user not shown)
Line 17: Line 17:
===Function values===
===Function values===
{{main|Function Value}}
{{main|Function Value}}
Functions are composed of a collection of properties called [[Function Value]]s. These form the actual numeric definitions which are applied on a Construction which is set to be of a certain Function. In principle, when such a value of a Construction is required for a calculation, the value set in the Function is used. However, a Construction can have a Function Value overridden for itself. If the Construction in consideration for a calculation has an overridden Function Value, that overridden value will be used instead.
Functions are composed of a collection of properties called [[Function Value]]s. These form the actual numeric definitions which are applied on a Construction which is set to be of a certain Function. In principle, when such a value of a Construction is required for a calculation, the value set in the Function is used.


A complete list of all available Function Values can be found on the [[Function Value]]s page.
A complete list of all available Function Values can be found on the [[Function Value]]s page.
Line 30: Line 30:


Currently the {{software}} distinguishes the following Function Categories:
Currently the {{software}} distinguishes the following Function Categories:
* Affordable housing
{|class=wikitable
* Agriculture
! Category
* Education
! TQL Term
* Gardens
! Combinable
* Healthcare
! Description
* Industry
|-
* Leisure
| Affordable housing
* Market housing
| SOCIAL
* Nature
| yes
* Offices
|
* Other
|-
* Parks
| Agriculture
* Senior housing
| AGRICULTURE
* Shops and restaurants
|
* Squares
|
* Student housing
|-
* Top market housing
| Bridge
* Underground
| BRIDGE
{{clear}}
|
|
|-
| Education
| EDUCATION
| yes
|
|-
| Gardens
| GARDEN
|
|
|-
| Healthcare
| HEALTHCARE
| yes
|
|-
| Industry
| INDUSTRY
| yes
|
|-
| Intersection
| INTERSECTION
|
|
|-
| Leisure
| LEISURE
|
|
|-
| Market housing
| NORMAL
| yes
|
|-
| Nature
| NATURE
|
|
|-
| Offices
| OFFICES
| yes
|
|-
| Other
| OTHER
|
|
|-
| Parks
| PARK
|
|
|-
| Roads
| ROAD
|
|
|-
| Senior housing
| SENIOR
| yes
|
|-
| Shops and restaurants
| SHOPPING
| yes
|
|-
| Squares
| PAVED_AREA
|
|
|-
| Student housing
| STUDENT
| yes
|
|-
| Top market housing
| LUXE
| yes
|
|-
| Underground
| UNDERGROUND
|
|
|}


===Regions===
===Regions===
Line 58: Line 150:
'''Regions: '''
'''Regions: '''


Currently the {{software}} distinguishes the following Regions:
Currently the {{software}} distinguishes the following regions:
* Africa
* Africa
* Asia
* Asia
Line 65: Line 157:
* Other
* Other


==Editing Functions==
==How-to's==
{{Editor location|Function Values}}
* [[How to add Functions for editing]]
All Functions in the {{software}} can be edited, and new Functions can be created based on pre-existing ones. By default, a small list of Functions is available for editing.
* [[How to create Functions]]
[[File:Function_values_screen.jpg|thumb|750px|left|The Function Values window.]]
* [[How to change Function Values for a Function]]
{{clear}}
* [[How to add a Category to a Function]]
 
* [[How to remove a Category from a Function]]
===Adding Functions for editing===
* [[How to change the Category of a Function]]
The default list of Functions does not include all Functions available in the {{software}}. It is possible to add additional functions to the overview of editable functions. When they are added, their properties can be altered as desired.
 
{{Editor steps|title=add a Function for editing|Click "Add".|Select the desired Function in the Function selection window, and "Apply".|Find the Function in the name column list in the "Function Values" panel.}}
 
===Creating new Functions===
It's possible to create new Functions based on existing Functions by duplicating an existing function. The properties of the new Function can then be changed independently of the old Function.
 
{{Editor steps|title=create a new Function through duplication|Select a function from the list to use as original.|Press "Duplicate".|Find the duplicate function at the bottom of the list.}}
 
===Changing Function Values===
{{main|Function Value}}
When a Function is added to the list of Functions, its [[Function Values]] can be modified.
{{Editor steps|title=change Function Values |If the desired Function is not yet present in the list, {{inlink|Adding Functions for editing|add the Function}} to the list.|Find the column with the property you wish to change.|Change the value in the row of the function and the column of the property.}}
'''Note: When a Function has multiple Categories, some [[Category Value|Function Value]]s can also have different values per Category for the same Function.'''
[[File:Function_values_screen_edit_value.jpg|thumb|left|950px|Editing the construction cost for the function "Roads".]]{{clear}}
 
===Changing Categories of Functions===
Functions can be part of multiple Categories at once. By assigning a Function a second Category, and then removing the original Category, a Function's Category can be changed entirely.
 
{{Editor steps|title=add Categories to Functions|If the desired Function is not yet present in the list, {{inlink|Adding Functions for editing|add the Function}} to the list.|Select the Function to which you wish to add a Category.|Select the desired Category using the drop down box at the bottom.|Select "Add Category".}}
{{Editor steps|title=remove Categories from Functions|Ensure the Function, from which you wish to remove a Category, has at least two Categories.|Select the Category of the Function you wish to remove.|Press "Delete Category".}}
 
Remember that each Function should have at least one Category. It is not possible to remove the last Function Category from a Function.
<!--
 
 
 
 
===Function values===
{{Editor location|Function Values}}
[[File:Function_values_screen.jpg|thumb|750px|left|The function values window.]]<br clear=all>
 
Each function has a predefined set of properties. Those properties can be changed directly in the function values window by changing the value in the column (Generally to a different numeric value, unless otherwise specified):
 
; Name
: ''The name of the function. This is displayed in the legend in the [[interface]] to indicate what kind of [[constructions|construction]] something is, and as the name for [[actions]] which place constructions with this function in the world.'' This value does not need to be a numeric value. Instead, you can use letters, numbers and certain symbols.''
 
; Category
: ''The category of the function. Each function has a category. The category to which the function belongs is a group for all functions which belong to this category. One function can have multiple categories, for example buildings which are part house and part shop would have both "Housing" and "Shops and Restaurants" as a category. '' The available function categories are predefined, so only a select number is available.''
 
: ''For information on adding and removing categories see: [[Functions#Changing_categories_of_functions|Adding and removing Categories from functions]]
 
; Buyout Cost M2 (€ / $ per floor space)
: ''The costs to vacate a building with this function. This is the amount a stakeholder will have to pay per m² to remove a building with this function if the building is not vacant, in addition to the "Demolish costs".''
 
; Category Weight (0-1 (%))
: ''Each function has a category weight. The category weight is a percentage of the category function belongs. All functions have 1 category by default, meaning the Category Weight is 1 for all functions. Once multiple categories have been added, both categories can have their own weight, 0.2 for the Affordable Housing Category (meaning 20%) 0.8 for Shops and Restaurants (meaning 80%). ''
; Construction cost per floor space (€ / $ per floor space)
: ''The costs to create a building with this function. This is the amount a stakeholder will have to pay per m² to construct a building with this function.''
 
; Construction time in months
: ''The amount of time it takes to construct a building with this function. This is only used in [[Simulation Type|timeline]] projects.''
 
; Default floor height
: ''The default height for a single floor of this building. A higher value means each floor of the building will be taller.''
 
; Default  floors
: ''The default amount of floors when a participant wishes to build this building. A participant is free to set the amount of floors of the building to any value between "minimum amount of floors" and "maximum amount of floors", using a slider. When the option is presented, the slider starts at this value. This value should be higher than or equal to the "Minimum amount of floors", and lower than or equal to the "Maximum amount of floors".''
 
; Demolish costs per floor space (€ / $ per floor space)
: ''The costs to demolish a building with this function. This is the amount a stakeholder will have to pay per m² to remove a building with this function. Note that for not vacant buildings, a stakeholder will also have to pay the "Buyout costs".''
 
; Demolish time in months
: ''The amount of time it takes to demolish a building with this function. This is only used in [[Simulation Type|timeline]] projects.''
 
; Distance Zone (m)
: ''The required safety distance for this function in the event.''
 
; Drainage
: ''The effect on the ground water levels. A negative value means passive drainage. A positive value means active drainage. For more information, see [[Subsidence (Overlay)]].''
 
; Green per floor space
: ''The amount of m² of green per m² of a building with this function. A value of "1.0" means the function is entirely green. "0.4" means 40% of the area drawn is green.''
 
; Heat effect (Environment effect (Minimum -10 / Maximum +10 °C)
: ''The amount of ambient heat caused by this function. Lower is better.''
 
; Heat flow M² / year
: ''The amount of usable heat produced or required by this function. (Currently not used)''
 
; Livability (Minimum -10 / Maximum +10)
: ''The effect of a building with this function on the livability of the area. This is used in combination with the [[Livability (Indicator)|livability indicator]] and [[Quality_of_Life_(Overlay)|livability overlay]]. A higher value is better.''
 
; Max  floors
: ''The maximum amount of floors a building with this function can have, Some functions, such as roads or parks, are only 1 floor high. Buildings such as townhouses are usually not any taller than 3 or 4 floors. A participant can vary the amount of floors from this value downwards (including this value), down to the "Minimum amount of floors". This value cannot be lower than the "Minimum amount of floors".
 
; Min floors
: ''The minimum amount of floors a building with this function must have. Some functions, such as apartments or skyscrapers, could be built with just 1 floor, but that would not make sense logically given the type of building. A participant can vary the amount of floors from this value upwards (including this value), up to the "Maximum amount of floors". This value cannot be higher than the "Maximum amount of floors".''
 
; Noise sigma
: see [[Traffic_Model|Traffic Model]]
 
; Noise tau
: see [[Traffic_Model|Traffic Model]]
 
; Parking lots
: "the actual amount of parking space (m2) that is available for this building type."
 
; Parkinglots per floor space
: ''The amount of parking spaces this function provides by surface area. If a negative number is used, this function increases the demand for parking spaces.''
 
; Unit size
: ''How much floor space constitutes a single unit. Larger, more luxurious houses typically have more floor space. If the amount of floor space per house is 140m², a housing construction with 560m² of floor space will be 4 houses.''
 
; Units per hour
: see [[Traffic_model|Traffic Model]]
 
; Safety Distance
: ''The required safety distance for this function in the event of flooding. (Currently not used)''
 
; Sell price per floor space
: ''The amount of money received per m² when a building with this function is created. When a building is constructed, the stakeholder receives this money automatically.''
 
; Slanting roof height
: ''The height of the center of the roof for this function. A higher value means the roof will be steeper. This is only a visual adjustment and does not influence calculations. However, it is possible to take the slanting roof hight as a value into account in a calculation. This needs to be changed in the calculation manually.''
 
; Traffic Flow
: ''When [[units]] make use of this function as a road, a greater value for traffic flow means more vehicles will be on the road at the same time.''
 
; Traffic Lanes
: ''When [[units]] make use of this function as a road, this is the amount of lanes the vehicles will use.''
 
; Traffic Speed
: ''When [[units]] make use of this function as a road, a greater value for traffic speed means vehicles will travel across the road faster.''
; Water storage per floor space
: ''The amount of water a building with this function can store. This is used in combination with the [[Water Storage (Indicator)|water storage indicator]]. Water storage achieved this way is counted as "innovative" water storage.''
; Zoning permit required
: ''Whether constructing a building with this function needs to be approved by the municipality. If set to "1.0", the municipality can deny the construction of a building with this function. If set to "0.0", the building is automatically approved when the acting stakeholder [[ownership|owns]] the land and construct the building in the proper zone.''
-->

Revision as of 07:37, 8 October 2019

Template:Learned

What are functions

A function is the purpose of a type of building. The term function comes from urban planning jargon, when dealing with zoning plans.

How do functions relate to the Tygron Platform

Functions are the blueprints of Constructions in the 3D world. They describe the purpose and properties of Constructions. A Function also defines which 3D model is placed in the 3D world. A Function is effectively a "type of Construction".

The properties associated with a Function are known as Function Values

Each Construction in a Project has a Function defining what kind of Construction it is. Constructions with the same Function may have different locations, different heights, and different owners. But Constructions with the same Function will have the same set of properties defining their economic, environmental, and spatial effect.

Additionally, Functions can also be used as definitions for actions. When a Function is used as an Action, the Action will be the creation of a new Construction, the Function of which is the Function which is used as Action. Some properties of the Function, such as the minimum, maximum, and default amount of floors, also affect how a Stakeholder can enact their action.

The Tygron Platform contains several hundred Functions.

Function values

Main article: Function Value

Functions are composed of a collection of properties called Function Values. These form the actual numeric definitions which are applied on a Construction which is set to be of a certain Function. In principle, when such a value of a Construction is required for a calculation, the value set in the Function is used.

A complete list of all available Function Values can be found on the Function Values page.

Function Categories

The function selection window. This will appear whenever you need to a select a function.

Functions are divided into Function Categories. Where a Function itself may be "Old Warehouses", such a Function may belong to a Function Category "Industry". This categorization helps when trying to select a specific Function among the full collection of Functions. It also makes it easier to query Constructions in a Project but filtering on the purposes of the Construction. Rather than creating individual queries for each Function which matches a broad usage for Constructions, a single query for a Function Category can be used.

Functions are always part of at least one Category, but can also be part of multiple functions. An example is a Function for a Construction with shops at a bottom floor, but residences on floors above it. Or flats which contain a mix of both social and luxury housing. In these cases, the Function's Categories each have a respective weight. The Construction will be considered wholly of the specified Function, but the Construction will be considered "divided up" between the Categories when querying, for example, their floor size.

Categories:

Currently the Tygron Platform distinguishes the following Function Categories:

Category TQL Term Combinable Description
Affordable housing SOCIAL yes
Agriculture AGRICULTURE
Bridge BRIDGE
Education EDUCATION yes
Gardens GARDEN
Healthcare HEALTHCARE yes
Industry INDUSTRY yes
Intersection INTERSECTION
Leisure LEISURE
Market housing NORMAL yes
Nature NATURE
Offices OFFICES yes
Other OTHER
Parks PARK
Roads ROAD
Senior housing SENIOR yes
Shops and restaurants SHOPPING yes
Squares PAVED_AREA
Student housing STUDENT yes
Top market housing LUXE yes
Underground UNDERGROUND

Regions

The region selector, to filter the available functions.

To further help with finding the appropriate Function, they are also divided into regions. Based on the location of the Project, the region for the Project is set automatically. Some Functions are only available in certain regions. This is based on what region of the world the Function would be most appropriate for.

When selecting a Function, it is possible to change the region of the Project to gain access to the Functions of other regions. It is possible to Mix Functions of various regions freely.

Regions:

Currently the Tygron Platform distinguishes the following regions:

  • Africa
  • Asia
  • North America
  • Northwestern Europe
  • Other

How-to's

Retrieved from "https://support.tygron.com/w/index.php?title=Function&oldid=28472"