ucar.nc2.ft.point

Class StationTimeSeriesCollectionImpl

java.lang.Object

ucar.nc2.ft.point.OneNestedPointCollectionImpl

ucar.nc2.ft.point.StationTimeSeriesCollectionImpl

All Implemented Interfaces:

FeatureCollection, NestedPointFeatureCollection, StationCollection, StationTimeSeriesFeatureCollection

Direct Known Subclasses:

CompositeStationCollection, RemoteStationCollection, StandardStationCollectionImpl

public abstract class StationTimeSeriesCollectionImpl
extends OneNestedPointCollectionImpl
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.OneNestedPointCollectionImpl

altUnits, collectionFeatureType, extras, name, npts, timeUnit

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
protected abstract StationHelper	createStationHelper()
void	finish() Make sure that the internal iterator is complete, and recover resources.
PointFeatureCollection	flatten(LatLonRect boundingBox, CalendarDateRange dateRange) Flatten into a PointFeatureCollection, discarding connectedness information.
PointFeatureCollection	flatten(java.util.List<java.lang.String> stationNames, CalendarDateRange dateRange, java.util.List<VariableSimpleIF> varList) Flatten into a PointFeatureCollection, discarding connectedness information.
PointFeatureCollection	flatten(java.util.List<java.lang.String> stations, DateRange dateRange, java.util.List<VariableSimpleIF> varList) Flatten into a PointFeatureCollection, discarding connectedness information.
LatLonRect	getBoundingBox() Get the bounding box including all the stations.
NestedPointFeatureCollectionIterator	getNestedPointFeatureCollectionIterator(int bufferSize) Iterate through the collection, composed of NestedPointFeatureCollection.
PointFeatureCollectionIterator	getPointFeatureCollectionIterator(int bufferSize) Iterate through the collection, composed of PointFeatureCollection.
Station	getStation(PointFeature feature) Get the station that belongs to this feature
Station	getStation(java.lang.String name) Find a Station by name.
StationTimeSeriesFeature	getStationFeature(Station s) Get the collection of data for a particular Station.
java.util.List<StationFeature>	getStationFeatures() Get list of stations as StationFeatures
java.util.List<StationFeature>	getStationFeatures(LatLonRect boundingBox)
java.util.List<StationFeature>	getStationFeatures(java.util.List<java.lang.String> stnNames)
protected StationHelper	getStationHelper()
java.util.List<Station>	getStations() Get all the Stations in the collection.
java.util.List<Station>	getStations(LatLonRect boundingBox) Get all the Stations within a bounding box.
java.util.List<Station>	getStations(java.util.List<java.lang.String> stnNames) Translate list of station names to list of Stations.
boolean	hasNext() Use the internal iterator to check if there is another StationTimeSeriesFeature in the iteration.
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) Get a subsetted StationCollection from a LatLonRect
StationTimeSeriesFeatureCollection	subset(java.util.List<Station> stations) Get a subsetted StationCollection based on a list of Stations.
StationTimeSeriesFeatureCollection	subsetFeatures(java.util.List<StationFeature> stationsFeatures) Get a subsetted StationCollection based on a list of Stations.

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

flatten, getAltUnits, getCollectionFeatureType, getExtraVariables, getName, getTimeUnit, isMultipleNested, setSize, 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.NestedPointFeatureCollection

flatten, getAltUnits, getExtraVariables, getTimeUnit, isMultipleNested, size

Methods inherited from interface ucar.nc2.ft.FeatureCollection

getCollectionFeatureType, getName

Field Detail

localIterator

protected PointFeatureCollectionIterator localIterator

Constructor Detail

StationTimeSeriesCollectionImpl

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

Method Detail

getStationHelper

protected StationHelper getStationHelper()

createStationHelper

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

Throws:

java.io.IOException

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

getStationFeature

public StationTimeSeriesFeature getStationFeature(Station s)
                                           throws java.io.IOException

Description copied from interface: StationTimeSeriesFeatureCollection

Get the collection of data for a particular Station.

Specified by:

getStationFeature in interface StationTimeSeriesFeatureCollection

Parameters:

s - get data for this station, must have come from this Collection

Returns:

collection of data for this Station.

Throws:

java.io.IOException - on i/o error

getStation

public Station getStation(PointFeature feature)
                   throws java.io.IOException

Description copied from interface: StationTimeSeriesFeatureCollection

Get the station that belongs to this feature

Specified by:

getStation in interface StationTimeSeriesFeatureCollection

Parameters:

feature - PointFeature obtained from a StationTimeSeriesFeature in this collection

Returns:

the Station is belongs to

Throws:

java.io.IOException - on i/o error

getStationFeatures

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

Description copied from interface: StationTimeSeriesFeatureCollection

Get list of stations as StationFeatures

Specified by:

getStationFeatures in interface StationTimeSeriesFeatureCollection

Returns:

list of stations as StationFeatures

Throws:

java.io.IOException - on i/o error

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

subset

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

Description copied from interface: StationTimeSeriesFeatureCollection

Get a subsetted StationCollection from a LatLonRect

Specified by:

subset in interface NestedPointFeatureCollection

Specified by:

subset in interface StationTimeSeriesFeatureCollection

Parameters:

boundingBox - spatial subset. may be null

Returns:

subsetted collection

Throws:

java.io.IOException - on i/o error

subset

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

Description copied from interface: StationTimeSeriesFeatureCollection

Get a subsetted StationCollection based on a list of Stations.

Specified by:

subset in interface StationTimeSeriesFeatureCollection

Parameters:

stations - only contain these stations

Returns:

subsetted collection

Throws:

java.io.IOException - on i/o error

subsetFeatures

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

Description copied from interface: StationTimeSeriesFeatureCollection

Get a subsetted StationCollection based on a list of Stations.

Specified by:

subsetFeatures in interface StationTimeSeriesFeatureCollection

Parameters:

stationsFeatures - only contain these stations

Returns:

subsetted collection

Throws:

java.io.IOException - on i/o error

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

Description copied from interface: NestedPointFeatureCollection

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

Specified by:

flatten in interface NestedPointFeatureCollection

Overrides:

flatten in class OneNestedPointCollectionImpl

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(java.util.List<java.lang.String> stations,
                                      DateRange 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:

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

getStations

public java.util.List<Station> getStations()

Description copied from interface: StationCollection

Get all the Stations in the collection.

Specified by:

getStations in interface StationCollection

Returns:

List of Station

getStations

public java.util.List<Station> getStations(java.util.List<java.lang.String> stnNames)

Description copied from interface: StationCollection

Translate list of station names to list of Stations. Skip any not found

Specified by:

getStations in interface StationCollection

Parameters:

stnNames - list of stnNames

Returns:

corresponding list of Stations

getStations

public java.util.List<Station> getStations(LatLonRect boundingBox)
                                    throws java.io.IOException

Description copied from interface: StationCollection

Get all the Stations within a bounding box.

Specified by:

getStations in interface StationCollection

Parameters:

boundingBox - spatial subset

Returns:

List of Station

Throws:

java.io.IOException - on i/o error

getStation

public Station getStation(java.lang.String name)

Description copied from interface: StationCollection

Find a Station by name.

Specified by:

getStation in interface StationCollection

Parameters:

name - name/id of the station

Returns:

Station or null if not found

getBoundingBox

public LatLonRect getBoundingBox()

Description copied from interface: StationCollection

Get the bounding box including all the stations.

Specified by:

getBoundingBox in interface StationCollection

Returns:

bounding box as a LatLonRect

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

Overrides:

getNestedPointFeatureCollectionIterator in class OneNestedPointCollectionImpl

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

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.finish()

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