ucar.visad.quantities

Class GeopotentialAltitude

java.lang.Object

ucar.visad.quantities.Quantity

ucar.visad.quantities.ScalarQuantity

ucar.visad.quantities.GeopotentialAltitude

public final class GeopotentialAltitude
extends ScalarQuantity

Provides support for the quantity of geopotential altitude.

Version:

$Id: GeopotentialAltitude.java,v 1.15 2006/10/09 14:49:16 dmurray Exp $

Author:

Steven R. Emmerson

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GeopotentialAltitude.GeopotentialCoordinateSystem Provides support for coordinate system transformations between geopotential altitude and altitude.

Method Summary

Modifier and Type	Method and Description
static visad.Data	fromAltitude(visad.Data altitude) Converts altitude to geopotential altitude.
static visad.Data	fromAltitude(visad.Data altitude, visad.Real gravity) Converts altitude to geopotential altitude based on a value for gravity.
static visad.Unit	getGeopotentialMeter() Gets the geopotential meter unit.
static visad.Unit	getGeopotentialUnit(visad.Unit altUnit) Returns the standard geopotential altitude unit corresponding to an altitude unit.
static visad.Unit	getGeopotentialUnit(visad.Unit altUnit, visad.Real gravity) Returns the geopotential altitude unit corresponding to an altitude unit and gravity.
static visad.RealTupleType	getRealTupleType() Obtains the RealTupleType associated with this class.
static visad.RealType	getRealType() Obtains the RealType associated with this class.
static visad.Data	toAltitude(visad.Data geopotentialAltitude) Converts from geopotential altitude to altitude.
static visad.Data	toAltitude(visad.Data geopotentialAltitude, visad.Real gravity) Converts from geopotential altitude to altitude.
static double[]	toAltitude(double[] geoAlts, visad.Unit geoUnit, visad.Real gravity, double[] altitudes, visad.Unit altUnit) Converts from geopotential altitude to altitude.
static double[]	toAltitude(double[] geoAlts, visad.Unit geoUnit, visad.Real gravity, double[] altitudes, visad.Unit altUnit, boolean copy) Converts from geopotential altitude to altitude.
static float[]	toAltitude(float[] geoAlts, visad.Unit geoUnit, visad.Real gravity, float[] altitudes, visad.Unit altUnit) Converts from geopotential altitude to altitude.
static float[]	toAltitude(float[] geoAlts, visad.Unit geoUnit, visad.Real gravity, float[] altitudes, visad.Unit altUnit, boolean copy) Converts from geopotential altitude to altitude.
static double[]	toGeopotentialAltitude(double[] altitudes, visad.Unit altUnit, visad.Real gravity, double[] geoAlts, visad.Unit geoUnit) Converts from altitude to geopotential altitude.
static double[]	toGeopotentialAltitude(double[] altitudes, visad.Unit altUnit, visad.Real gravity, double[] geoAlts, visad.Unit geoUnit, boolean copy) Converts from altitude to geopotential altitude.
static float[]	toGeopotentialAltitude(float[] altitudes, visad.Unit altUnit, visad.Real gravity, float[] geoAlts, visad.Unit geoUnit) Converts from altitude to geopotential altitude.
static float[]	toGeopotentialAltitude(float[] altitudes, visad.Unit altUnit, visad.Real gravity, float[] geoAlts, visad.Unit geoUnit, boolean copy) Converts from altitude to geopotential altitude.

Methods inherited from class ucar.visad.quantities.ScalarQuantity

getRealType, getRealType, realType

Methods inherited from class ucar.visad.quantities.Quantity

realTupleType, setRealTupleType

Methods inherited from class java.lang.Object

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

Method Detail

getGeopotentialMeter

public static visad.Unit getGeopotentialMeter()
                                       throws visad.VisADException

Gets the geopotential meter unit.

Returns:

A geopotential meter unit.

Throws:

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

getRealType

public static visad.RealType getRealType()
                                  throws visad.VisADException

Obtains the RealType associated with this class.

Returns:

The RealType associated with this class.

Throws:

visad.VisADException - Couldn't perform necessary VisAD operation.

getRealTupleType

public static visad.RealTupleType getRealTupleType()
                                            throws visad.VisADException

Obtains the RealTupleType associated with this class.

Returns:

The RealTupleType associated with this class.

Throws:

visad.VisADException - Couldn't perform necessary VisAD operation.

fromAltitude

public static visad.Data fromAltitude(visad.Data altitude)
                               throws visad.VisADException,
                                      java.rmi.RemoteException

Converts altitude to geopotential altitude.

Parameters:

altitude - The altitude data object.

Returns:

The equivalent geopotential altitude data object.

Throws:

visad.VisADException - if a core VisAD failure occurs.

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

fromAltitude

public static visad.Data fromAltitude(visad.Data altitude,
                                      visad.Real gravity)
                               throws visad.VisADException,
                                      java.rmi.RemoteException

Converts altitude to geopotential altitude based on a value for gravity.

Parameters:

altitude - The altitude data object.

gravity - The value for gravity.

Returns:

The equivalent geopotential altitude data object.

Throws:

visad.VisADException - if a core VisAD failure occurs.

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

toAltitude

public static visad.Data toAltitude(visad.Data geopotentialAltitude,
                                    visad.Real gravity)
                             throws visad.VisADException,
                                    java.rmi.RemoteException

Converts from geopotential altitude to altitude.

Parameters:

geopotentialAltitude - Geopotential altitude.

gravity - Gravity.

Returns:

Altitude. The type of the object will be that of the arguments after standard promotion.

Throws:

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

java.rmi.RemoteException - Java RMI failure.

See Also:

VisADMath

toAltitude

public static visad.Data toAltitude(visad.Data geopotentialAltitude)
                             throws visad.VisADException,
                                    java.rmi.RemoteException

Converts from geopotential altitude to altitude.

Parameters:

geopotentialAltitude - Geopotential altitude.

Returns:

Altitude. The type of the object will be that of the arguments after standard promotion.

Throws:

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

java.rmi.RemoteException - Java RMI failure.

See Also:

VisADMath

toAltitude

public static double[] toAltitude(double[] geoAlts,
                                  visad.Unit geoUnit,
                                  visad.Real gravity,
                                  double[] altitudes,
                                  visad.Unit altUnit)
                           throws visad.VisADException,
                                  java.rmi.RemoteException

Converts from geopotential altitude to altitude.

Parameters:

geoAlts - Geopotential altitudes in units of geoUnit.

geoUnit - The unit of geopotential altitude.

gravity - Gravity.

altitudes - Altitudes in units of altUnit. Its length shall be at least geoAlts.length. It may be the same array as geoAlts.

altUnit - The unit of altitude.

Returns:

altitudes (as a convenience).

Throws:

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

java.rmi.RemoteException - Java RMI failure.

toAltitude

public static double[] toAltitude(double[] geoAlts,
                                  visad.Unit geoUnit,
                                  visad.Real gravity,
                                  double[] altitudes,
                                  visad.Unit altUnit,
                                  boolean copy)
                           throws visad.VisADException,
                                  java.rmi.RemoteException

Converts from geopotential altitude to altitude.

Parameters:

geoAlts - Geopotential altitudes in units of geoUnit.

geoUnit - The unit of geopotential altitude.

gravity - Gravity.

altitudes - Altitudes in units of altUnit. Its length shall be at least geoAlts.length. It may be the same array as geoAlts.

altUnit - The unit of altitude.

copy - if true, a new copy of the array will be made

Returns:

altitudes (as a convenience).

Throws:

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

java.rmi.RemoteException - Java RMI failure.

toAltitude

public static float[] toAltitude(float[] geoAlts,
                                 visad.Unit geoUnit,
                                 visad.Real gravity,
                                 float[] altitudes,
                                 visad.Unit altUnit)
                          throws visad.VisADException,
                                 java.rmi.RemoteException

Converts from geopotential altitude to altitude.

Parameters:

geoAlts - Geopotential altitudes in units of geoUnit.

geoUnit - The unit of geopotential altitude.

gravity - Gravity.

altitudes - Altitudes in units of altUnit. Its length shall be at least geoAlts.length. It may be the same array as geoAlts.

altUnit - The unit of altitude.

Returns:

altitudes (as a convenience).

Throws:

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

java.rmi.RemoteException - Java RMI failure.

toAltitude

public static float[] toAltitude(float[] geoAlts,
                                 visad.Unit geoUnit,
                                 visad.Real gravity,
                                 float[] altitudes,
                                 visad.Unit altUnit,
                                 boolean copy)
                          throws visad.VisADException,
                                 java.rmi.RemoteException

Converts from geopotential altitude to altitude.

Parameters:

geoAlts - Geopotential altitudes in units of geoUnit.

geoUnit - The unit of geopotential altitude.

gravity - Gravity.

altitudes - Altitudes in units of altUnit. Its length shall be at least geoAlts.length. It may be the same array as geoAlts.

altUnit - The unit of altitude.

copy - if true, a new copy of the array will be made

Returns:

altitudes (as a convenience).

Throws:

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

java.rmi.RemoteException - Java RMI failure.

toGeopotentialAltitude

public static double[] toGeopotentialAltitude(double[] altitudes,
                                              visad.Unit altUnit,
                                              visad.Real gravity,
                                              double[] geoAlts,
                                              visad.Unit geoUnit)
                                       throws visad.VisADException,
                                              java.rmi.RemoteException

Converts from altitude to geopotential altitude.

Parameters:

altitudes - Altitudes in units of altUnit.

altUnit - The unit of altitude.

gravity - Gravity.

geoAlts - Geopotential altitudes in units of geoUnit. Its length shall be at least altitudes.length. It may be the same array as altitudes.

geoUnit - The unit of geopotential altitude.

Returns:

geoAlts (as a convenience).

Throws:

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

java.rmi.RemoteException - Java RMI failure.

toGeopotentialAltitude

public static double[] toGeopotentialAltitude(double[] altitudes,
                                              visad.Unit altUnit,
                                              visad.Real gravity,
                                              double[] geoAlts,
                                              visad.Unit geoUnit,
                                              boolean copy)
                                       throws visad.VisADException,
                                              java.rmi.RemoteException

Converts from altitude to geopotential altitude.

Parameters:

altitudes - Altitudes in units of altUnit.

altUnit - The unit of altitude.

gravity - Gravity.

geoAlts - Geopotential altitudes in units of geoUnit. Its length shall be at least altitudes.length. It may be the same array as altitudes.

geoUnit - The unit of geopotential altitude.

copy - if true, a new copy of the array will be made

Returns:

geoAlts (as a convenience).

Throws:

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

java.rmi.RemoteException - Java RMI failure.

toGeopotentialAltitude

public static float[] toGeopotentialAltitude(float[] altitudes,
                                             visad.Unit altUnit,
                                             visad.Real gravity,
                                             float[] geoAlts,
                                             visad.Unit geoUnit)
                                      throws visad.VisADException,
                                             java.rmi.RemoteException

Converts from altitude to geopotential altitude.

Parameters:

altitudes - Altitudes in units of altUnit.

altUnit - The unit of altitude.

gravity - Gravity.

geoAlts - Geopotential altitudes in units of geoUnit. Its length shall be at least altitudes.length. It may be the same array as altitudes.

geoUnit - The unit of geopotential altitude.

Returns:

geoAlts (as a convenience).

Throws:

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

java.rmi.RemoteException - Java RMI failure.

toGeopotentialAltitude

public static float[] toGeopotentialAltitude(float[] altitudes,
                                             visad.Unit altUnit,
                                             visad.Real gravity,
                                             float[] geoAlts,
                                             visad.Unit geoUnit,
                                             boolean copy)
                                      throws visad.VisADException,
                                             java.rmi.RemoteException

Converts from altitude to geopotential altitude.

Parameters:

altitudes - Altitudes in units of altUnit.

altUnit - The unit of altitude.

gravity - Gravity.

geoAlts - Geopotential altitudes in units of geoUnit. Its length shall be at least altitudes.length. It may be the same array as altitudes.

geoUnit - The unit of geopotential altitude.

copy - if true, a new copy of the array will be made

Returns:

geoAlts (as a convenience).

Throws:

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

java.rmi.RemoteException - Java RMI failure.

getGeopotentialUnit

public static visad.Unit getGeopotentialUnit(visad.Unit altUnit)
                                      throws visad.VisADException

Returns the standard geopotential altitude unit corresponding to an altitude unit.

Parameters:

altUnit - A unit of altitude (e.g. m)

Returns:

The standard geopotential altitude unit corresponding to altUnit (e.g. gpm).

Throws:

visad.VisADException - VisAD failure.

getGeopotentialUnit

public static visad.Unit getGeopotentialUnit(visad.Unit altUnit,
                                             visad.Real gravity)
                                      throws visad.UnitException,
                                             visad.TypeException,
                                             java.rmi.RemoteException,
                                             visad.VisADException

Returns the geopotential altitude unit corresponding to an altitude unit and gravity.

Parameters:

altUnit - A unit of altitude (e.g. meter).

gravity - The value of gravity.

Returns:

The geopotential altitude unit corresponding to altUnit (e.g. geopotential meter).

Throws:

visad.UnitException - Altitude unit not a unit of length.

visad.TypeException - gravity isn't gravity.

visad.VisADException - VisAD failure.

java.rmi.RemoteException - Java RMI failure.