ucar.unidata.geoloc.vertical

Class VTfromExistingData

java.lang.Object

ucar.unidata.geoloc.vertical.VTfromExistingData

All Implemented Interfaces:

VerticalTransform

@Immutable
public class VTfromExistingData
extends Object

This implements a VerticalTransform using an existing 3D variable. This is a common case when the 3D pressure or height field is stored in the file.

Field Summary

Fields

Modifier and Type	Field and Description
static String	existingDataField The name of the Parameter whose value is the variable that contains the 2D Height or Pressure field
protected String	units

Method Summary

Modifier and Type	Method and Description
static VTfromExistingData	create(NetcdfFile ds, Dimension timeDim, List<Parameter> params) Constructor.
ArrayDouble.D3	getCoordinateArray(int timeIndex) Get the 3D vertical coordinate array for this time step.
ArrayDouble.D1	getCoordinateArray1D(int timeIndex, int xIndex, int yIndex) Get the 1D vertical coordinate array for this time step and point
protected Dimension	getTimeDimension() Get the time Dimension, if it exists
String	getUnitString() Get the unit string for the vertical coordinate.
boolean	isTimeDependent() Get whether this coordinate is time dependent.
VerticalTransform	subset(Range t_range, Range z_range, Range y_range, Range x_range) Create a VerticalTransform as a section of an existing VerticalTransform.

Methods inherited from class java.lang.Object

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

Field Detail

existingDataField

public static final String existingDataField

The name of the Parameter whose value is the variable that contains the 2D Height or Pressure field

See Also:

Constant Field Values

units

protected final String units

Method Detail

create

public static VTfromExistingData create(NetcdfFile ds,
                                        Dimension timeDim,
                                        List<Parameter> params)

Constructor.

Parameters:

ds - containing Dataset

timeDim - time Dimension

params - list of transformation Parameters TODO: params will change to AttributeContainer in ver7.

getCoordinateArray

public ArrayDouble.D3 getCoordinateArray(int timeIndex)
                                  throws IOException,
                                         InvalidRangeException

Description copied from interface: VerticalTransform

Get the 3D vertical coordinate array for this time step. Must be in "canonical order" : z, y, x.

Specified by:

getCoordinateArray in interface VerticalTransform

Parameters:

timeIndex - the time index. Ignored if !isTimeDependent().

Returns:

vertical coordinate array

Throws:

IOException - problem reading the data

InvalidRangeException - timeIndex out of bounds

getCoordinateArray1D

public ArrayDouble.D1 getCoordinateArray1D(int timeIndex,
                                           int xIndex,
                                           int yIndex)
                                    throws IOException,
                                           InvalidRangeException

Get the 1D vertical coordinate array for this time step and point

Specified by:

getCoordinateArray1D in interface VerticalTransform

Parameters:

timeIndex - the time index. Ignored if !isTimeDependent().

xIndex - the x index

yIndex - the y index

Returns:

vertical coordinate array

Throws:

IOException - problem reading data

InvalidRangeException - _more_

getUnitString

@Nullable
public String getUnitString()

Description copied from interface: VerticalTransform

Get the unit string for the vertical coordinate.

Specified by:

getUnitString in interface VerticalTransform

isTimeDependent

public boolean isTimeDependent()

Description copied from interface: VerticalTransform

Get whether this coordinate is time dependent.

Specified by:

isTimeDependent in interface VerticalTransform

getTimeDimension

protected Dimension getTimeDimension()

Get the time Dimension, if it exists

subset

public VerticalTransform subset(Range t_range,
                                Range z_range,
                                Range y_range,
                                Range x_range)

Description copied from interface: VerticalTransform

Create a VerticalTransform as a section of an existing VerticalTransform.

Specified by:

subset in interface VerticalTransform

Parameters:

t_range - subset the time dimension, or null if you want all of it

z_range - subset the vertical dimension, or null if you want all of it

y_range - subset the y dimension, or null if you want all of it

x_range - subset the x dimension, or null if you want all of it

Returns:

a new VerticalTransform for the given subset