Difference between revisions of "Extensions.Measure.GetMeasurementQuantity"

From emotive
Jump to navigation Jump to search
Line 1: Line 1:
 
{{DISPLAYTITLE:'''GetMeasurementQuantity '''}}[[Category:Measure]]
 
{{DISPLAYTITLE:'''GetMeasurementQuantity '''}}[[Category:Measure]]
 
== Classification ==
 
== Classification ==
{{ClassificationActivity | GetMeasurementQuantity | Gets the measured NumericQuantity from a measurement | [[Term]] | [[Extensions.Measure|OTX Measure extension]] | [[Measurement related terms]] | [[Core.Actions.Throw.Exception.InvalidMeasurementException|InvalidMeasurementException]] | - }}
+
{{ClassificationActivity | GetMeasurementQuantity | Gets the measured quantity value from a measurement | [[Term]] | [[Extensions.Measure|OTX Measure extension]] | [[Extensions.Measure#Terms|Measurement related terms]] | [[Extensions.Measure.InvalidMeasurementException|InvalidMeasurementException]] | - }}
  
 
== OTL Syntax ==
 
== OTL Syntax ==
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
QuantityTerm = Measure.GetMeasurementQuantity(Measurement);
+
QuantityTerm = Measure.GetMeasurementQuantity(MeasurementTerm);
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
== Description ==
 
== Description ==
This term gets the measured ''NumericQuantity'' from a measurement.
+
This term gets the measured ''quantity value'' from a measurement.
  
{{TermReturnValue| [[Extensions.Quantities.Quantity|Quantity]] | The NumericQuantity of a measurement. }}
+
{{TermReturnValue| [[Extensions.Quantities.Quantity|Quantity]] | The quantity value of a measurement. }}
  
 
== Properties ==
 
== Properties ==
 
{| {{TableHeader}}
 
{| {{TableHeader}}
 
{{TableRowPropertiesHeader}}
 
{{TableRowPropertiesHeader}}
{{TableRowPropertie1| Measurement | [[Extensions.Measure.Measurement|Measurement]] | [[Term]] | - | [1] | The measurement whose quantity value is acquired.}}
+
{{TableRowPropertie2| Measurement | [[Extensions.Measure.Measurement|Measurement]] | [[Term]] | - | [1] | The '''measurement''' whose quantity value shall be acquired.}}
 
|}
 
|}
  
 
== OTL Examples ==
 
== OTL Examples ==
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
package Measure.DeviceSignature TestDocument
+
/// Signatures
 +
 
 +
package Measure.DeviceSignature DeviceSignature1
 
{
 
{
  DeviceServiceSignature Addition(in Integer a, in Integer b, out Measure.Measurement OutValue);
+
Measure.DeviceServiceSignature Add(in Integer a, out Measure.Measurement Measurement);
 
}
 
}
  
public procedure GetMeasurementQuantity()
+
/// Global Declarations
 +
 
 +
public procedure main()
 
{
 
{
  Measure.Measurement Return;
+
/// Local Declarations
  Float a = 12;
+
 
  Quantities.Quantity Quantity;
+
Measure.Measurement Measurement1;
 +
Integer a1 = 10;
 +
Quantities.Quantity Quantity1;
 +
 
 +
/// Flow
  
  Measure.ExecuteDeviceService(TestDocument, Addition, {in a = 2, in b = 3, out OutValue = Return}, false, false);
+
Measure.ExecuteDeviceService(DeviceSignature1, Add, {a = a1, Measurement = Measurement1}, false, false);
  Quantity = Measure.GetMeasurementQuantity(Return);
+
Quantity1 = Measure.GetMeasurementQuantity(Measurement1);
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>

Revision as of 08:11, 19 October 2018

Classification

Name GetMeasurementQuantity
Short Description Gets the measured quantity value from a measurement
Class Term
Extension OTX Measure extension
Group Measurement related terms
Exceptions InvalidMeasurementException
Checker Rules -
Standard Compliant Yes

OTL Syntax

QuantityTerm = Measure.GetMeasurementQuantity(MeasurementTerm);

Description

This term gets the measured quantity value from a measurement.

Return Value

The Term returns the value, see table below.

Icons Note.png In OTX, Terms are categorized according to its return data type!
Data Type Description
Quantity The quantity value of a measurement.

Properties

Name Data Type Class Default Cardinality Description
Measurement Measurement Term - [1] The measurement whose quantity value shall be acquired.

OTL Examples

/// Signatures

package Measure.DeviceSignature DeviceSignature1
{
	Measure.DeviceServiceSignature Add(in Integer a, out Measure.Measurement Measurement);
}

/// Global Declarations

public procedure main()
{
	/// Local Declarations

	Measure.Measurement Measurement1;
	Integer a1 = 10;
	Quantities.Quantity Quantity1;

	/// Flow

	Measure.ExecuteDeviceService(DeviceSignature1, Add, {a = a1, Measurement = Measurement1}, false, false);
	Quantity1 = Measure.GetMeasurementQuantity(Measurement1);
}

See also

GetMeasurementTimestamp
GetMeasurementStatus
GetMeasurementFloatValue
IsValidMeasurement