Heatmaps & Room Box Views

Heatmap Layers allow you to visualize numeric sensor data, such as temperature, humidity, CO₂, or custom metrics across your rooms in a color-coded view. You can configure the system default layers or create your own custom layers.

Room Box Views color entire rooms using a fixed color or live sensor values evaluated against color rules. Use the Layers panel to configure your visualization layers.

Creating a New Heatmap Layer

1. Go to the Layers tab in the left sidebar while in Designer Mode.
   Zircon3D provides two system layers: Temperature and Humidity.
   You may adjust their parameters as needed.

2. Click Add → Add Heatmap Layer.

You can configure:

• Color Pattern — Choose from multiple gradient styles.

• Value Range — Set minimum and maximum expected values.

• Isoline Interval — Controls spacing between contour lines.

  Explanation:
  Smaller interval → more detail
  Larger interval → smoother appearance

• Distance Decay Exponent — Controls how quickly sensor influence decreases with distance.

  Explanation:
  Higher exponent → more localized influence
  Lower exponent → influence spreads farther

• Matching Rules — Automatically assign sensors to this heatmap layer.

  Click + Add Rule, then choose:

  • Match Type: Entity ID or UID
  • Operator: Contains / Equals / Starts With / Ends With / Regex
  • Value: Text to match
    Matched sensors appear in the Matched Entities list on the right.

3. Save the layer when finished.

Applying Heatmap Layers in the Floorplan

Automatic Matching

When you drag a sensor or entity onto the floorplan,
any heatmap layers whose Matching Rules apply will be assigned automatically.
This means the sensor will immediately contribute to those heatmaps without additional configuration.

If sensors are already placed:

You have two options:

1. Re-mount the sensors
   Remove them from the floor and drag them back — the new layer applies automatically.

2. Update mappings manually

   • Select the sensor
   • Open the Monitoring Properties panel
   • In Data Layers, click + Add Layer
   • Choose the new heatmap layer
   • Select the entity used for the data
   • Click Save Floor

Heatmap layers become visible once enabled in the bottom Display Settings of the Viewer.

Room-Level Heatmaps

By default, heatmaps cover the floor. Enable Room Heatmap to give a room its own heatmap, isolated from the surrounding floor.

1. Select a room.
2. Open the Data panel on the right.
3. Under Heatmap, turn on Room Heatmap.
4. Select the desired heatmap layer from the bottom status bar.

Sensors placed in that room and mapped to the selected layer contribute only to that room’s heatmap. Sensors outside the room do not affect it.

Turn off Room Heatmap to include the room and its sensors in the floor-level heatmap again.

Sensors must belong to the room, not simply appear inside its boundaries. They must also be mapped to the selected heatmap layer.

Room Box Views

Room Box Views color entire rooms on your 3D floorplan. Use a fixed color to identify spaces, or link live sensor data to change room colors automatically—for example, to visualize occupancy or temperature ranges.

Set a static room color

1. Select a room and open its right-side Data panel.
2. Under Box Views, enable Static Box View.
3. Use the color picker beside it to choose the room’s color.
4. Select the static Room Box View layer from the Heatmap Layer list in the bottom status bar to display the room colors.

Create a data-driven Room Box View

1. Open Layers in the Designer’s left sidebar.

2. Click Add → Add Room Box View.

3. Under Settings, enter a Name.

4. Under Color Rules, click Add Color Rule and configure:

   Field	Purpose
   Color	The room color when the rule matches.
   Match	Choose Equals =, Range [ ], At most ≤, or At least ≥.
   Value	The value or range to match.
   Label	A descriptive name for the matching state, such as “Occupied.”

5. Set Value Display to Show Values, Show Labels, or Hidden.

6. Click Add Layer.

Range boundaries are inclusive. If multiple rules match, the first matching rule determines the color.

Map sensor data to a room

1. Select the room and open its Data Panel.
2. Under Data Links, link the entity or device that provides the room’s data by dragging it from the Monitoring tab into the Data Links box..
3. Under Box Views, the Room Box View should appear automatically.
4. If it is missing, click Add. And choose your Room Box View in Layer. Choose the linked entity’s data property, then click Ok.
5. Select the layer for display.

Repeat the mapping for each room. Each room uses its mapped value with the same layer-wide color rules.

Color rules compare numeric values. For an occupancy source that provides 0 for vacant and 1 for occupied, you could configure:

Use values appropriate to your selected data source.

Hide the box for a room

To exclude a hallway or another space:

1. Select the room and open Data Panel→ Box Views.
2. Turn off the switch beside Static Box View or the relevant data-driven layer.

This hides the room’s box for that layer without removing the room or its sensor mapping. Room Box Views do not hide furniture or other objects inside the room.