Use this when you want to assign a usage to a feature within a flow, for example automatically applying a land use classification to generated lots.
This node is only for parametrically applying usages within a flow. To apply a usage to a simple geometry, set the usage property in the property palette.
Like write feature property, Apply Usage writes information to a geometry via the flow. However, unlike write property or write feature property, this node applies as many properties as is required by the selected usage.
Usages, unlike Properties, often have additional nested settings. The Apply Usage node ensures that all Usage properties and defaults are included on the geometry from the flow.
Category: Usage
Kind: Operation
Description: Apply a usage to a feature, including all of its defaults and nested categories
Inputs
Name | Abbreviation | Type | Access | Description |
feature | F | Feature | Item or List | the feature to apply usage to — works with either a single feature or a list of them |
usage (optional) | U | String | Item | the usage to apply — if left blank, the feature's own existing usage is used instead |
override (default false) | O | Boolean | Item | when on, the usage's properties replace any matching properties already on the feature; when off (the default), existing properties on the feature win and the usage only fills in what's missing |
Outputs
Name | Abbreviation | Type | Access | Description |
feature | F | Feature | Item or List | the feature with usage applied — matches the shape of the input (a list in gives a list out) |
Get a feature, or a list of features.
Add the Apply Usage node.
Define the usage — either type the usage name in the box (case-sensitive), or connect a Get Usage node to pick one from a dropdown. Leave it blank to re-apply whatever usage the feature already has.
Connect your feature (or list of features) to the "feature" input of Apply Usage.
Turn on "override" if you want the usage's properties to replace ones the feature already has, instead of only filling in what's missing.
The result is geometry with the usage applied, including all of its defaults and other settings (color, costs, dwellings, etc).