Read historical trend – National Instruments BridgeVIEW User Manual

Page 351

Advertising
background image

Appendix A

HMI Function Reference

© National Instruments Corporation

A-31

BridgeVIEW User Manual

Read Historical Trend

Use the Read Historical Trend VI to read the historical data for a given tag from user specified
start and stop dates and times, up to the maximum number of points specified. If start
timestamp
and stop timestamp are not wired, all historical data for the tag is returned, up to
the maximum points per trend specified. If max points per trend is left unwired, all points
between the start timestamp and stop timestamp are returned.

You can use this VI to read history information for analog, discrete or bit array tags. All
values are returned as floating point values.

max points in trend is the maximum number of points to read. If the value
is less than zero, all points available between start timestamp and stop
timestamp
are returned. Otherwise, the number of points in the trend is the
minimum of the actual number of data points between start timestamp,
stop timestamp, and max points in trend.

Citadel path in is the path to the directory containing the Citadel historical
database. If this path is empty, the VI attempts to use the historical data
directory configured in the active

.scf

file. If this has not been configured,

the VI prompts you to select a data directory.

tag name is the tag for which you want to read historical data. If the tag is
not logged in the historical database, you will get an empty trend.

start timestamp is the date and time associated with the first data point to
be retrieved from the historical database. If this input is unwired, the data
is extracted starting at the first point available for the tag.

error in (no error) is a cluster that describes the error status before this VI
executes. For more information about this control, see the section

Errors

Not Reported by the BridgeVIEW Engine

in this appendix.

stop timestamp (now) is the date and time associated with the last data
point to be retrieved from the historical database. If this input is unwired,
the data is extracted up to the last point available for the tag.

Citadel path out is the path to directory containing historical data files.

Advertising