ucar.unidata.geoloc.vertical

Class HybridSigmaPressure

java.lang.Object

ucar.unidata.geoloc.vertical.HybridSigmaPressure

All Implemented Interfaces:

VerticalTransform

@Immutable
public class HybridSigmaPressure
extends Object

Create a 3D height(z,y,x) array using the netCDF CF convention formula for "atmosphere_hybrid_sigma_pressure_coordinate".

pressure(x,y,z) = a(z)*p0 + b(z)*surfacePressure(x,y) or

pressure(x,y,z) = ap(z) + b(z)*surfacePressure(x,y)

See Also:

"http://cfconventions.org/Data/cf-conventions/cf-conventions-1.8/cf-conventions.html#_atmosphere_hybrid_sigma_pressure_coordinate"

Field Summary

Fields

Modifier and Type	Field and Description
static String	A The "a" variable name identifier
static String	AP The "ap" variable name identifier
static String	B The "b" variable name identifier
static String	P0 P-naught identifier
static String	PS Surface pressure name identifier
protected String	units

Method Summary

Modifier and Type	Method and Description
static HybridSigmaPressure	create(NetcdfFile ds, Dimension timeDim, List<Parameter> params) Construct a coordinate transform for sigma pressure
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

P0

public static final String P0

P-naught identifier

See Also:

Constant Field Values

PS

public static final String PS

Surface pressure name identifier

See Also:

Constant Field Values

A

public static final String A

The "a" variable name identifier

See Also:

Constant Field Values

AP

public static final String AP

The "ap" variable name identifier

See Also:

Constant Field Values

B

public static final String B

The "b" variable name identifier

See Also:

Constant Field Values

units

protected final String units

Method Detail

create

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

Construct a coordinate transform for sigma pressure

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 - _more_

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