Use this when you want to assign a usage to a geometry 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 geometry to apply usage to. Works with either a single geometry or a list of them |
usage (optional) | U | String | Item | the usage to apply. If left blank, the geometry'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 geometry; when off (the default), existing properties on the geometry win and the usage only fills in what's missing |
Outputs
Name | Abbreviation | Type | Access | Description |
feature | F | Feature | Item or List | the geometry with usage applied. Matches the shape of the input (a list in gives a list out) |
Warnings and errors
Message | Cause | Fix |
| The usage name does not match a usage in this project. The features still pass through. | Check the spelling, or add the usage to the project. |
Get a geometry, or a list of geometries.
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 geometry already has.
Connect your geometry (or list of geometries) to the "feature" input of Apply Usage.
Turn on "override" if you want the usage's properties to replace ones the geometry 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).