ucar.unidata.geoloc.vertical

Class AtmosSigma

java.lang.Object

ucar.unidata.geoloc.vertical.AtmosSigma

All Implemented Interfaces:

VerticalTransform

@Immutable
public class AtmosSigma
extends Object

Create a 3D height(z,y,x) array using the CF formula for "atmospheric sigma vertical coordinate".

pressure(x,y,z) = ptop + sigma(z)*surfacePressure(x,y)

Field Summary

Fields

Modifier and Type	Field and Description
static String	PS Surface pressure name identifier
static String	PTOP P-naught identifier
static String	SIGMA The "depth" variable name identifier
protected String	units

Method Summary

Modifier and Type	Method and Description
static AtmosSigma	create(NetcdfFile ds, Dimension timeDim, List<Parameter> params) Create a new vertical transform for Ocean S coordinates
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 (needds test!!!)
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

PTOP

public static final String PTOP

P-naught identifier

See Also:

Constant Field Values

PS

public static final String PS

Surface pressure name identifier

See Also:

Constant Field Values

SIGMA

public static final String SIGMA

The "depth" variable name identifier

See Also:

Constant Field Values

units

protected final String units

Method Detail

create

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

Create a new vertical transform for Ocean S coordinates

Parameters:

ds - 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 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 (needds test!!!)

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