Gauge Mod for Spotfire®

The gauge mod is a configurable visualization for gauge reading using a radial scale to display a specific data point using a dial over a radial scale with defined limits.

Gauges can be used for many purposes like speed, satisfaction, volume, temperature, etc. But most common use is from car dashboard for fuel, speed, etc. also known as speedometer.

Data requirement

Every mod handles missing, corrupted and/or inconsistent data in different ways. It is advised to always review how the data is visualized.

To make the gauge work properly, the underlying data must be formatted in a certain way. A data table with at least two columns is required. At least one column must contain categories. And a second column must contain values.

Setting up the chart

In this example dataset, we have two columns: City, Satisfaction

The gauge mod can be configured to show the average satisfaction per city by configuring a gauge with the following settings:
- Gauge = City
- Value = Satisfaction with (Avg) as aggregation method

Optionally we could also use colors to better depict cities. E.g.:
- Color By = City

By default the min and max axes are empty. When min is empty, the default value is 0. The default max is the current greatest value from the value axis. The simplest way to configure min and max values are to set static numeric custom expressions, such as '5' for the max expression since we know our rating value ranges from 0 to 5.

The end result will look something like this:

Configuring the chart

After setting the data, multiple options are available to alter the gauges appearance live. To open the appearance options, click the settings button on the top right of the visualization (available in Edit mode).



- Arc width: Alters gauges arcs width. Set it to minimum to show as line. Set it to maximum to show as pies.
- Gauge angle: Alters the angle. Set it to minimum for full circle gauges or to maximum for half circle gauges.
- Background opacity: Alters the visibility of the gauge background. Set it to minimum opacity to hide gauge background.
- Scale ticks opacity: Alters the visibility of the tick marks. Set it to minimum opacity to hide tick marks.
- Show percent: Displays the center values as percentage.
- Show min and max: Displays labels for minimum and maximum values.

Using the chart

The gauge mod supports marking data and filtering data. Clicking on an arc will mark it. Clicking in an empty space will clear the marking. Hovering over arcs will also show a tooltip with additional information.

Help and support

This Mod for Spotfire® is not supported by Support.
In the event of issues or to suggest features and enhancements, submit an issue in the Mod's GitHub repository.
For general questions about Mods, please post in the Forums with the topic "Mods" to make it visible and routed to the appropriate team(s) to respond.

More information about Mods for Spotfire®

• Spotfire Community Exchange: A safe and trusted place to discover ready-to-use Mods
• Developer Documentation: Introduction and tutorials for Mods developers
• Mods code examples on GitHub: A public repository for example projects