BulletGauge [value,reference,{min,max}]
draws a bullet gauge showing value and reference in a range of min to max.
BulletGauge [value,reference,{min,m1,m2,…,max}]
draws a bullet gauge with performance regions split at the mi.
BulletGauge [{v1,v2,…},…]
draws a bullet gauge with multiple values v1, v2, ….
BulletGauge [values,{r1,r2,…},…]
draws a bullet gauge with multiple references r1, r2, ….
BulletGauge
BulletGauge [value,reference,{min,max}]
draws a bullet gauge showing value and reference in a range of min to max.
BulletGauge [value,reference,{min,m1,m2,…,max}]
draws a bullet gauge with performance regions split at the mi.
BulletGauge [{v1,v2,…},…]
draws a bullet gauge with multiple values v1, v2, ….
BulletGauge [values,{r1,r2,…},…]
draws a bullet gauge with multiple references r1, r2, ….
Details and Options
- Values less than min or greater than max are clipped to the respective limits.
- Undefined values or bad input are taken to be missing and typically display 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.
- BulletGauge has the same options as Graphics , with the following additions and changes: [List of all options]
-
- GaugeLabels can take the following forms:
-
None no gauge labelsAutomatic include units as labelsFull include units and a value as labelsAll include all values as labels"Value" include values as labels"Unit" include units as labelslabel use label as a label{label1,label2,…} use multiple labels
- GaugeLabels->Placed [label,pos] can use the positions pos:
-
bs position along the scale{bx,by} scaled position {bx,by} in the gauge{pos,{lx,ly}} scaled position {lx,ly} in the label at a general position pos in the gauge
- A list of built-in settings for GaugeMarkers , GaugeFaceElementFunction , and GaugeFrameElementFunction can be obtained from ChartElementData["BulletGauge"]. A visual gallery is available in the Chart Element Schemes palette.
- GaugeMarkers by default uses a bar appearance when min≤0≤max, and a discrete marker otherwise.
- ReferenceMarkers by default uses a rectangular appearance for the marker.
- GaugeMarkers and ReferenceMarkers can take the following forms:
-
"name" named marker appearanceChartElementData["name",…] chart element functionNone omit the marker for valuef pure function for creating a gauge element{marker1,marker2,…} use markeri for the i^(th) value
- BulletGauge supports the following locations inside Placed for GaugeMarkers and ReferenceMarkers:
-
"DivisionCenter" cumulative markers centered on division marks"DivisionInterval" cumulative markers between division marks"Scale" within the scale region"Center" marker centered on the scale"OppositeScale" within the scale region on the side of the axis opposite the ticks"ScaleRange" cumulative marker within the scale region"Frame" within the dial frame
- By default, the styles used for the gauge markers and reference markers are based on GaugeStyle .
-
ImageMargins 0. the margins to leave around the graphicPreserveImageOptions Automatic whether to preserve image options when displaying new versions of the same graphicReferenceMarkers Automatic appearance for the marker
List of all options
Examples
open all close allBasic Examples (3)
Generate a gauge for a particular value and reference value:
Generate a gauge for a list of values and a list of reference values:
Generate a gauge with specific background ranges:
Scope (13)
Data and Layouts (5)
Data values do not have to be within the range of the scale:
Nonreal data is taken to be missing and typically uses the min value of the gauge:
The min and max specified are sorted so that the smaller number of the list is always the min:
Specify the values with units:
Specify the units for the gauge:
Styling and Appearance (5)
Use a theme to control the overall appearance:
Use explicit styles for the markers:
Change the type of markers used:
Change where the markers are placed:
Specify ranges of the scale to be colored by the index:
Labeling and Legending (3)
Use GaugeLabels to add a label to the gauge face:
Use Placed to change the location of the label on the face of the gauge:
Use a list to specify more than one label:
Options (52)
AspectRatio (2)
By default, BulletGauge uses a fixed ratio for the height to width of the gauge:
Specify a height to width ratio for the gauge:
Background (1)
Insert a background color behind the gauge:
GaugeLabels (9)
Show the value as a label:
Specify a label:
Labels can be any expression:
Use Placed to control label placement:
Position labels at values along the scale:
Position labels using a scaled coordinate system along the scale:
Use a scaled coordinate system over the entire gauge:
Place all labels at the middle of the scale and vary the coordinates within the label:
Use a list to specify more than one label:
GaugeMarkers (5)
Turn the markers on and off:
List built-in settings for GaugeMarkers :
For detailed settings, use Palettes ▶ Chart Element Schemes:
Use an image or graphic for a marker:
Use Placed to change the location of the marker:
Use cumulative markers:
GaugeStyle (4)
Style the marker:
By default, different styles are chosen for multiple markers:
Specify a list of styles:
Specify the style for cumulative markers up to the gauge value:
Specify an additional style for markers beyond the gauge value:
ImageSize (7)
Use named sizes such as Tiny , Small , Medium and Large :
Specify the width of the plot:
Specify the height of the plot:
Allow the width and height to be up to a certain size:
Specify the width and height for a graphic, padding with space if necessary:
Setting AspectRatio Full will fill the available space:
Use maximum sizes for the width and height:
Use ImageSize Full to fill the available space in an object:
Specify the image size as a fraction of the available space:
LabelStyle (1)
Style the labels:
PerformanceGoal (2)
Generate a gauge with tooltips on the gauge markers:
Emphasize performance by disabling interactive behaviors:
PlotTheme (4)
Create gauges using a variety of base themes:
Specify a theme with bright elements:
Change the gauge color:
The "Sparkline" theme fits gauges in the surrounding text:
ReferenceMarkers (5)
Turn the markers on and off:
List built-in settings for ReferenceMarkers:
For detailed settings, use Palettes ▶ Chart Element Schemes:
Use an image or graphic for a marker:
Use Placed to change the location of the marker:
Use cumulative markers:
ReferenceMarkerStyle (2)
Style the marker:
Specify a list of styles:
ScaleDivisions (2)
Specify the total number of ticks:
Specify the number of major and minor ticks:
ScaleRangeStyle (5)
Apply a style to all of the ranges:
Use a list of styles to draw the ranges:
Color the scale ranges with built-in color schemes:
Define a one-dimensional color function:
Apply a style to the background and foreground of all the ranges:
TargetUnits (2)
By default, units are determined automatically:
Specify the displayed units:
TicksStyle (1)
Specify overall ticks style:
Applications (2)
Visualize business statistics:
Visualize current stock prices for several companies:
Related Guides
Text
Wolfram Research (2012), BulletGauge, Wolfram Language function, https://reference.wolfram.com/language/ref/BulletGauge.html (updated 2014).
CMS
Wolfram Language. 2012. "BulletGauge." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2014. https://reference.wolfram.com/language/ref/BulletGauge.html.
APA
Wolfram Language. (2012). BulletGauge. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/BulletGauge.html
BibTeX
@misc{reference.wolfram_2025_bulletgauge, author="Wolfram Research", title="{BulletGauge}", year="2014", howpublished="\url{https://reference.wolfram.com/language/ref/BulletGauge.html}", note=[Accessed: 08-January-2026]}
BibLaTeX
@online{reference.wolfram_2025_bulletgauge, organization={Wolfram Research}, title={BulletGauge}, year={2014}, url={https://reference.wolfram.com/language/ref/BulletGauge.html}, note=[Accessed: 08-January-2026]}