ucar.nc2.dt.point

Class DapperDataset

java.lang.Object

ucar.nc2.dt.TypedDatasetImpl

ucar.nc2.dt.point.PointObsDatasetImpl

ucar.nc2.dt.point.DapperDataset

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, PointCollection, PointObsDataset, TypedDataset, TypedDatasetFactoryIF

public class DapperDataset
extends PointObsDatasetImpl
implements TypedDatasetFactoryIF

Handles datasets using Dapper doubley nested sequences.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	DapperDataset.SeqPointObs
class	DapperDataset.SeqStationObs

Field Summary

Fields

Modifier and Type	Field and Description
protected ucar.nc2.Variable	altVar
protected ucar.nc2.dods.DODSNetcdfFile	dodsFile
protected boolean	fatal
protected ucar.nc2.dataset.StructureDS	innerSequence
protected boolean	isProfile
protected ucar.nc2.Variable	latVar
protected ucar.nc2.Variable	lonVar
protected ucar.nc2.dataset.StructureDS	outerSequence
protected ucar.nc2.Variable	timeVar

Fields inherited from class ucar.nc2.dt.point.PointObsDatasetImpl

formatter, timeUnit

Fields inherited from class ucar.nc2.dt.TypedDatasetImpl

boundingBox, dataVariables, desc, endDate, location, netcdfDataset, parseInfo, startDate, title

Constructor Summary

Constructors

Constructor and Description
DapperDataset()
DapperDataset(ucar.nc2.dataset.NetcdfDataset ds)

Method Summary

Modifier and Type	Method and Description
static PointObsDataset	factory(ucar.nc2.dataset.NetcdfDataset ds)
java.util.List	getData(ucar.nc2.util.CancelTask cancel) Get all data, allow user to cancel.
java.util.List	getData(ucar.unidata.geoloc.LatLonRect boundingBox, ucar.nc2.util.CancelTask cancel) Get all data within the specified bounding box, allow user to cancel.
java.util.List	getData(ucar.unidata.geoloc.LatLonRect boundingBox, java.util.Date start, java.util.Date end, ucar.nc2.util.CancelTask cancel) Get all data within the specified bounding box and date range, allow user to cancel.
int	getDataCount() Get estimate of number of data records (may not be exact).
DataIterator	getDataIterator(int bufferSize) Get an efficient iterator over all the data in the Collection.
boolean	isMine(ucar.nc2.dataset.NetcdfDataset ds) Determine if this dataset belongs to you
static boolean	isValidFile(ucar.nc2.NetcdfFile ds)
static void	main(java.lang.String[] args)
TypedDataset	open(ucar.nc2.dataset.NetcdfDataset ncd, ucar.nc2.util.CancelTask task, java.lang.StringBuilder errlog) Open a NetcdfDataset as a TypedDataset.
java.util.List	readStationData(ucar.unidata.geoloc.Station s, ucar.nc2.util.CancelTask cancel)
void	readStations(java.util.List stations)
protected void	setBoundingBox()
protected void	setEndDate()
protected void	setStartDate()
protected void	setTimeUnits()

Methods inherited from class ucar.nc2.dt.point.PointObsDatasetImpl

getData, getData, getData, getDataClass, getDetailInfo, getMetersConversionFactor, getScientificDataType, getTime, getTimeUnits

Methods inherited from class ucar.nc2.dt.TypedDatasetImpl

close, findGlobalAttributeIgnoreCase, getBoundingBox, getDataVariable, getDataVariables, getDescription, getEndDate, getGlobalAttributes, getLocation, getLocationURI, getNetcdfFile, getStartDate, getTitle, removeDataVariable, setDescription, setLocationURI, setTitle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface ucar.nc2.dt.TypedDatasetFactoryIF

getScientificDataType

Methods inherited from interface ucar.nc2.dt.TypedDataset

close, findGlobalAttributeIgnoreCase, getBoundingBox, getDataVariable, getDataVariables, getDescription, getEndDate, getGlobalAttributes, getLocationURI, getNetcdfFile, getStartDate, getTitle

Field Detail

dodsFile

protected ucar.nc2.dods.DODSNetcdfFile dodsFile

latVar

protected ucar.nc2.Variable latVar

lonVar

protected ucar.nc2.Variable lonVar

altVar

protected ucar.nc2.Variable altVar

timeVar

protected ucar.nc2.Variable timeVar

innerSequence

protected ucar.nc2.dataset.StructureDS innerSequence

outerSequence

protected ucar.nc2.dataset.StructureDS outerSequence

isProfile

protected boolean isProfile

fatal

protected boolean fatal

Constructor Detail

DapperDataset

public DapperDataset()

DapperDataset

public DapperDataset(ucar.nc2.dataset.NetcdfDataset ds)
              throws java.io.IOException

Throws:

java.io.IOException

Method Detail

isValidFile

public static boolean isValidFile(ucar.nc2.NetcdfFile ds)

factory

public static PointObsDataset factory(ucar.nc2.dataset.NetcdfDataset ds)
                               throws java.io.IOException

Throws:

java.io.IOException

isMine

public boolean isMine(ucar.nc2.dataset.NetcdfDataset ds)

Description copied from interface: TypedDatasetFactoryIF

Determine if this dataset belongs to you

Specified by:

isMine in interface TypedDatasetFactoryIF

Parameters:

ds - examine this NetcdfDataset to see if it belongs to this class.

Returns:

true if this class knows how to create a TypedDataset out of this NetcdfDataset.

open

public TypedDataset open(ucar.nc2.dataset.NetcdfDataset ncd,
                         ucar.nc2.util.CancelTask task,
                         java.lang.StringBuilder errlog)
                  throws java.io.IOException

Description copied from interface: TypedDatasetFactoryIF

Open a NetcdfDataset as a TypedDataset.

Specified by:

open in interface TypedDatasetFactoryIF

Parameters:

ncd - already opened NetcdfDataset.

task - use may cancel

errlog - place errors here

Returns:

a subclass of TypedDataset

Throws:

java.io.IOException - on error

setTimeUnits

protected void setTimeUnits()

Specified by:

setTimeUnits in class PointObsDatasetImpl

setStartDate

protected void setStartDate()

Specified by:

setStartDate in class TypedDatasetImpl

setEndDate

protected void setEndDate()

Specified by:

setEndDate in class TypedDatasetImpl

setBoundingBox

protected void setBoundingBox()

Specified by:

setBoundingBox in class TypedDatasetImpl

getDataCount

public int getDataCount()

Description copied from interface: PointCollection

Get estimate of number of data records (may not be exact). Return -1 if not able to estimate.

Specified by:

getDataCount in interface PointCollection

Returns:

number of data records or -1

getData

public java.util.List getData(ucar.nc2.util.CancelTask cancel)
                       throws java.io.IOException

Description copied from interface: PointCollection

Get all data, allow user to cancel. Return null if too expensive to implement. Call getDataCount() to get estimate of size. This will return a list of getDataClass(), but the actual data may or may not already be read in to memory. In any case, you call dataType.getData() to get the data.

Specified by:

getData in interface PointCollection

Parameters:

cancel - allow user to cancel. Implementors should return ASAP.

Returns:

List of type getDataClass()

Throws:

java.io.IOException - on io error

See Also:

as a (possibly) more efficient alternative

getData

public java.util.List getData(ucar.unidata.geoloc.LatLonRect boundingBox,
                              ucar.nc2.util.CancelTask cancel)
                       throws java.io.IOException

Description copied from interface: PointCollection

Get all data within the specified bounding box, allow user to cancel.

Specified by:

getData in interface PointCollection

Parameters:

boundingBox - restrict data to this bounding nox

cancel - allow user to cancel. Implementors should return ASAP.

Returns:

List of type getDataClass()

Throws:

java.io.IOException - on io error

See Also:

as a (possibly) more efficient alternative

getData

public java.util.List getData(ucar.unidata.geoloc.LatLonRect boundingBox,
                              java.util.Date start,
                              java.util.Date end,
                              ucar.nc2.util.CancelTask cancel)
                       throws java.io.IOException

Description copied from interface: PointCollection

Get all data within the specified bounding box and date range, allow user to cancel.

Specified by:

getData in interface PointCollection

Parameters:

boundingBox - restrict data to this bounding nox

start - restrict data to after this time

end - restrict data to before this time

cancel - allow user to cancel. Implementors should return ASAP.

Returns:

List of type getDataClass()

Throws:

java.io.IOException - on io error

See Also:

as a (possibly) more efficient alternative

readStations

public void readStations(java.util.List stations)
                  throws java.io.IOException

Throws:

java.io.IOException

readStationData

public java.util.List readStationData(ucar.unidata.geoloc.Station s,
                                      ucar.nc2.util.CancelTask cancel)
                               throws java.io.IOException

Throws:

java.io.IOException

getDataIterator

public DataIterator getDataIterator(int bufferSize)
                             throws java.io.IOException

Description copied from interface: PointCollection

Get an efficient iterator over all the data in the Collection. You must fully process the data, or copy it out of the StructureData, as you iterate over it. DO NOT KEEP ANY REFERENCES to the dataType object or the StructureData object.

This is the efficient way to get all the data, it can be 100 times faster than getData(). This will return an iterator over type getDataClass(), and the actual data has already been read into memory, that is, dataType.getData() will not incur any I/O. This is accomplished by buffering bufferSize amount of data at once.

We dont need a cancelTask, just stop the iteration if the user want to cancel.

Example for point observations:
 

 Iterator iter = pointObsDataset.getDataIterator();
 while (iter.hasNext()) {
   PointObsDatatype pobs = (PointObsDatatype) iter.next();
   StructureData sdata = pobs.getData();
   // process fully
 }
 

Specified by:

getDataIterator in interface PointCollection

Parameters:

bufferSize - if > 0, the internal buffer size, else use the default. Typically 100k - 1M for best results.

Returns:

iterator over type getDataClass(), no guarenteed order.

Throws:

java.io.IOException - on io error

main

public static void main(java.lang.String[] args)
                 throws java.io.IOException

Throws:

java.io.IOException