Pie Chart / Gauge Style Dialog - Gauge Parameters Tab

Concept Link IconSee Also

 

Options given on this tab only apply to how gauges are displayed.

Show Limit Labels

When checked, text labels will be drawn with the gauge showing the four limits in use.

Include Units in Limit Labels

When checked, units will be included when the limit labels are shown.

Numeric Value Type

This option allows the numeric value to either be displayed as the Actual Value or the calculated Percent value.

Display of Numeric Value

This option determines when the value of the field is displayed with the gauge. Never will not show the value, Always will always show the value, and If Violating Warning/Limit Value will only show the value if it is outside of the limit range that is currently in use.

Digits to Right of Decimal

This parameter determines how many digits to the right of the decimal are displayed in the limit labels and the numeric value when they are shown with the gauge.

Gauge Width is Always a Fixed Proportion of Size

When checked, the Gauge Fixed Width/Size Ratio is used to determine the width of the gauge as a proportion of the size (height). Note: the size of gauges is specified for individual gauges on the pie chart/gauge dialogs.

Gauge Fixed Width/Size Ratio

Specifies the ratio of the gauge width to the size when the Gauge Width is Always a Fixed Proportion of Size option is checked.

Percent Overhang on Top of Gauge

The overhang at the top of the gauge is the region above the high limit line. The size of this region is defined as a percentage of the total size of the gauge.

Percent Overhang on Bottom of Gauge

The overhang at the bottom of the gauge is the region below the low limit line. The size of this region is defined as a percentage of the total size of the gauge.

Gauge Fill and Percent Calculation

These options determine how the calculated percent will be displayed and how the gauge will be filled. Four parameters are required for determining these: low limit, high limit, zero percent low limit, and zero percent high limit. These four limits are determined from options set with individual gauges and/or options set with the style. In all cases if the limits are not defined correctly, the percent will be returned as zero.

Use Absolute Value for Percent

When checked, the displayed percent will be the absolute value of the calculated percent. This option does not impact how the gauge will be filled.

Gauge Fill Options (Zero Percent Reference)

This option determines how the gauge will be filled. If Fill up or down from deadband is selected, the fill will begin at the low or high deadband limit and continue up or down depending upon where the field value falls within the defined limits. If Fill up from bottom is selected, the fill will begin at the bottom of the gauge and fill up to the field value.

Regardless of which fill option is selected, the following equations will be used to calculate the percent based upon where the field value falls within the defined limits:

If (field value) > (zero percent high limit) and (high limit) > (zero percent high limit) then

Percent = ((field value) – (zero percent high limit))/((high limit) – (zero percent high limit))

 

If (field value) < (zero percent low limit) and (low limit) < (zero percent low limit) then

Percent = ((field value) – (zero percent low limit))/((zero percent low limit) – (low limit))

Ignore Deadband

When checked, deadband limits are ignored. This effectively forces the fill to start from the bottom of the gauge and fill up to the field value. The percent is calculated based on the following equation and will always be reported as the absolute value:

If ((high limit) – (low limit)) <> 0 then

Percent = ((field value) – (low limit))/((high limit) – (low limit))

Override Low Limits with a Value of Zero

When checked, the low limit value will be set to zero when determining the fill and calculating the percent. This option is only applied if the Ignore Deadband check box is also checked. The percent is calculated based on the following equation and will always be reported as the absolute value:

If ((field value) > 0) and ((high limit) <> 0) then

Percent = (field value)/(high limit)