6.6 DataTypes

6.6.1 AnnotationDataType DataType definition

This structure contains additions as explanation and specification of the physical quantity such as "relative" for a relative velocity. The structure is defined in Table 51.

Table 51 – AnnotationDataType Structure
NameTypeDescription
AnnotationDataTypestructureSubtype of Structure defined in OPC 10000-5

Annotation

StringNames the annotation to give further information about value like how it is measured or where it originates from.

Discipline

StringGives a human readable classification of the physical quantity according to its field of application to allow grouping of values. These can be, for example, “Engineering”, “Finance” or similar.

Uri

StringNames a source for deeper description of the annotation.

Examples are given in Table 52.

Table 52 – AnnotationDataType examples
NameValues for a linear acceleration Values for AC voltageValues for DC voltageValues for AC RMS voltage
AnnotationDataType

Annotation

linearACDCRMS

Discipline

-Electrical EngineeringElectrical EngineeringElectrical Engineering

Uri

-https://www.britannica.com/science/alternating-currenthttps://www.britannica.com/science/direct-currenthttps://en.wikipedia.org/wiki/Root_mean_square

Its representation in the AddressSpace is defined in Table 53.

Table 53 – AnnotationDataType definition
Attribute Value
BrowseNameAnnotationDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the Structure defined in OPC 10000-5
Conformance Units
Data Access Quantities Base

6.6.2 LinearConversionDataType DataType definition

This structure contains a simple conversion according to the following formula. The factors (a = inititialAddend, b = multiplicand, c = divisor, d = finalAddend) are given in a Structure. X is the source value (in source unit) and f(x) the target value (in target unit). The structure is defined in Table 54.

The values of the structure can also be used for a simple inverse conversion. It can be used if a Client wants to write a value to the Server. The value y1 is the value that the Client wants to write to the Server in the named alternative unit and x1 is the value the Client actually has to write to the Server instead.

Table 54 – LinearConversionDataType Structure
NameTypeDescription
LinearConversionDataTypeStructureSubtype of Structure defined in OPC 10000-5

InitialAddend

FloatThe initial addend of linear conversion.

Multiplicand

FloatThe multiplicand of linear conversion.

Divisor

FloatThe divisor of linear conversion.

FinalAddend

FloatThe final addend of linear conversion.

Its representation in the AddressSpace is defined in Table 53.

Table 55 – LinearConversionDataType Definition
Attribute Value
BrowseNameLinearConversionDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the Structure defined in OPC 10000-5
Conformance Units
Data Access Alternative Units

6.6.3 ConversionLimitEnum

ConversionLimitEnum indicates whether the ServerUnit can be converted. A distinction is made between NO_CONVERSION, LIMITED and UNLIMITED. NO_CONVERSION means that no conversion is allowed (e.g. for statistical values). LIMITED conversion means that either only the conversions mentioned in the AlternativeUnits are to be used or the client requires specific know-how for the conversion. UNLIMITED means the conversion is simple and possible if the client knows the UnitSystem. The enumeration is defined in Table 56.

Table 56 – ConversionLimitEnum Items
NameValueDescription
NO_CONVERSION0No conversion of the value allowed (e.g. statistical value).
LIMITED1Conversion only permitted on the basis of the conversions specified by the server, or if the client has the appropriate domain knowledge to perform an independent conversion.
UNLIMITED2Conversion on the basis of the specified unit according to the rules of the source system of units (e.g. SI / ISQ) and the coding system (e.g. UCUM) is permitted.

Its representation in the AddressSpace is defined in Table 57.

Table 57 – ConversionLimitEnum Definition
Attribute Value
BrowseNameConversionLimitEnum
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the Enumeration type defined in OPC 10000-5
HasPropertyVariableEnumStringsLocalizedText []PropertyType
Conformance Units
Data Access Alternative Units

6.6.4 QuantityDimension

The QuantityDimension Structure DataType describes the dimensionality of a kind of quantity in the context of a system of units. In the SI system of units, the dimensions of a kind of quantity are expressed as a product of the basic physical dimensions length (L), mass (M), time (T), current (I), absolute temperature (θ), amount of substance (N) and luminous intensity (J) as

.

The rational powers of the dimensional exponents (α, β, γ, δ, ε, η, v), are positive, negative, or zero.

An additional dimensionless exponent is used for countable things that have no physical quantity assigned.

The QuantityDimension elements are defined in Table 58.

Table 58 – QuantityDimension DataType structure
NameTypeDescription
QuantityDimensionStructure

MassExponent

SByteExponent of the dimension mass for the physical quantity.

LengthExponent

SByteExponent of the dimension length for the physical quantity.

TimeExponent

SByteExponent of the dimension time for the physical quantity.

ElectricCurrentExponent

SByteExponent of the dimension electric current for the physical quantity.

AmountOfSubstanceExponent

SByteExponent of the dimension amount of substance for the physical quantity.

LuminousIntensityExponent

SByteExponent of the dimension luminous intensity for the physical quantity.

AbsoluteTemperatureExponent

SByteExponent of the dimension absolute temperature for the physical quantity.

DimensionlessExponent

SByteExponent for dimensionless quantities.

Its representation in the AddressSpace is defined in Table 59.

Table 59 – QuantityDimension definition
Attribute Value
BrowseNameQuantityDimension
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of Structure defined in OPC 10000-5.
Conformance Units
Data Access Quantities Base

For example, the dimension of the physical quantity kind

,

the dimension of the physical quantity kind force is

,

and the dimension of the physical quantity kind “things (e.g., screws) per time” is

.

Table 60 – QuantityDimension examples
NameValues for speedValues for forceValues for “things per time”
QuantityDimension

MassExponent

010

LengthExponent

110

TimeExponent

-1-2-1

ElectricCurrentExponent

000

AmoutOfSubstanceExponent

000

LuminousIntensityExponent

000

AbsoluteTemperatureExponent

000

DimensionlessExponent

001

The extended SI System of units includes derived units that are built as a product of base units. That makes it difficult to compare units as SI allows an unlimited number of “SI unit strings” to describe the same quantity.

All 3 are valid SI representations of the quantity “speed” and therefore share the same quantity dimensions. A specific representation of a unit is often used to express details how the unit was measured. The dimension structure makes it much easier to identify and compare the kind of quantity of EU values.