Description

The SmartAdd is a NumericPoint with an extension, the SmartAddExt, which allows the summation of the values of several points as well as the synthesis of their states. The components taken into account by SmartAdd are:

  • NumericPoints
  • Other NumericPoint SmartOperators

The extension sums the values of the points and then returns the results to the NumericPoint in which it is located. The SmartAddExt extension is a variation of the SmartStatusExt, which means that it performs the same work on the status as the SmartStatusExt.

In the case of a SmartAdd, the NumericPoint out slot will therefore contain the sum of the points and the state resulting from the addition of all the states of the incoming points.

 

Implementation

Refer to the SmartOperator section for general description.

  • To use the SmartAdd component: copy paste a SmartAdd from the btibTooIkit palette to anywhere in the station.

To use the extension in an existing point, copy and paste the SmartAddExt extension in the SmartAdd into a NumericPoint.

  • Select the points from Query request ( (warning) Only NumericPoints will be taken into account)
  • Change the Enable property to true


Properties

The properties of the extension are the same as those of the SmartStatusExt.

The properties of the parent point are the same as those of the SmartStatusExt parent. However, two slots differ in type and content:

  • Out: This is a StatusNumeric that contains the sum of the valid values of the incoming points. A value is considered invalid in these four cases:
    • The state of the point is invalid according to the InvalidStatus property
    • The value is Nan,
    • The value is +inf or -inf AND the ExcludelnfiniteValues property is true
    • If autoConversion is enabled and the input slot units are not convertible in the SmartOperator unit
    • Value: This is a Double that contains the out value


Advanced configuration property:

  • Conversion Auto: Enables the automatic conversion of values according to the facets of the "value" slot. See the "Converting Values" section below for more explanation.


Actions

The actions of the SmartAddExt are the same as those of SmartStatusExt.


Converting values

SmartOperators that work on numeric values take into account the units of the values processed.

  • Initialization:
    • The facets of the "out" property of the SmartOperator are applied to the "value" slot

 It is therefore necessary to relaunch an initialization when the facets of the "out" property change so that this modification is taken into account

  • "autoConversion" property of the advancedConfig:
    • If enabled, the units of the input slots are compared to those of the "value" slot facets. If they are not compatible, the input slot is ignored and is considered an invalid input
    • If not activated, slot units are not checked
    • Execution:
      • The input values are converted according to the units of the "value" slot