Control your design’s performance with property values

Without properties, the geometry in Giraffe is just shapes. Properties add data about the objects that can be leveraged in Urban Calculations and Analytics.

Quick Links

Usages

Urban Calculations

Analytics

List of Included Feature Properties

Visual Properties

Giraffe Data Model

What is a Property?


<aside> 🎓 What is a property? From dictionary.com: an essential or distinctive attribute or quality of a thing From Wikipedia: a property is a characteristic of an object; a red object is said to have the property of redness.

Other words for Property:

Properties in Giraffe allow you to tell your project story. Use properties to control everything from giving all the residential buildings the same buildCost to making all annotations blue. Giraffe comes pre-loading with many properties (see the full List of Included Feature Properties) or you can create your own.

<aside> 🚨 Other properties may be required by various apps in order for them to run properly, but this page only describes the properties relevant to Giraffe.

</aside>

Properties can apply at both the Usages and Features level.

What is a Usage?

What is a Feature?

Usages enable you to compile a database of standards and assumptions, composed of Properties. This allows your team to apply the same data to multiple geometries within a project - from giving all the residential buildings the same buildCost to making all annotations blue.

Giraffe comes with some default usages such as Residential , Road, Basement Carpark and Annotation , and you can create your own and copy them between projects.

Each shape in Giraffe are GeoJSON features with a geometry and various Properties . Giraffe allows any property to be added to these shapes by users or apps.

Certain properties are used by Giraffe to render the shape on the map, and to perform the calculations required for Urban Calculations , so it is important that users are aware of these.

The Usage properties, in The Usages Editor

usage properties ui.png

The Feature properties, in The Properties Palette

property palette ui.png

Add a Property


Click “Add property” in either The Usages Editor or The Properties Palette.

Untitled

Scroll the list, or type a value to find the property you would like to add.

You can add multiple properties before you close the window.

Each property will be added to either the Usage or Feature when you click on it.

They will display within their Property category.

Click off of the properties list to close it.

Untitled

Inheritance


If a geometry feature has a property that exists in the feature’s Usages, the section will inherit properties from the Usage it references.

If the property is set directly in the feature, the feature-level property has priority. That is, feature properties override the Usage’s properties at the instance level.

Usage Level

Controls multiple features.

Edit in the Usages Editor

Use to control many objects

Feature Level

Controls a single selected feature

Edit in The Properties Palette

Use to override Usages in a one-off fashion