Configure the source of the data to display in the Trend object. Add a pen for each data point to draw on the trend chart. When trending historical data from a database, a trend line is drawn between points when the logger is not capturing data.

Project view

, right-click a node to contain the

Trend

object and select

New

Data controls

Trend

Properties

, in

Mode

, select either:

Normal

. The default mode of trend charts. Navigate and zoom the trend chart.

Trace

. Add time traces to the chart to mark significant data points.

Range

. Select, move, and resize time ranges on the trend chart.

TIP: Trend objects expose

Clear time traces

and

Clear time ranges

methods. To be able to remove time traces and time ranges from the trend chart, you can associate these methods with button events. For more information, see Add a method to an existing event.

Properties

, either:

Create a dynamic link between the

Model

property and a project node. This obtains values of attributes or properties of all direct child nodes.

For example, select the

Model

folder with objects that contain data. For more information, see Project nodes.

Create a dynamic link between the

Model

property and a database object. This obtains data contained in database tables.

For example, select an Embedded, ODBC, or InfluxDB database object. For more information, see Database.

For more information about dynamic links, see Create dynamic links.

TIP: To configure the trend and trend pens for data logger data, from

Project view

, drop a data logger onto the trend in the editor. You can also drop the data logger onto the trend

Model

Properties

(optional) Specify the kind of items to display in the object by setting

ItemKind

TIP:

The

ItemKind

property is automatically set with the object or variable type recognized among the child nodes.

For example, if the model is based on a folder node that contains several instances of a

Motor

object type,

ItemKind

is automatically set with the reference to the

Motor

type. In this case, the values that display are the attributes or properties of different instances (

Motor1

Motor2

Motor3

, and so on).

(optional) In

Query

, enter a standard SQL query to filter items obtained from a database or project nodes as specified in

Model

For more information, see SQL queries.

For example:

SELECT * FROM Model WHERE SPEED > 40

SELECT * FROM "DataLogger1" WHERE Speed > 40

(optional) In

Refresh time

, specify the sampling time.

(optional) In

Reference time zone

, specify the time zone of the date and time on the X-axis.

Under

Pens

, associate

TrendPen#

with the pen data source.

Data type	Data source
Real-time values of a specific variable	Dynamic link to a variable.
Real-time values sampled by a data logger	Dynamic link to the Last value property of a Data logger.
Historic values of variables stored in a database	The name of the column of interest in a Database. Do not create a dynamic link to the column of interest in the Database. Provide the name of the column instead.

(optional) Configure pen properties:

Thickness

. Weight of the pen line.

Title

. Pen title.

Color

. Color of the pen line.

Enabled

. Shows or hides the pen.

(optional) To add a threshold to a pen, next to

Thresholds

, select

and configure the

Threshold#

properties:

Value

. Threshold line position on the Y-axis.

Color

. Threshold line color.

Thickness

. Threshold line thickness.

(optional) To add a pen, next to

Pens

, select

and repeat 8.

(optional) Add a Y-axis by right-clicking a

TrendPen

and selecting

YAxis

TIP: Adding more Y-axes to trend pens is useful for visualizing the same data in different scales. Control the scale by setting

Maximum value

and

Minimum value

properties.

(optional) Configure the X-axis properties:

Interactive

. Make the X-axis interactive at runtime.

Applies only to the

Normal

Trend Mode

Date and time

. Date and time that displays in the X-axis at runtime. Defaults to the current time.

Snap position

. If you specify

Date and time

, you can set the X-axis position to either:

Left

. Displays the specified date and time on the left of the X-axis.

Right

. Displays the specified date and time on the right of the X-axis.

Center

. Displays the specified date and time in the center of the X-axis.

. Scroll the X-axis automatically as time progresses at runtime.

Time window

. Time interval shown by the trend (in milliseconds).

(optional) Configure the Y-axes properties:

Automatic scaling

. Scales the Y-axis at runtime based on the minimum and maximum values.

Interactive

. Makes the Y-axis interactive.

Minimum value

. Minimum value displayed on the Y-axis.

Maximum value

. Maximum value displayed on the Y-axis.

(optional) Add the

Refresh

method of the

Trend

object to an event.

For example, associate the

Refresh

method with the

MouseClick event

of a

Button

object.

Trend

Provide Feedback

Have questions or feedback about this documentation? Please submit your feedback here.