DataSet

Supertype: Representation

Definition: Representation for an Observation composed of value(s) represented as a set of key-value pairsassociation between an identifier referred to as the key and a value which taken together create a key-value pair. .

Version Info

Introduced	Deprecated	Updated
1.5

Documentation

Description

DataSet for an Observation is defined by the associated DataItem::representation as DATA_SET.

DataItem::representation as DATA_SET MUST have DataItem::category as SAMPLE or EVENT.

Figure VariableDataSet shows the model for Variable (Event type) with a Representation type of DataSet.

Note: See Figure DataSet Schema for XML schema.

DataSet reports multiple values as a set of key-value pairassociation between an identifier referred to as the key and a value which taken together create a key-value pair. where each keyunique identifier in a key-value pair association. MUST be unique. The representation of the key-value pairassociation between an identifier referred to as the key and a value which taken together create a key-value pair. is an Entry. The value of each Entry MUST have the same constraints and format as the Observation defined for DataItem::representation as VALUE for the DataItem type. (See Value).

The meaning of each Entry MAY be provided as the DataItem EntryDefinition.

Figure DataSet Example shows Event Observation type Variable with a Representation type of DataSet.

Note: See dataset-example for the XML representation of the same example.

Management of Data Set Observations

An agentsoftware that collects data published from one or more piece(s) of equipment, organizes that data in a structured manner, and responds to requests for data from client software systems by providing a structured response in the form of a response document that is constructed using the semantic data model of a Standard. MUST maintain the current state of the DataSet as described in Fundamentals.

One or more key-value pairsassociation between an identifier referred to as the key and a value which taken together create a key-value pair. MAY be added, removed, or changed in an Observation. An agentsoftware that collects data published from one or more piece(s) of equipment, organizes that data in a structured manner, and responds to requests for data from client software systems by providing a structured response in the form of a response document that is constructed using the semantic data model of a Standard. MUST publish the changes to one or more key-value pairsassociation between an identifier referred to as the key and a value which taken together create a key-value pair. as a single Observation. An agentsoftware that collects data published from one or more piece(s) of equipment, organizes that data in a structured manner, and responds to requests for data from client software systems by providing a structured response in the form of a response document that is constructed using the semantic data model of a Standard. MUST indicate the removal of a key-value pairassociation between an identifier referred to as the key and a value which taken together create a key-value pair. from a DataSet using the Entry::removed as true.

When the DataItem::discrete is false or is not present, an agentsoftware that collects data published from one or more piece(s) of equipment, organizes that data in a structured manner, and responds to requests for data from client software systems by providing a structured response in the form of a response document that is constructed using the semantic data model of a Standard. in response to a sample requestrequest to an agent to produce an MTConnectStreams Response Document containing the Observation Information Model for a set of timestamped observations made by Components. MUST only publish the changed key-value pairassociation between an identifier referred to as the key and a value which taken together create a key-value pair. since the previous state of the DataSet.

When the DataItem::discrete attribute is true, an agentsoftware that collects data published from one or more piece(s) of equipment, organizes that data in a structured manner, and responds to requests for data from client software systems by providing a structured response in the form of a response document that is constructed using the semantic data model of a Standard. , in response to a sample requestrequest to an agent to produce an MTConnectStreams Response Document containing the Observation Information Model for a set of timestamped observations made by Components., MUST report all key-value pairsassociation between an identifier referred to as the key and a value which taken together create a key-value pair. ignoring the state of the DataSet.

When an agentsoftware that collects data published from one or more piece(s) of equipment, organizes that data in a structured manner, and responds to requests for data from client software systems by providing a structured response in the form of a response document that is constructed using the semantic data model of a Standard. responds to a current requestrequest to an agent to produce an MTConnectStreams Response Document containing the Observation Information Model for a snapshot of the latest observations at the moment of the request or at a given sequence number., the response documentelectronic document published by an MTConnect Agent in response to a probe request, current request, sample request or asset request. MUST include the full set of key-value pairsassociation between an identifier referred to as the key and a value which taken together create a key-value pair. . If the current requestrequest to an agent to produce an MTConnectStreams Response Document containing the Observation Information Model for a snapshot of the latest observations at the moment of the request or at a given sequence number. includes an at query parameter, the agentsoftware that collects data published from one or more piece(s) of equipment, organizes that data in a structured manner, and responds to requests for data from client software systems by providing a structured response in the form of a response document that is constructed using the semantic data model of a Standard. MUST provide the set of key-value pairsassociation between an identifier referred to as the key and a value which taken together create a key-value pair. at the sequence numberprimary key identifier used to manage and locate a specific piece of streaming data in an agent..

When an Observation resetact of reverting back the accumulated value or statistic to their initial value. > Note: An Observation with a data set representation removes all key-value pairs, setting the data set to an empty set. occurs, the DataSet MUST remove all key-value pairsassociation between an identifier referred to as the key and a value which taken together create a key-value pair. making the set empty. The Observation MAY simultaneously populate the DataSet with new key-value pairsassociation between an identifier referred to as the key and a value which taken together create a key-value pair. . The previous entries MUST NOT be included and MUST NOT have Entry::removed as true.

When the Observation is UNAVAILABLE the DataSet MUST remove all key-value pairsassociation between an identifier referred to as the key and a value which taken together create a key-value pair. making the set empty.

Properties

Name	Type	Int	Dep	Multiplicity	Description
count	integer	1.5		1	number of Entry elements for the Observation.

Relations

Name	Type	Int	Dep	Multiplicity	Description
result	Entry	1.5		0..*

Subclasses

Name	Int	Dep
AlarmLimitResult	1.7
ControlLimitResult	1.7
LocationAddressResult	2.3
SensorAttachmentResult	1.7
SpecificationLimitResult	1.7