ucar.unidata.data.radar

Class Level2Adapter

java.lang.Object

ucar.unidata.data.radar.Level2Adapter

All Implemented Interfaces:

RadarAdapter, RadarConstants

public class Level2Adapter
extends java.lang.Object
implements RadarAdapter

Adapt an Archive Level II file to a VisAD data structure.

Version:

$Revision: 1.111 $

Author:

IDV Development team

Field Summary

Fields inherited from interface ucar.unidata.data.radar.RadarAdapter

AZIMUTH_ANGLE_TYPE, AZIMUTH_TYPE, ELEVATION_ANGLE_TYPE, RANGE_TYPE

Fields inherited from interface ucar.unidata.data.radar.RadarConstants

AZIMUTH, AZIMUTH_ANGLE, ELEVATION_ANGLE, PROP_2DOR3D, PROP_ANGLE, PROP_ANGLES, PROP_AZIMUTH, PROP_AZIMUTHS, PROP_CAPPI_LEVEL, PROP_CAPPI_LEVELS, PROP_TIMEHEIGHT, PROP_VCS, PROP_VCS_END, PROP_VCS_START, PROP_VOLUMEORSWEEP, PROP_VWP, RADAR_MOST_RECENT, RADIAL_VELOCITY_NAME, RANGE, REFLECTIVITY, REFLECTIVITY_NAME, SPECTRUM_WIDTH, SPECTRUM_WIDTH_NAME, STATION_LOCATION, VALUE_2D, VALUE_3D, VALUE_SWEEP, VALUE_VOLUME, VELOCITY

Constructor Summary

Constructors

Constructor and Description
Level2Adapter(DataSourceImpl source, java.lang.String filename) Construct a new Level2Adapter
Level2Adapter(DataSourceImpl source, java.lang.String filename, visad.georef.EarthLocation radarLocation) Construct a new Level2Adapter for the radar location given

Method Summary

Modifier and Type	Method and Description
void	clearCachedData() Implement the interce.
void	doRemove() Clean up whatever we need to when we are removed.
double[]	getAngles() Get the array of sweep tilts in this files volume scan.
visad.DateTime	getBaseTime() Get the starting time of this Volume
visad.FieldImpl	getCAPPI(int moment, visad.Real level) Get a CAPPI for the given moment at the given level
visad.FlatField	getCut(int moment, double elevation) Get a 2D sweep of a particular moment at the specified elevation angle.
visad.FlatField	getCut(int moment, double elevation, boolean want3D) Get a 2D sweep of a particular moment at the specified elevation angle.
visad.DataImpl	getData(DataChoice choice, DataSelection ds, java.util.Hashtable requestProperties) Get the data for this DataChoice
static java.lang.String	getMomentName(int moment) Print out the name of the moment.
java.lang.String	getName() Return the name of the file
visad.FieldImpl	getRHI(int moment, double rhiAz) Get an RHI for the given azimuth
static NamedStationTable	getStations() Read in the nexrad stations from the idv/resources/nexradstns.xml resource
visad.FlatField	getVolume(int moment) Makes a field of all data from one level II file (one volume scan); which is composed of severla azimuthal sweeps at different angles (titls, elevations) above the horizontal.
visad.FlatField	getVWP(double altitudeLimit) Make a data object to display in the IDV as a VAD Wind Profile.
void	setRadarLocation(visad.georef.EarthLocation el) Set the radar location
java.lang.String	toString() String representation of this adapter.

Methods inherited from class java.lang.Object

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

Constructor Detail

Level2Adapter

public Level2Adapter(DataSourceImpl source,
                     java.lang.String filename)
              throws visad.VisADException,
                     java.rmi.RemoteException,
                     java.io.IOException

Construct a new Level2Adapter

Parameters:

source - DataSource for caching

filename - path of file

Throws:

visad.VisADException - couldn't create VisAD object

java.rmi.RemoteException - couldn't create remote object

java.io.IOException - problem opening or reading file

Level2Adapter

public Level2Adapter(DataSourceImpl source,
                     java.lang.String filename,
                     visad.georef.EarthLocation radarLocation)
              throws visad.VisADException,
                     java.rmi.RemoteException,
                     java.io.IOException

Construct a new Level2Adapter for the radar location given

Parameters:

source - DataSource for caching

filename - path of file

radarLocation - location of the radar

Throws:

visad.VisADException - couldn't create VisAD object

java.rmi.RemoteException - couldn't create remote object

java.io.IOException - problem opening or reading file

Method Detail

clearCachedData

public void clearCachedData()

Implement the interce. For now lets not do anything

Specified by:

clearCachedData in interface RadarAdapter

getBaseTime

public visad.DateTime getBaseTime()

Get the starting time of this Volume

Specified by:

getBaseTime in interface RadarAdapter

Returns:

starting time

getAngles

public double[] getAngles()

Get the array of sweep tilts in this files volume scan.

Returns:

tilts

setRadarLocation

public void setRadarLocation(visad.georef.EarthLocation el)
                      throws visad.VisADException,
                             java.rmi.RemoteException

Set the radar location

Parameters:

el - location of the radar

Throws:

visad.VisADException - couldn't create VisAD object

java.rmi.RemoteException - couldn't create remote object

getData

public visad.DataImpl getData(DataChoice choice,
                              DataSelection ds,
                              java.util.Hashtable requestProperties)
                       throws visad.VisADException,
                              java.rmi.RemoteException

Get the data for this DataChoice

Specified by:

getData in interface RadarAdapter

Parameters:

choice - choice describing the data

ds - sub-selection criteria

requestProperties - extra request criteria (e.g, used to get RHI azimuth)

Returns:

VisAD Data object corresponding to this DataChoice

Throws:

visad.VisADException - couldn't create VisAD object

java.rmi.RemoteException - couldn't create remote object

getCut

public visad.FlatField getCut(int moment,
                              double elevation)
                       throws visad.VisADException,
                              java.rmi.RemoteException

Get a 2D sweep of a particular moment at the specified elevation angle.

Parameters:

moment - moment (REFLECTIVITY, VELOCITY, SPECTRUM_WIDTH) of data

elevation - elevation angle

Returns:

a FlatField representation of the cut

Throws:

java.rmi.RemoteException - couldn't create remote object

visad.VisADException - couldn't create VisAD object

getCut

public visad.FlatField getCut(int moment,
                              double elevation,
                              boolean want3D)
                       throws visad.VisADException,
                              java.rmi.RemoteException

Get a 2D sweep of a particular moment at the specified elevation angle.

Parameters:

moment - moment (REFLECTIVITY, VELOCITY, SPECTRUM_WIDTH) of data

elevation - elevation angle

want3D - true if you want this as a 3-D field

Returns:

a 2- or 3-D FlatField representation of the cut

Throws:

java.rmi.RemoteException - couldn't create remote object

visad.VisADException - couldn't create VisAD object

getVWP

public visad.FlatField getVWP(double altitudeLimit)
                       throws visad.VisADException,
                              java.rmi.RemoteException

Make a data object to display in the IDV as a VAD Wind Profile. for one time.

Parameters:

altitudeLimit - typically 10 to 15 km; highest wind used.

Returns:

VWP for the given altitude limit

Throws:

java.rmi.RemoteException - couldn't create remote object

visad.VisADException - couldn't create VisAD object

getRHI

public visad.FieldImpl getRHI(int moment,
                              double rhiAz)
                       throws visad.VisADException,
                              java.rmi.RemoteException

Get an RHI for the given azimuth

Parameters:

moment - moment (REFLECTIVITY, VELOCITY, SPECTRUM_WIDTH) of data

rhiAz - azimuth for the RHI

Returns:

RHI as a Field of FlatFields, each for a particular elevation angle

Throws:

java.rmi.RemoteException - couldn't create remote object

visad.VisADException - couldn't create VisAD object

getCAPPI

public visad.FieldImpl getCAPPI(int moment,
                                visad.Real level)
                         throws visad.VisADException,
                                java.rmi.RemoteException

Get a CAPPI for the given moment at the given level

Parameters:

moment - moment (REFLECTIVITY, VELOCITY, SPECTRUM_WIDTH) of data

level - level (Altitude)

Returns:

CAPPI as a Field

Throws:

java.rmi.RemoteException - couldn't create remote object

visad.VisADException - couldn't create VisAD object

toString

public java.lang.String toString()

String representation of this adapter.

Overrides:

toString in class java.lang.Object

Returns:

String representation of this object

getName

public java.lang.String getName()

Return the name of the file

Specified by:

getName in interface RadarAdapter

Returns:

name

getVolume

public visad.FlatField getVolume(int moment)
                          throws visad.VisADException,
                                 java.rmi.RemoteException

Makes a field of all data from one level II file (one volume scan); which is composed of severla azimuthal sweeps at different angles (titls, elevations) above the horizontal. Character of data field when plotted with ColorRadarVolumeControl is colored data point values (pixels) along beam lines, forming semi-transparent nested cones, not filled surfaces.

Parameters:

moment - moment (REFLECTIVITY, VELOCITY, SPECTRUM_WIDTH) of data

Returns:

volume as a FieldImpl

Throws:

java.rmi.RemoteException - couldn't create remote object

visad.VisADException - couldn't create VisAD object

getStations

public static NamedStationTable getStations()

Read in the nexrad stations from the idv/resources/nexradstns.xml resource

Returns:

List of of NamedStation-s

getMomentName

public static java.lang.String getMomentName(int moment)

Print out the name of the moment.

Parameters:

moment - radar moment (ex: REFLECTIVITY)

Returns:

a String name of the moment (ex: "Reflectivity");

doRemove

public void doRemove()

Clean up whatever we need to when we are removed.

Specified by:

doRemove in interface RadarAdapter