ucar.unidata.geoloc.vertical

Class WRFEta

java.lang.Object

ucar.unidata.geoloc.vertical.WRFEta

All Implemented Interfaces:

VerticalTransform

@Immutable
public class WRFEta
extends Object

Models the vertical coordinate for the Weather Research and Forecast (WRF) model's vertical Eta coordinate

Field Summary

Fields

Modifier and Type	Field and Description
static String	BaseGeopotentialVariable
static String	BasePressureVariable
static String	IsStaggeredX
static String	IsStaggeredY
static String	IsStaggeredZ
static String	PerturbationGeopotentialVariable
static String	PerturbationPressureVariable
protected String	units

Method Summary

Modifier and Type	Method and Description
static WRFEta	create(NetcdfFile ds, Dimension timeDim, List<Parameter> params) Construct a vertical coordinate for WRF vertical Eta coordinate
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

BasePressureVariable

public static final String BasePressureVariable

See Also:

Constant Field Values

PerturbationPressureVariable

public static final String PerturbationPressureVariable

See Also:

Constant Field Values

BaseGeopotentialVariable

public static final String BaseGeopotentialVariable

See Also:

Constant Field Values

PerturbationGeopotentialVariable

public static final String PerturbationGeopotentialVariable

See Also:

Constant Field Values

IsStaggeredX

public static final String IsStaggeredX

See Also:

Constant Field Values

IsStaggeredY

public static final String IsStaggeredY

See Also:

Constant Field Values

IsStaggeredZ

public static final String IsStaggeredZ

See Also:

Constant Field Values

units

protected final String units

Method Detail

create

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

Construct a vertical coordinate for WRF vertical Eta coordinate

Parameters:

ds - netCDF 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

Get the 3D vertical coordinate array for this time step.

Specified by:

getCoordinateArray in interface VerticalTransform

Parameters:

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

Returns:

vertical coordinate array

Throws:

IOException - problem reading 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