ucar.unidata.data.radar

Class CDMRadarAdapter

java.lang.Object

ucar.unidata.data.radar.CDMRadarAdapter

All Implemented Interfaces:

RadarAdapter, RadarConstants

public class CDMRadarAdapter
extends java.lang.Object
implements RadarAdapter

A data adapter for Common Data Model radial data (Level II, Level III, DORADE)

Version:

$Revision: 1.54 $

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
CDMRadarAdapter() Zero-argument constructor for construction via unpersistence.
CDMRadarAdapter(DataSourceImpl source, java.lang.String fileName) Construct a new DORADE adapter.

Method Summary

Modifier and Type	Method and Description
void	clearCachedData() Clear the rds data
void	doRemove() Clean up whatever we need to when we are removed.
boolean	equals(java.lang.Object o) Check to see if this CDMDataSource is equal to the object in question.
protected double[]	getAngles(java.lang.String vname) Get the angles for this parameter
visad.DateTime	getBaseTime() Get the base time for this sweep
ucar.unidata.geoloc.Bearing	getBearing(double lat, double lon) calculate the bearing of one location to the radar location
visad.FieldImpl	getCAPPI(int moment, java.lang.String varName, visad.Real level) This api is based on the rsl c library from TRMM Office Radar Software Library.
java.lang.Object[]	getCutIdx(ucar.nc2.dt.RadialDatasetSweep.RadialVariable sweepVar) get radar sweep index
visad.DataImpl	getData(DataChoice dataChoice, DataSelection subset, java.util.Hashtable requestProperties) Get the data for the given DataChoice and selection criteria.
java.lang.String	getDataFormatName() Get the data format name (e.g.
float[]	getFloatNaN(int n) get float array init with NaN
float[]	getIntersectionOfRayAndLine(visad.georef.EarthLocation radarCenter, float azi, float lat3, float lon3, float lat4, float lon4) calculate the intersection of ray and a line
float[]	getIntersectionOfTwoLines(float lat1, float lon1, float lat2, float lon2, float lat3, float lon3, float lat4, float lon4) alculate the intersection of two lines
java.lang.String	getName() Return the name of the file
protected visad.RealType[]	getParams() Get the parameters for this adapter
visad.FieldImpl	getRadarCrossSection(int moment, java.lang.String varName, visad.georef.LatLonPoint p1, visad.georef.LatLonPoint p2) Makes a field of all data from one common data model radar adapter;
visad.georef.EarthLocation	getRadarStationInFile() Get the radar location from the dataset.
visad.FlatField	getRaster(int moment, java.lang.String varName) Create the initial spatial domain
visad.FieldImpl	getRHI(int moment, java.lang.String varName, double rhiAz) Makes a field of all data from one common data model radar adapter;
visad.FieldImpl	getRHIOld(int moment, java.lang.String varName, double rhiAz) Makes a field of all data from one common data model radar adapter;
visad.FieldImpl	getRHISweep(int moment, double azimus, java.lang.String varName, int idx, boolean want3D) Makes a field of all data from one common data model radar adapter;
visad.FlatField	getRHIVolume(int moment, java.lang.String varName) Makes a field of all data from one common data model radar adapter;
java.lang.String	getStationID() Get the station ID
visad.georef.EarthLocation	getStationLocation() Get the parameters for this adapter
java.lang.String	getStationName() Get the parameters for this adapter
visad.FlatField	getSweep(int moment, double elevation, java.lang.String varName, int idx, boolean want3D) Makes a field of all data from one common data model radar adapter;
int	getSweepNumber(java.lang.String vname, double angle) Get the sweep number for the particular variable and elevation angle
protected double	getVCPAngle(double angle, short id) Find the closest angle to the given VCP angles
protected double[]	getVCPAngles(short id, double[] origAngles) Get the parameters for this adapter
protected short	getVCPid(java.lang.String vname) Get the parameters for this adapter
visad.FlatField	getVolume(int moment, java.lang.String varName) Makes a field of all data from one common data model radar adapter;
int	hashCode() Get the hash code for this object.
boolean	isRaster() Get the parameters for this adapter
boolean	isRHI() Get the parameters for this adapter
boolean	isVolume() Get the parameters for this adapter
static void	main(java.lang.String[] args) main
static void	mainDorade(java.lang.String[] args) Test main
visad.georef.LatLonPoint	setCrossSectionLinePosition(float azi) setting the init crosssection line position with azimuth angle
void	setStationLocation(visad.georef.EarthLocation el) Set the station location
java.lang.String	toString() to String.

Methods inherited from class java.lang.Object

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

Constructor Detail

CDMRadarAdapter

public CDMRadarAdapter()

Zero-argument constructor for construction via unpersistence.

CDMRadarAdapter

public CDMRadarAdapter(DataSourceImpl source,
                       java.lang.String fileName)
                throws visad.VisADException

Construct a new DORADE adapter.

Parameters:

source - DataSource (may be null)

fileName - name of the DORADE file to read

Throws:

visad.VisADException - problem creating data

Method Detail

equals

public boolean equals(java.lang.Object o)

Check to see if this CDMDataSource is equal to the object in question.

Overrides:

equals in class java.lang.Object

Parameters:

o - object in question

Returns:

true if they are the same or equivalent objects

hashCode

public int hashCode()

Get the hash code for this object.

Overrides:

hashCode in class java.lang.Object

Returns:

hash code.

getRadarStationInFile

public visad.georef.EarthLocation getRadarStationInFile()

Get the radar location from the dataset.

Returns:

EarthLocation.

toString

public java.lang.String toString()

to String.

Overrides:

toString in class java.lang.Object

Returns:

to string

getAngles

protected double[] getAngles(java.lang.String vname)

Get the angles for this parameter

Parameters:

vname - variable name

Returns:

angles for that variable

getBaseTime

public visad.DateTime getBaseTime()

Get the base time for this sweep

Specified by:

getBaseTime in interface RadarAdapter

Returns:

time of sweep

getVCPid

protected short getVCPid(java.lang.String vname)

Get the parameters for this adapter

Parameters:

vname - variable name

Returns:

id for that variable

getVCPAngles

protected double[] getVCPAngles(short id,
                                double[] origAngles)

Get the parameters for this adapter

Parameters:

id - vcp id number

origAngles - The original angles

Returns:

dd vcp angles

getVCPAngle

protected double getVCPAngle(double angle,
                             short id)

Find the closest angle to the given VCP angles

Parameters:

angle - to find

id - of VCP

Returns:

ang for angle;

getCAPPI

public visad.FieldImpl getCAPPI(int moment,
                                java.lang.String varName,
                                visad.Real level)
                         throws visad.VisADException,
                                java.rmi.RemoteException,
                                java.io.IOException

This api is based on the rsl c library from TRMM Office Radar Software Library.

Parameters:

moment - the moment

varName - variable name

level - the level

Returns:

capi as a FieldImpl

Throws:

java.io.IOException - problem reading the file

java.rmi.RemoteException - problem with Java RMI

visad.VisADException - problem creating VisAD object

getData

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

Get the data for the given DataChoice and selection criteria.

Specified by:

getData in interface RadarAdapter

Parameters:

dataChoice - DataChoice for selection

subset - subsetting criteria

requestProperties - extra request properties

Returns:

the Data object for the request

Throws:

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

visad.VisADException - couldn't create the data

clearCachedData

public void clearCachedData()

Clear the rds data

Specified by:

clearCachedData in interface RadarAdapter

getName

public java.lang.String getName()

Return the name of the file

Specified by:

getName in interface RadarAdapter

Returns:

name

getParams

protected visad.RealType[] getParams()

Get the parameters for this adapter

Returns:

parameters

getRHIOld

public visad.FieldImpl getRHIOld(int moment,
                                 java.lang.String varName,
                                 double rhiAz)
                          throws visad.VisADException,
                                 java.rmi.RemoteException,
                                 java.io.IOException

Makes a field of all data from one common data model radar adapter;

Parameters:

moment - moment

varName - variable name

rhiAz - azimuth for RHI

Returns:

rhi as a FieldImpl

Throws:

java.io.IOException - Problem reading data

java.rmi.RemoteException - Java RMI problem

visad.VisADException - Couldn't create VisAD Object

getRadarCrossSection

public visad.FieldImpl getRadarCrossSection(int moment,
                                            java.lang.String varName,
                                            visad.georef.LatLonPoint p1,
                                            visad.georef.LatLonPoint p2)
                                     throws visad.VisADException,
                                            java.io.IOException

Makes a field of all data from one common data model radar adapter;

Parameters:

moment - moment

varName - variable name

p1 - cross lint start point

p2 - cross lint end point

Returns:

a FieldImpl

Throws:

java.io.IOException - Problem reading data

visad.VisADException - Couldn't create VisAD Object

getBearing

public ucar.unidata.geoloc.Bearing getBearing(double lat,
                                              double lon)

calculate the bearing of one location to the radar location

Parameters:

lat - input latitude

lon - input longitude

Returns:

bearing

setCrossSectionLinePosition

public visad.georef.LatLonPoint setCrossSectionLinePosition(float azi)
                                                     throws visad.VisADException,
                                                            java.rmi.RemoteException

setting the init crosssection line position with azimuth angle

Parameters:

azi - input azimuth angle

Returns:

lat lon point

Throws:

java.rmi.RemoteException

visad.VisADException

getIntersectionOfRayAndLine

public float[] getIntersectionOfRayAndLine(visad.georef.EarthLocation radarCenter,
                                           float azi,
                                           float lat3,
                                           float lon3,
                                           float lat4,
                                           float lon4)

calculate the intersection of ray and a line

Parameters:

radarCenter - earthlocation of radar

azi - ray azimuth

lat3 - line latitude of one end

lon3 - line longitude of one end

lat4 - line latitude of another end

lon4 - _more_

Returns:

lat lon points

getIntersectionOfTwoLines

public float[] getIntersectionOfTwoLines(float lat1,
                                         float lon1,
                                         float lat2,
                                         float lon2,
                                         float lat3,
                                         float lon3,
                                         float lat4,
                                         float lon4)

alculate the intersection of two lines

Parameters:

lat1 - latitude of line 1

lon1 - longitude of line 1

lat2 - latitude of line 1

lon2 - longitude of line 1

lat3 - latitude of line 2

lon3 - longitude of line 2

lat4 - latitude of line 2

lon4 - longitude of line 2

Returns:

lat lon float array

getRHI

public visad.FieldImpl getRHI(int moment,
                              java.lang.String varName,
                              double rhiAz)
                       throws visad.VisADException,
                              java.rmi.RemoteException,
                              java.io.IOException

Makes a field of all data from one common data model radar adapter;

Parameters:

moment - moment

varName - variable name

rhiAz - azimuth for RHI

Returns:

rhi as a FieldImpl

Throws:

java.io.IOException - Problem reading data

java.rmi.RemoteException - Java RMI problem

visad.VisADException - Couldn't create VisAD Object

getStationID

public java.lang.String getStationID()

Get the station ID

Returns:

the station ID

getStationLocation

public visad.georef.EarthLocation getStationLocation()

Get the parameters for this adapter

Returns:

parameters

setStationLocation

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

Set the station location

Parameters:

el - location of the radar

Throws:

visad.VisADException - couldn't create VisAD object

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

getStationName

public java.lang.String getStationName()

Get the parameters for this adapter

Returns:

parameters

getDataFormatName

public java.lang.String getDataFormatName()

Get the data format name (e.g. Level II, DORADE, etc)

Returns:

the format name

getRaster

public visad.FlatField getRaster(int moment,
                                 java.lang.String varName)
                          throws visad.VisADException,
                                 java.rmi.RemoteException,
                                 java.io.IOException,
                                 ucar.ma2.InvalidRangeException

Create the initial spatial domain

Parameters:

moment -

varName - variable name

Returns:

The initial spatial domain

Throws:

java.io.IOException - Problem reading data

ucar.ma2.InvalidRangeException - Problem reading data

java.rmi.RemoteException - Java RMI problem

visad.VisADException - problem creating domain

getRHISweep

public visad.FieldImpl getRHISweep(int moment,
                                   double azimus,
                                   java.lang.String varName,
                                   int idx,
                                   boolean want3D)
                            throws visad.VisADException,
                                   java.rmi.RemoteException,
                                   java.io.IOException

Makes a field of all data from one common data model radar adapter;

Parameters:

moment - moment

azimus - azimuth angle

varName - variable name

idx - index

want3D - true if should return a 3D field

Returns:

sweep as a FieldImpl

Throws:

java.io.IOException - Problem reading data

java.rmi.RemoteException - Java RMI problem

visad.VisADException - Couldn't create VisAD Object

getSweep

public visad.FlatField getSweep(int moment,
                                double elevation,
                                java.lang.String varName,
                                int idx,
                                boolean want3D)
                         throws visad.VisADException,
                                java.rmi.RemoteException,
                                java.io.IOException

Makes a field of all data from one common data model radar adapter;

Parameters:

moment - moment

elevation - elevation angle

varName - variable name

idx - _more_

want3D - true if should return a 3D field

Returns:

sweep as a FieldImpl

Throws:

java.io.IOException - Problem reading data

java.rmi.RemoteException - Java RMI problem

visad.VisADException - Couldn't create VisAD Object

getSweepNumber

public int getSweepNumber(java.lang.String vname,
                          double angle)

Get the sweep number for the particular variable and elevation angle

Parameters:

vname - variable name

angle - elevation angle

Returns:

the index of the sweep in the dataset

getCutIdx

public java.lang.Object[] getCutIdx(ucar.nc2.dt.RadialDatasetSweep.RadialVariable sweepVar)

get radar sweep index

Parameters:

sweepVar - radar variable

Returns:

sweep index array

getVolume

public visad.FlatField getVolume(int moment,
                                 java.lang.String varName)
                          throws visad.VisADException,
                                 java.rmi.RemoteException,
                                 java.io.IOException

Makes a field of all data from one common data model radar adapter;

Parameters:

moment - moment

varName - variable name

Returns:

volume as a FieldImpl

Throws:

java.io.IOException - Problem reading data

java.rmi.RemoteException - Java RMI problem

visad.VisADException - Couldn't create VisAD Object

getRHIVolume

public visad.FlatField getRHIVolume(int moment,
                                    java.lang.String varName)
                             throws visad.VisADException,
                                    java.rmi.RemoteException,
                                    java.io.IOException

Makes a field of all data from one common data model radar adapter;

Parameters:

moment - moment

varName - variable name

Returns:

volume as a FieldImpl

Throws:

java.io.IOException - Problem reading data

java.rmi.RemoteException - Java RMI problem

visad.VisADException - Couldn't create VisAD Object

getFloatNaN

public float[] getFloatNaN(int n)

get float array init with NaN

Parameters:

n - 1 D array length

Returns:

float array

isRaster

public boolean isRaster()

Get the parameters for this adapter

Returns:

parameters

isVolume

public boolean isVolume()

Get the parameters for this adapter

Returns:

parameters

isRHI

public boolean isRHI()

Get the parameters for this adapter

Returns:

parameters

mainDorade

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

Test main

Parameters:

args - cmd line args

Throws:

java.lang.Exception - when bad things happen

main

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

main

Parameters:

args - args

Throws:

java.lang.Exception - On badness

doRemove

public void doRemove()

Clean up whatever we need to when we are removed.

Specified by:

doRemove in interface RadarAdapter