No Results
Gauge (Deprecated)

This page contains details on how to configure the Gauge Visualization in edgeCore v3.4. 

The Gauge Visualization displays a value, along with threshold information. The threshold information describes whether the value is good or bad.

Arc Gauge 

Linear Gauge 

Gauge Configuration Steps

The Gauge Visualization configuration is broken out into five steps:

  1. Base Gauge
    Identifies the name and appearance of the Visualization.
  2. Labels
    Configures how labels used with gauges will appear.
  3. Thresholds
    Determines the colors of the indicators.
  4. Options
    Determines some additional options based on the type of gauge.
  5. Preview
    Preview of the gauges based on the choices made.

Step 1:  Base Gauge

Visualization Name

A symbolic name used to represent this Visualization. This is the name that will show up in choosers when adding a Visualization to a page.

Type

The type of gauge. Choices are:

Arc Gauges are radial, and show up in a flow layout.
Linear Gauges are horizontal, and show up in a vertical layout.

Padding

Number of pixels between the gauge and its border.

Min 1
Max 60

Margin

Number of pixels between gauges.

Min 1
Max 40

Show Border

Determines whether a border will appear for radial gauges

Yes A border will appear around gauges
No Gauges will not have a border

Step 2:  Labels

The label properties displayed depend on the type of gauge selected.

Value Label

Value Field

This Attribute will be depicted on the gauge’s “dial”. The Value Label is a text representation of what is shown on the gauge. 

  • On a Radial Gauge, the value label will appear as a label in the center of the gauge. 
  • On a Linear Gauge, the value label will appear beneath the gauge label.

Styling

This determines whether label styles are static, or derived based on values in the data set.

Static All values will have the same style.
Derived The style will change based upon a set of rules. Refer to Rule Sets for more information.

Show Decimal Places

Determines whether decimal values should be rounded when displayed.

Yes A spinner control will appear, allowing you to configure the number of decimal places that should be shown.
No The renderer will display the raw data.

Show Thousands Separator

A Boolean that determines whether a separator is used when displaying numbers greater than 1,000.

Yes Uses a separator for thousands (1,000)
No Does not use a separator when displaying thousands (1000)

Negative Numbers

Determines how negative numbers are displayed.

1. -1000 
2. (1000)

Prefix

Allows a prefix to be used with a number. This is used to convey units of measure. The example below shows currency as a prefix.

Example $100.00

Suffix

Allows a suffix to be used with a number. This is used to convey units of measure. The example below shows weight as a suffix.

Example 100.00 lbs

Primary Label

The Gauge Label describes the gauge to the user. It will appear beneath the gauge for an Arc type and above the Value Label for a Linear type. In the case where multiple gauges are displayed, the Primary Label helps the user to understand the difference between one gauge and another.

Label Field

The Label Field describes the gauge value to the user. Where multiple gauges are displayed, the Gauge Label differentiates one gauge and another.

The gauge label will appear:

  • Beneath the gauge for an Arc type
  • Above the Value Label for a Linear type.

Styling 

This determines whether Label Field styles are static, or derived based on values in the data set.

Static All values will have the same style.
Derived The style will change based upon a set of rules. Refer to Rule Sets.

Step 3:  Thresholds

The threshold properties can affect the color of a gauge. They are based on the Value Attribute.  

Gauge Color

Use Threshold Colors This option uses the gauge’s value to determine color, and gauge colors will vary.
Only use Default Threshold Color This option uses a solid color for all gauges.

Default Threshold Color

The default color is used for values that exceed the maximum defined threshold, or for all values if the gauge color is configured to only use the default threshold color.

Threshold Alpha

Only applicable with Linear gauge Type. This option determines how saturated the background colors on a linear gauge will be.

Min 0 Background threshold colors are transparent, and the threshold boundaries will not appear.
Max 1 Threshold boundaries are 100% visible.

Configuring a Threshold

Color

The color to use for the gauge when the threshold rule is true. 

Value

Static A static value is used for the threshold.
Derived The value from an attribute’s record will determine what the threshold is.
Calculated The threshold is calculated based on all of the values for the selected attribute, using:AvgMaxMin

Step 4:  Options

The options properties displayed depend on the type of gauge selected.

Arc Gauge Options

Gauge Size

Determines the size of the arc gauge.

Min 25
Max 512

Arc Thickness

Determines the thickness of the Arc. The four options are:

  1. Thicker
  2. Thick
  3. Thin
  4. Thinner

Arc Start Angle

Determines where the gauge value starts

Default Value 0

Arc End Angle

Determines where the gauge value ends

Default Value 360

Start and End Example 1

Start Angle -150
End Angle 150

Start and End Example 2

Start Angle -50
End Angle 50

Start from smallest Value

Yes All gauges will start from the smallest value found in the value attribute.
No All gauges will start from zero.

Linear Gauge

Gauge Size

Determines the height of the linear gauge.

Min 25
Max 256

Show Comparative Value

Determines whether to show a comparative measure on the linear gauge, indicated by a vertical line.

Yes A comparative measure will be shown
No The comparative measure will be hidden

Comparative Value Field

The attribute used to plot the comparative measure.

Comparative Color

Determines the color of the vertical line used to indicate the comparative value.

Start from smallest Value

Yes All gauges will start from the smallest value found in the value attribute.
No All gauges will start from zero.

Step 5:  Preview

Shows a preview of what the Gauge Visualization will look like.


Terms | Privacy