Scatter Chart

This widget displays a metrics values into a scatter chart. This widget displays XY points where X and Y are the values of the two input metrics and the value pairs are obtained by matching data points by timestamp.

Scatter Chart

You can also display lines between data points, and coloring the area between the line and the X or Y axis. Here is an example showing the progression of a drilling combining the Depth and RPM.

Template Syntax

Below you can find some examples of how to use the component within a template.


<scatter-chart-widget [title]="'Temperature by Humidity'">
  <metric name="humidity"></metric>
  <metric name="temperature"></metric>
</scatter-chart-widget>

Component Reference

Here is a comprehensive list of all the elements and properties that can be used to configure the component.

Scatter Chart <scatter-chart-widget>

Title

The title displayed on the top part of the widget box.

Name: title

Type: STRING | Optional

[title]="'Details'"

Controls

Export Enabled

The boolean flag indicating whether the data export is enabled.

Name: config.exportEnabled

Type: BOOLEAN | Optional

Default Value: false

[config]="{exportEnabled: true}"

Export File Type

The export file type

Name: config.exportFileType

Type: ENUM | Optional

Values: json, csv, xlsx

Default Value: csv

[config]="{exportFileType: 'json'}"

Period Filter Enabled

The boolean flag indicating whether the embedded period filter is available.

Name: config.filterEnabled

Type: BOOLEAN | Optional

Default Value: false

[config]="{filterEnabled: true}"

Scrollbar Enabled

The flag enabling the widget top scrollbar allowing the user to scroll and zoom data.

Name: config.scrollbarEnabled

Type: BOOLEAN | Optional

Default Value: false

[config]="{scrollbarEnabled: true}"

Data

Default Loading Period

The default date and time filtering period applied when entering the page.

Name: config.defaultPeriodValue

Type: ENUM | Optional

Values: TODAY, YESTERDAY, LAST_1_HOUR, LAST_6_HOURS, LAST_12_HOURS, LAST_24_HOURS, LAST_7_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH, LAST_6_MONTHS, LAST_12_MONTHS, THIS_WEEK, LAST_WEEK, LAST_FULL_7_DAYS, LAST_FULL_30_DAYS, LAST_FULL_12_MONTHS

Default Value: LAST_7_DAYS

[config]="{defaultPeriodValue: 'TODAY'}"

Period Variable

The id of the page's variable providing the date range filtering period, for instance the id of a <period-filter-field>.

Name: inputs.period

Type: STRING | Optional

[inputs]="{period: 'period'}"

Advanced

Color

The color used to display the bullets and lines.

Name: config.color

Type: STRING | Optional

Default Value: #08B05B

[config]="{color: 'abc'}"

Show Bullets

Indicates whether to display data point bullets.

Name: config.showBullets

Type: BOOLEAN | Optional

Default Value: true

[config]="{showBullets: false}"

Show Timestamps

Indicates whether to display the timestamps associated to data points.

Name: config.showTimestamps

Type: BOOLEAN | Optional

Default Value: false

[config]="{showTimestamps: true}"

Rendering

CSS Class

The name(s) of the CSS class used to customize the widget layout.

Name: class

Type: STRING | Optional

class="my-custom-class"

Height

The widget desired height (default 480px).

Name: config.height

Type: STRING | Optional

[config]="{height: '250px'}"

Visibility Condition

The expression that allows you to reduce the visibility of the element.

Name: *ngIf

Type: STRING | Optional

*ngIf="getUser().organizationId != null"

Sub Elements

Metric

The X-axis (first) or Y-axis (second) metric whose values must be loaded by the widget.

Metric <metric>

Filter

The name of the filter used to transform and display values.

Name: filter

Type: FILTER | Optional

filter="fooBarFilter"

Label

The metric alternative label.

Name: label

Type: STRING | Optional

label="Temperature"

Name

The metric whose value(s) must be loaded by the widget.

Name: name

Type: METRIC | Required

name="Temperature"

Unit

The unit of measurement to be displayed along the value.

Name: unit

Type: STRING | Optional

unit="&deg;C"

Advanced

Visibility Condition

The expression that allows you to reduce the visibility of the element.

Name: *ngIf

Type: STRING | Optional

*ngIf="getUser().organizationId != null"