Format a radial gauge
- Last UpdatedDec 19, 2024
- 4 minute read
Use the Format Gauge pane to customize a radial gauge and change its appearance, scales, and labels.
-
Right-click the gauge and then click Format Gauge to open the Format Gauge pane.
-
Under Style, customize the appearance of the gauge:
-
Type
Indicator type for the gauge. You can select an arc, a triangle, a pointer, or a line.
-
Angle
Angle of the face.
-
Indicator
Color of the indicator.
-
Size
Size of the indicator.
-
Fill
Color of the fill. The fill is the dial area. For an arc-type indicator, the fill is the background.
-
Outline
Color of the outline. The outline is the scale's border without the tick marks and scale labels.
-
Weight
Thickness of the outline.
-
Scale
Color of the tick marks and labels.
-
Value
Color of the data value.
-
Format
Display format of the value.
Format
Description
Database
Show numbers in a format that depends on the data item:
-
For PI points or PI AF attributes with a PI point data reference, the format depends on the value of the point's DisplayDigits attribute:
-
Zero or positive numbers specify the number of digits to display to the right of the decimal point.
-
Negative numbers specify the number of significant digits.
-
-
For PI Vision calculations or PI AF attributes without a PI point data reference, numbers show 5 significant digits.
All data items show the thousands separator.
General
Show all significant digits for numbers except for trailing zeros. If the absolute value of the number is greater than 1x107 or less than 1x10-4, the format will switch to use scientific notation.
Number
Show numbers in the custom format that you specify:
-
Decimal Places
The number of digits shown after the decimal.
-
Use 1000 separator
Select this check box to show the thousands separator in large numbers.
Scientific
Show numbers in the format 0.00E+00.
-
-
Units
Set the display units for the value. Either Default for the base units or a listed unit to convert to. Only units appropriate for conversion from the base unit are listed.
-
-
Under Font, select your preferred font from the Name dropdown.
Note: If the selected font is not installed on a user’s system, an alternative font will be used by the browser. Roboto and Roboto Slab are installed with PI Vision, so will display consistently for all users.
To change the font size:
-
Select or enter a size in the Size dropdown.
-
Use the Increase Font Size
and Decrease Font Size
buttons to change the size incrementally.
-
-
Under Visibility, select the information you want to appear on the gauge:
-
Label
Text that describes the gauge. Select a label from the list (an attribute name or description) or enter custom text.
-
Value
Value of the attribute.
-
Units
Units of measurement for the attribute.
-
Label Location
Location of the label, either above or below the gauge.
-
Scale
Amount of labels on the scale, either all or only the first and last labels.
-
-
Under Scale Range, configure the maximum and minimum values on the scale:
-
Database limits
Set the scale to the data item's configured minimum and maximum values.
Select the Invert Scale check box to reverse the start and end scale values.
-
Custom limits
Set the maximum and minimum values of the gauge manually. Enter the Right and Left values. To reverse the start and end scale values, enter the numbers in reverse.
Note: When working with data containing digital states (such as LOW, HIGH, OPEN, CLOSE, ON, or OFF) rather than numerical values, you will be able to select digital states from the list for the start and end of the scale. For more information, see the PI Server topic Digital state sets.
-
Arc start
Use the scale start value from the AF database (Default).
-
Select Custom to change the point at which the scale values begin.
Note: If your actual value is less than your start value, your bar will display inversely.
-
-
If you want to reset all the settings in the pane to the default settings, select Reset to default.
-
If you want to save the current settings as the default settings for radial gauge symbols, select Save as default. The saved settings are applied by default when a user creates a new radial gauge symbol, and they are applied when a user selects Reset to default in the Format Gauge pane.
Note: You must have administrator privileges to save defaults.
-
Click the down arrow
at the top of the pane and then click Add Navigation Link to add a navigation link to the symbol.