About BULLET_GRAPH

BULLET_GRAPH helps SCADA operators quickly interpret a process value within a defined graphical range and in relation to comparison information, rather than viewing the value in isolation. The central visual element is the read SCADA data value rendered as a bar.

In the source code, _ReadData is defined as the SCADA data value that is read and drawn as a BAR, while _ComparativeMeasureData is defined as the SCADA data value used for comparison. These two data sources directly correspond to the classic BULLET_GRAPH approach of “current value + comparison.”

The Color Regions defined by _ColorRegions can be used to divide the chart range into qualitative performance zones. However, the supplied source code does not specify the drawing order of these regions or the algorithm applied when RegionMax values overlap. Therefore, this page describes only the structure supported by the source code.

Basic Operating Principle

Read SCADA Value → BAR
Comparative SCADA Value → Benchmark/comparison
Chart Range → Visual scale
Color Regions → Performance context

This structure is suitable for SCADA screens where answering “Where is the value relative to the reference?” is more important than simply answering “Where is the value?”

How to Configure

When configuring BULLET_GRAPH, first define the data sources, then specify the chart orientation and range, the appearance of the main bar, the comparative measurement, the text settings, and finally the color regions.

Recommended Configuration Sequence

  1. Data: Use ReadData to specify the SCADA data value to be displayed as a bar.
  2. Comparison: Use ComparativeMeasureData to specify the SCADA data value for comparison.
  3. Chart: Define the FlowDirection and GraphRange values.
  4. Featured measurement: Configure the bar color and display setting.
  5. Comparative measurement: Configure the comparison indicator's color, constant, and text.
  6. Color regions: Define the performance zones using REGION_COLLECTION items.

Source Code Limitation

In the supplied source code, only the RegionColor and RegionMax fields of the REGION_COLLECTION class are shown. Therefore, this page does not assume any behavior that is not documented in the source code regarding how the lower bounds of color regions are calculated, how the collection is sorted, or how overlapping ranges are handled.

General Properties

General properties define the control's basic operating behavior and its text and appearance settings on the SCADA screen.

Property EOS Turkish Equivalent Default Purpose Typical Application
UCType Control Type BULLET_GRAPH Defines the type of user control within EOS SCADA. All SCADA screens where the BULLET_GRAPH control is defined.
UpdateInterval Update Interval 1000 ms Specifies the interval at which the control refreshes its current data. Screens where live process data is refreshed periodically.
DecimalPoint Decimal Places 0 Specifies the number of decimal places used to display numerical values. Numerical process values such as power, flow rate, level, and pressure.
UCBackColor Control Background Color Transparent Specifies the control's background color. Integrating the control into the overall SCADA screen design.
UCForeColor Control Text Color Black Specifies the control's primary text color. Maintaining visual consistency for text displayed on the chart.
UCFont Control Font Arial Narrow, 8.25 pt Specifies the control's font. Adjusting the readability of scale labels and control text.

Data Settings

A key feature that distinguishes BULLET_GRAPH from many other chart controls is that the main bar and the comparative measurement are handled as separate data sources. In the source code, both fields are defined as string.

Property EOS Turkish Equivalent Default Purpose Typical Application
ReadData Read Data string Represents the SCADA data value that is read and drawn as a BAR on the chart. Displaying an instantaneous process value as the main indicator bar.
ComparativeMeasureData Comparative Measurement Data string Represents the SCADA data value used for comparison. Comparing the current value with a target, reference, or another SCADA measurement.

SCADA Example

In a hydroelectric power plant, ReadData could be linked to the generator's instantaneous active power, while ComparativeMeasureData could be linked to the target active power of the same unit. For example, if the chart range is 100 MW, the bar could display a value of 72 MW while the comparison indicator marks the 80 MW target. This allows the operator to see the current power and its position relative to the target at a glance.

Chart Settings

Property EOS Turkish Equivalent Default Purpose Typical Application
FlowDirection Flow Direction Lefttoright Specifies the direction in which the bar progresses across the chart range. Standard left-to-right displays or custom right-to-left screen designs.
GraphRange Chart Range 100 Specifies the chart's basic value range. Scaling percentages, power, flow rate, level, or other numerical measurements.

FlowDirection Values

Option English Description
Lefttoright Left to Right Causes the bar to progress from left to right across the chart range.
Righttoleft Right to Left Causes the bar to progress from right to left across the chart range.

Featured Measurement Settings

This group contains settings for visually highlighting BULLET_GRAPH's main measurement. The naming used in the source code indicates that the primary measurement is treated as the Featured Measure.

Property EOS Turkish Equivalent Default Purpose Typical Application
FeaturedMeasureColor Featured Measure Color DarkOrange Specifies the visual color of the featured main measurement. Highlighting the read SCADA value on the bar.
DisplayFeaturedMeasure Display Featured Measure false Specifies whether the featured measurement is displayed visually. Screens where the visibility of the main bar is controlled.
FeaturedStartString Featured Start String "" Specifies the text to be used at the beginning of the featured measurement. Screens designed to display explanatory text or units around the chart.
FeaturedEndString Featured End String "" Specifies the text to be used at the end of the featured measurement. When additional information or a unit needs to be appended to the value.

Comparative Measurement Settings

The comparative measurement helps BULLET_GRAPH relate a target or reference value to the main bar on the same scale. In the source code, both a SCADA data source and a constant field are defined for the comparative measurement.

Property EOS Turkish Equivalent Default Purpose Typical Application
ComparativeMeasureColor Comparative Measurement Color Maroon Specifies the visual color of the comparative measurement. Distinguishing a target or reference value from the main bar.
DisplayComparativeMeasure Display Comparative Measure false Specifies whether the comparative measurement is displayed. Situations where target/reference information needs to be visible on screen.
ComparativeMeasureConstant Comparative Measurement Constant "" Represents a constant value that can be defined for the comparative measurement. Designs that use the constant comparison option defined in the source code.
ComparativeMeasureStartString Comparative Measure Start String "" The start text for the comparative measurement, as defined in the source code. Formatting text at the beginning of the comparison display.
ComparativeMeasureEndString Comparative Measure End String "" The end text for the comparative measurement, as defined in the source code. Formatting text at the end of the comparison display.

Terminology Note

In the EOS dictionary standard, English text is recorded instead of Turkish equivalents for ComparativeMeasureStartString and ComparativeMeasureEndString. This page preserves the dictionary standard as provided and does not invent new Turkish equivalents.

Color Region Settings

ColorRegions is a collection that can divide the BULLET_GRAPH chart range into sections using different colors. In the source code, each region is represented by the REGION_COLLECTION class.

Property EOS Turkish Equivalent Default Purpose Typical Application
ColorRegions Color Regions REGION_COLLECTION[] Represents the collection of color regions on the chart. Visually distinguishing qualitative performance zones such as normal, warning, and critical.
RegionColor Region Color Red Specifies the color of the corresponding region. Visually identifying a particular value range.
RegionMax Region Maximum 0 Represents the maximum boundary defined for the region in the source code. Defining the upper boundary of a color region within the chart range.

Example Color Regions

For example, on a process indicator with a range of 0–100, color regions could be configured with maximum boundaries such as 40, 70, and 100. This allows the operator to see not only the numerical position of the main bar but also the qualitative performance zone in which it falls. These numbers are illustrative only; the supplied source code does not define any default sequence of regions.

Interpreting the BULLET_GRAPH Display

In the example image you provided, the chart is horizontal and displays a scale from 0 to 100. The orange horizontal bar is the prominent visual element representing the main measurement's position on the chart. The dark vertical marker can serve as a reference indicating the comparative measurement.

What Operators Can Read at a Glance

  • Bar length: The position of the read SCADA value within the chart range.
  • Reference marker: The position of the comparative measurement.
  • Scale: The range within which the value falls.
  • Color regions: The qualitative performance zone of the value.
  • Flow direction: Whether the bar progresses from left to right or right to left.

Compared with a conventional numerical indicator, this structure fits more contextual information into a small area. However, BULLET_GRAPH is not a historical trend chart; a separate trend or line chart is required for detailed analysis of changes over time.

Applications

Online research describes a bullet graph as a space-efficient chart that displays a primary measure together with a target or another reference and qualitative performance ranges. Tableau notes that bullet graphs are particularly suitable for quickly evaluating performance against a target and can be used to compare production levels against performance ranges. IBM Cognos documentation gives examples of using bullet charts to monitor production measurements such as defect counts and shipped orders.

Manufacturing and OEE

Can be used to quickly evaluate measurements such as production volume, quality indicators, defect counts, or shift targets against a target. IBM includes defect counts and shipped orders among its bullet chart examples for manufacturing.

Energy and Power Systems

In SCADA applications, it can be configured as a compact comparison indicator for measurements such as unit active power, load level, production target, or current value relative to capacity. This use aligns with the BULLET_GRAPH data structure provided, which follows the “read value + comparative SCADA value” approach.

Level and Flow

Can be used to monitor process measurements such as tank level, reservoir level, flow rate, or pump performance together with target or limit regions.

Infrastructure and IT Monitoring

The bullet graph approach can be used to compare a single performance metric, such as CPU usage, network utilization, or capacity utilization, against an expected value. Tableau identifies monitoring network utilization against expected levels as an example for IT departments.

Capacity and Service Indicators

Bullet graphs are also used to present target-based KPIs, such as capacity, call volume, or similar metrics, in a compact format. IBM Cognos documentation provides call center metrics as an example.

Compact KPI Dashboards

Placing multiple bullet indicators side by side or vertically allows different KPIs to be scanned quickly within the same screen. Tableau notes that bullet graphs can be used as compact indicators in multi-metric dashboards.

Key Advantage for SCADA

The main advantage of BULLET_GRAPH on a SCADA screen is that, instead of dedicating a large indicator to a single process value, it can present the relationship between current value + comparison + scale + color region within the same small area. This can be useful in higher-level operational and control screens where many KPIs need to be monitored together.

Example Scenarios for EOS SCADA

Scenario ReadData / BAR ComparativeMeasureData Chart Range Color Regions
Hydroelectric Unit Power Instantaneous MW Target MW Unit rated power Based on load condition
Reservoir Level Current level Operating target Lower/upper operating range Low / normal / high
Pump Flow Rate Current flow rate Target flow rate Rated flow rate Insufficient / normal / high
Production KPI Actual value Shift target Target or capacity Performance categories
Electrical Load Current load Reference/planned value Upper operating limit Normal / warning / critical

Hydroelectric Power Plant Example

Consider a hydroelectric unit with ReadData = 72 MW, ComparativeMeasureData = 80 MW, and GraphRange = 100 MW. The bar progresses to the 72 MW level; if the comparative measurement is visible, it also displays the 80 MW reference. When color regions are defined according to the operating philosophy, the operator can read the current power, target, and performance zone simultaneously.

Using BULLET_GRAPH in SCADA Screen Design

  • For a single KPI: Using BULLET_GRAPH alongside a numerical value makes its position relative to the target visible.
  • For multiple KPIs: Several BULLET_GRAPH controls of the same size can be used to create a compact performance dashboard.
  • For color regions: Color should communicate performance context rather than serve merely as decoration.
  • For comparisons: The colors of the main bar and reference marker should be clearly distinguishable.
  • When trends are needed: Use a separate trend chart instead of BULLET_GRAPH to examine behavior over time. Tableau also notes that bullet graphs do not show historical trends and are suitable for rapid status assessment.

Visual Density

A bullet graph is a compact indicator; placing too much information in a single control can reduce readability. Tableau also notes that bullet graphs may not be suitable for comparing a large number of items simultaneously.

Quick Property Reference

Source Code Property EOS Turkish Equivalent Value / Type
_ReadData Read Data string
_ComparativeMeasureData Comparative Measurement Data string
_FlowDirection Flow Direction BGOrientation
_GraphRange Chart Range int
_FeaturedMeasureColor Featured Measure Color Color
_DisplayFeaturedMeasure Display Featured Measure bool
_FeaturedStartString Featured Start String string
_FeaturedEndString Featured End String string
_ComparativeMeasureColor Comparative Measurement Color Color
_DisplayComparativeMeasure Display Comparative Measure bool
_ComparativeMeasureConstant Comparative Measurement Constant string
_ComparativeMeasureStartString Comparative Measure Start String string
_ComparativeMeasureEndString Comparative Measure End String string
_ColorRegions Color Regions REGION_COLLECTION[]

Enumeration Values

BGOrientation

Technical Value English Equivalent
Lefttoright Left to Right
Righttoleft Right to Left

REGION_COLLECTION

Field EOS Turkish Equivalent Default
_RegionColor Region Color Color.Red
_RegionMax Region Maximum 0

Internet Research and References

Current online documentation was reviewed to understand the general visual principles and applications of bullet graphs. The sources below are not the source code for EOS SCADA BULLET_GRAPH; they are external references explaining the general use of the bullet graph approach.

  1. Tableau – What is a Bullet Graph? Describes a bullet graph as a compact chart that combines a primary measure, a target/reference marker, and qualitative performance ranges. It provides examples from manufacturing, IT, and KPI dashboards. View Source.
  2. IBM Cognos Analytics – Reporting User Guide Explains how a bullet chart compares an actual measure with a target and qualitative performance zones such as good, satisfactory, and poor. It describes applications including production defect counts and shipped orders. View Source.
  3. Tableau Help – Reference Lines, Bands, Distributions and Boxes Explains that a bullet graph is a variation of a bar chart and that reference distributions and target lines can be used together. View Source.
  4. Tableau – Chart Selection Guide Notes that a bullet chart is suitable for quickly showing progress against a target at a single point in time, but is not designed for analyzing historical changes. View Source.

Conclusion

BULLET_GRAPH can be regarded as a powerful, compact user control in EOS SCADA for presenting a live SCADA value not merely as a number, but through the relationship between bar + comparison + chart range + color regions.

According to the supplied source code, ReadData defines the main BAR data, ComparativeMeasureData defines the comparison SCADA data, GraphRange defines the visual scale, and ColorRegions defines the collection of color regions. The display direction can be changed through FlowDirection, while the colors and visibility of the main and comparative measurements can be configured separately.

Summary

  • Live: SCADA data is refreshed according to the update interval.
  • Comparative: A separate SCADA data value can be used for comparison.
  • Compact: Provides multiple types of contextual information in a small area.
  • Color-coded: Color regions can be used to distinguish performance zones.
  • Directional: The bar can progress from left to right or from right to left.
  • SCADA-focused: Can be adapted to KPI, target, load, power, level, and performance screens.