ucar.nc2.ft.point.collection

Class CompositeStationCollection

java.lang.Object

ucar.nc2.ft.point.OneNestedPointCollectionImpl

ucar.nc2.ft.point.StationTimeSeriesCollectionImpl

ucar.nc2.ft.point.collection.CompositeStationCollection

All Implemented Interfaces:

FeatureCollection, NestedPointFeatureCollection, UpdateableCollection, StationCollection, StationTimeSeriesFeatureCollection

public class CompositeStationCollection
extends StationTimeSeriesCollectionImpl
implements UpdateableCollection

StationTimeSeries composed of a collection of individual StationTimeSeries. "Composite" pattern.

Since:

May 19, 2009

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.List<VariableSimpleIF>	dataVariables
protected java.util.List<Attribute>	globalAttributes

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

localIterator

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

altUnits, collectionFeatureType, extras, name, npts, timeUnit

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CompositeStationCollection(java.lang.String name, DateUnit timeUnit, java.lang.String altUnits, TimedCollection dataCollection)

Method Summary

Modifier and Type	Method and Description
protected StationHelper	createStationHelper()
PointFeatureCollection	flatten(LatLonRect boundingBox, CalendarDateRange dateRange) Flatten into a PointFeatureCollection, discarding connectedness information.
PointFeatureCollection	flatten(java.util.List<java.lang.String> stations, CalendarDateRange dateRange, java.util.List<VariableSimpleIF> varList) Flatten into a PointFeatureCollection, discarding connectedness information.
java.util.List<VariableSimpleIF>	getDataVariables()
java.util.List<Attribute>	getGlobalAttributes()
PointFeatureCollectionIterator	getPointFeatureCollectionIterator(int bufferSize) Iterate through the collection, composed of PointFeatureCollection.
StationTimeSeriesFeature	getStationFeature(Station s) Get the collection of data for a particular Station.
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.
CalendarDateRange	update()

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

finish, flatten, getBoundingBox, getNestedPointFeatureCollectionIterator, getStation, getStation, getStationFeatures, getStationFeatures, getStationFeatures, getStationHelper, getStations, getStations, getStations, hasNext, next, resetIteration, subsetFeatures

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

dataVariables

protected java.util.List<VariableSimpleIF> dataVariables

globalAttributes

protected java.util.List<Attribute> globalAttributes

Constructor Detail

CompositeStationCollection

protected CompositeStationCollection(java.lang.String name,
                                     DateUnit timeUnit,
                                     java.lang.String altUnits,
                                     TimedCollection dataCollection)
                              throws java.io.IOException

Throws:

java.io.IOException

Method Detail

createStationHelper

protected StationHelper createStationHelper()
                                     throws java.io.IOException

Specified by:

createStationHelper in class StationTimeSeriesCollectionImpl

Throws:

java.io.IOException

getDataVariables

public java.util.List<VariableSimpleIF> getDataVariables()

getGlobalAttributes

public java.util.List<Attribute> getGlobalAttributes()

update

public CalendarDateRange update()
                         throws java.io.IOException

Specified by:

update in interface UpdateableCollection

Throws:

java.io.IOException

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

Overrides:

subset in class StationTimeSeriesCollectionImpl

Parameters:

stations - only contain these stations

Returns:

subsetted collection

Throws:

java.io.IOException - on i/o error

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

Overrides:

subset in class StationTimeSeriesCollectionImpl

Parameters:

boundingBox - spatial subset. may be null

Returns:

subsetted collection

Throws:

java.io.IOException - on i/o 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

Overrides:

getStationFeature in class StationTimeSeriesCollectionImpl

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

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 StationTimeSeriesCollectionImpl

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

Overrides:

flatten in class StationTimeSeriesCollectionImpl

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

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

Overrides:

getPointFeatureCollectionIterator in class StationTimeSeriesCollectionImpl

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