ucar.unidata.data.point
Class NetcdfPointDataSource

java.lang.Object
  extended by ucar.unidata.collab.SharableImpl
      extended by ucar.unidata.data.DataSourceImpl
          extended by ucar.unidata.data.FilesDataSource
              extended by ucar.unidata.data.point.PointDataSource
                  extended by ucar.unidata.data.point.NetcdfPointDataSource
All Implemented Interfaces:
Sharable, DataSource, DataSourceFactory, XmlPersistable
Direct Known Subclasses:
NetcdfMetarDataSource

public class NetcdfPointDataSource
extends PointDataSource

A data source for netCDF or CDM point data

Version:
$Revision: 1.32 $ $Date: 2007/07/31 19:29:16 $
Author:
Don Murray

Field Summary
 
Fields inherited from class ucar.unidata.data.point.PointDataSource
fieldsDescription, POINT_DATA, PROP_STATIONMODELNAME, STATION_DATA, STATION_PLOT
 
Fields inherited from class ucar.unidata.data.FilesDataSource
adapters, oldSourceFromBundles, sources
 
Fields inherited from class ucar.unidata.data.DataSourceImpl
changeDataPathsCbx, dataCacheKey, dataChoices, geoSelectionPanel, haveBeenUnPersisted, okToContinue, PARAM_SHOW_HIDE, PARAM_SHOW_NO, PARAM_SHOW_YES
 
Fields inherited from interface ucar.unidata.data.DataSource
MOST_RECENT, ordinalNames, PROP_AUTOCREATEDISPLAY, PROP_BASEDIRECTORY, PROP_CACHEABLE, PROP_DATACHOICENAME, PROP_DISPLAYPROPERTIES, PROP_DOCUMENTLINKS, PROP_FILEPATTERN, PROP_GEOLOCATION, PROP_ICON, PROP_NAME, PROP_POLLINFO, PROP_RESOLVERURL, PROP_SERVICE_HTTP, PROP_SUBPROPERTIES, PROP_TIMELABELS, PROP_TITLE
 
Constructor Summary
NetcdfPointDataSource()
          Default constructor
NetcdfPointDataSource(DataSourceDescriptor descriptor, List sources, Hashtable properties)
          Create a new NetcdfPointDataSource
NetcdfPointDataSource(DataSourceDescriptor descriptor, String[] sources, Hashtable properties)
          Create a new NetcdfPointDataSource
NetcdfPointDataSource(DataSourceDescriptor descriptor, String source, Hashtable properties)
          Create a new NetcdfPointDataSource
 
Method Summary
 boolean canDoGeoSelection()
          Can this datasource do the geoselection subsetting and decimation
protected  boolean canDoGeoSelectionStride()
          Used for the geo subsetting property gui as to whether to show the stride or not
 boolean canSaveDataToLocalDisk()
          Is this data source capable of saving its data to local disk
protected  ucar.nc2.dt.PointObsDataset doMakeDataset()
          Make the dataset
 boolean equals(Object o)
          Check to see if this NetcdfPointDataSource is equal to the object in question.
 ucar.nc2.dt.PointObsDataset getDataset()
          Return the GridDataset associated with this DataSource.
 int hashCode()
          Get the hashcode for this object
 void initAfterCreation()
          Initialize after we have been created.
static void main(String[] args)
          test
protected  FieldImpl makeObs(DataChoice dataChoice, DataSelection subset, ucar.unidata.geoloc.LatLonRect bbox)
          Make PointObs from the PointObsDataset
 
Methods inherited from class ucar.unidata.data.point.PointDataSource
applyProperties, doMakeDataChoices, getBinRoundTo, getBinWidth, getDataInner, getDataName, getDescriptionDataChoice, getFullDescription, getPointCategories, getPropertiesComponents, getSource, init, makeFieldDescription, setBinRoundTo, setBinWidth, setRoundToFromComboBox, setSource, setWidthFromComboBox
 
Methods inherited from class ucar.unidata.data.FilesDataSource
doRemove, getDataFileExtension, getDataPaths, getFilePath, getInputStreams, getLocationsForPolling, getPartialDescription, getSource, getSources, haveSources, initAfterUnpersistence, initWithPollingInfo, isFileBased, newFilesFromPolling, processDataFilename, propertiesChanged, reloadData, saveDataToLocalDisk, setNewFiles, setSources, sourcesChanged, updateState
 
Methods inherited from class ucar.unidata.data.DataSourceImpl
addActions, addDataChangeListener, addDataChoice, addPropertiesTabs, applyFieldMask, beginWritingDataToLocalDisk, canCacheDataToDisk, canChangeData, canDoFieldMask, canDoGeoSelectionMap, canPoll, canShowParameter, checkForInitAfterUnPersistence, clearCachedData, clearFileCache, clearTimes, convertToFilesIfDirectory, createAutoDisplay, createCacheKey, createElement, decrOutstandingGetDataCalls, doDirectory, doMakeDateTimes, doMakeGeoSelectionPanel, doMakeGeoSelectionPanel, doMakeGeoSelectionPanel, doMakeGeoSubsetPropertiesComponent, endWritingDataToLocalDisk, expandIfNeeded, findDataChoice, findDataChoices, flushCache, getAbsoluteDateTimes, getActions, getAlias, getAllDateTimes, getAllDateTimes, getAllLevels, getAllLevels, getCache, getCacheClearDelay, getCacheDataToDisk, getCompositeDataChoices, getData, getData, getDataCachePath, getDataChangeListeners, getDataChoices, getDataContext, getDataInner, getDataIsEditable, getDataPrefix, getDataSelection, getDataSelectionComponents, getDataSource, getDateTimes, getDateTimeSelection, getDescription, getDescriptor, getErrorMessage, getExtraGeoSelectionComponent, getFileFilterForPolling, getid, getInError, getLocalDirectory, getLocationForPolling, getMostRecentFiles, getName, getNameForDataSource, getNeedToShowErrorToUser, getNextId, getOutstandingGetDataCalls, getPassword, getPathsThatCanBeRelative, getPollingInfo, getProperties, getPropertiesHeader, getProperty, getProperty, getProperty, getProperty, getProperty, getProperty, getProperty, getRelativePaths, getSampleDataProjection, getSaveDataFileLabel, getSelectedDateTimes, getSelectedDateTimes, getTimesFromDataSelection, getTmpPaths, getTypeName, getUserName, handlePropertiesAction, hasPollingInfo, holdsDateTimes, holdsIndices, identifiedBy, identifiedByName, incrOutstandingGetDataCalls, initAfter, initDataChoice, initDataSelectionComponents, initFromXml, isPolling, loadFieldMask, loadFieldMask, loadLatestFile, logException, logException, makeDerivedDataChoices, makeSaveLocalActions, newFileFromPolling, notifyDataChange, putCache, removeCache, removeDataChangeListener, removeDataChoice, removeProperty, replaceDataChoice, resetTmpState, saveDataToLocalDisk, saveDataToLocalDisk, setAlias, setAskToUpdate, setCacheClearDelay, setCacheDataToDisk, setDataEditableStrings, setDataIsEditable, setDataIsRelative, setDataRelativeStrings, setDataSelection, setDateTimeSelection, setDescription, setDescriptor, setDirectory, setInError, setInError, setInError, setName, setObjectProperties, setObjectProperty, setPassword, setPollingInfo, setPollLocation, setProperties, setProperty, setProperty, setRelativePaths, setTemplateName, setTmpPaths, setUserName, shouldCache, showPasswordDialog, showPropertiesDialog, showPropertiesDialog, showPropertiesDialog, showWaitDialog, tick, toString, toStringTruncated, updateDetailsText, writeFieldMaskFile, writeFieldMaskFile
 
Methods inherited from class ucar.unidata.collab.SharableImpl
applySharableProperties, doShare, doShare, doShareExternal, doShareInternal, getSharablePropertiesComponent, getShareGroup, getSharing, getUniqueId, initSharable, receiveShareData, removeSharable, setShareGroup, setSharing, setUniqueId, showSharableDialog
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface ucar.unidata.data.DataSource
getUniqueId
 

Constructor Detail

NetcdfPointDataSource

public NetcdfPointDataSource()
                      throws VisADException
Default constructor

Throws:
VisADException - problem creating the object

NetcdfPointDataSource

public NetcdfPointDataSource(DataSourceDescriptor descriptor,
                             String source,
                             Hashtable properties)
                      throws VisADException
Create a new NetcdfPointDataSource

Parameters:
descriptor - data source descriptor
source - source of data (filename/URL)
properties - extra properties for initialization
Throws:
VisADException - problem creating the data

NetcdfPointDataSource

public NetcdfPointDataSource(DataSourceDescriptor descriptor,
                             String[] sources,
                             Hashtable properties)
                      throws VisADException
Create a new NetcdfPointDataSource

Parameters:
descriptor - data source descriptor
sources - sources of data (filename/URL)
properties - extra properties for initialization
Throws:
VisADException - problem creating the data

NetcdfPointDataSource

public NetcdfPointDataSource(DataSourceDescriptor descriptor,
                             List sources,
                             Hashtable properties)
                      throws VisADException
Create a new NetcdfPointDataSource

Parameters:
descriptor - data source descriptor
sources - List source of data (filenames/URLs)
properties - extra properties for initialization
Throws:
VisADException - problem creating the data
Method Detail

canDoGeoSelection

public boolean canDoGeoSelection()
Can this datasource do the geoselection subsetting and decimation

Specified by:
canDoGeoSelection in interface DataSource
Overrides:
canDoGeoSelection in class DataSourceImpl
Returns:
_can do geo subsetting

canDoGeoSelectionStride

protected boolean canDoGeoSelectionStride()
Used for the geo subsetting property gui as to whether to show the stride or not

Overrides:
canDoGeoSelectionStride in class DataSourceImpl
Returns:
default is true

canSaveDataToLocalDisk

public boolean canSaveDataToLocalDisk()
Is this data source capable of saving its data to local disk

Specified by:
canSaveDataToLocalDisk in interface DataSource
Overrides:
canSaveDataToLocalDisk in class DataSourceImpl
Returns:
Can save to local disk

equals

public boolean equals(Object o)
Check to see if this NetcdfPointDataSource is equal to the object in question.

Overrides:
equals in class FilesDataSource
Parameters:
o - object in question
Returns:
true if they are the same or equivalent objects

hashCode

public int hashCode()
Get the hashcode for this object

Overrides:
hashCode in class Object
Returns:
hash code

initAfterCreation

public void initAfterCreation()
Initialize after we have been created.

Specified by:
initAfterCreation in interface DataSource
Overrides:
initAfterCreation in class FilesDataSource

getDataset

public ucar.nc2.dt.PointObsDataset getDataset()
Return the GridDataset associated with this DataSource.

Returns:
dataset

doMakeDataset

protected ucar.nc2.dt.PointObsDataset doMakeDataset()
Make the dataset

Returns:
the dataset

makeObs

protected FieldImpl makeObs(DataChoice dataChoice,
                            DataSelection subset,
                            ucar.unidata.geoloc.LatLonRect bbox)
                     throws Exception
Make PointObs from the PointObsDataset

Specified by:
makeObs in class PointDataSource
Parameters:
dataChoice - choice for data (source of data)
subset - subsetting parameters
bbox - bounding box. may be null
Returns:
data of the form index -> (EarthLocation, Time, Data)
Throws:
Exception - problem creating data

main

public static void main(String[] args)
test

Parameters:
args - args