Skip to content

Web Application - Admin User Manuals

Customizing Space Heatmap Widget

6 min readUpdated

The Space Heatmap is a specialized widget designed for floor visualization. When used, it is usually the sole widget on the dashboard, offering a detailed view of spaces like desks or meeting rooms. You can configure various data points and apply color-coded ranges to represent parameters such as occupancy or environmental conditions.

For example, the widget can display room occupancy status—occupied rooms might appear in one color, and available rooms in another. Similarly, it can monitor room temperature, where temperatures exceeding a defined threshold could be highlighted in red, while normal levels appear in yellow, ensuring quick insights into space utilization and comfort levels.

To customize Space Heatmap widget:

  1. Create a dashboard.
  2. Click the Widgets tab.
    The Widget pop-up is displayed with the Dashboard tab active.
  3. Search for and click Space Heatmap.
    ‎OR
    ‎From the Space Usage widget category, select Space Heatmap.
    ‎The floor plan with various data points is displayed.
  4. Hover the cursor over the top-right corner of the heatmap widget and click Widget Edit icon.
  5. Enter or select the required properties.
    Field Description

    Title

    Enter the title for the space heatmap.

    Refresh Rate (sec.)

    Set the duration for automatically resetting the data on the dashboard.

    Background Color

    Select the background color for the heatmap widget.

    Fore Color

    Select the foreground color for the heatmap widget.

    Dashboard Group

    Enter the name of the associated/related dashboard group to provide its hyperlink in the widget tile.

    Dashboard

    Enter the name of the associated/related dashboard to provide its hyperlink in the widget tile.

    Default Date Slot

    Select the required date slot to always see the data for that selected time period.

    Note: This setting overrides the options selected in the Advanced Filter options.

    Default Time Filter

    Select the required time filter to always see the data for that selected time filter.

    Note: This setting overrides the options selected in the Advanced Filter options.

    Comfort Temperature Weight

    Enter the weight for temperature to signify its contribution to the overall comfort index. A higher weight indicates a greater impact on the comfort score if the temperature is outside the configured threshold.

    Comfort Min. Temperature

    Enter the minimum temperature value to define a comfortable range.

    Comfort Min. Temperature

    Enter the maximum temperature value for the comfort range.

    Comfort CO2 Weight

    Enter the weight for CO2 levels to signify their contribution to the overall comfort index. A higher weight indicates a greater impact on the comfort score if the CO2 levels exceed the configured threshold.

    Comfort Min. CO2

    Enter the minimum CO2 level within the comfort range.

    Comfort Max. CO2

    Enter the maximum CO2 level within the comfort range.

    Comfort Humidity Weight

    Enter the weight for humidity to signify its contribution to the overall comfort index. A higher weight indicates a greater impact on the comfort score if the humidity is outside the configured threshold.

    Comfort Min. Humidity

    Enter the minimum humidity level within the comfort range.

    Comfort Min. Humidity

    Enter the maximum humidity level within the comfort range.

    Comfort AC Filter Weight

    Enter the weight for the AC filter condition to signify its contribution to the overall comfort index. A higher weight indicates a greater impact on the comfort score if the filter condition is not optimal.

    Trend

    • Show Live: Select this checkbox to display real-time data on the dashboard.
    • Show Historic: Select this checkbox to view historical data trends for analysis.

    Floor Plan

    • Show Space: Select this checkbox to visualize available spaces like rooms or desks on the floor plan.
    • Show HVAC: Select this checkbox to display the HVAC (Heating, Ventilation, and Air Conditioning) components on the floor plan.
    • Show Lighting: Select this checkbox to show lighting elements on the floor plan.

    Data Points:

    For Space

    • Show Occupancy: Select this checkbox to display the current occupancy status of spaces (e.g., occupied or vacant).
    • Show Temperature: Select this checkbox to monitor temperature readings for each space.
    • Show IAQ Overall Index: Select this checkbox to display the Indoor Air Quality (IAQ) index for the spaces.
    • Show Utilization: Select this checkbox to track how frequently or effectively the space is being used.
    • Show LUX: Select this checkbox to show the light intensity (in lux) for each space.

    For HVAC

    Show Temperature: Select this checkbox to display the temperature managed by the HVAC system.

    Show IAQ Overall Index: Select this checkbox to track the IAQ index across HVAC zones.

    Show Comfort Level: Select this checkbox to visualize comfort levels based on HVAC data and environmental parameters.

    For Lighting

    • Show Dim Level: Select this checkbox to display the brightness level of lights.
    • Show LUX: Select this checkbox to monitor the light intensity managed by the lighting system.
    • Show Occupancy: Select this checkbox to track whether the area under lighting is mapped for utilization.
    • Show Load: Select this checkbox to monitor the total and percentage of utilized power load for the lighting system.
    • Show Utilization: Select this checkbox to monitor the total and percentage of utilized power load for the lighting system.

    Show Hourly Live

    Select this checkbox to view live data on an hourly basis.

    View

    • Show Standard: Select this checkbox to view the data in standard dashboard layout.
    • Show Classic: Select this checkbox to view the data in classic dashboard layout.
    • New Tab: Select this checkbox to open the heatmap widget in a new browser tab.
  6. Click Add Data Point Range.
    ‎The Data Point field is displayed.
  7. Select the required data point to add a range. For example, Space>Temperature.

    Note: By default, the Unknown label is displayed is displayed for all unknown values in the widget. This label cannot be renamed, and no minimum or maximum values can be defined for this range.

  8. To configure the colors for theUnknown label, click Expand icon. 
  9. Select colors for both Range Color and Label Text Color to represent the range visually.
  10. To add another label, click Add Label.
    A new label field is displayed.
  11. Enter a name for the label. For example, Warning.
  12. To configure the range and colors for this label, click Expand icon. 
  13. Select colors for both Range Color and Label Text Color to represent the range visually.
  14. Add more labels as required.
  15. To delete a label, click Remove or click the Remove label icon icon.
  16. To add another data point and its labels, repeat steps 6 to 14.
  17. To apply the same range and settings to another related data point, click the Copy icon icon under the source data point, and then click the Paste icon icon under the target data point.

    Note: Properties can also be copied from one widget and pasted into another. This functionality is not restricted to a single widget but can be used across multiple widgets.

  18. Once all data points are added, click Submit Form.
Was this page helpful?