User's Reference - Band

### Band

Category

Realization

Function

Divides a specified field into bands.

Syntax

    band = Band(data, value, number, remap);

Inputs

Name | Type | Default | Description
--- | --- | --- | ---
`data` | scalar field | none | field to be divided
`value` | scalar or scalar list | data mean | band divisions
`number` | integer | no default | number of divisions
`remap` | string | "low" | data values applied to bands

Outputs

Name | Type | Description
--- | --- | ---
`band` | field or group | divided input

Functional Details

The values used for dividing a field into bands are specified by `value` or `number`.

`data` | is the field to be divided and must have 2-dimensional connections (triangles or quads).
`value` | specifies the value(s) at which the divisions are to be created (i.e., the data values in the data field). If this parameter and `number` (see below) are both unspecified, the module, by default, constructs the division at the arithmetic mean of the data set.
`number` | specifies the number of equal divisions to be created between the minimum (min) and maximum (max) data values of the field. The first division is created at min + delta, the second at min + 2 * delta, and the last at max - delta, where delta = (max-min)/(number+1). Note: This parameter is ignored if `value` is specified.
`remap` | assigns data values to the elements in each band:
"low" | specifies that all connection elements are assigned the value of the lower boundary of the band (the lowest data value if it is the first band).
"high" | specifies that all connection elements are assigned the value of the upper boundary of the band (the largest data value if it is the last band).
"original" | specifies that the data values remain unchanged.

Components

This module creates new "positions" and "connections" components, and adds a "colors" component if one is not already present. The "data" component is modified according to the value of `remap`. The output data are connection dependent.

Example Visual Programs

    AlternateVisualizations.net

    BandedColors.net

    InvalidData.net
    SIMPLE/Band.net

See Also

Isosurface

[ OpenDX Home at IBM | OpenDX.org ]