Jump to content
  • Version 1.1.0, released February 2022

    guagemod1.png.a3e81320c54fad058f3dbc7c9978d6ab.png

    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.

    image.thumb.png.6eefdffa978754c6bb858763e0427f82.png

    Data Requirements

    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 Mod

    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.

    The end result will look something like this:

    Guagemod2.thumb.png.ece89567756fd14e5e3275665066673f.png
    Configuring the Mod

    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).

    Guagemod3.png.8ab7ad117f6f9404d7aadab90a3bb801.png

    - 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 Mod

    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.

    Building the Project

    In a terminal window:

    • npm install
    • npm start

    In a new terminal window:

    • npm run server

    Help and Support

    This Mod is not supported by Spotfire® 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 a question in the Forum for Extensions & Mods to make it visible and routed to the appropriate team(s) to respond.

    More Information About Spotfire® Mods


    User Feedback

    Recommended Comments

    There are no comments to display.


×
×
  • Create New...