IBM Visualization Data Explorer User's Reference

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

[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]