ucar.nc2.ft.point

Class StationTimeSeriesCollectionImpl

java.lang.Object

ucar.nc2.ft.point.DsgCollectionImpl

ucar.nc2.ft.point.PointFeatureCCImpl

ucar.nc2.ft.point.StationTimeSeriesCollectionImpl

All Implemented Interfaces:

java.lang.Iterable<StationTimeSeriesFeature>, DsgFeatureCollection, PointFeatureCC, StationTimeSeriesFeatureCollection

Direct Known Subclasses:

CompositeStationCollection, StandardStationCollectionImpl, StationCollectionStream

public abstract class StationTimeSeriesCollectionImpl
extends PointFeatureCCImpl
implements StationTimeSeriesFeatureCollection

Abstract superclass for implementations of StationFeatureCollection. Subclass must supply createStationHelper, may need to override getPointFeatureCollectionIterator().

Since:

Feb 5, 2008

Field Summary

Fields

Modifier and Type	Field and Description
protected PointFeatureCollectionIterator	localIterator

Fields inherited from class ucar.nc2.ft.point.PointFeatureCCImpl

collectionFeatureType

Fields inherited from class ucar.nc2.ft.point.DsgCollectionImpl

altUnits, extras, info, name, timeUnit

Constructor Summary

Constructors

Constructor and Description
StationTimeSeriesCollectionImpl(java.lang.String name, CalendarDateUnit timeUnit, java.lang.String altUnits)

Method Summary

Modifier and Type	Method and Description
protected abstract StationHelper	createStationHelper()
StationFeature	findStationFeature(java.lang.String name)
void	finish() Make sure that the internal iterator is complete, and recover resources.
PointFeatureCollection	flatten(LatLonRect boundingBox, CalendarDateRange dateRange)
PointFeatureCollection	flatten(java.util.List<java.lang.String> stationNames, CalendarDateRange dateRange, java.util.List<VariableSimpleIF> varList) Flatten into a PointFeatureCollection, discarding connectedness information.
LatLonRect	getBoundingBox() The boundingBox for the FeatureCollection.
IOIterator<PointFeatureCollection>	getCollectionIterator() General way to handle iterations on all classes that implement this interface.
PointFeatureCollectionIterator	getPointFeatureCollectionIterator()
StationFeature	getStationFeature(PointFeature flatPointFeature)
java.util.List<StationFeature>	getStationFeatures()
java.util.List<StationFeature>	getStationFeatures(LatLonRect boundingBox)
java.util.List<StationFeature>	getStationFeatures(java.util.List<java.lang.String> stnNames)
protected StationHelper	getStationHelper()
StationTimeSeriesFeature	getStationTimeSeriesFeature(StationFeature s)
boolean	hasNext() Use the internal iterator to check if there is another StationTimeSeriesFeature in the iteration.
java.util.Iterator<StationTimeSeriesFeature>	iterator()
StationTimeSeriesFeature	next() Use the internal iterator to get the next StationTimeSeriesFeature in the iteration.
void	resetIteration() Reset the internal iterator for another iteration over the StationTimeSeriesFeatures in this Collection.
StationTimeSeriesFeatureCollection	subset(LatLonRect boundingBox)
StationTimeSeriesFeatureCollection	subset(LatLonRect boundingBox, CalendarDateRange dateRange)
StationTimeSeriesFeatureCollection	subset(java.util.List<StationFeature> stations)
StationTimeSeriesFeatureCollection	subset(java.util.List<StationFeature> stnsWanted, CalendarDateRange dateRange)
StationTimeSeriesFeatureCollection	subsetFeatures(java.util.List<StationFeature> stationsFeatures)

Methods inherited from class ucar.nc2.ft.point.PointFeatureCCImpl

getCollectionFeatureType

Methods inherited from class ucar.nc2.ft.point.DsgCollectionImpl

getAltUnits, getCalendarDateRange, getExtraVariables, getInfo, getName, getNobs, getTimeUnit, size

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.DsgFeatureCollection

getAltUnits, getCalendarDateRange, getCollectionFeatureType, getExtraVariables, getName, getTimeUnit, size

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

localIterator

protected PointFeatureCollectionIterator localIterator

Constructor Detail

StationTimeSeriesCollectionImpl

public StationTimeSeriesCollectionImpl(java.lang.String name,
                                       CalendarDateUnit timeUnit,
                                       java.lang.String altUnits)

Method Detail

getStationHelper

protected StationHelper getStationHelper()

createStationHelper

protected abstract StationHelper createStationHelper()
                                              throws java.io.IOException

Throws:

java.io.IOException

getBoundingBox

public LatLonRect getBoundingBox()

Description copied from interface: DsgFeatureCollection

The boundingBox for the FeatureCollection. May not be known until after iterating through the collection.

Specified by:

getBoundingBox in interface DsgFeatureCollection

Overrides:

getBoundingBox in class DsgCollectionImpl

Returns:

the lat/lon boundingBox for the entire collection, or null if unknown.

getStationFeatures

public java.util.List<StationFeature> getStationFeatures()
                                                  throws java.io.IOException

Specified by:

getStationFeatures in interface StationTimeSeriesFeatureCollection

Throws:

java.io.IOException

getStationFeatures

public java.util.List<StationFeature> getStationFeatures(java.util.List<java.lang.String> stnNames)

Specified by:

getStationFeatures in interface StationTimeSeriesFeatureCollection

getStationFeatures

public java.util.List<StationFeature> getStationFeatures(LatLonRect boundingBox)
                                                  throws java.io.IOException

Specified by:

getStationFeatures in interface StationTimeSeriesFeatureCollection

Throws:

java.io.IOException

findStationFeature

public StationFeature findStationFeature(java.lang.String name)

Specified by:

findStationFeature in interface StationTimeSeriesFeatureCollection

getStationTimeSeriesFeature

public StationTimeSeriesFeature getStationTimeSeriesFeature(StationFeature s)

Specified by:

getStationTimeSeriesFeature in interface StationTimeSeriesFeatureCollection

subset

public StationTimeSeriesFeatureCollection subset(LatLonRect boundingBox)
                                          throws java.io.IOException

Specified by:

subset in interface StationTimeSeriesFeatureCollection

Throws:

java.io.IOException

subset

public StationTimeSeriesFeatureCollection subset(LatLonRect boundingBox,
                                                 CalendarDateRange dateRange)
                                          throws java.io.IOException

Specified by:

subset in interface StationTimeSeriesFeatureCollection

Throws:

java.io.IOException

subset

public StationTimeSeriesFeatureCollection subset(java.util.List<StationFeature> stations)
                                          throws java.io.IOException

Specified by:

subset in interface StationTimeSeriesFeatureCollection

Throws:

java.io.IOException

subset

public StationTimeSeriesFeatureCollection subset(java.util.List<StationFeature> stnsWanted,
                                                 CalendarDateRange dateRange)
                                          throws java.io.IOException

Specified by:

subset in interface StationTimeSeriesFeatureCollection

Throws:

java.io.IOException

subsetFeatures

public StationTimeSeriesFeatureCollection subsetFeatures(java.util.List<StationFeature> stationsFeatures)
                                                  throws java.io.IOException

Specified by:

subsetFeatures in interface StationTimeSeriesFeatureCollection

Throws:

java.io.IOException

flatten

public PointFeatureCollection flatten(java.util.List<java.lang.String> stationNames,
                                      CalendarDateRange dateRange,
                                      java.util.List<VariableSimpleIF> varList)
                               throws java.io.IOException

Description copied from interface: StationTimeSeriesFeatureCollection

Flatten into a PointFeatureCollection, discarding connectedness information.

Specified by:

flatten in interface StationTimeSeriesFeatureCollection

Parameters:

stationNames - only contain these stations; if null or empty use all

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

varList - only these member variables. may be null. currently ignored

Returns:

a PointFeatureCollection, may be null if its empty.

Throws:

java.io.IOException - on read error

flatten

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

Specified by:

flatten in interface StationTimeSeriesFeatureCollection

Throws:

java.io.IOException

getStationFeature

public StationFeature getStationFeature(PointFeature flatPointFeature)
                                 throws java.io.IOException

Specified by:

getStationFeature in interface StationTimeSeriesFeatureCollection

Throws:

java.io.IOException

iterator

public java.util.Iterator<StationTimeSeriesFeature> iterator()

Specified by:

iterator in interface java.lang.Iterable<StationTimeSeriesFeature>

getCollectionIterator

public IOIterator<PointFeatureCollection> getCollectionIterator()
                                                         throws java.io.IOException

Description copied from interface: PointFeatureCC

General way to handle iterations on all classes that implement this interface. Generally, one uses class specific foreach

Specified by:

getCollectionIterator in interface PointFeatureCC

Returns:

Iterator over PointFeatureCollection which may throw an IOException

Throws:

java.io.IOException

getPointFeatureCollectionIterator

public PointFeatureCollectionIterator getPointFeatureCollectionIterator()
                                                                 throws java.io.IOException

Specified by:

getPointFeatureCollectionIterator in interface StationTimeSeriesFeatureCollection

Throws:

java.io.IOException

hasNext

public boolean hasNext()
                throws java.io.IOException

Description copied from interface: StationTimeSeriesFeatureCollection

Use the internal iterator to check if there is another StationTimeSeriesFeature in the iteration.

Specified by:

hasNext in interface StationTimeSeriesFeatureCollection

Returns:

true is there is another StationTimeSeriesFeature in the iteration.

Throws:

java.io.IOException - on read error

finish

public void finish()

Description copied from interface: StationTimeSeriesFeatureCollection

Make sure that the internal iterator is complete, and recover resources. You must complete the iteration (until hasNext() returns false) or call finish().

Specified by:

finish in interface StationTimeSeriesFeatureCollection

See Also:

PointFeatureIterator.close()

next

public StationTimeSeriesFeature next()
                              throws java.io.IOException

Description copied from interface: StationTimeSeriesFeatureCollection

Use the internal iterator to get the next StationTimeSeriesFeature in the iteration. You must call hasNext() before you call this.

Specified by:

next in interface StationTimeSeriesFeatureCollection

Returns:

the next StationTimeSeriesFeature in the iteration

Throws:

java.io.IOException - on read error

resetIteration

public void resetIteration()
                    throws java.io.IOException

Description copied from interface: StationTimeSeriesFeatureCollection

Reset the internal iterator for another iteration over the StationTimeSeriesFeatures in this Collection.

Specified by:

resetIteration in interface StationTimeSeriesFeatureCollection

Throws:

java.io.IOException - on read error