Overview
DrillingChart 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. Users configure it by setting control names, binding tags, and defining pen properties. Usage involves selecting tag objects, setting up axes, and configuring visual elements for data display and interaction in monitoring production metrics and quality control.
On this page:
Requirements
This component is Portable. It runs both on Windows (WPF) and on Web Pages hosted on any platform.
Configuration
- Go to Displays / Draw.
- On the Components Panel, select Charts, then DrillingChart.
- Click or drag-and-drop it on the Drawing area to use it.
- Double-click the object to open the configuration window.
DrillingChart Settings | |
|---|---|
Control Name | Defines the name for the control, allowing it to be accessed via Scripts or 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:
|
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.
Drilling X Axis configuration | |
|---|---|
Duration | Sets the time span for the X-axis 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.
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. |
Using Y Axis Scaling
Considering:
Y-axis Min = 0;
Y-axis Max = 100;
The Drilling 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
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.
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.
|
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. |
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. |
Legend | Defines the position of the legend in the Drilling control (e.g., RightPanel). Options available: None: No legend is displayed. TopLeft: Positions the legend at the top left of the drilling control. TopRight: Positions the legend at the top right of the drilling control. BottomLeft: Positions the legend at the bottom left of the drilling control. BottomRight: Positions the legend at the bottom right of the drilling control. RightPanel: Positions the legend in the right panel of the drilling control. BottomPanel: Positions the legend in the bottom panel of the drilling control. |
Runtime Execution
During runtime, the DrillingChart visualizes time-series data, enabling users to monitor and analyze data drilling effectively. Users have previously configured the Drilling Chart 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 DrillingChart displays the configured data. Users can interact with the chart, adjusting axes and visual elements to refine their data analysis. The 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.
In this section: