Function Value: Difference between revisions
m (→Water) |
mNo edit summary |
||
| Line 25: | Line 25: | ||
===Assets and visualisation=== | ===Assets and visualisation=== | ||
{{Function values table start}} | {{Function values table start|suppresscategory=yes}} | ||
|- | |- | ||
| Image | | Image | ||
| Line 45: | Line 45: | ||
===Construction=== | ===Construction=== | ||
{{Function values table start}} | {{Function values table start|suppresscategory=yes}} | ||
{{:Category weight (Function Value)}} | {{:Category weight (Function Value)}} | ||
{{:Construction time in months (Function Value)}} | {{:Construction time in months (Function Value)}} | ||
| Line 61: | Line 61: | ||
===Environment=== | ===Environment=== | ||
{{Function values table start}} | {{Function values table start|suppresscategory=yes}} | ||
{{:Critical infrastructure (Function Value)}} | {{:Critical infrastructure (Function Value)}} | ||
{{:Distance zone (Function Value)}} | {{:Distance zone (Function Value)}} | ||
| Line 72: | Line 72: | ||
===Financial=== | ===Financial=== | ||
{{Function values table start}} | {{Function values table start|suppresscategory=yes}} | ||
{{:Buyout cost (Function Value)}} | {{:Buyout cost (Function Value)}} | ||
{{:Construction cost (Function Value)}} | {{:Construction cost (Function Value)}} | ||
| Line 80: | Line 80: | ||
===Network=== | ===Network=== | ||
{{Function values table start}} | {{Function values table start|suppresscategory=yes}} | ||
{{:Heat flow change per year (Function Value)}} | {{:Heat flow change per year (Function Value)}} | ||
{{:Heat flow formula start year (Function Value)}} | {{:Heat flow formula start year (Function Value)}} | ||
| Line 89: | Line 89: | ||
===Traffic=== | ===Traffic=== | ||
{{Function values table start}} | {{Function values table start|suppresscategory=yes}} | ||
{{:Height offset (Function Value)}} | {{:Height offset (Function Value)}} | ||
{{:Lanes (Function Value)}} | {{:Lanes (Function Value)}} | ||
| Line 101: | Line 101: | ||
===Water=== | ===Water=== | ||
{{Function values table start}} | {{Function values table start|suppresscategory=yes}} | ||
{{:Connected to sewer area (Function Value)}} | {{:Connected to sewer area (Function Value)}} | ||
{{:Depth of plant roots (Function Value)}} | {{:Depth of plant roots (Function Value)}} | ||
Revision as of 14:26, 4 October 2019
Function values are specific values which form the general properties of any construction with a specific function. A function has many function values, and any construction of that function also has those function values.
Function values can be changed for an individual construction, or for a function, which in turn would affect all constructions of that function.
Category values
Some function values are construction-related, and some function values are category-related. The difference between them is only applicable if a single function consists of multiple function categories. For example, the function value indicating the maximum amount of floors for the construction is related to the construction as a whole. However, if the function contains both social housing and luxury housing, the individual types of housing can have different unit sizes configured, as one type of housing may offer bigger housing units than the other.
Overview of all function values
Most function values have specific effects in the context of the Tygron Platform. Individual function values can be grouped into categories based on their effects or themes.
Name
| Function value | Attribute | Unit | Per category | Description |
|---|---|---|---|---|
| Name | (Property of function value) | text | The name of the Function. |
Assets and visualisation
Template:Function values table start |- | Image | (Property of function value) | Image (png, 200x100) | | The image used to represent this function. This property is currently unused.
Roof color ROOF_COLOR color No -2147483648 to 2147483647 The color of the roof of a building. For flat building (such as gardens and roads), it is also the color of the ground surface. Ground color GROUND_COLOR color No -2147483648 to 2147483647 The color of the walls of the bottom floor of a building. Extra color EXTRA_COLOR color No -2147483648 to 2147483647 The color of the walls of the floors of the building which are neither the top nor bottom floor. Top color TOP_COLOR color No -2147483648 to 2147483647 The color of the walls of the top floor of a building, unless that floor is also the bottom floor.
|- | Description | (Property of function value) | text | | The textual description of this function, which is displayed to the user when using this function as as action. Template:Table end
Construction
Template:Function values table start
Category weight CATEGORY_WEIGHT decimal Yes 4.9E-324 to 1.7976931348623157E308 How much of a building of this function is classified under the specified category.
Construction time in months (Function Value)
Default floors DEFAULT_FLOORS integer No 1 to 250 How many floors a building of this function will have by default, unless otherwise specified. When using this Function as an Action, this is the default amount of floors created, unless the user changes this setting while performing the Action. This values must always be in the range of min floors and max floors (inclusive).
Demolish time in months (Function Value) Floating (Function Value)
Floor height m FLOOR_HEIGHT_M m No 0 to 1.7976931348623157E308 The height of each floor of the Building. Max floors MAX_FLOORS integer No 1 to 250 The maximum amount of floors this Building (or any of its sections) can have. This also limits how many floors a Building can have when used as an action during a session. Min floors MIN_FLOORS integer No 1 to 250 The minimum amount of floors this Building (or any of its sections) should have. This also limits how many floors a Building must have when used as an action during a session. Monumental MONUMENTAL boolean No 0 to 1 Whether this building is monumental. Monumental buildings can be disallowed for demolition by the zoning plan. Slanting roof height SLANTING_ROOF_HEIGHT m No 0 to 10 How high the slanting roof at the top of the building should be visualized at its peak. The roof will slant inwards equally from all sides. This is a visual effect only, but it is possible to reference this value in custom calculations. Unit size UNIT_SIZE_M2 m²/unit Yes 0 to 1.7976931348623157E308 How large a single housing unit within this Building is. This is only relevant for residential categories. Zoning permit required ZONING_PERMIT_REQUIRED boolean No 0 to 1 Whether the municipal stakeholder should be requested permission, when another user uses this function as an action to plan a new building during a session.
Environment
Template:Function values table start
Critical infrastructure CRITICAL_INFRASTRUCTURE integer No 0 to 10 Number indicating the critical infrastructure priority of a building in case of calamities. Distance zone m DISTANCE_ZONE_M m No 0 to 2000.0 The distance drawn in Distance Overlays by this building. Disturbance distance m DISTURBANCE_DISTANCE_M m No 0 to 2000.0 The distance drawn in the Distance Overlay by this building.
Heat effect HEAT_EFFECT °C No -10 to 10 The capacity of this building for heat retention. Livability effect LIVABILITY_EFFECT decimal No -10 to 10 The effect this building has on the Livability Overlay calculations.
Safety distance (Function Value) Template:Table end
Financial
Template:Function values table start
Buyout cost BUYOUT_COST_M2 currency/m² Yes 0 to 1.7976931348623157E308 How much it costs, in addition to the demolition costs, to demolish this Building during a session, when the Building is not vacant. These costs are due to eviction or buyout of existing tenants. Construction cost CONSTRUCTION_COST_M2 currency/m² Yes 0 to 1.7976931348623157E308 How much it costs to create a new building, when using this function as an action during a session. Demolition cost DEMOLISH_COST_M2 currency/m² Yes 0 to 1.7976931348623157E308 How much it costs to demolish this Building during a session. If the building is not vacant, the buyout costs are applicable as well, in addition to the demolition costs. Sell price SELL_PRICE_M2 currency/m² Yes 0 to 1.7976931348623157E308 How much revenue is generated for the owner, when a building of this function is created during a session. The income is only generated once, when the construction of the building has completed.
Network
Template:Function values table start
Heat flow change per year HEAT_FLOW_M2_CHANGE_PER_YEAR m²/year Yes -1.7976931348623157E308 to 1.7976931348623157E308 For any net load connected to an address part of a Building of this function, the amount of resources (FLOW) requested in addition to those in the starting year during every subsequent year. The amount of resources requested starts at HEAT_FLOW_M2_START_VALUE in the start year, and is then increased by this value every year until the building's year of creation, and finally multiplied by the size of the address(es) the net load is associated with to get a default FLOW value for the net load. Heat flow formula start year HEAT_FLOW_M2_START_YEAR year Yes 0 to 3000 For any net load connected to an Address part of a Building of this function, the start year for the calculation of the amount of resources (FLOW) requested. The amount of resources requests starts at HEAT_FLOW_M2_START_VALUE in this year, and is then increased by HEAT_FLOW_M2_CHANGE_PER_YEAR every year until the building's year of creation, and finally multiplied by the size of the address(es) the net load is associated with to get a default FLOW value for the net load. Heat flow to power multiplier HEAT_POWER_TO_FLOW_MULTIPLIER factor Yes -1.7976931348623157E308 to 1.7976931348623157E308 For any net load connected to an address part of a building of this function, the divisor used to convert the automatically calculated FLOW to an automatically calculated POWER attribute. The automatically calculated FLOW divided by this value is the automatically calculated POWER. Note that an explicitly defined FLOW attribute is not used in this calculation. Heat flow value at start year HEAT_FLOW_M2_START_VALUE m² Yes -100 to 100 For any net load connected to an address part of a Building of this function, the amount of resources (FLOW) requested by the net load in the defined starting year. This value is increased with the HEAT_FLOW_M2_CHANGE_PER_YEAR, until the building's year of Building, and finally multiplied by the size of the address(es) the net load is associated with to get a default FLOW value for the net load. Pipes permitted PIPES_PERMITTED boolean No 0 to 1 Whether net lines are allowed to be generated under this building.
Traffic
Template:Function values table start
Height offset HEIGHT_OFFSET_M m No -1.7976931348623157E308 to 1.7976931348623157E308 How many meters above or below the datum this building should be visualized. This is intended for bridges or other buildings on water, so that they can be lined up appropriately with the surrounding land, or float at an appropriate height. Lanes TRAFFIC_LANES integer No -1.7976931348623157E308 to 1.7976931348623157E308 How many lanes of traffic there are on this road. A negative value causes vehicles to move in the opposite direction. This is only relevant for roads, intersections, and bridges. This only affects the visualization. Noise sigma TRAFFIC_NOISE_SIGMA dB(A) No -1.7976931348623157E308 to 1.7976931348623157E308 Difference in noise intensity of vehicles at their reference speed. Effectively a flat modifier in noise. Noise tau TRAFFIC_NOISE_TAU dB(A) No -1.7976931348623157E308 to 1.7976931348623157E308 Difference in noise intensity of vehicles for every order of magnitude difference with their reference speed. Effectively a speed-dependent modifier in noise. Parking lots PARKING_LOTS_PER_M2 parking lot/m² Yes 0 to 1 How many parking lots are available per m² of this building. Parking lots demand PARKING_LOTS_DEMAND_PER_M2 parking lot/m² Yes 0 to 2 How many parking lots are required per m² of this building. Speedlimit TRAFFIC_SPEED km/h No 0 to 1.7976931348623157E308 How fast vehicles move on this building. This is only relevant for roads, intersections, and bridges. This affects the visualization, and the calculations for the Traffic Noise Overlay.
Units per hour (Function Value) Template:Table end
Water
Template:Function values table start
Connected to sewer area SEWERED boolean No 0 to 1 Whether this building can be connected to a sewer. Depth of plant roots ROOT_DEPTH_M m No 0 to 1.7976931348623157E308 The depth of the roots of the plants of this building. Drainage DRAINAGE m No -10 to 10 Whether this Building has drainage, which affects the calculation of the Subsidence Overlay. Ground infiltration per day GROUND_INFILTRATION_MD m/day No 0 to 1.7976931348623157E308 The permeability of this building to water trying to infiltrate into the ground. Manning value WATER_MANNING s/(m1/3) No 0.01 to 0.255 The manning value of the building, which is a roughness in regards to water flow. Water evaporation WATER_EVAPORATION_FACTOR factor No 0 to 1.7976931348623157E308 Factor indicating how much a building with a crop, tree or plant function facilitates evapotranspiration. This factor is multiplied with the weather's evaporation rate at a particular time in the simulation. Water storage WATER_STORAGE_M2 m³/m² No 0 to 1.7976931348623157E308 How much water can be stored in this building.
Attributes
Besides the function values which are provided by default, it is possible to add user-defined attributes to function values as well. Any attribute added is automatically available as an attribute for all functions, and all constructions, although the default value of the attribute will be 0.
User-defined attributes added to a function value always apply to the construction as a whole, and cannot be category-specific.
| Function value | Attribute | Unit | Per category | Description |
|---|---|---|---|---|
| (user defined) | (user defined) | (user defined) | Attributes can be used to assign any additional values or properties to functions and the constructions which derive from them. |