Arithmetic Examples

This topic provides numerous useful examples of the various ways you can use reference methods in your device template files to perform conversions with constant values and/or reference data group element values. A sample device template file using each example is available upon request; it can be loaded to a DDS and used to test your reference methods. It is called ReferenceTester.dtf.

See the following subsections for details:

• Addition (A)
• Addition (B)
• Average Value (A)
• Average Value (B)
• Division (A)
• Division (B)
• Exponent/Raise to Power (A)
• Exponent/Raise to Power (B)
• Maximum Value (A)
• Maximum Value (B)
• Minimum Value (A)
• Minimum Value (B)
• Multiplication (A)
• Multiplication (B)
• Subtraction (A)
• Subtraction (B)

For information about example data group elements and values used below, see Example Values.

Addition (A)

The following example uses two child elements to add two values. The first child element references the operation opAssignId and the value of the data group element raw10 to assign the current value of 10 as the initial value for AddConst. The second child element references the operation opAdd to add the constant value "5" to the value assigned by the first child element. The result is 15.

Useful attributes to know are isRef, prec, refOp, deid, and value. A useful element to know is ref.

Addition (B)

The following example uses two child elements to add two values. The first child element references the operation opAssign and the constant value "10" to assign the current value of 10 as the initial value for AddId. The second child element references the operation opAddId to add the value of the referenced data group element raw5 to the value assigned by the first child element. The result is 15.

Useful attributes to know are isRef, prec, refOp, deid, and value. A useful element to know is ref.

Average Value (A)

The following example uses specialized child elements to select an average value from a set of defined values. The first child element references the operation opAverage to specify that its children are part of a data set from which the average value is required. Then the dataSet element is defined. Finally, child item elements are defined. Each item element specifies a value; the value can either be a constant (value) or variable (deid). In this example, the average value from the data set is 55.

Useful attributes to know are isRef, prec, refOp, deid, and value. Useful elements to know are ref, dataSet, and item.

Average Value (B)

The following example uses specialized child elements to select an average value from a set of defined values where some of the values are outside the data set, but within the parent data group element. The first child element references the operation opAssignId to assign a starting value that will be compared to values in the data set. The second child element references the operation opScaleFactorId to apply a scale factor of 2 to the value 1. The result is 2. A third child element references the operation opAverage to specify that an average value is to be returned. Then the dataSet element is defined. Finally, child item elements are defined. Each item element specifies a value; the value can either be a constant (value) or variable (deid). In this example, the value 2 is used along with the values in the data set to determine an average; the average value is assigned to the parent data group element. In this case, the average value from the data set is 29.25.

Useful attributes to know are isRef, prec, refOp, deid, and value. Useful elements to know are ref, dataSet, and item.

Division (A)

The following example uses two child elements to divide one value by another value. The first child element references the operation opAssignId and the value of the data group element raw10 to assign the current value of 10 as the initial value for DivConst. The second child element references the operation opDiv to divide the initial value 10 by the constant value assigned by the second child element. The result is 5.

Useful attributes to know are isRef, prec, refOp, value, deid, divZeroAction, and divZeroSentinel. A useful element to know is ref.

Division (B)

The following example uses two child elements to divide one value by another value. The first child element references the operation opAssign and the constant value "10" to assign the current value of 10 as the initial value for DivId. The second child element references the operation opDivId to divide the constant value "10" by the value of the reference data group element assigned by the second child element. The result is 5.

Useful attributes to know are isRef, prec, refOp, deid, value, divZeroAction, and divZeroSentinel. A useful element to know is ref.

Exponent/Raise to Power (A)

The following example uses two child elements to raise one value to the power of the other. The first child element references the operation opAssignId and the value of the data group element raw10 to assign the current value of 10 as the initial value for PowConst. The second child element references the operation opPow and uses a constant value to raise the initial value to the power of "2". The result is 100.

Useful attributes to know are isRef, prec, refOp, deid, and value. A useful element to know is ref.

Exponent/Raise to Power (B)

The following example uses two child elements to raise one value to the power of the other. The first child element references the operation opAssign and the constant value "10" to assign the current value of 10 as the initial value for PowId. The second child element references the operation opPowId and uses a reference data group element value to raise the initial value to the power of "2". The result is 100.

Useful attributes to know are isRef, prec, refOp, deid, and value. A useful element to know is ref.

Maximum Value (A)

The following example uses specialized child elements to select a maximum value from a set of defined values. The first child element references the operation opMax to specify that its children are part of a data set from which the maximum value is required. Then the dataSet element is defined. Finally, child item elements are defined. Each item element specifies a value; the value can either be a constant (value) or variable (deid). In this example, the maximum value from the data set is 50.

Useful attributes to know are isRef, prec, refOp, deid, and value. Useful elements to know are ref, dataSet, and item.

Maximum Value (B)

The following example uses specialized child elements to select a maximum value from a set of defined values where some of the values are outside the data set, but within the parent data group element. The first child element references the operation opAssignId to assign a starting value that will be compared to values in the data set. The second child element references the operation opScaleFactor to apply a scale factor of 10 to the value 2. The result is 200. A third child element references the operation opMax to specify that a maximum value is to be returned. Then the dataSet element is defined. Finally, child item elements are defined. Each item element specifies a value; the value can either be a constant (value) or variable (deid). In this example, the value 200 is compared to the values in the data set; the maximum value is assigned to the parent data group element. In this case, the maximum value for the data group element is 200.

Useful attributes to know are isRef, prec, refOp, deid, and value. Useful elements to know are ref, dataSet, and item.

Minimum Value (A)

The following example uses specialized child elements to select a minimum value from a set of defined values. The first child element references the operation opMin to specify that its children are part of a data set from which the minimum value is required. Then the dataSet element is defined. Finally, child item elements are defined. Each item element specifies a value; the value can either be a constant (value) or variable (deid). In this example, the minimum value from the data set is 1, because the data group element referenced (raw1) contains the value 1.

Useful attributes to know are isRef, prec, refOp, deid, and value. Useful elements to know are ref, dataSet, and item.

Minimum Value (B)

The following example uses specialized child elements to select a minimum value from a set of defined values where some of the values are outside the data set, but within the parent data group element. The first child element references the operation opAssignId to assign a starting value that will be compared to values in the data set. The second child element references the operation opScaleFactor to apply a scale factor of 10 to the value 2. The result is 200. A third child element references the operation opMin to specify that a minimum value is to be returned. Then the dataSet element is defined. Finally, child item elements are defined. Each item element specifies a value; the value can either be a constant (value) or variable (deid). In this example, the value 200 is compared to the values in the data set; the minimum value is assigned to the parent data group element. In this case, the minimum value from the data set is 1, because the data group element referenced (raw1) contains the value 1.

Useful attributes to know are isRef, prec, refOp, deid, and value. Useful elements to know are ref, dataSet, and item.

Multiplication (A)

The following example uses two child elements to multiply values. The first child element references the operation opAssignId and the value of the data group element raw10 to assign the current value of 10 as the initial value for MultConst. The second child element references the operation opMult to multiply the constant value "5" by the value assigned by the first child element. The result is 50.

Useful attributes to know are isRef, prec, refOp, deid, and value. A useful element to know is ref.

Multiplication (B)

The following example uses two child elements to multiply values. The first child element references the operation opAssign and the constant value "10" to assign the current value of 10 as the initial value for MultId. The second child element references the operation opMultId to multiply the value of the referenced data group element raw5 by the value assigned by the first child element. The result is 50.

Useful attributes to know are isRef, prec, refOp, deid, and value. A useful element to know is ref.

Subtraction (A)

The following example uses two child elements to subtract one value from another value. The first child element references the operation opAssignId and the value of the data group element raw10 to assign the current value of 10 as the initial value for SubConst. The second child element references the operation opSub to subtract the constant value "5" from the value assigned by the first child element. The result is 5.

Useful attributes to know are isRef, prec, refOp, deid, and value. A useful element to know is ref.

Subtraction (B)

The following example uses two child elements to subtract one value from another value. The first child element references the operation opAssign and the constant value "10" to assign the current value of 10 as the initial value for SubId. The second child element references the operation opSubId to subtract the value of the referenced data group element raw5 from the value assigned by the first child element. The result is 5.

Useful attributes to know are isRef, prec, refOp, deid, and value. A useful element to know is ref.