ucar.nc2

Class Dimension

java.lang.Object

ucar.nc2.CDMNode

ucar.nc2.Dimension

All Implemented Interfaces:

Comparable

public class Dimension
extends CDMNode
implements Comparable

A Dimension is used to define the array shape of a Variable. It may be shared among Variables, which provides a simple yet powerful way of associating Variables. When a Dimension is shared, it has a unique name within its Group. It may have a coordinate Variable, which gives each index a coordinate value. A private Dimension cannot have a coordinate Variable, so use shared dimensions with coordinates when possible. The Dimension length must be > 0, except for an unlimited dimension which may have length = 0, and a vlen Dimension has length = -1.

Immutable if setImmutable() was called, except for an Unlimited Dimension, whose size can change.

Author:

caron

Field Summary

Fields

Modifier and Type	Field and Description
static Dimension	VLEN A variable-length dimension: the length is not known until the data is read.

Constructor Summary

Constructors

Constructor and Description
Dimension(String name, Dimension from) Copy Constructor.
Dimension(String name, int length) Constructor
Dimension(String name, int length, boolean isShared) Constructor
Dimension(String name, int length, boolean isShared, boolean isUnlimited, boolean isVariableLength) Constructor

Method Summary

Methods

Modifier and Type	Method and Description
void	addCoordinateVariable(Variable v) Deprecated. - do not use
int	compareTo(Object o) Dimensions with the same name are equal.
boolean	equals(Object oo) Instances which have same contents are equal.
List<Variable>	getCoordinateVariables() Deprecated. - do not use
Group	getGroup() Get the Group that owns this Dimension.
int	getLength() Get the length of the Dimension.
int	hashCode() Override Object.hashCode() to implement equals.
boolean	isShared() If this Dimension is shared, or is private to a Variable.
boolean	isUnlimited() If unlimited, then the length can increase; otherwise it is immutable.
boolean	isVariableLength() If variable length, then the length is unknown until the data is read.
static String	makeDimensionList(List<Dimension> dimList)
String	makeFullName()
void	setGroup(Group g) Set the group
Dimension	setImmutable() Make this immutable.
void	setLength(int n) Set the Dimension length.
String	setName(String name) Set the name, converting to valid CDM object name if needed.
void	setShared(boolean b) Set whether this is shared.
void	setUnlimited(boolean b) Set whether this is unlimited, meaning length can increase.
void	setVariableLength(boolean b) Set whether the length is variable.
String	toString() CDL representation, not strict.
String	writeCDL(boolean strict) CDL representation.
protected void	writeCDL(Formatter out, Indent indent, boolean strict)

Methods inherited from class ucar.nc2.CDMNode

getDODSName, getFullName, getFullNameEscaped, getImmutable, getName, getParentGroup, getParentStructure, getShortName, getSort, isMemberOfStructure, setDODSName, setImmutable, setParentGroup, setParentStructure, setShortName, setSort

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

VLEN

public static Dimension VLEN

A variable-length dimension: the length is not known until the data is read.

Constructor Detail

Dimension

public Dimension(String name,
         int length)

Constructor

Parameters:

name - name must be unique within group

length - length of Dimension

Dimension

public Dimension(String name,
         int length,
         boolean isShared)

Constructor

Parameters:

name - name must be unique within group

length - length, or UNLIMITED.length or UNKNOWN.length

isShared - whether its shared or local to Variable.

Dimension

public Dimension(String name,
         int length,
         boolean isShared,
         boolean isUnlimited,
         boolean isVariableLength)

Constructor

Parameters:

name - name must be unique within group. Can be null only if not shared.

length - length, or UNLIMITED.length or UNKNOWN.length

isShared - whether its shared or local to Variable.

isUnlimited - whether the length can grow.

isVariableLength - whether the length is unknown until the data is read.

Dimension

public Dimension(String name,
         Dimension from)

Copy Constructor. used to make global dimensions

Parameters:

name - name must be unique within group. Can be null only if not shared.

from - copy all other fields from here.

Method Detail

makeDimensionList

public static String makeDimensionList(List<Dimension> dimList)

getLength

public int getLength()

Get the length of the Dimension.

Returns:

length of Dimension

isUnlimited

public boolean isUnlimited()

If unlimited, then the length can increase; otherwise it is immutable.

Returns:

if its an "unlimited" Dimension

isVariableLength

public boolean isVariableLength()

If variable length, then the length is unknown until the data is read.

Returns:

if its a "variable length" Dimension.

isShared

public boolean isShared()

If this Dimension is shared, or is private to a Variable. All Dimensions in NetcdfFile.getDimensions() or Group.getDimensions() are shared. Dimensions in the Variable.getDimensions() may be shared or private.

Returns:

if its a "shared" Dimension.

getGroup

public Group getGroup()

Get the Group that owns this Dimension.

Overrides:

getGroup in class CDMNode

Returns:

owning group or null if !isShared

makeFullName

public String makeFullName()

equals

public boolean equals(Object oo)

Instances which have same contents are equal. Careful!! this is not object identity !!

Overrides:

equals in class Object

hashCode

public int hashCode()

Override Object.hashCode() to implement equals.

Overrides:

hashCode in class Object

toString

public String toString()

CDL representation, not strict.

Overrides:

toString in class Object

compareTo

public int compareTo(Object o)

Dimensions with the same name are equal.

Specified by:

compareTo in interface Comparable

Parameters:

o - compare to this Dimension

Returns:

0, 1, or -1

writeCDL

public String writeCDL(boolean strict)

CDL representation.

Parameters:

strict - if true, write in strict adherence to CDL definition.

Returns:

CDL representation.

writeCDL

protected void writeCDL(Formatter out,
            Indent indent,
            boolean strict)

setUnlimited

public void setUnlimited(boolean b)

Set whether this is unlimited, meaning length can increase.

Parameters:

b - true if unlimited

setVariableLength

public void setVariableLength(boolean b)

Set whether the length is variable.

Parameters:

b - true if variable length

setShared

public void setShared(boolean b)

Set whether this is shared.

Parameters:

b - true if shared

setLength

public void setLength(int n)

Set the Dimension length.

Parameters:

n - length of Dimension

setName

public String setName(String name)

Set the name, converting to valid CDM object name if needed.

Parameters:

name - set to this value

Returns:

valid CDM object name

setGroup

public void setGroup(Group g)

Set the group

Parameters:

g - parent group

setImmutable

public Dimension setImmutable()

Make this immutable.

Returns:

this

addCoordinateVariable

public void addCoordinateVariable(Variable v)

Deprecated. - do not use

Parameters:

v - coord var

getCoordinateVariables

public List<Variable> getCoordinateVariables()

Deprecated. - do not use

Use Variable cv = ncfile.findVariable(dim.getShortName()); if ((cv != null) && cv.isCoordinateVariable()) ...

Returns:

an empty list