ThermometerGaugeCopy to clipboard.
✖
ThermometerGauge
draws a thermometer showing value in a range of 0 to 1.
draws a thermometer showing value in a range of min to max.
allows value to be set interactively using the thermometer.
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 commensurate.
- ThermometerGauge 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 Automatic 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 dial 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 - ScalePadding can take the following forms:
-
p the same horizontal and vertical padding {pr,py} different horizontal and vertical padding {{px left,px right},…} different padding on each side of the axis etc. - ThermometerGauge by default uses a filled liquid appearance for the marker.
- 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 Automatic 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 (2)Summary of the most common use cases
Generate a thermometer gauge for a particular value:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-5cusvk
Generate a thermometer gauge using values with units:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-lk2qyl
Scope (15)Survey of the scope of standard use cases
Data and Layouts (4)
Data values do not have to be within the range of the scale:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-gripqn
Nonreal data is taken to be missing and uses the minimum value of the gauge:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-6794b7
The min and max specified are sorted so that the smaller number of the list is always the min:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-6ugb19
Specify temperatures using units:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-9hm9mf
Specify the displayed units with TargetUnits:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-peo7sy
Styling and Appearance (5)
Use a theme to control the overall appearance:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-zl877x
Use explicit styles for the markers:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-9mc3ni
Change the face style for the gauge:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-gcpwa9
Change the style of the frame around the gauge:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-z72w8m
Specify ranges of the scale to be colored by the index on the dial face:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-6z2ohz
Labeling and Legending (6)
Use GaugeLabels to add a label to the gauge face:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-z3h43a
Add a display of the scale value:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-sj8663
Add a display of the thermometer units:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-bgx2ku
https://wolfram.com/xid/0bzqjwjil0g25mp3i-pwz3uj
Use Placed to change the location of the label on the face of the gauge:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-d1t062
Add multiple labels to the gauge face:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-xhzjri
Options (49)Common values & functionality for each option
Background (1)
Insert a background color behind the gauge:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-keda1x
Use GaugeFaceStyle to set the face style:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-gbxlvg
GaugeFaceElementFunction (3)
List built-in settings for GaugeFaceElementFunction:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-iuo5q3
For detailed settings use Palettes ▶ ChartElementSchemes:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-nm2p63
Write a custom GaugeFaceElementFunction:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-sjgooz
https://wolfram.com/xid/0bzqjwjil0g25mp3i-xlcxoz
GaugeFaceStyle (3)
Specify the style for the gauge face:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-is6ce2
Use None to turn off the face:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-uiz5gy
Use a Texture as a gauge face:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-3umigp
GaugeFrameElementFunction (2)
List built-in settings for GaugeFrameElementFunction:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-nt2nf5
For detailed settings, use Palettes ▶ ChartElementSchemes:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-xojot2
GaugeFrameSize (3)
Use an explicit width in the graphics coordinate system to draw the frame:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-58smay
Use None to turn off the frame:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-2b3jt5
Use named sizes for the frame:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-orrhfw
GaugeFrameStyle (1)
GaugeLabels (6)
https://wolfram.com/xid/0bzqjwjil0g25mp3i-63bmrb
https://wolfram.com/xid/0bzqjwjil0g25mp3i-70587n
https://wolfram.com/xid/0bzqjwjil0g25mp3i-525ff8
Use Placed to control label placement:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-4zdth3
Use a scaled coordinate system over the entire gauge:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-xr4bey
Use a list to specify more than one label:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-0tselc
GaugeStyle (1)
LabelStyle (1)
PerformanceGoal (3)
Generate a gauge with interaction highlighting and improved aesthetics:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-idl15m
Turn off interactive highlighting and use a simpler appearance for increased speed:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-zz26bm
Typically, less memory is required for noninteractive charts:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-q582ho
PlotTheme (5)
Create gauges using a variety of base themes:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-ts04n8
Specify a theme with minimal elements:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-7cygl4
https://wolfram.com/xid/0bzqjwjil0g25mp3i-z09xhw
https://wolfram.com/xid/0bzqjwjil0g25mp3i-obdh97
https://wolfram.com/xid/0bzqjwjil0g25mp3i-7zk0jy
ScaleDivisions (2)
Specify the total number of ticks divisions:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-4dz07f
Specify the number of major and minor ticks:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-8u795j
ScaleRanges (7)
Highlight a range of values on the scale:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-32dbi5
https://wolfram.com/xid/0bzqjwjil0g25mp3i-rjhpck
Style the entire region behind the scale:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-7pgo4q
Ranges need not be contiguous or distinct:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-t31z2i
Directly associate a style with a range with range->style:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-4aexfs
ScaleRanges draws in front of the gauge face:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-j00xsg
https://wolfram.com/xid/0bzqjwjil0g25mp3i-45q432
https://wolfram.com/xid/0bzqjwjil0g25mp3i-e8rr6b
ScaleRangeStyle (7)
By default, scale ranges styles are based on GaugeStyle:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-mctyjo
Apply a style to all of the ranges:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-364szm
Use a list of directives to style the ranges:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-yptm0c
Styles will repeat cyclically if necessary:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-6xmbiu
Use ScaleRangeStyle->{None,style} to apply a style to the scale only:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-m9owsc
Apply a style to the backgrounds and foregrounds of all the ranges:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-08osl7
Color the scale ranges with built-in ColorData gradients:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-nt7cy6
TargetUnits (2)
TicksStyle (2)
https://wolfram.com/xid/0bzqjwjil0g25mp3i-otj9ct
Use None to not draw ticks:
https://wolfram.com/xid/0bzqjwjil0g25mp3i-2f4qkd
Applications (1)Sample problems that can be solved with this function
Wolfram Research (2012), ThermometerGauge, Wolfram Language function, https://reference.wolfram.com/language/ref/ThermometerGauge.html (updated 2015).
Text
Wolfram Research (2012), ThermometerGauge, Wolfram Language function, https://reference.wolfram.com/language/ref/ThermometerGauge.html (updated 2015).
Wolfram Research (2012), ThermometerGauge, Wolfram Language function, https://reference.wolfram.com/language/ref/ThermometerGauge.html (updated 2015).
CMS
Wolfram Language. 2012. "ThermometerGauge." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2015. https://reference.wolfram.com/language/ref/ThermometerGauge.html.
Wolfram Language. 2012. "ThermometerGauge." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2015. https://reference.wolfram.com/language/ref/ThermometerGauge.html.
APA
Wolfram Language. (2012). ThermometerGauge. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ThermometerGauge.html
Wolfram Language. (2012). ThermometerGauge. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ThermometerGauge.html
BibTeX
@misc{reference.wolfram_2024_thermometergauge, author="Wolfram Research", title="{ThermometerGauge}", year="2015", howpublished="\url{https://reference.wolfram.com/language/ref/ThermometerGauge.html}", note=[Accessed: 10-January-2025
]}
BibLaTeX
@online{reference.wolfram_2024_thermometergauge, organization={Wolfram Research}, title={ThermometerGauge}, year={2015}, url={https://reference.wolfram.com/language/ref/ThermometerGauge.html}, note=[Accessed: 10-January-2025
]}