ucar.unidata.data.sounding

Class TrackAdapter

java.lang.Object

ucar.unidata.data.sounding.TrackAdapter

Direct Known Subclasses:

CdmTrackAdapter, EolDbTrackAdapter, TrajectoryFeatureTypeAdapter

public abstract class TrackAdapter
extends java.lang.Object

Adapter for track type data. This could be a balloon sounding with spatial (lat/lon/alt) data for each time step, or an aircraft track.

Author:

IDV Development Team

Constructor Summary

Constructors

Constructor and Description
TrackAdapter()
TrackAdapter(TrackDataSource dataSource, java.lang.String filename) Construct a new track from the filename.
TrackAdapter(TrackDataSource dataSource, java.lang.String filename, java.util.Hashtable pointDataFilter, int stride, int lastNMinutes) Construct a new track from the filename.

Method Summary

Modifier and Type	Method and Description
protected void	addActions(java.util.List actions) Adds the actions.
protected void	addTrackInfo(TrackInfo trackInfo) Add the track info to the list.
visad.Data	getAerologicalDiagramData(java.lang.String trackId) Get the track data parameters necessary to plot an aerological diagram.
visad.DateTime	getBaseTime() Deprecated. use #getStartTime()
java.lang.String	getDataSourceDescription() Gets the data source description.
java.lang.String	getDataSourceName() Gets the data source name.
visad.DateTime	getEndTime() Get the ending time of this track.
java.lang.String	getFilename() Get the Filename property.
int	getLastNMinutes() Get the LastNMinutes property.
ucar.ma2.Range	getLastPointRange(java.lang.String trackId) Get the data range for the very last obs.
int	getNumObservations(java.lang.String trackId) get total number of obs_.
visad.FieldImpl	getPointObTrack(java.lang.String trackId, ucar.ma2.Range range) Take a FlatField of data and turn it into a field of PointObs.
visad.DateTime	getStartTime() Get the starting time of this track.
int	getStride() Get the Stride property.
visad.FlatField	getTrack(java.lang.String trackId, java.lang.String variable, ucar.ma2.Range range) Returns a track for the variable name specified.
TrackInfo	getTrackInfo(java.lang.String name) Find the track info with the given name.
java.util.List<TrackInfo>	getTrackInfos() Get list of TrackInfo-s.
visad.FlatField	getTrackWithTime(java.lang.String trackId, java.lang.String variable, ucar.ma2.Range range) Returns a track for the variable name specified.
boolean	includeInPointData(java.lang.String varName) Should we include the given var in the point data.
void	setLastNMinutes(int value) Set the LastNMinutes property.
void	setStride(int value) Set the Stride property.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

TrackAdapter

public TrackAdapter()
             throws java.lang.Exception

Throws:

java.lang.Exception

TrackAdapter

public TrackAdapter(TrackDataSource dataSource,
                    java.lang.String filename)
             throws java.lang.Exception

Construct a new track from the filename.

Parameters:

dataSource - datasource

filename - location of file

Throws:

java.lang.Exception - On badness

TrackAdapter

public TrackAdapter(TrackDataSource dataSource,
                    java.lang.String filename,
                    java.util.Hashtable pointDataFilter,
                    int stride,
                    int lastNMinutes)
             throws java.lang.Exception

Construct a new track from the filename.

Parameters:

dataSource - _more_

filename - location of file

pointDataFilter - Filters the variables to use

stride - The stride

lastNMinutes - use the last N minutes

Throws:

java.lang.Exception - On badness

Method Detail

addActions

protected void addActions(java.util.List actions)

Adds the actions.

Parameters:

actions - the actions

addTrackInfo

protected void addTrackInfo(TrackInfo trackInfo)
                     throws java.lang.Exception

Add the track info to the list.

Parameters:

trackInfo - Describes a track

Throws:

java.lang.Exception - On badness

getTrackInfos

public java.util.List<TrackInfo> getTrackInfos()

Get list of TrackInfo-s.

Returns:

list of TrackInfo-s

getTrackInfo

public TrackInfo getTrackInfo(java.lang.String name)

Find the track info with the given name.

Parameters:

name - name of track info

Returns:

the track info or null if not found

getTrackWithTime

public visad.FlatField getTrackWithTime(java.lang.String trackId,
                                        java.lang.String variable,
                                        ucar.ma2.Range range)
                                 throws java.lang.Exception

Returns a track for the variable name specified. Returned track is of type:

 ((Latitude, Longitude, Altitude) -> (variable, Time)
 

Parameters:

trackId - Which track

variable - variable to get

range - The data range of the request

Returns:

FlatField of the type above.

Throws:

java.lang.Exception - On badness

getLastPointRange

public ucar.ma2.Range getLastPointRange(java.lang.String trackId)
                                 throws java.lang.Exception

Get the data range for the very last obs.

Parameters:

trackId - which track

Returns:

The range

Throws:

java.lang.Exception - On badness

getNumObservations

public int getNumObservations(java.lang.String trackId)
                       throws java.lang.Exception

get total number of obs_.

Parameters:

trackId - Which track

Returns:

num of obs

Throws:

java.lang.Exception - On badness

getPointObTrack

public visad.FieldImpl getPointObTrack(java.lang.String trackId,
                                       ucar.ma2.Range range)
                                throws java.lang.Exception

Take a FlatField of data and turn it into a field of PointObs.

Parameters:

trackId - Which track

range - The data range of the request

Returns:

field of PointObs

Throws:

java.lang.Exception - On badness

getTrack

public visad.FlatField getTrack(java.lang.String trackId,
                                java.lang.String variable,
                                ucar.ma2.Range range)
                         throws java.lang.Exception

Returns a track for the variable name specified. Returned track is of type:

 ((Latitude, Longitude, Altitude) -> (variable)
 

Parameters:

trackId - Which track

variable - variable of data

range - The data range of the request

Returns:

FlatField of the type above.

Throws:

java.lang.Exception - On badness

getAerologicalDiagramData

public visad.Data getAerologicalDiagramData(java.lang.String trackId)
                                     throws java.lang.Exception

Get the track data parameters necessary to plot an aerological diagram. Returned data is of type:

     (Time -> (AirPressure,
                AirTemperature,
                Dewpoint,
                (Speed, Direction),
                (Latitude, Longitude, Altitude)))
 

Parameters:

trackId - id of the track

Returns:

Data object in the format above

Throws:

java.lang.Exception - On badness

getBaseTime

public visad.DateTime getBaseTime()

Deprecated. use #getStartTime()

Get the base (starting) time of this track.

Returns:

starting time

getStartTime

public visad.DateTime getStartTime()

Get the starting time of this track.

Returns:

starting time

getEndTime

public visad.DateTime getEndTime()

Get the ending time of this track.

Returns:

ending time

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

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

includeInPointData

public boolean includeInPointData(java.lang.String varName)

Should we include the given var in the point data.

Parameters:

varName - Variable name

Returns:

Include in point data

getFilename

public java.lang.String getFilename()

Get the Filename property.

Returns:

The Filename

getDataSourceName

public java.lang.String getDataSourceName()

Gets the data source name.

Returns:

the data source name

getDataSourceDescription

public java.lang.String getDataSourceDescription()

Gets the data source description.

Returns:

the data source description

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object