AngularGauge
✖
AngularGauge
Details and Options




- Values less than min or greater than max are clipped to the respective limits.
- Undefined values or bad input is taken to be missing and typically displays the min value.
- Units may be assigned to value, min, and max by using Quantity.
- The units do not need to be the same, but must be compatible.
- AngularGauge has the same options as Graphics with the following additions and changes: [List of all options]
-
GaugeFaceElementFunction Automatic function to draw the face GaugeFaceStyle Automatic style for the gauge face GaugeFrameElementFunction Automatic function to draw the frame GaugeFrameSize Automatic how large to make the gauge frame GaugeFrameStyle Automatic style for the gauge frame GaugeLabels None labels for the gauge GaugeMarkers Automatic appearance for the marker GaugeStyle Automatic style for gauge markers Method Automatic method to use PerformanceGoal $PerformanceGoal aspects of performance to try to optimize PlotTheme $PlotTheme theme to use for drawing the gauge ScaleDivisions Automatic the number and distribution of ticks ScaleOrigin Automatic where to position the scale in the gauge ScalePadding Automatic how to draw the space around the scale ScaleRanges None the sections of the scale to be styled ScaleRangeStyle Automatic how to draw the scale ranges ScalingFunctions None scaling functions for the gauge TargetUnits Automatic units to display in the gauge - GaugeLabels can take the following forms:
-
None no gauge labels Automatic include units as labels Full include units and a value as labels All include all values as labels "Value" include values as labels "Unit" include units as labels label use label as a label Placed[label,pos] place label at position pos {label1,label2,…} use multiple labels - GaugeLabels->Placed[label,pos] can use the positions pos:
-
Top,Bottom,Left,Right,Center positions within the gauge face bs position along the scale Scaled[bs] scaled position along the scale {bx,by} scaled position {bx,by} in the gauge {pos,{lx,ly}} scaled position {lx,ly} in the label at general position pos in the gauge - A list of built-in settings for GaugeMarkers, GaugeFaceElementFunction, and GaugeFrameElementFunction can be obtained from ChartElementData["AngularGauge"]. A visual gallery is available in the Chart Element Schemes palette.
- GaugeMarkers->Placed[marker,pos] can be used to control where the marker is placed in the gauge. The possible positions pos are:
-
"Center" center of the dial face "DivisionCenter" cumulative markers centered on division marks "DivisionInterval" cumulative markers between division marks "Scale" within the scale region "OutsideScale" outside the scale region "InsideScale" inside the scale region "ScaleRange" cumulative marker within the scale region "Frame" within the dial frame - ScaleOrigin can take the following values:
-
r radius of the scale Left,Right,Bottom,Top on which side to center the scale {θmin,θmax} angular locations of min and max for the scale {angle,r} angular and radial origins for the scale - The angles in ScaleOrigin are measured in radians, counterclockwise from the positive
axis. The values need not be between 0 and
.
- Scales run counterclockwise when θmin<θmax and clockwise when θmin>θmax.
- If Abs[θmax-θmin]>2Pi, the scale will overlap itself.
- The radial component r of the scale origin is scaled to run from 0 at the center of the gauge to 1 at the edge of the face.
- ScalePadding can take the following forms:
-
p angular padding p on each end of the scale {pmin,pmax} padding pmin before the scale and pmax after None no padding around the scale Automatic automatically determined padding Full pad to the nearest chord of a circle All pad the scale to make a complete circle - TargetUnits->Automatic automatically selects the units based on the input. If no units are present, none will be displayed.
- TargetUnits->unit displays unit in the gauge, even if no units were present in the input.
-
AlignmentPoint Center the default point in the graphic to align with AspectRatio Automatic ratio of height to width Axes False whether to draw axes AxesLabel None axes labels AxesOrigin Automatic where axes should cross AxesStyle {} style specifications for the axes Background None background color for the plot BaselinePosition Automatic how to align with a surrounding text baseline BaseStyle {} base style specifications for the graphic ContentSelectable Automatic whether to allow contents to be selected CoordinatesToolOptions Automatic detailed behavior of the coordinates tool Epilog {} primitives rendered after the main plot FormatType TraditionalForm the default format type for text Frame False whether to put a frame around the plot FrameLabel None frame labels FrameStyle {} style specifications for the frame FrameTicks Automatic frame ticks FrameTicksStyle {} style specifications for frame ticks GaugeFaceElementFunction Automatic function to draw the face GaugeFaceStyle Automatic style for the gauge face GaugeFrameElementFunction Automatic function to draw the frame GaugeFrameSize Automatic how large to make the gauge frame GaugeFrameStyle Automatic style for the gauge frame GaugeLabels None labels for the gauge GaugeMarkers Automatic appearance for the marker GaugeStyle Automatic style for gauge markers GridLines None grid lines to draw GridLinesStyle {} style specifications for grid lines ImageMargins 0. the margins to leave around the graphic ImagePadding All what extra padding to allow for labels etc. ImageSize Automatic the absolute size at which to render the graphic LabelStyle {} style specifications for labels Method Automatic method to use PerformanceGoal $PerformanceGoal aspects of performance to try to optimize PlotLabel None an overall label for the plot PlotRange All range of values to include PlotRangeClipping False whether to clip at the plot range PlotRangePadding Automatic how much to pad the range of values PlotRegion Automatic the final display region to be filled PlotTheme $PlotTheme theme to use for drawing the gauge PreserveImageOptions Automatic whether to preserve image options when displaying new versions of the same graphic Prolog {} primitives rendered before the main plot RotateLabel True whether to rotate y labels on the frame ScaleDivisions Automatic the number and distribution of ticks ScaleOrigin Automatic where to position the scale in the gauge ScalePadding Automatic how to draw the space around the scale ScaleRanges None the sections of the scale to be styled ScaleRangeStyle Automatic how to draw the scale ranges ScalingFunctions None scaling functions for the gauge TargetUnits Automatic units to display in the gauge Ticks Automatic axes ticks TicksStyle {} style specifications for axes ticks

List of all options




Examples
open allclose allBasic Examples (4)Summary of the most common use cases
Generate a dial gauge for a particular value:

https://wolfram.com/xid/0j0cpw1ilhccda-66qkbv

Generate a gauge using values with units:

https://wolfram.com/xid/0j0cpw1ilhccda-lk2qyl

Generate a gauge that displays multiple values:

https://wolfram.com/xid/0j0cpw1ilhccda-70edvd

Generate a dial gauge with an interactive value:

https://wolfram.com/xid/0j0cpw1ilhccda-obu4bc

Scope (22)Survey of the scope of standard use cases
Data and Layouts (7)
Data values are clipped to be within the range of the scale:

https://wolfram.com/xid/0j0cpw1ilhccda-gripqn

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

https://wolfram.com/xid/0j0cpw1ilhccda-z5ueyy

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

https://wolfram.com/xid/0j0cpw1ilhccda-6ugb19

Generate a gauge using values with units:

https://wolfram.com/xid/0j0cpw1ilhccda-c466ak

Specify the displayed units with TargetUnits:

https://wolfram.com/xid/0j0cpw1ilhccda-78rrq6

Change the position of the scale:

https://wolfram.com/xid/0j0cpw1ilhccda-9fihjx

Display the gauge as a semicircle:

https://wolfram.com/xid/0j0cpw1ilhccda-tc9hfo

Use Dynamic to make an interactive gauge:

https://wolfram.com/xid/0j0cpw1ilhccda-nmfayz

Styling and Appearance (9)
Use a theme to control the overall appearance:

https://wolfram.com/xid/0j0cpw1ilhccda-zl877x

Use explicit styles for the markers:

https://wolfram.com/xid/0j0cpw1ilhccda-9mc3ni

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

https://wolfram.com/xid/0j0cpw1ilhccda-2eqh46

Change the type of markers used:

https://wolfram.com/xid/0j0cpw1ilhccda-ieo7ly

Change where the markers are placed:

https://wolfram.com/xid/0j0cpw1ilhccda-bj9oqa

Use any graphic or image for the marker:

https://wolfram.com/xid/0j0cpw1ilhccda-pbnphu

Change the style of the face of the gauge:

https://wolfram.com/xid/0j0cpw1ilhccda-k6zf7

Change the style of the frame around the gauge:

https://wolfram.com/xid/0j0cpw1ilhccda-p0np9n

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

https://wolfram.com/xid/0j0cpw1ilhccda-6z2ohz

Labeling (6)
Use GaugeLabels to add a label to the gauge face:

https://wolfram.com/xid/0j0cpw1ilhccda-z3h43a

Add a display of the scale value:

https://wolfram.com/xid/0j0cpw1ilhccda-sj8663

Add a display of the gauge units:

https://wolfram.com/xid/0j0cpw1ilhccda-bgx2ku


https://wolfram.com/xid/0j0cpw1ilhccda-pwz3uj

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

https://wolfram.com/xid/0j0cpw1ilhccda-d1t062

Use a list to specify more than one label:

https://wolfram.com/xid/0j0cpw1ilhccda-x9rt6p

Options (87)Common values & functionality for each option
AspectRatio (2)
AspectRatio is automatic by default, resulting in perfect circles:

https://wolfram.com/xid/0j0cpw1ilhccda-kipgtn

Use a fixed ratio to change the shape of the gauge:

https://wolfram.com/xid/0j0cpw1ilhccda-bftm6h

Background (1)
Insert a background color behind the gauge:

https://wolfram.com/xid/0j0cpw1ilhccda-keda1x

Use GaugeFaceStyle to set the face style:

https://wolfram.com/xid/0j0cpw1ilhccda-gbxlvg

Frame (4)
AngularGauge does not use a frame by default:

https://wolfram.com/xid/0j0cpw1ilhccda-573cxe

Use FrameTrue to draw a frame around the plot:

https://wolfram.com/xid/0j0cpw1ilhccda-khimwi

Draw a frame on the left and right edges:

https://wolfram.com/xid/0j0cpw1ilhccda-lyx1bm

Draw a frame on the left and bottom edges:

https://wolfram.com/xid/0j0cpw1ilhccda-fbrngi

FrameStyle (2)
GaugeFaceElementFunction (3)
List built-in settings for GaugeFaceElementFunction:

https://wolfram.com/xid/0j0cpw1ilhccda-iuo5q3

For detailed settings, use Palettes ▶ Chart Element Schemes:

https://wolfram.com/xid/0j0cpw1ilhccda-nm2p63

Write a custom GaugeFaceElementFunction:

https://wolfram.com/xid/0j0cpw1ilhccda-sjgooz

https://wolfram.com/xid/0j0cpw1ilhccda-xlcxoz

GaugeFaceStyle (3)
Specify the style for the gauge face:

https://wolfram.com/xid/0j0cpw1ilhccda-is6ce2

Use None to turn off the face:

https://wolfram.com/xid/0j0cpw1ilhccda-j9cc15

Use a Texture as a gauge face:

https://wolfram.com/xid/0j0cpw1ilhccda-3umigp


https://wolfram.com/xid/0j0cpw1ilhccda-fcokxz

GaugeFrameElementFunction (3)
List built-in settings for GaugeFrameElementFunction:

https://wolfram.com/xid/0j0cpw1ilhccda-nt2nf5

For detailed settings, use Palettes ▶ Chart Element Schemes:

https://wolfram.com/xid/0j0cpw1ilhccda-xojot2

Construct a custom rendering function:

https://wolfram.com/xid/0j0cpw1ilhccda-i2mo8n

https://wolfram.com/xid/0j0cpw1ilhccda-p5dyoz

GaugeFrameSize (3)
Make the frame have an explicit width scaled to the size of the gauge face:

https://wolfram.com/xid/0j0cpw1ilhccda-f6lf5c

Use None to turn off the frame:

https://wolfram.com/xid/0j0cpw1ilhccda-2b3jt5

Use named sizes for the frame:

https://wolfram.com/xid/0j0cpw1ilhccda-orrhfw

GaugeFrameStyle (1)
GaugeLabels (10)

https://wolfram.com/xid/0j0cpw1ilhccda-zqjccz


https://wolfram.com/xid/0j0cpw1ilhccda-70587n


https://wolfram.com/xid/0j0cpw1ilhccda-525ff8

If units are present, they can be added as a label to the gauge:

https://wolfram.com/xid/0j0cpw1ilhccda-pjdeyb

Use Placed to control label placement:

https://wolfram.com/xid/0j0cpw1ilhccda-4zdth3

Position labels at values along the scale:

https://wolfram.com/xid/0j0cpw1ilhccda-2137wy

Position labels using a scaled coordinate system along the scale:

https://wolfram.com/xid/0j0cpw1ilhccda-va9hun

Use a scaled coordinate system over the entire gauge:

https://wolfram.com/xid/0j0cpw1ilhccda-k4fzks

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

https://wolfram.com/xid/0j0cpw1ilhccda-nsq3yr

Use a list to specify more than one label:

https://wolfram.com/xid/0j0cpw1ilhccda-0tselc

GaugeMarkers (8)

https://wolfram.com/xid/0j0cpw1ilhccda-t8ch7j

List built-in settings for GaugeMarkers:

https://wolfram.com/xid/0j0cpw1ilhccda-tf9r82

For detailed settings, use Palettes ▶ Chart Element Schemes:

https://wolfram.com/xid/0j0cpw1ilhccda-8hjkou

Use an image or graphic for a marker:

https://wolfram.com/xid/0j0cpw1ilhccda-0r749l

Use Placed to change the location of the marker:

https://wolfram.com/xid/0j0cpw1ilhccda-tftl8w

Fill a cumulative bar to the value:

https://wolfram.com/xid/0j0cpw1ilhccda-hmwcfo

Fill segments that are centered on division values:

https://wolfram.com/xid/0j0cpw1ilhccda-kdy1ui

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

https://wolfram.com/xid/0j0cpw1ilhccda-0vrw9v

Fill segments that are between division values:

https://wolfram.com/xid/0j0cpw1ilhccda-c4b6ht

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

https://wolfram.com/xid/0j0cpw1ilhccda-4f33kf

Use an image or graphic for a cumulative marker:

https://wolfram.com/xid/0j0cpw1ilhccda-lxhsh1

GaugeStyle (5)

https://wolfram.com/xid/0j0cpw1ilhccda-bjqews

By default, different styles are chosen for multiple markers:

https://wolfram.com/xid/0j0cpw1ilhccda-hvkiv3


https://wolfram.com/xid/0j0cpw1ilhccda-rz86mp

Use any gradient or indexed color schemes from ColorData:

https://wolfram.com/xid/0j0cpw1ilhccda-ucxiqx

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

https://wolfram.com/xid/0j0cpw1ilhccda-1bfu9b

Specify an additional style for markers beyond the gauge value:

https://wolfram.com/xid/0j0cpw1ilhccda-qi62pm

Use None to not use any style:

https://wolfram.com/xid/0j0cpw1ilhccda-zyhwia

ImageSize (7)
Use named sizes such as Tiny, Small, Medium and Large:

https://wolfram.com/xid/0j0cpw1ilhccda-kjcklw

Specify the width of the plot:

https://wolfram.com/xid/0j0cpw1ilhccda-k1a7yk

Specify the height of the plot:

https://wolfram.com/xid/0j0cpw1ilhccda-dsxhj6

Specify the width and height for a graphic, padding with space if necessary:

https://wolfram.com/xid/0j0cpw1ilhccda-fkoiqq

Use maximum sizes for the width and height:

https://wolfram.com/xid/0j0cpw1ilhccda-trm50

Use ImageSizeFull to fill the available space in an object:

https://wolfram.com/xid/0j0cpw1ilhccda-brw8e1

Specify the image size as a fraction of the available space:

https://wolfram.com/xid/0j0cpw1ilhccda-cgprb

PerformanceGoal (2)
PlotTheme (4)
Create gauges using a variety of base themes:

https://wolfram.com/xid/0j0cpw1ilhccda-ts04n8

Combine the base themes with the "GaugeHalf" feature theme:

https://wolfram.com/xid/0j0cpw1ilhccda-xm1is6

Combine the "Marketing" theme with a scale origin:

https://wolfram.com/xid/0j0cpw1ilhccda-vr0avh

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

https://wolfram.com/xid/0j0cpw1ilhccda-1q0r6l


https://wolfram.com/xid/0j0cpw1ilhccda-r71vdr

ScaleDivisions (2)
ScaleOrigin (4)
Use ScaleOrigin to specify a radial position for the scale:

https://wolfram.com/xid/0j0cpw1ilhccda-66h0y

Use a relative location for the center of the scale:

https://wolfram.com/xid/0j0cpw1ilhccda-225dmn

Specify a starting and ending angle for the scale:

https://wolfram.com/xid/0j0cpw1ilhccda-ykr8dg

Change the order of the endpoints to reverse the scale direction:

https://wolfram.com/xid/0j0cpw1ilhccda-ywk502

Change the endpoints to use the opposite arc of the scale:

https://wolfram.com/xid/0j0cpw1ilhccda-juc901

Change the order of the endpoints to reverse the scale direction:

https://wolfram.com/xid/0j0cpw1ilhccda-lcizip

Specify a radial and angular position for the scale:

https://wolfram.com/xid/0j0cpw1ilhccda-lvbc6x

ScalePadding (5)
Use automatically determined angular padding:

https://wolfram.com/xid/0j0cpw1ilhccda-o6frpu

Full padding will ensure a "nice" dial face shape:

https://wolfram.com/xid/0j0cpw1ilhccda-v764be

Leave no angular padding around the scale:

https://wolfram.com/xid/0j0cpw1ilhccda-uhr1b4

Specify a constant angular padding:

https://wolfram.com/xid/0j0cpw1ilhccda-clt5qb

Specify different angular padding on each side:

https://wolfram.com/xid/0j0cpw1ilhccda-ccrd4d

ScaleRanges (7)
Highlight a range of values on the scale:

https://wolfram.com/xid/0j0cpw1ilhccda-n13yos


https://wolfram.com/xid/0j0cpw1ilhccda-n08uhh

Style the entire region behind the scale:

https://wolfram.com/xid/0j0cpw1ilhccda-7pgo4q

Ranges need not be contiguous or distinct:

https://wolfram.com/xid/0j0cpw1ilhccda-peh69z

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

https://wolfram.com/xid/0j0cpw1ilhccda-hfk982

ScaleRanges appears in front of the gauge face:

https://wolfram.com/xid/0j0cpw1ilhccda-j00xsg


https://wolfram.com/xid/0j0cpw1ilhccda-45q432

Vary the width for each scale range:

https://wolfram.com/xid/0j0cpw1ilhccda-e8rr6b

ScaleRangeStyle (8)
By default, the scale ranges are styles based on the marker color:

https://wolfram.com/xid/0j0cpw1ilhccda-mctyjo


https://wolfram.com/xid/0j0cpw1ilhccda-364szm

Use a list of directives to style each range separately:

https://wolfram.com/xid/0j0cpw1ilhccda-yptm0c

Styles will repeat cyclically if necessary:

https://wolfram.com/xid/0j0cpw1ilhccda-6xmbiu

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

https://wolfram.com/xid/0j0cpw1ilhccda-m9owsc

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

https://wolfram.com/xid/0j0cpw1ilhccda-5z9w1r

Color the scale ranges with built-in color schemes:

https://wolfram.com/xid/0j0cpw1ilhccda-48ecsi

Define a one-dimensional color function:

https://wolfram.com/xid/0j0cpw1ilhccda-cmig79

https://wolfram.com/xid/0j0cpw1ilhccda-g9dn36

Applications (6)Sample problems that can be solved with this function
Use a gauge as a control in Manipulate:

https://wolfram.com/xid/0j0cpw1ilhccda-73t50r

Visualize leaf count for successive integrals:

https://wolfram.com/xid/0j0cpw1ilhccda-vdje6i


https://wolfram.com/xid/0j0cpw1ilhccda-qjpyol
Monitor memory used by processes with an indicator of the max memory used:

https://wolfram.com/xid/0j0cpw1ilhccda-8gvtm

Monitor progress when integrating a differential equation:

https://wolfram.com/xid/0j0cpw1ilhccda-exw13n


https://wolfram.com/xid/0j0cpw1ilhccda-kcs3

Visualize properties of noble gases:

https://wolfram.com/xid/0j0cpw1ilhccda-w61bhh

Visualize the first two derivatives of a polynomial:

https://wolfram.com/xid/0j0cpw1ilhccda-pbl7ma

Wolfram Research (2012), AngularGauge, Wolfram Language function, https://reference.wolfram.com/language/ref/AngularGauge.html (updated 2015).
Text
Wolfram Research (2012), AngularGauge, Wolfram Language function, https://reference.wolfram.com/language/ref/AngularGauge.html (updated 2015).
Wolfram Research (2012), AngularGauge, Wolfram Language function, https://reference.wolfram.com/language/ref/AngularGauge.html (updated 2015).
CMS
Wolfram Language. 2012. "AngularGauge." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2015. https://reference.wolfram.com/language/ref/AngularGauge.html.
Wolfram Language. 2012. "AngularGauge." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2015. https://reference.wolfram.com/language/ref/AngularGauge.html.
APA
Wolfram Language. (2012). AngularGauge. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/AngularGauge.html
Wolfram Language. (2012). AngularGauge. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/AngularGauge.html
BibTeX
@misc{reference.wolfram_2025_angulargauge, author="Wolfram Research", title="{AngularGauge}", year="2015", howpublished="\url{https://reference.wolfram.com/language/ref/AngularGauge.html}", note=[Accessed: 01-April-2025
]}
BibLaTeX
@online{reference.wolfram_2025_angulargauge, organization={Wolfram Research}, title={AngularGauge}, year={2015}, url={https://reference.wolfram.com/language/ref/AngularGauge.html}, note=[Accessed: 01-April-2025
]}