ucar.nc2.dt.radial

Class RadialDatasetSweepAdapter

java.lang.Object

ucar.nc2.dt.TypedDatasetImpl

ucar.nc2.dt.radial.RadialDatasetSweepAdapter

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, RadialDatasetSweep, TypedDataset, FeatureDataset, FileCacheable

Direct Known Subclasses:

CFnetCDF2Dataset, Dorade2Dataset, LevelII2Dataset, Netcdf2Dataset, Nids2Dataset, UF2Dataset

public abstract class RadialDatasetSweepAdapter
extends TypedDatasetImpl
implements RadialDatasetSweep

Make a NetcdfDataset into a RadialDatasetSweep.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	RadialDatasetSweepAdapter.MyRadialVariableAdapter

Nested classes/interfaces inherited from interface ucar.nc2.dt.RadialDatasetSweep

RadialDatasetSweep.RadialVariable, RadialDatasetSweep.Sweep, RadialDatasetSweep.Type

Field Summary

Fields

Modifier and Type	Field and Description
protected CalendarDateUnit	calDateUnits
protected java.util.HashMap	csHash
protected DateUnit	dateUnits
protected FileCacheIF	fileCache
protected EarthLocation	origin

Fields inherited from class ucar.nc2.dt.TypedDatasetImpl

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

Constructor Summary

Constructors

Constructor and Description
RadialDatasetSweepAdapter()
RadialDatasetSweepAdapter(NetcdfDataset ds)

Method Summary

Modifier and Type	Method and Description
protected abstract void	addRadialVariable(NetcdfDataset ds, Variable var)
void	calcBounds() Caclulate date range and bounding box, even if the data has to be scanned.
void	close() Close all resources associated with this dataset.
CalendarDate	getCalendarDateEnd() Ending Calendar date for the entire dataset.
CalendarDateRange	getCalendarDateRange() Calendar Date range for the entire dataset.
CalendarDate	getCalendarDateStart() Starting Calendar date for the entire dataset.
CalendarDateUnit	getCalendarDateUnit()
RadialDatasetSweep.Type	getCommonType() If all the sweeps are the same type, return it here, else NONE
DateRange	getDateRange() Date range for the entire dataset.
java.lang.String	getDetailInfo()
void	getDetailInfo(java.util.Formatter sf) Show debug / underlying implementation details
EarthLocation	getEarthLocation()
FeatureType	getFeatureType() Contains collections of this FeatureType.
java.lang.String	getImplementationName() Show who is implementing
long	getLastModified() Returns the time that the underlying file(s) were last modified.
DateUnit	getTimeUnits() Get the units of Calendar time.
protected abstract RadialDatasetSweep.RadialVariable	makeRadialVariable(NetcdfDataset nds, VariableSimpleIF v, Variable v0)
void	reacquire()
void	release()
protected void	setBoundingBox()
protected abstract void	setEarthLocation()
void	setFileCache(FileCacheIF fileCache) If the FileCache is not null, FileCacheable.close() must call FileCache.release()
protected abstract void	setTimeUnits()

Methods inherited from class ucar.nc2.dt.TypedDatasetImpl

findGlobalAttributeIgnoreCase, getBoundingBox, getDataVariable, getDataVariables, getDescription, getEndDate, getGlobalAttributes, getLocation, getLocationURI, getNetcdfFile, getStartDate, getTitle, removeDataVariable, setDescription, setEndDate, setLocationURI, setStartDate, 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.RadialDatasetSweep

clearDatasetMemory, getCommonOrigin, getDataFormat, getDataVariables, getRadarID, getRadarName, isStationary, isVolume

Methods inherited from interface ucar.nc2.dt.TypedDataset

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

Methods inherited from interface ucar.nc2.ft.FeatureDataset

findGlobalAttributeIgnoreCase, getBoundingBox, getDataVariable, getDescription, getEndDate, getGlobalAttributes, getLocation, getNetcdfFile, getStartDate, getTitle

Field Detail

origin

protected EarthLocation origin

csHash

protected java.util.HashMap csHash

dateUnits

protected DateUnit dateUnits

calDateUnits

protected CalendarDateUnit calDateUnits

fileCache

protected FileCacheIF fileCache

Constructor Detail

RadialDatasetSweepAdapter

public RadialDatasetSweepAdapter()

RadialDatasetSweepAdapter

public RadialDatasetSweepAdapter(NetcdfDataset ds)

Method Detail

addRadialVariable

protected abstract void addRadialVariable(NetcdfDataset ds,
                                          Variable var)

makeRadialVariable

protected abstract RadialDatasetSweep.RadialVariable makeRadialVariable(NetcdfDataset nds,
                                                                        VariableSimpleIF v,
                                                                        Variable v0)

setTimeUnits

protected abstract void setTimeUnits()
                              throws java.lang.Exception

Throws:

java.lang.Exception

getDetailInfo

public java.lang.String getDetailInfo()

Specified by:

getDetailInfo in interface TypedDataset

Overrides:

getDetailInfo in class TypedDatasetImpl

Returns:

debug / underlying implementation details

setEarthLocation

protected abstract void setEarthLocation()

getCommonType

public RadialDatasetSweep.Type getCommonType()

Description copied from interface: RadialDatasetSweep

If all the sweeps are the same type, return it here, else NONE

Specified by:

getCommonType in interface RadialDatasetSweep

Returns:

type of sweep, or NONE

getTimeUnits

public DateUnit getTimeUnits()

Description copied from interface: RadialDatasetSweep

Get the units of Calendar time. To get a Date, from a time value, call DateUnit.getStandardDate(double value). To get units as a String, call DateUnit.getUnitsString().

Specified by:

getTimeUnits in interface RadialDatasetSweep

Returns:

units of Calendar time

getCalendarDateUnit

public CalendarDateUnit getCalendarDateUnit()

getEarthLocation

public EarthLocation getEarthLocation()

setBoundingBox

protected void setBoundingBox()

Specified by:

setBoundingBox in class TypedDatasetImpl

calcBounds

public void calcBounds()
                throws java.io.IOException

Description copied from interface: FeatureDataset

Caclulate date range and bounding box, even if the data has to be scanned. This ensures that getDateRange() and getBoundingBox() return non-null. If the collection already knows its date range and bounding box, then this has no effect.

Specified by:

calcBounds in interface FeatureDataset

Throws:

java.io.IOException - or read error.

getFeatureType

public FeatureType getFeatureType()

Description copied from interface: FeatureDataset

Contains collections of this FeatureType.

Specified by:

getFeatureType in interface FeatureDataset

Returns:

FeatureType of data

getDateRange

public DateRange getDateRange()

Description copied from interface: FeatureDataset

Date range for the entire dataset.

Specified by:

getDateRange in interface FeatureDataset

Returns:

the date range for the entire dataset, or null if unknown

getCalendarDateRange

public CalendarDateRange getCalendarDateRange()

Description copied from interface: FeatureDataset

Calendar Date range for the entire dataset.

Specified by:

getCalendarDateRange in interface FeatureDataset

Returns:

the date range for the entire dataset, or null if unknown

getCalendarDateStart

public CalendarDate getCalendarDateStart()

Description copied from interface: FeatureDataset

Starting Calendar date for the entire dataset.

Specified by:

getCalendarDateStart in interface FeatureDataset

Returns:

the starting date for the entire dataset, or null if unknown

getCalendarDateEnd

public CalendarDate getCalendarDateEnd()

Description copied from interface: FeatureDataset

Ending Calendar date for the entire dataset.

Specified by:

getCalendarDateEnd in interface FeatureDataset

Returns:

the ending date for the entire dataset, or null if unknown

getDetailInfo

public void getDetailInfo(java.util.Formatter sf)

Description copied from interface: FeatureDataset

Show debug / underlying implementation details

Specified by:

getDetailInfo in interface FeatureDataset

Parameters:

sf - append info here

getImplementationName

public java.lang.String getImplementationName()

Description copied from interface: FeatureDataset

Show who is implementing

Specified by:

getImplementationName in interface FeatureDataset

Returns:

name of implementor

close

public void close()
           throws java.io.IOException

Description copied from interface: TypedDataset

Close all resources associated with this dataset.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface TypedDataset

Specified by:

close in interface FeatureDataset

Specified by:

close in interface FileCacheable

Overrides:

close in class TypedDatasetImpl

Throws:

java.io.IOException - on io error

release

public void release()
             throws java.io.IOException

Specified by:

release in interface FileCacheable

Throws:

java.io.IOException

reacquire

public void reacquire()
               throws java.io.IOException

Specified by:

reacquire in interface FileCacheable

Throws:

java.io.IOException

getLastModified

public long getLastModified()

Description copied from interface: FileCacheable

Returns the time that the underlying file(s) were last modified. If they've changed since they were stored in the cache, they will be closed and reopened with FileFactory.

Specified by:

getLastModified in interface FileCacheable

Returns:

a long value representing the time the file(s) were last modified or 0L if the last-modified time couldn't be determined for any reason.

setFileCache

public void setFileCache(FileCacheIF fileCache)

Description copied from interface: FileCacheable

If the FileCache is not null, FileCacheable.close() must call FileCache.release()

  public synchronized void close() throws java.io.IOException {
    if (cache != null) {
      if (cache.release(this)) return;
    }

    reallyClose();
  } 

Specified by:

setFileCache in interface FileCacheable

Parameters:

fileCache - must store this, use it on close as above.