GaugeLabels
is an option for gauge functions that specifies labels to be placed on the gauge.
Details
- 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->None or GaugeLabels->{} will not include any labels.
- GaugeLabels->label specifies a label at an automatic location on the gauge.
- Any expression can be specified as a label. It will be given by default in TraditionalForm. Arbitrary strings of text can be given as "text".
- With the setting of GaugeLabels->"Value", a numeric representation of the gauge value is included on the gauge.
- If units are present, the setting of GaugeLabels->"Unit" will include a label of the units on the gauge.
- If there are multiple markers, only the first value is labeled automatically.
- GaugeLabels->Placed[label,pos] includes label at position pos.
- GaugeLabels->{label1,label2,…} includes multiple labels in the gauge.
- In gauge functions, Placed allows the following positions:
-
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
Examples
open all close allBasic Examples (12)
Use Automatic to display the gauge value:
{ThermometerGauge[42, {0, 100}, GaugeLabels -> Automatic], AngularGauge[42, {0, 100}, GaugeLabels -> Automatic]}{AngularGauge[42, {0, 100}, GaugeLabels -> Style["", 24]], ClockGauge[{9, 24, 33}, GaugeLabels -> "CST"]}Table[VerticalGauge[55, {0, 100}, GaugeLabels -> label], {label, {Sqrt[x^x], [image], [image]}}]If units are present, they can be added as a label to the gauge:
{ThermometerGauge[Quantity[98.6, "Fahrenheit"], {0, 150}, GaugeLabels -> "Unit"], AngularGauge[4.2, {0, 10}, TargetUnits -> "Ft", GaugeLabels -> "Unit"]}Use GaugeLabels->Full to label the gauge value and units if present:
{ThermometerGauge[Quantity[98.6, "Fahrenheit"], {0, 150}, GaugeLabels -> Full], AngularGauge[4.2, {0, 10}, TargetUnits -> "Ft", GaugeLabels -> Full]}Use Placed to control label placement:
{VerticalGauge[9, {0, 10}, GaugeLabels -> Placed[Style["Above", "Section"], Above]], AngularGauge[9, {0, 10}, GaugeLabels -> Placed[Style["Below", "Section"], Below]]}Add a display of the gauge units:
{ThermometerGauge[Quantity[98.6, "Fahrenheit"], {0, 150}, GaugeLabels -> "Unit"], AngularGauge[4.2, {0, 10}, TargetUnits -> "Feet", GaugeLabels -> "Unit"]}Use a list to specify more than one label:
{VerticalGauge[90, {0, 100}, GaugeLabels -> {Placed[Rotate["% Complete", π / 2], {.3, .5}], "Value"}], AngularGauge[68.2, {0, 100}, GaugeLabels -> {"Tank Pressure", "Value"}]}Position labels at values along the scale:
Table[VerticalGauge[4.2, {0, 10}, GaugeLabels -> Placed["Value", p]], {p, {0, 5, 10}}]Position labels using a scaled coordinate system along the scale:
Table[VerticalGauge[9, {0, 10}, GaugeLabels -> Placed["Value", Scaled[p]]], {p, {0, 1 / 2, 1}}]Use a scaled coordinate system over the entire gauge:
Table[AngularGauge[9, {0, 10}, GaugeLabels -> Placed["Value", p]], {p, {{0.35, 0.5}, {0.1, 0.9}, {0.5, 0.65}}}]Table[VerticalGauge[9, {0, 10}, GaugeLabels -> Placed["Value", p], GaugeFrameStyle -> Gray], {p, {{0.2, 0.5}, {0.1, 0.9}, {0.5, 0.65}}}]Place all labels at the middle of the scale and vary the coordinates within the label:
Table[AngularGauge[9, {0, 10}, GaugeLabels -> Placed["Value", {Scaled[0.5], p}]], {p, {{0.5, 0}, {0.5, 1}, {0.5, 2.75}}}]Table[VerticalGauge[9, {0, 10}, GaugeLabels -> Placed["Value", {Scaled[0.5], p}]], {p, {{0, 0.5}, {1, 0.5}, {2.25, 0.5}}}]Scope (2)
Labels use TraditionalForm by default:
HorizontalGauge[5.5, {0, 10}, GaugeLabels -> f[x]]Use StandardForm instead:
HorizontalGauge[5.5, {0, 10}, GaugeLabels -> StandardForm[f[x]]]Individually styled labels can be used together with LabelStyle and have higher priority:
HorizontalGauge[5.5, {0, 10}, GaugeLabels -> {Placed[Style[x, Bold, Red], Bottom], Style[y, Bold, Blue]}, LabelStyle -> Directive[Orange, Medium]]Generalizations & Extensions (1)
Applications (1)
Use ColorData image as a label:
l = Show[ColorData["DarkRainbow", "Image"], ImageSize -> 60, Frame -> True, FrameTicks -> {{None, None}, {{{0, "Low"}, {1, "High"}}, None}}]AngularGauge[0.2, {0, 10}, ScaleRanges -> Partition[Range[0, 10, 1], 2, 1], ScaleRangeStyle -> "DarkRainbow", GaugeLabels -> Placed[l, {.5, .6}]]Properties & Relations (1)
The overall output format can be specified using FormatType:
VerticalGauge[4.2, {0, 10}, GaugeLabels -> Sin[x], FormatType -> StandardForm]Possible Issues (2)
When different format types are combined, the result is likely to be unpredictable:
VerticalGauge[4.2, {0, 10}, GaugeLabels -> {Placed["x", Bottom], Placed[TraditionalForm@Sin[x], Top]}, FormatType -> StandardForm]Only the value of the first marker is used for the numeric display:
VerticalGauge[Range[0, 10, 2], {0, 10}, GaugeLabels -> "Value"]Use GaugeLabels->All to label all of the gauge values:
VerticalGauge[Range[0, 10, 2], {0, 10}, GaugeLabels -> All]Text
Wolfram Research (2012), GaugeLabels, Wolfram Language function, https://reference.wolfram.com/language/ref/GaugeLabels.html.
CMS
Wolfram Language. 2012. "GaugeLabels." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/GaugeLabels.html.
APA
Wolfram Language. (2012). GaugeLabels. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/GaugeLabels.html