Numeric Attribute Labels

Overview

Numeric Attribute Labels in SharpCloud allow you to define custom value ranges for numeric attributes or calculated values. These labels are used to group, filter, and visually organize data within views, making it easier to interpret large datasets and apply meaningful business thresholds.

When numeric attributes are used on axes (e.g., X or Y), SharpCloud will automatically generate labels by splitting the full value range into four equal segments by default. However, this may not always reflect how your organization categorizes or evaluates data—custom labels provide full control over these ranges.

Supported Views

Numeric attribute labels are applied in the following views:

• Layer View

• Compare View

• Grid View

• Timeline View

These labels influence how items are grouped, displayed, and filtered when numeric attributes are used within these views.

Default vs Custom Label Behavior

Default Labels

• Automatically generated when a numeric attribute is used on an axis

• Evenly divide the minimum and maximum values into 4 segments

• Useful for quick visualization but may lack business context

Custom Labels

• Allow you to define specific value thresholds

• Enable more meaningful segmentation (e.g., financial bands, risk levels)

• Improve filtering accuracy and reporting clarity

Example:

Instead of evenly splitting $0–$1000M into 4 ranges, you might define:

• 0–125M

• 125–250M

• 250–500M

• 500M

Creating and Editing Numeric Labels

To configure numeric attribute labels:

1. Go to Settings → Story Setup

2. Select the Items tab

3. Open the Attributes sub-tab

4. Select the numeric attribute you want to configure

5. Click Add in the labels section

You will then be presented with the label configuration window.

Label Configuration Options

Within the label window, you can define:

• Label Name
  A descriptive name for the range (e.g., Low, Medium, High, Critical)

• Value (Threshold)
  Defines the upper boundary for the label (e.g., ≤125M)

  • Default value is ≤1, which should be updated as needed

  • Double-click the value field to edit

• Number of Labels

  • You must create at least two labels

  • The final label is automatically treated as a “greater than (>)” range

  • 

• Auto-set Label Ranges

  • Automatically distributes label thresholds evenly across the data range

  • Useful as a starting point, but values can be manually adjusted afterward

Creating an Unrestricted Range

By default, numeric attributes may enforce minimum and maximum limits, restricting the values items can have.

You can disable these limits to allow a dynamic (unrestricted) range:

• Go to the numeric attribute’s label settings

• Disable minimum and/or maximum constraints

This enables:

• Values to be determined by actual item data

• Items to exceed previously defined limits

• Greater flexibility when working with evolving datasets

Dragging Beyond Boundaries

With unrestricted ranges enabled:

• Items can be dragged beyond the visible boundaries of a view

• This assigns new numeric values outside previous limits

• Particularly useful in Grid or Compare views for quick adjustments

Re-enabling Limits

If you re-enable minimum or maximum limits and items fall outside the defined range, you will see this error:

• Yes – Adjusts item values to fit within the defined limits

• No – Keeps existing values and leaves limits disabled

This ensures you maintain control over how data is normalized when constraints are reintroduced.

Best Practices

• Use custom labels to reflect real-world thresholds (e.g., budget bands, priority levels)

• Start with Auto-set ranges, then refine for accuracy

• Enable unrestricted ranges when working with dynamic or uncertain data

• Regularly review labels to ensure they remain relevant as data evolves

Notes

• Applies only to numeric attributes and calculated values

• Labels directly impact filtering, grouping, and visual segmentation

• Especially useful for comparative analysis and dashboards