ucar.unidata.data.sounding

Class TrackDataSource

java.lang.Object

ucar.unidata.collab.SharableImpl

ucar.unidata.data.DataSourceImpl

ucar.unidata.data.FilesDataSource

ucar.unidata.data.sounding.TrackDataSource

All Implemented Interfaces:

Sharable, DataSource, DataSourceFactory, XmlPersistable

Direct Known Subclasses:

SondeDataSource, TrajectoryFeatureTypeDataSource

public class TrackDataSource
extends FilesDataSource

A data source for balloon and aircraft tracks

Version:

$Revision: 1.90 $ $Date: 2007/08/06 17:02:27 $

Author:

IDV Development Team

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ID_LASTOB Last point track type
static java.lang.String	ID_POINTTRACE Point track type
static java.lang.String	ID_SOUNDINGOB sounding ob id
static java.lang.String	ID_SOUNDINGTRACE sounding trace id
static java.lang.String	ID_TIMETRACE time trace id
static java.lang.String	ID_WHOLETRACE The whole track
static java.lang.String	PROP_TRACKTYPE track type identifier
protected java.util.List	soundingCats sounding categories
protected java.util.List	traceCats track categories

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

DATAPATH_DATE_FORMAT, DATAPATH_DATE_PATTERN, 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_TIMESTRIDE, PROP_TITLE

Constructor Summary

Constructors

Constructor and Description
TrackDataSource() Default Constructor
TrackDataSource(DataSourceDescriptor descriptor, java.util.List sources, java.util.Hashtable properties) Create a TrackDataSource from the specification given.
TrackDataSource(DataSourceDescriptor descriptor, java.util.List sources, java.lang.String description, java.util.Hashtable properties) Create a TrackDataSource from the specification given.
TrackDataSource(DataSourceDescriptor descriptor, java.lang.String source, java.util.Hashtable properties) Create a TrackDataSource from the specification given.

Method Summary

Modifier and Type	Method and Description
protected void	addActions(java.util.List actions) _more_
void	addPropertiesTabs(javax.swing.JTabbedPane tabbedPane) Add any extra tabs into the properties tab
protected visad.FieldImpl	aggregateTracks(java.util.List tracks, java.lang.Object id) Aggregate the list of track data
boolean	applyProperties() Apply properties components
protected boolean	canDoView() _more_
boolean	canSaveDataToLocalDisk() Is this data source capable of saving its data to local disk
protected TrackAdapter	doMakeAdapter(java.lang.String file, java.util.Hashtable pointDataFilter, int stride, int lastNMinutes) Factory method to make the adapter
protected void	doMakeDataChoices() Make the DataChoices associated with this dataset
protected java.util.List	doMakeDateTimes() Make the list of times associated with this DataSource for DataSelection.
void	doRemove() _more_
java.util.List	getAdapters() Create, if needed, and return the list of adapters.
protected visad.DateTime	getBaseTime() Get the base time to be used for the track.
protected java.lang.String	getChoiceId(DataChoice dc) Utility to extract the choice id
protected java.lang.String	getChoiceId0(DataChoice dc) Utility to extract the choice id
protected java.lang.String	getDataChoiceLabel(java.lang.Object id) Get the label for a particular data choice
protected visad.Data	getDataInner(DataChoice dataChoice, DataCategory category, DataSelection dataSelection, java.util.Hashtable requestProperties) Get the VisAD Data object that corresponds to the dataChoice category and dataSelection criteria.
java.lang.String	getFullDescription() Get the full description for this data source.
boolean	getHaveAskedToSubset() Get the HaveAskedToSubset property.
int	getLastNMinutes() Get the LastNMinutes property.
protected visad.FieldImpl	getLastPointOb(DataChoice dc, DataSelection dataSelection) Gets the last point ob associated with this track
protected visad.DateTime[]	getMinMaxTime() Get the min and max times in the tracks
java.util.Hashtable	getPointDataFilter() Get the PointDataFilter property.
protected visad.FieldImpl	getPointObTrack(DataChoice dc, DataSelection dataSelection, ucar.ma2.Range range) Gets the point ob track associated with this DataChoice
void	getPropertiesComponents(java.util.List comps) Add the gui components into the list for the properties dialog
protected java.util.List	getRaobCategories() Get the default categories RAOB sounding choices
protected java.util.List	getSoundingCategories() Get the default categories sounding choices
protected visad.Data	getSoundingOb(DataChoice dc, DataSelection dataSelection) Gets the SoundingOb associated with this DataChoice
protected visad.Data	getSoundingTrace(DataChoice dc, DataSelection dataSelection) Gets the sounding trace associated with this DataChoice
int	getStride() Get the Stride property.
TrackAdapter	getTraceAdapter() Gets the sounding trace associated with this DataChoice
protected java.util.List	getTraceCategories() Get the default categories trace choices
protected visad.FlatField	getTrack(DataChoice dc, DataSelection dataSelection, java.util.Hashtable requestProperties) Gets the track associated with this DataChoice
protected java.lang.String	getTrackId(DataChoice dc) Utility to get the track id
protected java.util.List	getTracks(DataChoice dc, DataSelection dataSelection, java.util.Hashtable requestProperties) Gets the track associated with this DataChoice
protected void	initAfter() _more_
void	initAfterCreation() _more_
protected void	initCategories() Initialize the categories
protected void	initTrack() Initialize the track
static void	main(java.lang.String[] args) Get the point observartion data Test routine
visad.FlatField	mergeTracks(java.util.List datas) Merge a List of FieldImpls of point obs into one.
void	resetLastNMinutesFld() Reset last N minutes field
void	resetStrideFld() reset stride field
void	setHaveAskedToSubset(boolean value) Set the HaveAskedToSubset property.
void	setLastNMinutes(int value) Set the LastNMinutes property.
void	setName(java.lang.String value) Set the source property (filename or URL).
void	setPointDataFilter(java.util.Hashtable value) Set the PointDataFilter property.
void	setStride(int value) Set the Stride property.
void	setTraceAdapter(TrackAdapter traceAdapter)
void	showSqlShell() _more_

Methods inherited from class ucar.unidata.data.FilesDataSource

equals, getDataFileExtension, getDataPaths, getFilePath, getInputStreams, getLocationsForPolling, getPartialDescription, getSource, getSources, haveSources, initAfterUnpersistence, initWithPollingInfo, isFileBased, newFilesFromPolling, processDataFilename, propertiesChanged, reloadData, reloadData, saveDataToLocalDisk, setNewFiles, setSource, setSources, sourcesChanged, updateState

Methods inherited from class ucar.unidata.data.DataSourceImpl

addDataChangeListener, addDataChoice, addReloadTab, applyFieldMask, beginWritingDataToLocalDisk, canAddCurrentName, canCacheDataToDisk, canChangeData, canDoAllLevels, canDoFieldMask, canDoGeoSelection, canDoGeoSelectionMap, canDoGeoSelectionStride, canPoll, canShowParameter, checkForInitAfterUnPersistence, clearCachedData, clearFileCache, clearTimes, convertSourceFile, convertToFilesIfDirectory, createAutoDisplay, createCacheKey, createElement, decrOutstandingGetDataCalls, doDirectory, doMakeGeoSelectionPanel, doMakeGeoSelectionPanel, doMakeGeoSelectionPanel, doMakeGeoSubsetPropertiesComponent, endWritingDataToLocalDisk, expandIfNeeded, findDataChoice, findDataChoices, flushCache, getAbsoluteDateTimes, getActions, getAlias, getAllDateTimes, getAllDateTimes, getAllLevels, getAllLevels, getAllTimesForTimeDriver, getCache, getCache, getCacheClearDelay, getCacheDataToDisk, getCompositeDataChoices, getData, getData, getDataCachePath, getDataChangeListeners, getDataChoices, getDataContext, getDataInner, getDataIsEditable, getDataPrefix, getDataSelection, getDataSelectionComponents, getDataSource, getDateTimes, getDateTimeSelection, getDefaultSave, getDescription, getDescriptor, getErrorMessage, getEverChangedName, getExtraGeoSelectionComponent, getExtraTimesComponent, getFileFilterForPolling, getid, getIdv, 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, initDataChoice, initDataSelectionComponents, initFromXml, isPolling, loadFieldMask, loadFieldMask, loadLatestFile, logException, logException, makeDerivedDataChoices, makeSaveLocalActions, newFileFromPolling, notifyDataChange, putCache, putCache, reloadProperties, removeCache, removeDataChangeListener, removeDataChoice, removeProperty, replaceDataChoice, resetTmpState, saveDataToLocalDisk, saveDataToLocalDisk, selectTimesFromList, setAlias, setAskToUpdate, setCacheClearDelay, setCacheDataToDisk, setDataEditableStrings, setDataIsEditable, setDataIsRelative, setDataRelativeStrings, setDataSelection, setDateTimeSelection, setDefaultSave, setDescription, setDescriptor, setDirectory, setEverChangedName, setInError, setInError, setInError, setObjectProperties, setObjectProperty, setPassword, setPollingInfo, setPollLocation, setProperties, setProperty, setProperty, setRelativePaths, setTemplateName, setTmpPaths, setUserName, shouldCache, 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, getReceiveShareTime, getSharablePropertiesComponent, getShareGroup, getSharing, getUniqueId, initSharable, receiveShareData, removeSharable, setReceiveShareTime, setShareGroup, setSharing, setUniqueId, showSharableDialog

Methods inherited from class java.lang.Object

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

Methods inherited from interface ucar.unidata.data.DataSource

getUniqueId

Field Detail

traceCats

protected java.util.List traceCats

track categories

soundingCats

protected java.util.List soundingCats

sounding categories

ID_SOUNDINGOB

public static final java.lang.String ID_SOUNDINGOB

sounding ob id

See Also:

Constant Field Values

ID_SOUNDINGTRACE

public static final java.lang.String ID_SOUNDINGTRACE

sounding trace id

See Also:

Constant Field Values

ID_TIMETRACE

public static final java.lang.String ID_TIMETRACE

time trace id

See Also:

Constant Field Values

ID_WHOLETRACE

public static final java.lang.String ID_WHOLETRACE

The whole track

See Also:

Constant Field Values

ID_POINTTRACE

public static final java.lang.String ID_POINTTRACE

Point track type

See Also:

Constant Field Values

ID_LASTOB

public static final java.lang.String ID_LASTOB

Last point track type

See Also:

Constant Field Values

PROP_TRACKTYPE

public static final java.lang.String PROP_TRACKTYPE

track type identifier

See Also:

Constant Field Values

Constructor Detail

TrackDataSource

public TrackDataSource()

Default Constructor

TrackDataSource

public TrackDataSource(DataSourceDescriptor descriptor,
                       java.lang.String source,
                       java.util.Hashtable properties)
                throws visad.VisADException

Create a TrackDataSource from the specification given.

Parameters:

descriptor - descriptor for the DataSource

source - file location or URL

properties - extra properties

Throws:

visad.VisADException

TrackDataSource

public TrackDataSource(DataSourceDescriptor descriptor,
                       java.util.List sources,
                       java.util.Hashtable properties)
                throws visad.VisADException

Create a TrackDataSource from the specification given.

Parameters:

descriptor - data source descriptor

sources - List of sources of data (filename/URL)

properties - extra properties for initialization

Throws:

visad.VisADException - problem creating the data

TrackDataSource

public TrackDataSource(DataSourceDescriptor descriptor,
                       java.util.List sources,
                       java.lang.String description,
                       java.util.Hashtable properties)
                throws visad.VisADException

Create a TrackDataSource from the specification given.

Parameters:

descriptor - data source descriptor

sources - List of sources of data (filename/URL)

description - dataset description

properties - extra properties for initialization

Throws:

visad.VisADException - problem creating the data

Method Detail

doRemove

public void doRemove()

_more_

Specified by:

doRemove in interface DataSource

Overrides:

doRemove in class FilesDataSource

addActions

protected void addActions(java.util.List actions)

_more_

Overrides:

addActions in class DataSourceImpl

Parameters:

actions - _more_

showSqlShell

public void showSqlShell()

_more_

initAfter

protected void initAfter()

_more_

Overrides:

initAfter in class DataSourceImpl

initAfterCreation

public void initAfterCreation()

_more_

Specified by:

initAfterCreation in interface DataSource

Overrides:

initAfterCreation in class FilesDataSource

initCategories

protected void initCategories()

Initialize the categories

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

getFullDescription

public java.lang.String getFullDescription()

Get the full description for this data source. Subclasses should override if they want something other than the default. This is what gets displayed in the details.

Specified by:

getFullDescription in interface DataSource

Overrides:

getFullDescription in class FilesDataSource

Returns:

the full description of this data source (description + name)

getTraceCategories

protected java.util.List getTraceCategories()

Get the default categories trace choices

Returns:

list of categories

getSoundingCategories

protected java.util.List getSoundingCategories()

Get the default categories sounding choices

Returns:

list of categories

getRaobCategories

protected java.util.List getRaobCategories()

Get the default categories RAOB sounding choices

Returns:

list of categories

initTrack

protected void initTrack()

Initialize the track

doMakeAdapter

protected TrackAdapter doMakeAdapter(java.lang.String file,
                                     java.util.Hashtable pointDataFilter,
                                     int stride,
                                     int lastNMinutes)
                              throws java.lang.Exception

Factory method to make the adapter

Parameters:

file - file or url

pointDataFilter - When creating point data this holds the map of variables to use

stride - string

lastNMinutes - clipping

Returns:

The adapter

Throws:

java.lang.Exception - On badness

getAdapters

public java.util.List getAdapters()

Create, if needed, and return the list of adapters. Will return null if there are no valid adapters.

Returns:

List of adapters or null

doMakeDataChoices

protected void doMakeDataChoices()

Make the DataChoices associated with this dataset

Overrides:

doMakeDataChoices in class DataSourceImpl

canDoView

protected boolean canDoView()

_more_

Returns:

_more_

getDataChoiceLabel

protected java.lang.String getDataChoiceLabel(java.lang.Object id)

Get the label for a particular data choice

Parameters:

id - id for the choice

Returns:

the appropriate label

getDataInner

protected visad.Data getDataInner(DataChoice dataChoice,
                                  DataCategory category,
                                  DataSelection dataSelection,
                                  java.util.Hashtable requestProperties)
                           throws visad.VisADException,
                                  java.rmi.RemoteException

Get the VisAD Data object that corresponds to the dataChoice category and dataSelection criteria.

Overrides:

getDataInner in class DataSourceImpl

Parameters:

dataChoice - choice for data

category - specific category of data (not used currently)

dataSelection - additional selection criteria

requestProperties - extra request properties

Returns:

corresponding Data object

Throws:

visad.VisADException - unable to create Data object

java.rmi.RemoteException - (some kind of remote error.

getBaseTime

protected visad.DateTime getBaseTime()

Get the base time to be used for the track. This is the largest of the end times

Returns:

Base time.

getMinMaxTime

protected visad.DateTime[] getMinMaxTime()

Get the min and max times in the tracks

Returns:

man/max times of the tracks

aggregateTracks

protected visad.FieldImpl aggregateTracks(java.util.List tracks,
                                          java.lang.Object id)
                                   throws visad.VisADException,
                                          java.rmi.RemoteException

Aggregate the list of track data

Parameters:

tracks - list of track data

id - _more_

Returns:

Aggregation

Throws:

java.rmi.RemoteException - On badness

visad.VisADException - On badness

doMakeDateTimes

protected java.util.List doMakeDateTimes()

Make the list of times associated with this DataSource for DataSelection.

Overrides:

doMakeDateTimes in class DataSourceImpl

Returns:

DateTimes as a list.

getTracks

protected java.util.List getTracks(DataChoice dc,
                                   DataSelection dataSelection,
                                   java.util.Hashtable requestProperties)
                            throws visad.VisADException,
                                   java.rmi.RemoteException

Gets the track associated with this DataChoice

Parameters:

dc - DataChoice for selection

dataSelection - sub selection criteria

requestProperties - selection properties

Returns:

associated track

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - VisAD problem

getTrack

protected visad.FlatField getTrack(DataChoice dc,
                                   DataSelection dataSelection,
                                   java.util.Hashtable requestProperties)
                            throws visad.VisADException,
                                   java.rmi.RemoteException

Gets the track associated with this DataChoice

Parameters:

dc - DataChoice for selection

dataSelection - sub selection criteria

requestProperties - selection properties

Returns:

associated track

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - VisAD problem

getLastPointOb

protected visad.FieldImpl getLastPointOb(DataChoice dc,
                                         DataSelection dataSelection)
                                  throws java.lang.Exception

Gets the last point ob associated with this track

Parameters:

dc - DataChoice for selection

dataSelection - sub selection criteria

Returns:

associated track

Throws:

java.lang.Exception - On badness

getPointObTrack

protected visad.FieldImpl getPointObTrack(DataChoice dc,
                                          DataSelection dataSelection,
                                          ucar.ma2.Range range)
                                   throws visad.VisADException,
                                          java.rmi.RemoteException

Gets the point ob track associated with this DataChoice

Parameters:

dc - DataChoice for selection

dataSelection - sub selection criteria

range - The data range

Returns:

associated track

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - VisAD problem

getSoundingTrace

protected visad.Data getSoundingTrace(DataChoice dc,
                                      DataSelection dataSelection)
                               throws java.lang.Exception

Gets the sounding trace associated with this DataChoice

Parameters:

dc - DataChoice for selection

dataSelection - sub selection criteria

Returns:

associated track

Throws:

java.lang.Exception - On badness

getTraceAdapter

public TrackAdapter getTraceAdapter()
                             throws java.lang.Exception

Gets the sounding trace associated with this DataChoice

Returns:

associated trace adapter

Throws:

java.lang.Exception - On badness

setTraceAdapter

public void setTraceAdapter(TrackAdapter traceAdapter)
                     throws java.lang.Exception

Throws:

java.lang.Exception

getChoiceId

protected java.lang.String getChoiceId(DataChoice dc)

Utility to extract the choice id

Parameters:

dc - the data choice

Returns:

The id. eg: parameter name

getChoiceId0

protected java.lang.String getChoiceId0(DataChoice dc)

Utility to extract the choice id

Parameters:

dc - the data choice

Returns:

The id. eg: parameter name

getTrackId

protected java.lang.String getTrackId(DataChoice dc)

Utility to get the track id

Parameters:

dc - data choice

Returns:

track id

getSoundingOb

protected visad.Data getSoundingOb(DataChoice dc,
                                   DataSelection dataSelection)
                            throws visad.VisADException,
                                   java.rmi.RemoteException

Gets the SoundingOb associated with this DataChoice

Parameters:

dc - DataChoice for selection

dataSelection - sub selection criteria

Returns:

SoundingOb

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - VisAD problem

setName

public void setName(java.lang.String value)

Set the source property (filename or URL). Used by persistence

Overrides:

setName in class DataSourceImpl

Parameters:

value - data source

main

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

Get the point observartion data Test routine

Parameters:

args - filename

Throws:

java.lang.Exception - problem

mergeTracks

public visad.FlatField mergeTracks(java.util.List datas)
                            throws visad.VisADException

Merge a List of FieldImpls of point obs into one.

Parameters:

datas - List of FieldImpls of point obs

Returns:

merged FieldImpl

Throws:

visad.VisADException - problem getting the data

setPointDataFilter

public void setPointDataFilter(java.util.Hashtable value)

Set the PointDataFilter property.

Parameters:

value - The new value for PointDataFilter

getPointDataFilter

public java.util.Hashtable getPointDataFilter()

Get the PointDataFilter property.

Returns:

The PointDataFilter

getPropertiesComponents

public void getPropertiesComponents(java.util.List comps)

Add the gui components into the list for the properties dialog

Overrides:

getPropertiesComponents in class DataSourceImpl

Parameters:

comps - List of components

resetLastNMinutesFld

public void resetLastNMinutesFld()

Reset last N minutes field

resetStrideFld

public void resetStrideFld()

reset stride field

applyProperties

public boolean applyProperties()

Apply properties components

Overrides:

applyProperties in class DataSourceImpl

Returns:

false if something failed and we need to keep showing the dialog

addPropertiesTabs

public void addPropertiesTabs(javax.swing.JTabbedPane tabbedPane)

Add any extra tabs into the properties tab

Overrides:

addPropertiesTabs in class DataSourceImpl

Parameters:

tabbedPane - The properties tab

setStride

public void setStride(int value)

Set the Stride property.

Parameters:

value - The new value for Stride

getStride

public int getStride()

Get the Stride property.

Returns:

The Stride

setHaveAskedToSubset

public void setHaveAskedToSubset(boolean value)

Set the HaveAskedToSubset property.

Parameters:

value - The new value for HaveAskedToSubset

getHaveAskedToSubset

public boolean getHaveAskedToSubset()

Get the HaveAskedToSubset property.

Returns:

The HaveAskedToSubset

setLastNMinutes

public void setLastNMinutes(int value)

Set the LastNMinutes property.

Parameters:

value - The new value for LastNMinutes

getLastNMinutes

public int getLastNMinutes()

Get the LastNMinutes property.

Returns:

The LastNMinutes