ucar.nc2.ft

Interface StationTimeSeriesFeatureCollection

All Superinterfaces:

FeatureCollection, NestedPointFeatureCollection, StationCollection

All Known Implementing Classes:

CompositeStationCollection, RemoteStationCollection, StandardStationCollectionImpl, StationTimeSeriesCollectionImpl

public interface StationTimeSeriesFeatureCollection
extends StationCollection, NestedPointFeatureCollection

A collection of StationTimeSeriesFeature.

Method Summary

Modifier and Type	Method and Description
void	finish() Make sure that the internal iterator is complete, and recover resources.
PointFeatureCollection	flatten(java.util.List<java.lang.String> stations, 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) Deprecated. use CalendarDateRange
Station	getStation(PointFeature feature) Get the station that belongs to this feature
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)
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> stations) Get a subsetted StationCollection based on a list of Stations.

Methods inherited from interface ucar.nc2.ft.StationCollection

getBoundingBox, getStation, getStations, getStations, getStations

Methods inherited from interface ucar.nc2.ft.NestedPointFeatureCollection

flatten, flatten, getAltUnits, getExtraVariables, getNestedPointFeatureCollectionIterator, getPointFeatureCollectionIterator, getTimeUnit, isMultipleNested, size

Methods inherited from interface ucar.nc2.ft.FeatureCollection

getCollectionFeatureType, getName

Method Detail

hasNext

boolean hasNext()
         throws java.io.IOException

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

Returns:

true is there is another StationTimeSeriesFeature in the iteration.

Throws:

java.io.IOException - on read error

next

StationTimeSeriesFeature next()
                       throws java.io.IOException

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

Returns:

the next StationTimeSeriesFeature in the iteration

Throws:

java.io.IOException - on read error

finish

void finish()

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

See Also:

PointFeatureIterator.finish()

resetIteration

void resetIteration()
             throws java.io.IOException

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

Throws:

java.io.IOException - on read error

subset

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

Get a subsetted StationCollection based on a list of Stations.

Parameters:

stations - only contain these stations

Returns:

subsetted collection

Throws:

java.io.IOException - on i/o error

subsetFeatures

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

Get a subsetted StationCollection based on a list of Stations.

Parameters:

stations - only contain these stations

Returns:

subsetted collection

Throws:

java.io.IOException - on i/o error

subset

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

Get a subsetted StationCollection from a LatLonRect

Specified by:

subset in interface NestedPointFeatureCollection

Parameters:

boundingBox - spatial subset. may be null

Returns:

subsetted collection

Throws:

java.io.IOException - on i/o error

getStationFeature

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

Get the collection of data for a particular Station.

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

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

Get the station that belongs to this feature

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

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

Get list of stations as StationFeatures

Returns:

list of stations as StationFeatures

Throws:

java.io.IOException - on i/o error

getStationFeatures

java.util.List<StationFeature> getStationFeatures(java.util.List<java.lang.String> stnNames)
                                           throws java.io.IOException

Throws:

java.io.IOException

getStationFeatures

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

Throws:

java.io.IOException

flatten

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

Flatten into a PointFeatureCollection, discarding connectedness information.

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

flatten

PointFeatureCollection flatten(java.util.List<java.lang.String> stations,
                               DateRange dateRange,
                               java.util.List<VariableSimpleIF> varList)
                        throws java.io.IOException

Deprecated. use CalendarDateRange

Flatten into a PointFeatureCollection, discarding connectedness information.

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