ucar.nc2.ft.point

Class MultipleNestedPointCollectionImpl

java.lang.Object

ucar.nc2.ft.point.MultipleNestedPointCollectionImpl

All Implemented Interfaces:

FeatureCollection, NestedPointFeatureCollection

Direct Known Subclasses:

SectionCollectionImpl, StationProfileCollectionImpl

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

Abstract superclass for multiply nested NestedPointFeatureCollection Subclass must supply getNestedPointFeatureCollectionIterator().

Since:

Mar 26, 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	MultipleNestedPointCollectionImpl(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.
PointFeatureCollectionIterator	getPointFeatureCollectionIterator(int bufferSize) Iterate through the collection, composed of PointFeatureCollection.
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

getNestedPointFeatureCollectionIterator, 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

MultipleNestedPointCollectionImpl

protected MultipleNestedPointCollectionImpl(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

getPointFeatureCollectionIterator

public PointFeatureCollectionIterator getPointFeatureCollectionIterator(int bufferSize)
                                                                 throws java.io.IOException

Description copied from interface: NestedPointFeatureCollection

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

Specified by:

getPointFeatureCollectionIterator in interface NestedPointFeatureCollection

Parameters:

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

Returns:

an iterator through PointFeatureCollection objects.

Throws:

java.io.IOException - on read error

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

flatten

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

Specified by:

flatten in interface NestedPointFeatureCollection

Throws:

java.io.IOException