Documentation Center

Plug-ins User Guide

Version 5.2 | Published March 20, 2024 ©

DataInRange

images/download/attachments/95401965/plugins_datainrange-icon.png
The DataInRange plug-in converts a range of values into a single value. The value in the Field name parameter is compared to the defined values in the Range Descriptions parameter. If the input value is found in one of the ranges, it is converted to the value assigned to the range and the result is set in the Result Field Name.

Note: This plug-in is located in: Plugins -> Container plug-ins -> Data

Information: DataPool plug-ins only work properly on a single channel on the same machine.

Note: Range values must be numeric values.

DataInRange Properties

  • Result Field Name: Defines the name of the DataPool variable that the result of the range conversion is assigned to.

  • Result Field Scope: Defines the scope of result field. If set to Local, the Result Filed Name value is defined as part of a DataPool structure used in an object. If defined as Global, the Result field is defined as a regular data field.

  • Range Descriptions: This parameter contains the different ranges. A range is defined inside brackets, with minimum and maximum values separated by comma. When a round bracket (opening or closing the range), the value next to it is not included in the range (but limiting the range). When square brackets are used the values are included in the range.

Example

In the following line the range of numbers between 1 and 10, excluding 1 and including 10, is converted to the text Little Numbers:

(1,10] = Little Numbers;