visad.data.dods

Class Valuator

java.lang.Object

visad.data.dods.Valuator

Direct Known Subclasses:

Float32Valuator, Float64Valuator, IntValuator

public abstract class Valuator
extends java.lang.Object

Provides support for processing numeric values in a DODS dataset. Processing includes checking for non-equality with "missing" or "fill" values, unpacking into more capacious data types, and checking that the values lie within a valid range.

Instances are immutable.

Method Summary

Modifier and Type	Method and Description
abstract SimpleSet	getRepresentationalSet(RealType realType) Returns the set used to represent unpacked, numeric values associated with this instance in the range of a VisAD FlatField.
double	process(double value) Processes values.
double[]	process(double[] values) Processes values.
float	process(float value) Processes a value.
float[]	process(float[] values) Processes a value.
static Valuator	valuator(dods.dap.AttributeTable table, int type) Returns an instance of this class corresponding to the attributes for a DODS variable.
static ValueRanger	valueRanger(dods.dap.AttributeTable table) Returns an instance of a value ranger corresponding to the attributes of a DODS variable.
static ValueUnpacker	valueUnpacker(dods.dap.AttributeTable table) Returns an instance of a value unpacker corresponding to the attributes of a DODS variable.
static ValueVetter	valueVetter(dods.dap.AttributeTable table) Returns an instance of a value vetter corresponding to the attributes of a DODS variable.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

valuator

public static Valuator valuator(dods.dap.AttributeTable table,
                                int type)
                         throws BadFormException,
                                VisADException,
                                java.rmi.RemoteException

Returns an instance of this class corresponding to the attributes for a DODS variable.

Parameters:

table - The attribute table for a DODS variable.

type - The type of packed variable: Attribute.BYTE, Attribute.INT16, etc.

Throws:

BadFormException - The attribute table is corrupt.

VisADException - VisAD failure.

java.rmi.RemoteException - Java RMI failure.

getRepresentationalSet

public abstract SimpleSet getRepresentationalSet(RealType realType)
                                          throws VisADException

Returns the set used to represent unpacked, numeric values associated with this instance in the range of a VisAD FlatField.

Returns:

realType The VisAD real-type for the set.

Throws:

VisADException - VisAD failure.

process

public float process(float value)

Processes a value.

Parameters:

value - The value to be processed.

process

public float[] process(float[] values)

Processes a value.

Parameters:

values - The values to be processed.

process

public double process(double value)

Processes values.

Parameters:

value - The value to be processed.

process

public double[] process(double[] values)

Processes values.

Parameters:

values - The values to be processed.

valueVetter

public static ValueVetter valueVetter(dods.dap.AttributeTable table)
                               throws BadFormException,
                                      VisADException,
                                      java.rmi.RemoteException

Returns an instance of a value vetter corresponding to the attributes of a DODS variable.

Parameters:

table - The DODS attribute table. May be null, in which case a trivial vetter is returned.

Returns:

A value vetter.

Throws:

BadFormException - The attribute table is corrupt.

VisADException - VisAD failure.

java.rmi.RemoteException - Java RMI failure.

valueUnpacker

public static ValueUnpacker valueUnpacker(dods.dap.AttributeTable table)
                                   throws BadFormException,
                                          VisADException,
                                          java.rmi.RemoteException

Returns an instance of a value unpacker corresponding to the attributes of a DODS variable.

Parameters:

table - A DODS attribute table. May be null, in which case a trivial unpacker is returned.

Returns:

A value unpacker.

Throws:

BadFormException - The attribute table is corrupt.

VisADException - VisAD failure.

java.rmi.RemoteException - Java RMI exception.

valueRanger

public static ValueRanger valueRanger(dods.dap.AttributeTable table)
                               throws BadFormException,
                                      VisADException,
                                      java.rmi.RemoteException

Returns an instance of a value ranger corresponding to the attributes of a DODS variable.

Parameters:

table - A DODS attribute table. May be null, in which case a trivial ranger is returned.

Returns:

A value ranger.

Throws:

BadFormException - The attribute table is corrupt.

VisADException - VisAD failure.

java.rmi.RemoteException - Java RMI exception.