Versions Compared

Old Version 4

changes.mady.by.user Paulo Tsuchiya

Saved on

compared with

New Version Current

changes.mady.by.user Support

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

The TrendChart is a graphical tool for visualizing data trends. Its purpose is to display and analyze time-series data for process monitoring. Key functionalities include customizable Y and X axesDrillingChart is similar to TrendChart, but it is adapted for drilling operations. It also allows axes customization, label and grid line settings, pen configurations, and SPC settings. Applications include monitoring production metrics and quality control. Configuration requires Users configure it by setting control names, binding tags, and defining pen properties. Usage involves selecting trend tag objects, setting up axes, and configuring visual elements for data display and interaction in monitoring production metrics and quality control.

On this page:

Table of Contents
maxLevel3
stylenone

Image Added

Requirements

This component is Portable. It runs both on Windows (WPF) and on Web Pages hosted in on any platform.

Configuration

  1. Go to Displays / Draw.
  2. On the Components Panel, select Charts, then TrendChart DrillingChart.
  3. Click or drag-and-drop it on the Drawing area to use it.
  4. Double-click the object to open the configuration window.

Image Added

Description in scripts. See Display Trend TrendChart TrendChart TrendChart TrendChart trend trend trend trend trend the trend control

DrillingChart Settings 

TrendChart Settings 

Field

Control Name

Defines the name for the control, allowing it to be accessed

via through the CodeBehind.

Bind to Tag

Specifies the object property where the

Drilling configuration will be saved.

Bind Pens to Tag

Specifies the object property where the Pen values will be saved.

Orientation

Sets the orientation of the

DrillingChart (Horizontal or Vertical). Options available:

  1. Horizontal: Sets the

  1. DrillingChart to display data horizontally.

  2. Vertical (Top to Bottom): Sets the

  1. DrillingChart to display data vertically, starting from the top and moving to the bottom.

  2. Vertical (Bottom to Top): Sets the

  1. DrillingChart to display data vertically, starting from the bottom and moving to the top.

Window

Sets the background color of the

Drilling control.

Labels

Defines the color of the

Drilling control labels.

Grid Lines

Sets the color of the grid lines in the

Drilling control.

Grid Lines Stroke

Defines the settings for the grid line stroke.

Cursor

Enables or disables cursor settings in the

Drilling control.

Mouse Actions

Enables or disables mouse actions on the

Drilling control.

Marker Tooltip

Enables or disables tooltips for markers on

the Drilling control.

AllowDrop

Enables or disables the ability to drop elements into the control area.


X Axis

The X-axis represents drilling parameters over time or depth.

Image Added

X Axis: .Enables or disables the definition of a X Axis: X Axis: Defines

Trend window settings 

Field

Description

Drilling X Axis configuration

Duration

Sets the time span for the X-axis

X Axis: XY Chart

defining a specific time window for the X-Axis and displays the Drilling over that period. In this mode, the X-Axis are representing time.

Depth

Configures a depth-based range for the X-axis values.

Labels

Specifies the number of labels on the X-axis.

Format

Controls how the time or value format appears defining the format of the X-axis labels.

Navigation Controls

Enables scrolling and zooming along the X-Axis, providing user-friendly data exploration.


Y Axis

The Y-axis typically assumes values related to physical or operational parameters measured during the drilling process.

Image Added

Y Axis

Y Axis: Axis: Y Y Axis: Y Axis: Y Axis: Y Axis:

Trend window settings 

Field

Description

Drilling Y Axis settings 

Y scale for each pen

Uses the min and max values of each pen for the Y-axis scale.

Y

Range

Defines a fixed range for the Y-axis.

Labels

Specifies the number of labels on the Y-axis.

Format

Defines the format of the Y-axis labels.

Stack Y scales

Enables stacking of similar Y scales for easier comparison between pens.

Merge similar Y scales

Merges similar Y scales.


Pens

Pens represent individual data series, variables, or metrics that are displayed on the chart. Each pen typically has its own color, style, and scale.

Image Added

Pens: Pens: Pens: Pens: Pens: Pens: Pens: Pens: Pens: Pens: Legend

Trend window settings 

Field

Description

Pens Properties 

ID

Identifier for each pen.

TagName

Sets the tag that provides the value for each pen.

PenSettings

Configures the pen settings, including line color, stroke, and marker type.

Image Added

MinValue

Defines the minimum value for the pen according to the Y-axis range.

Auto

Automatically sets the pen value based on the defined range.

MaxValue

Defines the maximum value for the pen according to the Y-axis range.

PenLabel

Sets the name of the pen.

By default, the PenLabel is "*", which sets the label text to the value of the TagName field.

LimitMinMaxValue

Removes points less than the tag's Min value and greater than the tag's Max value.

Square

Fills the pen points with a square wave.

FilterLevel

Specifies the filter level to group points on the XY axis, calculating the average.

SPCEnabled

Defines the position of the legend in the trend control (e.g., RightPanel). Options available:

  1. None: No legend is displayed.

  2. TopLeft: Positions the legend at the top left of the trend control.

  3. TopRight: Positions the legend at the top right of the trend control.

  4. BottomLeft: Positions the legend at the bottom left of the trend control.

  5. BottomRight: Positions the legend at the bottom right of the trend control.

  6. RightPanel: Positions the legend in the right panel of the trend control.

  7. BottomPanel: Positions the legend in the bottom panel of the trend control.

Using Y Axis Scaling 

Considering:

Y-axis Min = 0;

Y-axis Max = 100;

The trend control allows many pens to be displayed together. When your pens do not have the same range, you can use the tips below to fit your data in the same chart and for better visualization:

  • If a pen has a lower range, 0 to 1 for example, you can set the max property of the pen to 1. When the real tag value is 1, the value 100 will be displayed in the chart. (100/1 scale).

  • If a pen has a higher range, 0 to 1000 for example, you can set the max property of the pen to 1000. When the real tag value is 1000, the value 100 will be displayed in the chart. (1/10 scale).

===============

  • Added new property "FilterExpression" (string) in TDrillingChart and TTrendChart controls. This property is used with "select" command in where condition while getting samples from SQL historic.

  • Added new property "DisableXMinMaxChecking" (bool) in TDrillingChart control. This property is used to disable checking while scrolling X Axis, such as: depth < 0 and depth > current hole depth.

  • Created new properties and method in TDrillingChart and TTrendChart controls [only Windows Desktop]:

    • double RegionBeginPoint;

    • double RegionEndPoint;

    • DateTimeOffset RegionBeginDateTime [only GET];

    • DateTimeOffset RegionEndDateTime [only GET];

    • bool EnableRegionMode;

    • bool EnableRegionScroll;

    • Brush RegionOutsideBrush;

    • Brush RegionInsideBrush;

    • Brush RegionInsideStrokeBrush;

    • int RegionInsideStrokeThickness;

    • public void SetRegionDateTime(DateTimeOffset begin, DateTimeOffset end);

  • Add event handler while region is changed [only Windows Desktop]:

    • public event RegionChangedEventHandler RegionChangedEvent

  • Added new property "FilterExpression" (string) in TDrillingChart and TTrendChart controls. This property is used with "select" command in where condition while getting samples from SQL historic.

  • Added new property "DisableXMinMaxChecking" (bool) in TDrillingChart control. This property is used to disable checking while scrolling X Axis, such as: depth < 0 and depth > current hole depth.

  • Created new properties and method in TDrillingChart and TTrendChart controls [only Windows Desktop]:

    • double RegionBeginPoint;

    • double RegionEndPoint;

    • DateTimeOffset RegionBeginDateTime [only GET];

    • DateTimeOffset RegionEndDateTime [only GET];

    • bool EnableRegionMode;

    • bool EnableRegionScroll;

    • Brush RegionOutsideBrush;

    • Brush RegionInsideBrush;

    • Brush RegionInsideStrokeBrush;

    • int RegionInsideStrokeThickness;

    • public void SetRegionDateTime(DateTimeOffset begin, DateTimeOffset end);

  • Add event handler while region is changed [only Windows Desktop]:

    • public event RegionChangedEventHandler RegionChangedEvent

Enables the DrillingChart to display a set of extra pens describing the pen’s statistical process control (SPC).

SPCSettings

Defines what SPC pens to display. The following options are available:

Minimum: The minimum value in the tag’s history.
Maximum: The maximum value in the tag’s history.
Mean: The mean or average of values in the tag’s history.
Median: The middle value that separates the lower and upper halves of values in the tag’s history.
Sum: The sum of values in the tag’s history.
DeviationPlus (+ 2 Sigma): The mean plus twice the standard deviation of the tag’s history.
DeviationLess (- 2 Sigma): The mean minus twice the standard deviation of the tag’s history.


Runtime Execution

Runtime Execution

During runtime, the TrendChart Window visualizes time-series data, enabling users to monitor and analyze data trends effectively. Users have previously configured the TrendChart by setting control names, binding tags, and defining pen properties. They have also customized the Y and X axes, label and grid line settings, and SPC settings.

When the runtime environment is initiated, the TrendChart Window DrillingChart displays the configured data trends. Users can interact with the chart, adjusting axes and visual elements to refine their data analysis. The TrendChart DrillingChart dynamically updates to reflect real-time data changes, providing a comprehensive view of production metrics and quality control parameters. This tool facilitates detailed process monitoring and supports informed decision-making based on the visualized data trends.

In this section:

Page Tree
root@parent
spacesV10