Home

This Mod for Spotfire® can be used to display 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.

Installation

Opening the visualization in Spotfire® Analyst

1. From this repository Releases section, locate and download the .mod file.
2. Drag the .mod file into an analysis in Spotfire® Analyst.

For information on how to use and share visualizations mods, read the Spotfire® documentation.

Running the project in Spotfire®

1. From this repository Releases section, locate and download the source code.
2. Build the project in your preferred code editor. Microsoft Visual Studio Code is highly recommended.
3. Open an analysis in Spotfire® and select Tools > Development > Create visualization mod from the menubar to connect to the project.

For information on how to get started with visualization mod development, read the Spotfire® documentation.

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.

Setup

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

City	Satisfaction
Borås	5
Borås	4.5
Gothenburg	2
Gothenburg	2
Gothenburg	1
Gothenburg	2
Skene	5
Härryda	5
Härryda	3
Horred	4.5

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.

Configuration

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.

Usage

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.