ucar.visad

Class VisADMath

java.lang.Object

ucar.visad.VisADMath

public final class VisADMath
extends java.lang.Object

Utility class: provides support for mathematical operations on VisAD data objects.

Author:

Steven R. Emmerson $Id: VisADMath.java,v 1.15 2005/05/13 18:34:06 jeffmc Exp $

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	VisADMath.Index Provides support for indexing sample points.

Method Summary

Modifier and Type	Method and Description
static visad.Data	add(visad.Data data1, visad.Data data2) Adds two data objects together.
static visad.FlatField	curveIntegralOfGradient(visad.Field field) Returns the indefinite curve integral of a Field, which is assumed to be the gradient of a function.
static visad.Data	divide(visad.Data data1, visad.Data data2) Divides one data object by another.
static visad.Data	exp(visad.Data data) Exponentiates a data object.
static visad.FlatField	fromReference(visad.FunctionType type, visad.FlatField data) Transforms a FlatField object from a reference CoordinateSystem.
static visad.Data	fromReference(visad.MathType type, visad.Data data) Transforms a data object from a reference CoordinateSystem.
static visad.RealTuple	fromReference(visad.RealTupleType type, visad.RealTuple data) Transforms a RealTuple object from a reference CoordinateSystem.
static visad.IrregularSet	fromReference(visad.SetType type, visad.SampledSet data) Transforms a SampledSet object from a reference CoordinateSystem.
static visad.Data	invert(visad.Data data) Inverts a data object by forming the reciprocal.
static visad.Data	log(visad.Data data) Takes the natural logarithm of a data object.
static void	main(java.lang.String[] args) Tests this class.
static visad.Data	multiply(visad.Data data1, visad.Data data2) Multiplies two data objects together.
static visad.Data	negate(visad.Data data) Negates a data object.
static visad.FlatField	newFlatField(visad.SampledSet set) Creates a FlatField from a SampledSet.
static visad.FlatField	newFlatField(visad.SampledSet set, visad.MathType rangeType, visad.CoordinateSystem rangeCoordinateSystem) Creates a FlatField from a SampledSet, a MathType for the range, and a CoordinateSystem for the range.
static visad.FlatField	newFlatField(visad.SampledSet domain, visad.SampledSet range) Creates a FlatField from two SampledSet-s.
static visad.FlatField	newFlatField(visad.SampledSet domain, visad.SampledSet range, visad.MathType rangeType, visad.CoordinateSystem rangeCoordinateSystem) Creates a FlatField from a domain SampledSet, a range SampledSet, and a CoordinateSystem for the range.
static visad.Data	pow(visad.Data base, visad.Data exponent) Raises one data object to the power of another.
static visad.Data	subtract(visad.Data data1, visad.Data data2) Subtracts one data object from another.

Methods inherited from class java.lang.Object

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

Method Detail

negate

public static visad.Data negate(visad.Data data)
                         throws visad.VisADException,
                                java.rmi.RemoteException

Negates a data object.

Parameters:

data - The data object to be negated.

Returns:

The result of negating the data object.

Throws:

visad.VisADException - Couldn't create necessary VisAD object.

java.rmi.RemoteException - Java RMI failure.

invert

public static visad.Data invert(visad.Data data)
                         throws visad.VisADException,
                                java.rmi.RemoteException

Inverts a data object by forming the reciprocal.

Parameters:

data - The data object to be inverted.

Returns:

The result of inverting the data object.

Throws:

visad.VisADException - Couldn't create necessary VisAD object.

java.rmi.RemoteException - Java RMI failure.

exp

public static visad.Data exp(visad.Data data)
                      throws visad.VisADException,
                             java.rmi.RemoteException

Exponentiates a data object.

Parameters:

data - The data object to be exponentiated.

Returns:

The result of exponentiating the data object.

Throws:

visad.VisADException - Couldn't create necessary VisAD object.

java.rmi.RemoteException - Java RMI failure.

log

public static visad.Data log(visad.Data data)
                      throws visad.VisADException,
                             java.rmi.RemoteException

Takes the natural logarithm of a data object.

Parameters:

data - The data object to have the natural logarithm taken.

Returns:

The result of taking the natural logarithm of the data object.

Throws:

visad.VisADException - Couldn't create necessary VisAD object.

java.rmi.RemoteException - Java RMI failure.

add

public static visad.Data add(visad.Data data1,
                             visad.Data data2)
                      throws visad.UnimplementedException,
                             visad.TypeException,
                             java.lang.ArithmeticException,
                             visad.VisADException,
                             java.rmi.RemoteException

Adds two data objects together. The computational modes are Data.WEIGHTED_AVERAGE and Data.NO_ERRORS.

Parameters:

data1 - The first data object.

data2 - The second data object.

Returns:

The result of adding the two data objects together.

Throws:

visad.UnimplementedException - Operation not yet implemented.

visad.TypeException - MathTypes are incompatible.

java.lang.ArithmeticException - Invalid operation between types.

visad.VisADException - Couldn't create necessary VisAD object.

java.rmi.RemoteException - Java RMI failure.

subtract

public static visad.Data subtract(visad.Data data1,
                                  visad.Data data2)
                           throws visad.UnimplementedException,
                                  visad.TypeException,
                                  java.lang.ArithmeticException,
                                  visad.VisADException,
                                  java.rmi.RemoteException

Subtracts one data object from another.

Parameters:

data1 - The first data object.

data2 - The second data object.

Returns:

The result of subtracting the second data object from the first data object.

Throws:

visad.UnimplementedException - Operation not yet implemented.

visad.TypeException - MathTypes are incompatible.

java.lang.ArithmeticException - Invalid operation between types.

visad.VisADException - Couldn't create necessary VisAD object.

java.rmi.RemoteException - Java RMI failure.

multiply

public static visad.Data multiply(visad.Data data1,
                                  visad.Data data2)
                           throws visad.UnimplementedException,
                                  visad.TypeException,
                                  java.lang.ArithmeticException,
                                  visad.VisADException,
                                  java.rmi.RemoteException

Multiplies two data objects together. The computational modes are Data.WEIGHTED_AVERAGE and Data.NO_ERRORS.

Parameters:

data1 - The first data object.

data2 - The second data object.

Returns:

The result of multiplying the first data object by the second data object.

Throws:

visad.UnimplementedException - Operation not yet implemented.

visad.TypeException - MathTypes are incompatible.

java.lang.ArithmeticException - Invalid operation between types.

visad.VisADException - Couldn't create necessary VisAD object.

java.rmi.RemoteException - Java RMI failure.

divide

public static visad.Data divide(visad.Data data1,
                                visad.Data data2)
                         throws visad.UnimplementedException,
                                visad.TypeException,
                                java.lang.ArithmeticException,
                                visad.VisADException,
                                java.rmi.RemoteException

Divides one data object by another.

Parameters:

data1 - The first data object.

data2 - The second data object.

Returns:

The result of dividing the first data object by the second data object.

Throws:

visad.UnimplementedException - Operation not yet implemented.

visad.TypeException - MathTypes are incompatible.

java.lang.ArithmeticException - Invalid operation between types.

visad.VisADException - Couldn't create necessary VisAD object.

java.rmi.RemoteException - Java RMI failure.

pow

public static visad.Data pow(visad.Data base,
                             visad.Data exponent)
                      throws visad.UnimplementedException,
                             visad.TypeException,
                             java.lang.ArithmeticException,
                             visad.VisADException,
                             java.rmi.RemoteException

Raises one data object to the power of another.

Parameters:

base - The data object to be raised by a power.

exponent - The exponent by which to raise the base.

Returns:

The result of raising the base data object by the power of the exponent data object.

Throws:

visad.UnimplementedException - Operation not yet implemented.

visad.TypeException - MathTypes are incompatible.

java.lang.ArithmeticException - Invalid operation between types.

visad.VisADException - Couldn't create necessary VisAD object.

java.rmi.RemoteException - Java RMI failure.

fromReference

public static visad.Data fromReference(visad.MathType type,
                                       visad.Data data)
                                throws visad.TypeException,
                                       visad.VisADException,
                                       java.rmi.RemoteException

Transforms a data object from a reference CoordinateSystem. When the data object is a FlatField, then the transformation applies to its range and not its domain.

Parameters:

type - The VisAD MathType of the returned data object. It shall be a RealTupleType, SetType, or FunctionType and shall have a CoordinateSystem, which shall be used in the transformation.

data - The data object to be transformed. The object shall be a Real, RealTuple, SampledSet, or FlatField.

Returns:

The transformed data object. Its VisAD MathType shall be type.

Throws:

visad.TypeException - Data object has illegal type.

visad.VisADException - Couldn't create necessary VisAD object.

java.rmi.RemoteException - Java RMI failure.

fromReference

public static visad.RealTuple fromReference(visad.RealTupleType type,
                                            visad.RealTuple data)
                                     throws visad.VisADException,
                                            java.rmi.RemoteException

Transforms a RealTuple object from a reference CoordinateSystem.

Parameters:

type - The MathType of the returned data object. It shall have a CoordinateSystem, which shall be used in the transformation.

data - The RealTuple object to be transformed.

Returns:

The transformed data object.

Throws:

visad.VisADException - Couldn't create necessary VisAD object.

java.rmi.RemoteException - Java RMI failure.

fromReference

public static visad.IrregularSet fromReference(visad.SetType type,
                                               visad.SampledSet data)
                                        throws visad.VisADException

Transforms a SampledSet object from a reference CoordinateSystem.

Parameters:

type - The MathType of the returned data object.It shall have a CoordinateSystem, which shall be used in the transformation.

data - The SampledSet object to be transformed.

Returns:

The transformed data object.

Throws:

visad.VisADException - Couldn't create necessary VisAD object.

fromReference

public static visad.FlatField fromReference(visad.FunctionType type,
                                            visad.FlatField data)
                                     throws visad.VisADException,
                                            java.rmi.RemoteException

Transforms a FlatField object from a reference CoordinateSystem.

Parameters:

type - The MathType of the returned data object.It shall have a CoordinateSystem, which shall be used in the transformation.

data - The data object to be transformed.

Returns:

The transformed data object.

Throws:

visad.VisADException - Couldn't create necessary VisAD object.

java.rmi.RemoteException - Java RMI failure.

curveIntegralOfGradient

public static visad.FlatField curveIntegralOfGradient(visad.Field field)
                                               throws visad.FieldException,
                                                      visad.VisADException,
                                                      java.rmi.RemoteException

Returns the indefinite curve integral of a Field, which is assumed to be the gradient of a function. This method can handle any Field whose range is one of the following:

   Scalar derivative       dy/dx

   RealTuple of partial
   derivatives             (du/dx, du/dy, ...)

   Tuple of RealTuple-s
   of partial derivatives
   (one set of partial
   derivatives for each
   component of the
   resulting FlatField)    ((du/dx, du/dy, ...), (dv/dx, dv/dy, ...), ...)
 

The domain points of the returned FlatField will be the same as the Field's. The type of the range of the returned FlatField will depend on the type of the range of the Field. The value of the range at the first domain point of the returned FlatField shall be arbitrarily set to (possibly vector) zero.

Parameters:

field - The Field whose indefinite curve integral is to be computed.

Returns:

The indefinite curve integral of the Field.

Throws:

visad.FieldException - The Field has a non-flat range or range dimension of Field != domain dimension of Field.

visad.VisADException - Couldn't create necessary VisAD object.

java.rmi.RemoteException - Java RMI failure.

newFlatField

public static visad.FlatField newFlatField(visad.SampledSet set)
                                    throws visad.VisADException,
                                           java.rmi.RemoteException

Creates a FlatField from a SampledSet. This method should, perhaps, become a method in visad.Set or a constructor in FlatField.

Parameters:

set - The SampledSet.

Returns:

The SampledSet promoted to a FlatField. The MathType of the domain and range will be the RealTupleType of the set (i.e. ((SetType)set.getType()).getDomain(). The CoordinateSystem of the range will be that of the set (i.e. set.getCoordinateSystem()).

Throws:

visad.VisADException - Couldn't create necessary VisAD object.

java.rmi.RemoteException - Java RMI failure.

newFlatField

public static visad.FlatField newFlatField(visad.SampledSet domain,
                                           visad.SampledSet range)
                                    throws visad.VisADException,
                                           java.rmi.RemoteException

Creates a FlatField from two SampledSet-s. This method should, perhaps, become a method in visad.Set or a constructor in FlatField.

Parameters:

domain - The domain of the FlatField.

range - The range of the FlatField.

Returns:

The SampledSet promoted to a FlatField. The MathType of the domain and range will be the RealTupleType of the set (i.e. ((SetType)set.getType()).getDomain(). The CoordinateSystem of the range will be that of the set (i.e. set.getCoordinateSystem()).

Throws:

visad.VisADException - Couldn't create necessary VisAD object.

java.rmi.RemoteException - Java RMI failure.

newFlatField

public static visad.FlatField newFlatField(visad.SampledSet set,
                                           visad.MathType rangeType,
                                           visad.CoordinateSystem rangeCoordinateSystem)
                                    throws visad.VisADException,
                                           java.rmi.RemoteException

Creates a FlatField from a SampledSet, a MathType for the range, and a CoordinateSystem for the range. This method should, perhaps, become a method in visad.Set or a constructor in FlatField.

Parameters:

set - The SampledSet.

rangeType - The MathType of the range for the returned FlatField.

rangeCoordinateSystem - The CoordinateSystem for the range of the returned FlatField. May be null.

Returns:

The SampledSet promoted to a FlatField. The MathType of the domain will be the RealTupleType of the set (i.e. ((SetType)set.getType()).getDomain().

Throws:

visad.VisADException - Couldn't create necessary VisAD object.

java.rmi.RemoteException - Java RMI failure.

newFlatField

public static visad.FlatField newFlatField(visad.SampledSet domain,
                                           visad.SampledSet range,
                                           visad.MathType rangeType,
                                           visad.CoordinateSystem rangeCoordinateSystem)
                                    throws visad.VisADException,
                                           java.rmi.RemoteException

Creates a FlatField from a domain SampledSet, a range SampledSet, and a CoordinateSystem for the range. This method should, perhaps, become a method in visad.Set or a constructor in FlatField.

Parameters:

domain - The domain SampledSet.

range - The range SampledSet.

rangeType - The MathType of the range for the returned FlatField.

rangeCoordinateSystem - The CoordinateSystem for the range of the returned FlatField. May be null.

Returns:

The SampledSet promoted to a FlatField. The MathType of the domain will be the RealTupleType of the set (i.e. ((SetType)set.getType()).getDomain().

Throws:

visad.VisADException - Couldn't create necessary VisAD object.

java.rmi.RemoteException - Java RMI failure.

main

public static void main(java.lang.String[] args)
                 throws visad.VisADException,
                        java.rmi.RemoteException

Tests this class.

Parameters:

args - Ignored.

Throws:

visad.VisADException - if a core VisAD failure occurs.

java.rmi.RemoteException - if a Java RMI failure occurs.