Skip to main content

The JSON Editor

View and edit the raw data behind a geometry.

Written by Holly Conrad Smith

When a yield number looks wrong, the fastest way to find out why is to look at the data behind the geometry. The JSON Editor app shows a selected geometry's properties as JSON. Edit many properties in one go, paste values from another project, or compare what you entered with what Giraffe calculated.

Open the JSON Editor

  1. From the top bar, choose Apps.

  2. Choose Data, then choose JSON Editor.

The JSON Editor opens in a panel. Learn more about how to add an app. The JSON Editor is only available to people who can edit the project.

Show a geometry's JSON

Select one or more geometries on the map. The JSON Editor shows their data. The header shows how many geometries you have selected, such as 1 selected. With nothing selected, the JSON Editor is empty.

Choose what the JSON Editor shows

Two checkboxes at the top of the JSON Editor control the view.

  • Properties only is checked by default. It shows the geometry's properties, like its usage, height, and color. Uncheck it to see the full GeoJSON, which adds the geometry's coordinates.

  • Show evaluated is unchecked by default. Unchecked, the JSON Editor shows the raw values you entered. Check it to see the evaluated result: the values Giraffe calculated after applying the usage and any flow. The evaluated GeoJSON includes geometries a flow generated.

You can only edit the raw properties: Properties only checked and Show evaluated unchecked. Every other view is read-only.

Raw vs evaluated geometries

A raw geometry is what you drew and entered. It's a basic GeoJSON feature with three parts:

An evaluated geometry is the result after Giraffe processes the raw geometry. It adds:

  • Calculated values, like height from floor to floor times levels.

  • Values from the geometry's usage.

  • Geometries a flow generated, each with its own properties.

For example, check Show evaluated on a parking structure to see calculated values like grossBuildingArea, perimeter, and parkingBayCount. Uncheck Properties only too, and the GeoJSON lists the geometries the parking structure's flow generated.

Edit properties as JSON

  1. Select one or more geometries.

  2. In the JSON Editor, check Properties only and uncheck Show evaluated.

  3. Change, add, or delete properties in the JSON.

  4. Click Save, or press Cmd/Ctrl + S.

The JSON Editor doesn't save on its own. The Save button turns on once you change something. If the JSON isn't valid, Giraffe shows Invalid Properties and saves nothing.

Edit several geometries in the JSON Editor

With more than one geometry selected, the JSON Editor shows the properties they share. A property with different values across the selection shows "__varies__$". When you save:

  • A value you change applies to every selected geometry.

  • A property you delete is removed from every selected geometry.

  • A property left as "__varies__$" keeps each geometry's own value.

Large blocks like flow and coordinates start collapsed in the read-only views. Click the arrow beside a block to expand it.

Edit properties with a form instead in the properties palette.

Did this answer your question?