Sample

Supertype: Observation

Definition: Observation that is continuously changing or analog data value.

Version Info

IntroducedDeprecatedUpdated
1.0  

Documentation

Description

It provides the information and data reported from a piece of equipment for those DataItem entities defined with a category,DataItem property of SAMPLE in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..

Sample MUST always be reported in float.

Figure Sample Example shows Sample type examples. It also shows an example for when the result is not available (dataItemId=cspeed).

Sample Example

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

The following Section Value Properties of Sample lists the additional and/or updated attributes for Sample.

Inherited Properties

NameTypeIntDepMultiplicityDescription
compositionId ID1.40..1 identifier of the Composition entity defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request. associated with the data reported for the Observation.
dataItemId ID1.01

unique identifier of the DataItem associated with this Observation.

dataItemId MUST match the id attribute of the DataItem defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..

name string1.00..1

name of the DataItem associated with this Observation.

name MUST match the name attribute of the DataItem defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..

sequence integer1.01

number representing the sequential position of an occurrence of an observationobserved value of a property at a point in time. in the data buffer of 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. .

sequence MUST have a value represented as an unsigned 64-bit value from 1 to \(2^{64}-1\).

subType DataItemSubTypeEnum1.20..1

subtype of the DataItem associated with this Observation.

subType MUST match the subType attribute of the DataItem defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..

timestamp dateTime1.01 most accurate time available to a piece of equipment that represents the point in time that the data reported was measured.
type DataItemTypeEnum1.01

type of the DataItem associated with this Observation.

type MUST match the type attribute of the DataItem defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..

units UnitEnum1.00..1

units of the DataItem associated with this Observation.

units MUST match the units attribute of the DataItem defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..

result string1.00..1

observationobserved value of a property at a point in time. of the Observation entity.

The default value type for result is string.

Inherited Relations

NameTypeIntDepMultiplicityDescription
isObservationOf Component1.00..*
isObservationOf Agent1.00..*
isObservationOf DataItem1.00..*

Properties

NameTypeIntDepMultiplicityDescription
duration SECOND1.20..1

time-period over which the data was collected.

duration MUST be provided when the statistic attribute of the DataItem is defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..

resetTriggered ResetTriggeredEnum1.40..1

identifies when a reported value has been reset and what has caused that reset to occur for those DataItem entities that may be periodically reset to an initial value.

resetTriggered MUST only be provided for the specific occurrence of a DataItem reported in the MTConnectStreams Response Documentresponse document published by an MTConnect Agent in response to a current request or a sample request. when the reset occurred.

sampleRate float1.20..1

rate at which successive samples of the value are recorded.

statistic StatisticEnum1.20..1 type of statistical calculation defined by the statistic attribute of the DataItem defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..
result float1.00..1
units UnitEnum1.01
type SampleEnum1.01

Subclasses


Back to top

Copyright © 2017-2026 Association for Manufacturing Technology (AMT). All rights reserved. MTConnect® is a trademark of AMT. Terms of Use.

MTConnect SysML Model V2.0