WOLFRAM

draws a linear gauge showing value in a range of 0 to 1.

HorizontalGauge[value,{min,max}]

draws a linear gauge showing value in a range of min to max.

HorizontalGauge[Dynamic[value],]

allows value to be set interactively using the gauge.

HorizontalGauge[{value1,value2,},]

draws a gauge showing multiple values.

Details and Options

Examples

open allclose all

Basic Examples  (4)Summary of the most common use cases

Generate a dial gauge for a particular value:

Out[1]=1

Generate a gauge using values with units:

Out[1]=1

Generate a gauge that displays multiple values:

Out[1]=1

Generate a dial gauge with an interactive value:

Out[1]=1

Scope  (22)Survey of the scope of standard use cases

Data and Layouts  (7)

Data values do not have to be within the range of the scale:

Out[1]=1

Nonreal data is taken to be missing and typically uses the min value of the gauge:

Out[1]=1

The min and max specified are sorted so that the smaller number of the list is always the min:

Out[1]=1

Generate a gauge using values with units:

Out[1]=1

Specify the displayed units with TargetUnits:

Out[2]=2

Change the position of the scale:

Out[1]=1

Specify a constant horizontal and vertical padding:

Out[1]=1

Use Dynamic to make an interactive gauge:

Out[1]=1

Styling and Appearance  (9)

Use a theme to control the overall appearance:

Out[1]=1

Combine the theme with other options:

Out[2]=2

Use explicit styles for the markers:

Out[1]=1

Use any gradient or indexed color schemes from ColorData to style the markers:

Out[1]=1

Change the type of markers used:

Out[1]=1

Change where the markers are placed:

Out[1]=1

Position the marker in the frame:

Out[2]=2

Use any graphic or image for the marker:

Out[1]=1

Change the style of the face of the gauge:

Out[1]=1

Change the style of the frame around the gauge:

Out[1]=1

Specify ranges of the scale to be colored by the index on the dial face:

Out[1]=1

Labeling and Legending  (6)

Use GaugeLabels to add a label to the gauge face:

Out[1]=1

Add a display of the scale value:

Out[1]=1

Add a display of the gauge units:

Out[1]=1

Show units and scale value:

Out[1]=1

Use Placed to change the location of the label on the face of the gauge:

Out[1]=1

Use a list to specify more than one label:

Out[1]=1

Options  (69)Common values & functionality for each option

Background  (1)

Insert a background color behind the gauge:

Out[1]=1

Use GaugeFaceStyle to set the face style:

Out[2]=2

GaugeFaceElementFunction  (3)

List built-in settings for GaugeFaceElementFunction:

Out[1]=1

For detailed settings use Palettes ChartElementSchemes:

Out[1]=1

Write a custom GaugeFaceElementFunction:

Out[2]=2

GaugeFaceStyle  (3)

Specify the style for the gauge face:

Out[1]=1

Use None to turn off the face:

Out[1]=1

Use a Texture as a gauge face:

Out[1]=1
Out[2]=2

GaugeFrameElementFunction  (2)

List built-in settings for GaugeFrameElementFunction:

Out[1]=1

For detailed settings use Palettes ChartElementSchemes:

Out[1]=1

GaugeFrameSize  (3)

Use an explicit width in the graphics coordinate system to draw the frame:

Out[1]=1

Use None to turn off the frame:

Out[1]=1

Use named sizes for the frame:

Out[1]=1

GaugeFrameStyle  (1)

Use directives to change the rendering of the gauge frame:

Out[1]=1

GaugeLabels  (9)

Show the value as a label:

Out[1]=1

Specify a label:

Out[1]=1

Labels can be any expression:

Out[1]=1

Use Placed to control label placement:

Out[1]=1

Position labels at values along the scale:

Out[1]=1

Position labels using a scaled coordinate system along the scale:

Out[1]=1

Use a scaled coordinate system over the entire gauge:

Out[1]=1

Place all labels at the middle of the scale and vary the coordinates within the label:

Out[1]=1

Use a list to specify more than one label:

Out[1]=1

GaugeMarkers  (9)

Turn the markers on and off:

Out[1]=1

List built-in settings for GaugeMarkers:

Out[1]=1

For detailed settings use Palettes ChartElementSchemes:

Out[2]=2

Use an image or graphic for a marker:

Out[1]=1

Use Placed to change the location of the marker:

Out[1]=1

Position the marker in the frame:

Out[1]=1

Fill a cumulative bar to the value:

Out[1]=1

Fill segments that are centered on division values:

Out[1]=1

Sequential markers are activated when the value rounds to the division value:

Out[2]=2

Fill segments that are between division values:

Out[1]=1

Sequential markers are activated when the value is greater than or equal to the division value:

Out[2]=2

Use an image or graphic for a cumulative marker:

Out[1]=1

GaugeStyle  (5)

Style the gauge marker:

Out[1]=1

By default different styles are chosen for multiple markers:

Out[1]=1

Specify a list of styles:

Out[1]=1

Use any gradient or indexed color schemes from ColorData:

Out[1]=1

Specify the style for cumulative markers up to the gauge value:

Out[1]=1

Specify an additional style for markers beyond the gauge value:

Out[2]=2

LabelStyle  (1)

Style the labels:

Out[1]=1

PerformanceGoal  (2)

Generate a gauge with tooltips on the gauge markers:

Out[1]=1

Emphasize performance by disabling interactive behaviors:

Out[1]=1

PlotTheme  (4)

Create gauges using a variety of base themes:

Out[1]=1

Specify a theme with minimal elements:

Out[1]=1

Change the gauge color:

Out[1]=1

The "Sparkline" theme fits gauges in the surrounding text:

Out[1]=1
Out[2]=2

ScaleDivisions  (2)

Specify the total number of ticks:

Out[1]=1

Specify the number of major and minor ticks:

Out[1]=1

ScaleOrigin  (3)

Use ScaleOrigin to specify a vertical offset for the scale:

Out[1]=1

Specify a starting and ending position for the scale:

Out[1]=1

Specify a horizontal position and vertical extent for the scale:

Out[1]=1

ScalePadding  (3)

Use automatically determined padding around the scale:

Out[1]=1

Specify a constant horizontal and vertical padding:

Out[1]=1

Use a scaled value for the constant horizontal and vertical padding:

Out[2]=2

Specify different horizontal and vertical padding on each side:

Out[1]=1

ScaleRanges  (7)

Highlight a range of values on the scale:

Out[1]=1

Specify multiple ranges:

Out[1]=1

Style the entire region behind the scale:

Out[1]=1

Ranges need not be contiguous or distinct:

Out[1]=1

Directly associate a style with a range with range->style:

Out[1]=1

ScaleRanges draw in front of the gauge face:

Out[1]=1

Change the scale range width:

Out[1]=1
Out[2]=2

ScaleRangeStyle  (7)

By default, the scale ranges are colored with a gradient based on the marker color:

Out[1]=1

Apply a style to all of the ranges:

Out[1]=1

Use a list of styles to draw the ranges:

Out[1]=1

Use ScaleRangeStyle->{None,style} to apply a style to the scale only:

Out[1]=1

Apply a style to the backgrounds and foregrounds of all the ranges:

Out[1]=1

Color the scale ranges with built-in color schemes:

Out[1]=1

Define a one-dimensional color function:

Out[2]=2

TargetUnits  (2)

By default, units are determined automatically:

Out[1]=1

Specify the displayed units:

Out[1]=1

TicksStyle  (2)

Specify overall ticks style:

Out[1]=1

Use None to not draw ticks:

Out[1]=1

Applications  (6)Sample problems that can be solved with this function

Visualize leaf count for successive integrals:

Out[1]=1

Monitor memory used by processes with a indicator of the max memory used:

Out[1]=1

Monitor how long the kernel has been running and how much time has been spent in computation:

Out[1]=1

Monitor progress when integrating a differential equation:

Out[1]=1
Out[2]=2

Monitor where NIntegrate is focusing on approximating the integral:

Out[3]=3
Out[4]=4
Out[5]=5

Monitor progress when integrating a differential equation:

Out[1]=1
Out[2]=2

Visualize the spectral lines of elements:

Out[2]=2
Wolfram Research (2012), HorizontalGauge, Wolfram Language function, https://reference.wolfram.com/language/ref/HorizontalGauge.html (updated 2014).
Wolfram Research (2012), HorizontalGauge, Wolfram Language function, https://reference.wolfram.com/language/ref/HorizontalGauge.html (updated 2014).

Text

Wolfram Research (2012), HorizontalGauge, Wolfram Language function, https://reference.wolfram.com/language/ref/HorizontalGauge.html (updated 2014).

Wolfram Research (2012), HorizontalGauge, Wolfram Language function, https://reference.wolfram.com/language/ref/HorizontalGauge.html (updated 2014).

CMS

Wolfram Language. 2012. "HorizontalGauge." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2014. https://reference.wolfram.com/language/ref/HorizontalGauge.html.

Wolfram Language. 2012. "HorizontalGauge." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2014. https://reference.wolfram.com/language/ref/HorizontalGauge.html.

APA

Wolfram Language. (2012). HorizontalGauge. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/HorizontalGauge.html

Wolfram Language. (2012). HorizontalGauge. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/HorizontalGauge.html

BibTeX

@misc{reference.wolfram_2025_horizontalgauge, author="Wolfram Research", title="{HorizontalGauge}", year="2014", howpublished="\url{https://reference.wolfram.com/language/ref/HorizontalGauge.html}", note=[Accessed: 25-March-2025 ]}

@misc{reference.wolfram_2025_horizontalgauge, author="Wolfram Research", title="{HorizontalGauge}", year="2014", howpublished="\url{https://reference.wolfram.com/language/ref/HorizontalGauge.html}", note=[Accessed: 25-March-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_horizontalgauge, organization={Wolfram Research}, title={HorizontalGauge}, year={2014}, url={https://reference.wolfram.com/language/ref/HorizontalGauge.html}, note=[Accessed: 25-March-2025 ]}

@online{reference.wolfram_2025_horizontalgauge, organization={Wolfram Research}, title={HorizontalGauge}, year={2014}, url={https://reference.wolfram.com/language/ref/HorizontalGauge.html}, note=[Accessed: 25-March-2025 ]}