ucar.nc2.ft.point

Class OneNestedPointCollectionImpl

java.lang.Object

ucar.nc2.ft.point.OneNestedPointCollectionImpl

All Implemented Interfaces:

FeatureCollection, NestedPointFeatureCollection

Direct Known Subclasses:

SectionFeatureImpl, StandardProfileCollectionImpl, StandardTrajectoryCollectionImpl, StationProfileFeatureImpl, StationTimeSeriesCollectionImpl

public abstract class OneNestedPointCollectionImpl
extends java.lang.Object
implements NestedPointFeatureCollection

Abstract superclass for singly nested NestedPointFeatureCollection, such as Station, Profile, and Trajectory. Subclass must supply getPointFeatureCollectionIterator()

Since:

Mar 20, 2008

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	altUnits
protected FeatureType	collectionFeatureType
protected java.util.List<Variable>	extras
protected java.lang.String	name
protected int	npts
protected DateUnit	timeUnit

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	OneNestedPointCollectionImpl(java.lang.String name, DateUnit timeUnit, java.lang.String altUnits, FeatureType collectionFeatureType)

Method Summary

Modifier and Type	Method and Description
PointFeatureCollection	flatten(LatLonRect boundingBox, CalendarDateRange dateRange) Flatten into a PointFeatureCollection, discarding connectedness information.
PointFeatureCollection	flatten(LatLonRect boundingBox, DateRange dateRange)
java.lang.String	getAltUnits() The altitude unit string if it exists.
FeatureType	getCollectionFeatureType() All features in this collection have this feature type
java.util.List<Variable>	getExtraVariables() Other variables needed for co,pleteness, eg joined coordinate variables
java.lang.String	getName() Get the name of this feature collection.
NestedPointFeatureCollectionIterator	getNestedPointFeatureCollectionIterator(int bufferSize) Iterate through the collection, composed of NestedPointFeatureCollection.
DateUnit	getTimeUnit() The udunit time unit string.
boolean	isMultipleNested() If true, use getNestedPointFeatureCollectionIterator, otherwise use getPointFeatureCollectionIterator.
protected void	setSize(int npts)
int	size() The number of elements in the collection.

Methods inherited from class java.lang.Object

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

Methods inherited from interface ucar.nc2.ft.NestedPointFeatureCollection

getPointFeatureCollectionIterator, subset

Field Detail

name

protected java.lang.String name

timeUnit

protected DateUnit timeUnit

altUnits

protected java.lang.String altUnits

collectionFeatureType

protected FeatureType collectionFeatureType

npts

protected int npts

extras

protected java.util.List<Variable> extras

Constructor Detail

OneNestedPointCollectionImpl

protected OneNestedPointCollectionImpl(java.lang.String name,
                                       DateUnit timeUnit,
                                       java.lang.String altUnits,
                                       FeatureType collectionFeatureType)

Method Detail

getName

public java.lang.String getName()

Description copied from interface: FeatureCollection

Get the name of this feature collection.

Specified by:

getName in interface FeatureCollection

Returns:

the name of this feature collection

getTimeUnit

public DateUnit getTimeUnit()

Description copied from interface: NestedPointFeatureCollection

The udunit time unit string.

Specified by:

getTimeUnit in interface NestedPointFeatureCollection

Returns:

time unit string, may not be null

getAltUnits

public java.lang.String getAltUnits()

Description copied from interface: NestedPointFeatureCollection

The altitude unit string if it exists.

Specified by:

getAltUnits in interface NestedPointFeatureCollection

Returns:

altitude unit string, may be null

getExtraVariables

public java.util.List<Variable> getExtraVariables()

Description copied from interface: NestedPointFeatureCollection

Other variables needed for co,pleteness, eg joined coordinate variables

Specified by:

getExtraVariables in interface NestedPointFeatureCollection

Returns:

list of extra variables, may be empty not null

size

public int size()

Description copied from interface: NestedPointFeatureCollection

The number of elements in the collection. May not be known until after iterating through the collection.

Specified by:

size in interface NestedPointFeatureCollection

Returns:

number of elements in the collection, or -1 if not known.

setSize

protected void setSize(int npts)

isMultipleNested

public boolean isMultipleNested()

Description copied from interface: NestedPointFeatureCollection

If true, use getNestedPointFeatureCollectionIterator, otherwise use getPointFeatureCollectionIterator.

Specified by:

isMultipleNested in interface NestedPointFeatureCollection

Returns:

if multiple nested

getCollectionFeatureType

public FeatureType getCollectionFeatureType()

Description copied from interface: FeatureCollection

All features in this collection have this feature type

Specified by:

getCollectionFeatureType in interface FeatureCollection

Returns:

the feature type

getNestedPointFeatureCollectionIterator

public NestedPointFeatureCollectionIterator getNestedPointFeatureCollectionIterator(int bufferSize)
                                                                             throws java.io.IOException

Description copied from interface: NestedPointFeatureCollection

Iterate through the collection, composed of NestedPointFeatureCollection. Use this only if isMultipleNested() = true.

Specified by:

getNestedPointFeatureCollectionIterator in interface NestedPointFeatureCollection

Parameters:

bufferSize - how many bytes can be used to buffer data, use -1 to use default.

Returns:

an iterator through NestedPointFeatureCollection objects.

Throws:

java.io.IOException - on read error

flatten

public PointFeatureCollection flatten(LatLonRect boundingBox,
                                      DateRange dateRange)
                               throws java.io.IOException

Specified by:

flatten in interface NestedPointFeatureCollection

Throws:

java.io.IOException

flatten

public PointFeatureCollection flatten(LatLonRect boundingBox,
                                      CalendarDateRange dateRange)
                               throws java.io.IOException

Description copied from interface: NestedPointFeatureCollection

Flatten into a PointFeatureCollection, discarding connectedness information. Optionally subset.

Specified by:

flatten in interface NestedPointFeatureCollection

Parameters:

boundingBox - only points in this lat/lon bounding box. may be null.

dateRange - only points in this date range. may be null.

Returns:

a PointFeatureCollection, may be null if its empty.

Throws:

java.io.IOException - on read error