Configure a trend
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.
- InProject view, right-click a node to contain theTrendobject and select .
- InProperties, inTrend 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 exposeClear time tracesandClear time rangesmethods. 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. - Create a dynamic link betweenModeland a node or database from which you want to obtain the data.For more information about dynamic links, see Create dynamic links.TIP: To configure the trend and trend pens for data logger data, fromProject view, drop a data logger onto the trend in the editor. You can also drop the data logger onto the trendModelinProperties.
- (optional) Configure the trend properties:
- Query. SQL query that filters the data. For more information about queries, see SQL queries.
- Refresh time. Sampling time.
- Reference time zone. Time zone of the date and time on the X-axis.
- UnderPens, associateTrendPenwith the pen data source.#Data typeData sourceReal-time values of a specific variableDynamic link to a variable.Real-time values sampled by a data loggerDynamic link to theLast valueproperty of a Data logger.Historic values of variables stored in a databaseThe 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 toThresholds, select and configure theThresholdproperties:#
- Value. Threshold line position on the Y-axis.
- Color. Threshold line color.
- Thickness. Threshold line thickness.
- (optional) Add a Y-axis by right-clicking aTrendPenand selectingYAxis.TIP: Adding more Y-axes to trend pens is useful for visualizing the same data in different scales. Control the scale by settingMaximum valueandMinimum valueproperties.
- (optional) Configure the X-axis properties:
- Interactive. Make the X-axis interactive at runtime.Applies only to theNormalTrend Mode.
- Date and time. Date and time that displays in the X-axis at runtime. Defaults to the current time.
- Snap position. If you specifyDate 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.
- Follow. 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 theRefreshmethod of theTrendobject to an event.For example, associate theRefreshmethod with theMouseClick eventof aButtonobject.
trend
Provide Feedback