draws a bullet gauge showing value and reference in a range of min to max.


draws a bullet gauge with performance regions split at the mi.


draws a bullet gauge with multiple values v1, v2, .


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:
  • GaugeFaceElementFunctionAutomaticfunction to draw the face
    GaugeFaceStyleAutomaticstyle for the gauge face
    GaugeFrameElementFunctionAutomaticfunction to draw the frame
    GaugeFrameSizeAutomatichow large to make the gauge frame
    GaugeFrameStyleAutomaticstyle for the gauge frame
    GaugeLabelsNonelabels for the gauge
    GaugeMarkersAutomaticappearance for the marker
    GaugeStyleAutomaticstyle for gauge markers
    MethodAutomaticmethod to use
    PerformanceGoal$PerformanceGoalaspects of performance to try to optimize
    PlotTheme$PlotThemetheme to use for drawing the gauge
    ReferenceMarkersAutomaticappearance for the marker
    ReferenceMarkerStyleOpacity[0.5]style for gauge markers
    ScaleDivisionsAutomaticthe number and distribution of ticks
    ScaleOriginAutomaticwhere to position the scale in the gauge
    ScalePaddingAutomatichow to draw the space around the scale
    ScaleRangeStyleAutomatichow to draw the scale ranges
    ScalingFunctionsNonescaling functions for the gauge
    TargetUnitsAutomaticunits to display in the gauge
  • GaugeLabels can take the following forms:
  • Noneno gauge labels
    Automaticinclude units as labels
    Fullinclude units and a value as labels
    Allinclude all values as labels
    "Value"include values as labels
    "Unit"include units as labels
    labeluse 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,Centerpositions within the gauge face
    bsposition 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 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 min0max, 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 appearance
    Graphics[],Image[],graphic or image to be used for a marker
    ChartElementData["name",]chart element function
    Noneomit the marker for value
    fpure function for creating a gauge element
    {marker1,marker2,}use markeri for the i^(th) value
    Placed[spec,location]place the markers in spec at location
  • 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.


open all close all

Basic Examples  (3)

Generate a gauge for a particular value and reference value:

Click for copyable input

Generate a gauge for a list of values and a list of reference values:

Click for copyable input

Generate a gauge with specific background ranges:

Click for copyable input

Scope  (13)

Options  (43)

Applications  (2)

Introduced in 2012
Updated in 2014