Difference between revisions of "Extensions.Quantities.Multiplication"

From emotive
Jump to navigation Jump to search
 
(8 intermediate revisions by one other user not shown)
Line 5: Line 5:
 
== OTL Syntax ==
 
== OTL Syntax ==
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
QuantityTerm = QuantityTerm1 * QuantityTerm2 * ...;
+
QuantityVariable = QuantityTerm * NumericTerm;
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Line 11: Line 11:
 
This is a term which returns as a result of the product of all numerical quantities (NumericQuantity) in accordance with their units.  
 
This is a term which returns as a result of the product of all numerical quantities (NumericQuantity) in accordance with their units.  
  
* When '''Quantity''' values are multiplied or divided, a definition of the physical dimension of the resulting '''Quantity''' has to exist in the UNIT-SPEC available to the OTX system.  
+
* When '''Quantity''' values are multiplied, a definition of the physical dimension of the resulting '''Quantity''' has to exist in the UNIT-SPEC available to the OTX system.  
  
* Scalar operands shall be interpreted "as is"; this allows e.g. the multiplication of 2 * 2 km which will result in a '''Quantity''' of 4000 m.
+
* Scalar operands will be interpreted "as is"; this allows e.g. the multiplication of 2 * 2 km which will result in a '''Quantity''' of 4000 m.
  
* The display unit of the resulting '''Quantity''' should be set to the SI base unit corresponding to the physical dimension resulting from the operation. Furthermore, the display precision of the resulting '''Quantity''' shall be the maximum of the display precisions of the operands.
+
* The display unit of the resulting '''Quantity''' will be set to the SI base unit corresponding to the physical dimension resulting from the operation. Furthermore, the display precision of the resulting '''Quantity''' will be the maximum of the display precisions of the operands.
  
 
{{TermReturnValue| [[Extensions.Quantities.Quantity|Quantity]] | Product of two or more numeric quantity (NumericQuantity)}}
 
{{TermReturnValue| [[Extensions.Quantities.Quantity|Quantity]] | Product of two or more numeric quantity (NumericQuantity)}}
Line 22: Line 22:
 
{| {{TableHeader}}
 
{| {{TableHeader}}
 
{{TableRowPropertiesHeader}}
 
{{TableRowPropertiesHeader}}
{{TableRowPropertie1| QuantityTerm1 | [[Extensions.Quantities.Quantity|Quantity]] | [[Term]] | - | [1] | NumericQuantity operand, which should be multiplied}}
+
{{TableRowPropertie1| QuantityTerm | [[Extensions.Quantities.Quantity|Quantity]] | [[Term]] | - | [1..*] | Quantity values are multiplied}}
{{TableRowPropertie1| QuantityTerm2 | [[Extensions.Quantities.Quantity|Quantity]]/[[Numeric]] | [[Term]] | - | [1] | NumericQuantity/Numeric operand, which should be multiplied}}
+
{{TableRowPropertie2| NumericTerm| [[Numeric]] | [[Term]] | - | [0..*] | Numeric values are multiplied}}
 
|}
 
|}
  
 
== OTL Examples ==
 
== OTL Examples ==
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 +
/// Local Declarations
 +
 
Quantities.Quantity Quantity;
 
Quantities.Quantity Quantity;
  

Latest revision as of 03:13, 13 September 2019

Classification

Name Multiplication
Short Description Multiplication of all numerical quantities
Class Operations
Extension OTX Quantities extension
Group Overloading semantics
Exceptions InvalidConversionException
Checker Rules -
Standard Compliant Yes

OTL Syntax

QuantityVariable = QuantityTerm * NumericTerm;

Description

This is a term which returns as a result of the product of all numerical quantities (NumericQuantity) in accordance with their units.

  • When Quantity values are multiplied, a definition of the physical dimension of the resulting Quantity has to exist in the UNIT-SPEC available to the OTX system.
  • Scalar operands will be interpreted "as is"; this allows e.g. the multiplication of 2 * 2 km which will result in a Quantity of 4000 m.
  • The display unit of the resulting Quantity will be set to the SI base unit corresponding to the physical dimension resulting from the operation. Furthermore, the display precision of the resulting Quantity will be the maximum of the display precisions of the operands.

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 Product of two or more numeric quantity (NumericQuantity)

Properties

Name Data Type Class Default Cardinality Description
QuantityTerm Quantity Term - [1..*] Quantity values are multiplied
NumericTerm Numeric Term - [0..*] Numeric values are multiplied

OTL Examples

/// Local Declarations

Quantities.Quantity Quantity;

/// Flow

Quantity = 2 * 2 [@Unit, "BL_DataLibraMIB.odx", "km", 2];

See also

Addition
Subtraction
Division
Modulo
Absolute Value
Negation