dataPARC.DataSeries SDK v1.0.0
Loading...
Searching...
No Matches
dataPARC.DataSeries.SDK Namespace Reference

Classes

class  DataSeriesClient
 Provides methods for reading data. More...
interface  IDataPoint
 Represents a single data point with timestamp, quality, and value(s). More...

Enumerations

enum  AggregateType
 Specifies the types of aggregation that can be applied to tag data.
enum  DigitalTextReturnType
 Specifies how digital text values should be returned.
enum  InterpolationType
 Describes the interpolation method to apply to time-series data.
enum  ReadRawError
 Represents the error types returned when reading raw data.
enum  ReadSourceInfoError
 Represents the error types returned when reading source info.
enum  RunNormalizationMode
 Describes the normalization mode used during run-based aggregations.
enum  TagDataType
 Describes the data type of a tag.

Functions

readonly record struct BulkAggExportResult (DateTime[] Timestamps, DataPointSet[] Values, int TotalStreamChunkNumber, int CurrentChunkNumber)
 Represents a result chunk from aggregate data export.
readonly record struct BulkExportResult (DateTime[] Timestamps, DataPointList[] Values, int TotalStreamChunkNumber, int CurrentChunkNumber)
 Represents a result chunk from raw data export.
readonly record struct BulkExportWithInterpolationParameters (ExportParameters[] ExportParameters, DateTime StartTime, DateTime EndTime, int StepSize, AggregateType? AggregateType, long MaximumExportSize, RunNormalizationMode? RunNormalizationMode, bool IsInterpolateStateTag, bool IncludeBounds=true)
 Parameters for reading data points by aggregate type for a collection of tags.
readonly record struct BulkExportWithoutInterpolationParameters (ExportParameters[] ExportParameters, DateTime StartTime, DateTime EndTime, long MaximumExportSize, bool IncludeBounds=true)
 Parameters for exporting raw data points without interpolation for a collection of tags.
readonly record struct DataPointDouble(DateTime Timestamp, int Quality, double[] Values) readonly record struct DataPointDigitalText(DateTime Timestamp, int Quality, DigitalText[] Values) readonly record struct DataPointSet (TagIdentifier Tag, DataPoints DataPoints)
 Represents a numeric data point with double array values.
readonly record struct ExportParameters (string Tag, int DeltaTime, InterpolationType? InterpolationType, bool ForceQualityCheck)
 Parameters for exporting a tag data.
readonly record struct FullyQualifiedTagName (string InterfaceGroup, string Tag, string? Interface=null, string? InterfaceSet=null)
 Fully identifies a tag by group, name, interface, and set.
readonly record struct LatestQuickStatisticsParameters (TagLatestQuickStatisticsParameters[] TagParams, AggregateType?[] Aggregates)
 Parameters for retrieving the latest quick statistics for multiple tags.
readonly record struct QuickStatisticsParameters (TagQuickStatisticsParameters[] TagParams, AggregateType?[] Aggregates)
 Parameters for reading quick statistics for multiple tags.
readonly record struct QuickStatisticsResult (string UTag, double? TimeAvg, double? RawAvg, double? StdDev, double? Min, double? Max, int Count, double? Sum, int Duration, DateTime LastGoodQualityTime, double? TimeAvgToLastPoint)
 Represents statistical summary results for a tag within a specific time range.
readonly record struct ReadAtTimeParameters (string UTag, DateTime Timestamp)
 Parameters for reading raw data points at a specific timestamp.
readonly record struct ReadCurrentValueParameters (string UTag)
 Parameters for reading the current value of a tag.
readonly record struct ReadDataTypeResult (string Tag, TagDataType DataType, bool IsArray)
 Represents the result of determining the data type for a tag.
readonly record struct ReadRawBulkParameters (ReadRawTagParameters[] TagParams, bool ReturnStartBounds=true, bool ReturnEndBounds=true)
 Parameters for reading raw data for multiple tags.
readonly record struct ReadRawParameters (string UTag, DateTime StartTime, DateTime EndTime, bool ReturnStartBounds=true, bool ReturnEndBounds=true)
 Parameters for reading raw data from a tag.
readonly record struct ReadRawResult (TagIdentifier Tag, DataPoints DataPoints, ReadRawError? Error=null)
 The result from reading raw data points.
readonly record struct ReadRawTagParameters (string UTag, DateTime StartTime, DateTime EndTime)
 Represents a single tag and time range to read raw data from.
readonly record struct ReadRawToCurrentValueParameters (string UTag, DateTime StartTime)
 Parameters for reading up to current data points for a tag.
readonly record struct ReadSourceInfoParameters (string UTag)
 Parameters for reading source information of a tag.
readonly record struct ReadSourceInfoResult (TagSourceInfo Value, ReadSourceInfoError? Error=null)
 Represents the result of reading tag source info.
readonly record struct StreamRawBulkParameters (ReadRawTagParameters[] TagParams, bool ReturnStartBounds=true, bool ReturnEndBounds=true, int PageSize=512)
 Parameters for streaming raw data in bulk.
readonly record struct TagCurrentValue (string TagName, int? TagId, IDataPoint DataPoint, TagDataType DataType, bool IsArray)
 Represents the current value of a tag.
readonly record struct TagIdentifier (string Name, int? Id=null)
 An identifier for a tag.
readonly record struct TagLatestQuickStatisticsParameters (TagQuickStatisticsParameters TagParams, QuickStatisticsResult CurrentResult)
 Parameters for reading the latest quick statistics for a tag.
readonly record struct TagQuickStatisticsParameters (string UTag, DateTime StartTime, DateTime EndTime, bool IsTextSeries, InterpolationType? InterpolationType, TagDataType DataType, bool IsDrawToNow)
 Parameters for reading quick statistics for a single tag.
readonly record struct TagSourceInfo (string Tag, string Source, string ConnectionType, string SourceUri, string SourceType, string TimeZone)
 Represents metadata about the source of a tag.

Function Documentation

◆ BulkAggExportResult()

readonly record struct dataPARC.DataSeries.SDK.BulkAggExportResult ( DateTime[] Timestamps,
DataPointSet[] Values,
int TotalStreamChunkNumber,
int CurrentChunkNumber )

Represents a result chunk from aggregate data export.

Parameters
TimestampsArray of timestamps for the values.
ValuesArray of exported aggregated values by tag.
TotalStreamChunkNumberTotal number of chunks in the stream.
CurrentChunkNumberThe current chunk number being returned.

◆ BulkExportResult()

readonly record struct dataPARC.DataSeries.SDK.BulkExportResult ( DateTime[] Timestamps,
DataPointList[] Values,
int TotalStreamChunkNumber,
int CurrentChunkNumber )

Represents a result chunk from raw data export.

Parameters
TimestampsArray of timestamps for the values.
ValuesArray of exported values by tag.
TotalStreamChunkNumberTotal number of chunks in the stream.
CurrentChunkNumberThe current chunk number being returned.

◆ BulkExportWithInterpolationParameters()

readonly record struct dataPARC.DataSeries.SDK.BulkExportWithInterpolationParameters ( ExportParameters[] ExportParameters,
DateTime StartTime,
DateTime EndTime,
int StepSize,
AggregateType? AggregateType,
long MaximumExportSize,
RunNormalizationMode? RunNormalizationMode,
bool IsInterpolateStateTag,
bool IncludeBounds = true )

Parameters for reading data points by aggregate type for a collection of tags.

Parameters
ExportParametersThe tags to export data for.
StartTimeThe starting timestamp to export data from.
EndTimeThe ending timestamp to export data to.
MaximumExportSizeMaximum data size the exporting request allows.
IncludeBoundsMode specifying how the starting and ending timestamp should be included.
StepSizeThe step size to interpolate data to.
AggregateTypeThe aggregate type reading tag data for.
RunNormalizationModeThe normalization mode such as ToStepSize.
IsInterpolateStateTagMode specifying if the interpolation includes state tags.

◆ BulkExportWithoutInterpolationParameters()

readonly record struct dataPARC.DataSeries.SDK.BulkExportWithoutInterpolationParameters ( ExportParameters[] ExportParameters,
DateTime StartTime,
DateTime EndTime,
long MaximumExportSize,
bool IncludeBounds = true )

Parameters for exporting raw data points without interpolation for a collection of tags.

Parameters
ExportParametersThe tags to export data for.
StartTimeThe starting timestamp to export data from.
EndTimeThe ending timestamp to export data to.
MaximumExportSizeMaximum data size the exporting request allows.
IncludeBoundsMode specifying how the starting and ending timestamp should be included.

◆ DataPointSet()

readonly record struct DataPointDouble(DateTime Timestamp, int Quality, double[] Values) readonly record struct DataPointDigitalText(DateTime Timestamp, int Quality, DigitalText[] Values) readonly record struct dataPARC.DataSeries.SDK.DataPointSet ( TagIdentifier Tag,
DataPoints DataPoints )

Represents a numeric data point with double array values.

Represents a string data point with nullable string array values.

Represents a digital text value with both text and numeric representation.

Represents a digital text data point with an array of digital text values.

Represents a union of multiple data point types (double, string, digital text).

Represents a list of data points with string value of a tag.

Parameters
TagThe identifier of the tag.
DataTypeThe data type of the values.
ValuesThe values as a string array.

Represents a set of structured data points associated with a tag.

Parameters
TagThe identifier of the tag.
DataPointsThe data points grouped under the tag.

◆ ExportParameters()

readonly record struct dataPARC.DataSeries.SDK.ExportParameters ( string Tag,
int DeltaTime,
InterpolationType? InterpolationType,
bool ForceQualityCheck )

Parameters for exporting a tag data.

Parameters
TagThe tag to read data from.
DeltaTimeThe delta time of the tag.
InterpolationTypeThe interpolate type of this tag.
ForceQualityCheckMode specifying if forcing quality check for the export.

◆ FullyQualifiedTagName()

readonly record struct dataPARC.DataSeries.SDK.FullyQualifiedTagName ( string InterfaceGroup,
string Tag,
string? Interface = null,
string? InterfaceSet = null )

Fully identifies a tag by group, name, interface, and set.

Parameters
InterfaceGroupThe interface group name.
TagThe tag name.
InterfaceOptional interface name.
InterfaceSetOptional interface set name.

◆ LatestQuickStatisticsParameters()

readonly record struct dataPARC.DataSeries.SDK.LatestQuickStatisticsParameters ( TagLatestQuickStatisticsParameters[] TagParams,
AggregateType?[] Aggregates )

Parameters for retrieving the latest quick statistics for multiple tags.

Parameters
TagParamsParameters for reading the quick statistics of this tag.
AggregatesAggregate types that are included in the quick statistics.

◆ QuickStatisticsParameters()

readonly record struct dataPARC.DataSeries.SDK.QuickStatisticsParameters ( TagQuickStatisticsParameters[] TagParams,
AggregateType?[] Aggregates )

Parameters for reading quick statistics for multiple tags.

Parameters
TagParamsParameters for reading the quick statistics of this tag.
AggregatesAggregate types that are included in the quick statistics.

◆ QuickStatisticsResult()

readonly record struct dataPARC.DataSeries.SDK.QuickStatisticsResult ( string UTag,
double? TimeAvg,
double? RawAvg,
double? StdDev,
double? Min,
double? Max,
int Count,
double? Sum,
int Duration,
DateTime LastGoodQualityTime,
double? TimeAvgToLastPoint )

Represents statistical summary results for a tag within a specific time range.

Parameters
UTagThe tag name.
TimeAvgThe time-weighted average value.
RawAvgThe raw average value.
StdDevThe standard deviation of values.
MinThe minimum value observed.
MaxThe maximum value observed.
CountThe number of data points used in the statistics.
SumThe total sum of all values.
DurationThe total duration for the statistics.
LastGoodQualityTimeThe timestamp of the last good quality data point.
TimeAvgToLastPointThe time-weighted average up to the last point.

◆ ReadAtTimeParameters()

readonly record struct dataPARC.DataSeries.SDK.ReadAtTimeParameters ( string UTag,
DateTime Timestamp )

Parameters for reading raw data points at a specific timestamp.

Parameters
UTagThe tag to read data from.
TimestampThe specific timestamp.

◆ ReadCurrentValueParameters()

readonly record struct dataPARC.DataSeries.SDK.ReadCurrentValueParameters ( string UTag)

Parameters for reading the current value of a tag.

Parameters
UTagThe tag to read data from.

◆ ReadDataTypeResult()

readonly record struct dataPARC.DataSeries.SDK.ReadDataTypeResult ( string Tag,
TagDataType DataType,
bool IsArray )

Represents the result of determining the data type for a tag.

Parameters
TagThe tag name.
DataTypeThe determined data type.
IsArrayIndicates if the tag data is an array.

◆ ReadRawBulkParameters()

readonly record struct dataPARC.DataSeries.SDK.ReadRawBulkParameters ( ReadRawTagParameters[] TagParams,
bool ReturnStartBounds = true,
bool ReturnEndBounds = true )

Parameters for reading raw data for multiple tags.

Parameters
TagParamsThe list of params of a list of tags to read data from.
ReturnStartBoundsIndicates whether to return the start boundary value.
ReturnEndBoundsIndicates whether to return the end boundary value.

◆ ReadRawParameters()

readonly record struct dataPARC.DataSeries.SDK.ReadRawParameters ( string UTag,
DateTime StartTime,
DateTime EndTime,
bool ReturnStartBounds = true,
bool ReturnEndBounds = true )

Parameters for reading raw data from a tag.

Parameters
UTagThe tag to read data from.
StartTimeStart time for the data read.
EndTimeEnd time for the data read.
ReturnStartBoundsIndicates whether to return the start boundary value.
ReturnEndBoundsIndicates whether to return the end boundary value.

◆ ReadRawResult()

readonly record struct dataPARC.DataSeries.SDK.ReadRawResult ( TagIdentifier Tag,
DataPoints DataPoints,
ReadRawError? Error = null )

The result from reading raw data points.

Parameters
TagThe tag that this read result is from.
Parameters
DataPointsThe data points read.
Parameters
ErrorOptional error encountered during the read.

◆ ReadRawTagParameters()

readonly record struct dataPARC.DataSeries.SDK.ReadRawTagParameters ( string UTag,
DateTime StartTime,
DateTime EndTime )

Represents a single tag and time range to read raw data from.

Parameters
UTagThe tag to read data from.
StartTimeStart time for the data read.
EndTimeEnd time for the data read.

◆ ReadRawToCurrentValueParameters()

readonly record struct dataPARC.DataSeries.SDK.ReadRawToCurrentValueParameters ( string UTag,
DateTime StartTime )

Parameters for reading up to current data points for a tag.

Parameters
UTagThe tag to read data from.
StartTimeStart time for the data read.

◆ ReadSourceInfoParameters()

readonly record struct dataPARC.DataSeries.SDK.ReadSourceInfoParameters ( string UTag)

Parameters for reading source information of a tag.

Parameters
UTagThe tag to read source info from.

◆ ReadSourceInfoResult()

readonly record struct dataPARC.DataSeries.SDK.ReadSourceInfoResult ( TagSourceInfo Value,
ReadSourceInfoError? Error = null )

Represents the result of reading tag source info.

Parameters
ValueThe returned source info data.
ErrorOptional error encountered during the read.

◆ StreamRawBulkParameters()

readonly record struct dataPARC.DataSeries.SDK.StreamRawBulkParameters ( ReadRawTagParameters[] TagParams,
bool ReturnStartBounds = true,
bool ReturnEndBounds = true,
int PageSize = 512 )

Parameters for streaming raw data in bulk.

Parameters
TagParamsThe list of params of a list of tags to read data from.
ReturnStartBoundsIndicates whether to return the start boundary value.
ReturnEndBoundsIndicates whether to return the end boundary value.
PageSizeThe max number of data points in each message streamed from the server. This default is 512.

◆ TagCurrentValue()

readonly record struct dataPARC.DataSeries.SDK.TagCurrentValue ( string TagName,
int? TagId,
IDataPoint DataPoint,
TagDataType DataType,
bool IsArray )

Represents the current value of a tag.

Parameters
TagNameThe name of the tag.
TagIdThe ID of the tag, if available.
DataPointThe current data point value.
DataTypeThe data type of the value.
IsArrayWhether the value is an array.

◆ TagIdentifier()

readonly record struct dataPARC.DataSeries.SDK.TagIdentifier ( string Name,
int? Id = null )

An identifier for a tag.

Parameters
NameThe name of the tag.
IdThe Id of the tag.

◆ TagLatestQuickStatisticsParameters()

readonly record struct dataPARC.DataSeries.SDK.TagLatestQuickStatisticsParameters ( TagQuickStatisticsParameters TagParams,
QuickStatisticsResult CurrentResult )

Parameters for reading the latest quick statistics for a tag.

Parameters
TagParamsParameters for reading the quick statistics of this tag.
CurrentResultCurrent quick statistics result of this tag.

◆ TagQuickStatisticsParameters()

readonly record struct dataPARC.DataSeries.SDK.TagQuickStatisticsParameters ( string UTag,
DateTime StartTime,
DateTime EndTime,
bool IsTextSeries,
InterpolationType? InterpolationType,
TagDataType DataType,
bool IsDrawToNow )

Parameters for reading quick statistics for a single tag.

Parameters
UTagThe tag to read data from.
StartTimeStart time for the data read.
EndTimeEnd time for the data read.
IsTextSeriesIndicator of text series.
InterpolationTypeThe interpolate type of this tag.
DataTypeThe data type of this tag.
IsDrawToNowIndicator of draw to now mode of this tag.

◆ TagSourceInfo()

readonly record struct dataPARC.DataSeries.SDK.TagSourceInfo ( string Tag,
string Source,
string ConnectionType,
string SourceUri,
string SourceType,
string TimeZone )

Represents metadata about the source of a tag.

Parameters
TagThe name of the tag.
SourceThe source of the tag.
ConnectionTypeThe type of connection used to access the source.
SourceUriThe URI of the source data endpoint.
SourceTypeThe type of the source.
TimeZoneThe time zone used by the source.