Band By Strata (Deprecated) - Data360_Analyze - Latest

Data360 Analyze Server Help

Product type
Software
Portfolio
Verify
Product family
Data360
Product
Data360 Analyze
Version
Latest
Language
English
Product name
Data360 Analyze
Title
Data360 Analyze Server Help
Copyright
2024
First publish date
2016
Last updated
2024-11-28
Published on
2024-11-28T15:26:57.181000

Given an increment value, this deprecated node assigns a band number to each value based upon distance, in number of increments, from zero.

CAUTION:
This node has been deprecated and will not be supported in a future release. As an alternative, the Band by Strata node can be used to provide similar functionality, but the underlying code is Python rather than Data360 Analyze Script.

An additional field is appended to each input row to identify that row's band.

Bands start at zero and are as wide as the Increment property. They are calculated in both directions from zero. Values that are zero are in a separate band. In other words, zero is its own band, then zero to increment, then increment to 2*increment, etc., plus -increment to zero, -2*increment to -increment, etc. In each case, the value that defines the band that is the closest to zero (i.e. has the lowest absolute value) is excluded from the band. Null values are put into a band with a null value.

Bands are numbered with integers in the BandFieldName field, starting at zero for zero values, then 1 for the first band above zero, 2 for the second, etc. For negative input values, the first band just below 0 is numbered -1, the second, -2, etc.An example might help clarify this explanation. If Increment is 5, then the first band is the 0 band. Only values of 0 are put in the zero band. Values from 0, exclusive, to 5, inclusive, are in band one. Band two contains all values from 5, exclusive, to 10, inclusive. Conversely, -5, inclusive, to 0, exclusive, is band -1 while -10, inclusive, to -5, exclusive, is band -2. All values that fit in these bands are marked with the appropriate band number.

Properties

InputExpr

Specify the values used to band the input data. This expression is evaluated against each input row and must evaluate to a single value that is either an integer, a double, or a long value. This expression can convert data from one type to another. For example, it could convert two dates from two different fields into the number of days between those two dates.

A value is required for this property.

Increment

Specify a positive number that determines the width of the bands. If InputExpr is an integer or a long, then this value must also be an integral value.

A value is required for this property.

BandFieldName

Optionally specify the name of the field in which the band number is output. This value can be changed if you happen to have a field whose name is the same as this name or for any other purpose.

The default value is "_Band".

Epsilon

Optionally specify an Epsilon tolerance threshold for equality comparisons of banding floating-point values.

If left blank, then direct comparisons are used.

Inputs and outputs

Inputs: in1

Outputs: out1