Level2Record (Unidata IDV API v6.3)

java.lang.Object
- ucar.unidata.data.radar.Level2Record

```
public class Level2Record
extends java.lang.Object
```
This class reads a specified record a NEXRAD level II file and provides methods to retrieve selected data from it. Will probably change in the future. Adapted with permission from the Java Iras software developed by David Priegnitz at NSSL.

Version:

$Revision: 1.13 $ $Date: 2006/12/01 20:42:38 $

Author:

MetApps Development Team

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`data_lut_init_flag` Initialization flag for lookup tables
`static int`	`DATA_NOT_FOUND` Value for data not fount
`static float`	`DOPPLER_RESOLUTION_HIGH` High resolution value
`static int`	`DOPPLER_RESOLUTION_HIGH_CODE` High doppler resolution code
`static float`	`DOPPLER_RESOLUTION_LOW` Low resolution value
`static int`	`DOPPLER_RESOLUTION_LOW_CODE` Low doppler resolution code
`static int`	`FILE_HEADER_SIZE` Size of the file header
`static float`	`HORIZONTAL_BEAM_WIDTH` Horizontal beam width
`static float`	`KM_PER_NM` Kilometer to nautical mile conversion
`static int`	`MAX_RADIALS_IN_CUT` Maximum radials in a cut
`static int`	`RADAR_DATA_SIZE` Size of the radar data
`static int`	`RECORD_HEADER_SIZE` Size of the record header
`static int`	`REFLECTIVITY` Reflectivity moment identifier
`static float[]`	`Reflectivity_LUT` Reflectivity look up table
`static int`	`SIGNAL_BELOW_THRESHOLD` Value for signal below threshold
`static int`	`SIGNAL_OVERLAID` Value for overlaid signal
`static int`	`SPECTRUM_WIDTH` Sprectrum Width moment identifier
`static int`	`VELOCITY` Radial Velocity moment identifier
`static float[]`	`Velocity_1km_LUT` 1 km Velocity look up table
`static float[]`	`Velocity_hkm_LUT` 1/2 km Velocity look up table

Constructor Summary

Constructors
Constructor and Description

Level2Record()
Default constructor; does nothing

Constructors
Constructor and Description
`Level2Record()` Default constructor; does nothing

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`int`	`eof()` Get the end-of-file flag
`float`	`getAzimuth()` Get the azimuth for the current read
`int`	`getBinData(int moment, int radial, int bin)` This method returns a bin data element from the specified read level II record.
`int`	`getBinNum(int moment)` This method returns the number of bins defined for the specified moment in a read level II record.
`int`	`getBinSize(int moment)` This method returns the radial bin size (meters) for the specified moment in a read level II record.
`float`	`getBinValue(int moment, int radial, int bin)` This method returns a bin data value from the specified read level II record.
`float`	`getElevation()` Get the elevation angle for the current read
`short`	`getElevationNum()` Get the elevation number for the current read
`short`	`getMessageType()` Get the message type for the current read
`short`	`getVCP()` Get the Volume Coverage Pattern (VCP) for this record
`void`	`readAngles(ucar.netcdf.RandomAccessFile din, int record)` Read the angles from the file
`int`	`readCut(ucar.netcdf.RandomAccessFile din, int record)` Method to read a selected cut from a specified level II file.
`void`	`readHeader(ucar.netcdf.RandomAccessFile din, int record)` Method to read a selected header from a specified level II file.
`void`	`readRecord(ucar.netcdf.RandomAccessFile din, int record)` Method to read a selected record from a specified level II file.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - RECORD_HEADER_SIZE
```
public static final int RECORD_HEADER_SIZE
```
    Size of the record header
    
    See Also:
    
    Constant Field Values
  - FILE_HEADER_SIZE
```
public static final int FILE_HEADER_SIZE
```
    Size of the file header
    
    See Also:
    
    Constant Field Values
  - RADAR_DATA_SIZE
```
public static final int RADAR_DATA_SIZE
```
    Size of the radar data
    
    See Also:
    
    Constant Field Values
  - REFLECTIVITY
```
public static final int REFLECTIVITY
```
    Reflectivity moment identifier
    
    See Also:
    
    Constant Field Values
  - VELOCITY
```
public static final int VELOCITY
```
    Radial Velocity moment identifier
    
    See Also:
    
    Constant Field Values
  - SPECTRUM_WIDTH
```
public static final int SPECTRUM_WIDTH
```
    Sprectrum Width moment identifier
    
    See Also:
    
    Constant Field Values
  - SIGNAL_BELOW_THRESHOLD
```
public static final int SIGNAL_BELOW_THRESHOLD
```
    Value for signal below threshold
    
    See Also:
    
    Constant Field Values
  - SIGNAL_OVERLAID
```
public static final int SIGNAL_OVERLAID
```
    Value for overlaid signal
    
    See Also:
    
    Constant Field Values
  - DATA_NOT_FOUND
```
public static final int DATA_NOT_FOUND
```
    Value for data not fount
    
    See Also:
    
    Constant Field Values
  - DOPPLER_RESOLUTION_LOW_CODE
```
public static final int DOPPLER_RESOLUTION_LOW_CODE
```
    Low doppler resolution code
    
    See Also:
    
    Constant Field Values
  - DOPPLER_RESOLUTION_HIGH_CODE
```
public static final int DOPPLER_RESOLUTION_HIGH_CODE
```
    High doppler resolution code
    
    See Also:
    
    Constant Field Values
  - DOPPLER_RESOLUTION_LOW
```
public static final float DOPPLER_RESOLUTION_LOW
```
    Low resolution value
    
    See Also:
    
    Constant Field Values
  - DOPPLER_RESOLUTION_HIGH
```
public static final float DOPPLER_RESOLUTION_HIGH
```
    High resolution value
    
    See Also:
    
    Constant Field Values
  - MAX_RADIALS_IN_CUT
```
public static final int MAX_RADIALS_IN_CUT
```
    Maximum radials in a cut
    
    See Also:
    
    Constant Field Values
  - HORIZONTAL_BEAM_WIDTH
```
public static final float HORIZONTAL_BEAM_WIDTH
```
    Horizontal beam width
    
    See Also:
    
    Constant Field Values
  - KM_PER_NM
```
public static final float KM_PER_NM
```
    Kilometer to nautical mile conversion
    
    See Also:
    
    Constant Field Values
  - data_lut_init_flag
```
public static int data_lut_init_flag
```
    Initialization flag for lookup tables
  - Reflectivity_LUT
```
public static float[] Reflectivity_LUT
```
    Reflectivity look up table
  - Velocity_1km_LUT
```
public static float[] Velocity_1km_LUT
```
    1 km Velocity look up table
  - Velocity_hkm_LUT
```
public static float[] Velocity_hkm_LUT
```
    1/2 km Velocity look up table
- Constructor Detail
  - Level2Record
```
public Level2Record()
```
    Default constructor; does nothing
- Method Detail
  - readAngles
```
public void readAngles(ucar.netcdf.RandomAccessFile din,
                       int record)
```
    Read the angles from the file
    
    Parameters:
    
    din - file to read from
    
    record - record to read
  - readHeader
```
public void readHeader(ucar.netcdf.RandomAccessFile din,
                       int record)
```
    Method to read a selected header from a specified level II file.
    
    Parameters:
    
    din - file to read from
    
    record - record to read
  - readRecord
```
public void readRecord(ucar.netcdf.RandomAccessFile din,
                       int record)
```
    Method to read a selected record from a specified level II file.
    
    Parameters:
    
    din - file to read from
    
    record - record to read
  - readCut
```
public int readCut(ucar.netcdf.RandomAccessFile din,
                   int record)
```
    Method to read a selected cut from a specified level II file.
    
    Parameters:
    
    din - file to read from
    
    record - record to read
    
    Returns:
    
    number of radials in the cut
  - getAzimuth
```
public float getAzimuth()
```
    Get the azimuth for the current read
    
    Returns:
    
    azimuth value
  - getElevation
```
public float getElevation()
```
    Get the elevation angle for the current read
    
    Returns:
    
    elevation angle
  - getElevationNum
```
public short getElevationNum()
```
    Get the elevation number for the current read
    
    Returns:
    
    elevation number
  - getMessageType
```
public short getMessageType()
```
    Get the message type for the current read
    
    Returns:
    
    message type
  - getVCP
```
public short getVCP()
```
    Get the Volume Coverage Pattern (VCP) for this record
    
    Returns:
    
    volume coverage pattern
  - eof
```
public int eof()
```
    Get the end-of-file flag
    
    Returns:
    
    EOF flag
  - getBinSize
```
public int getBinSize(int moment)
```
    This method returns the radial bin size (meters) for the specified moment in a read level II record.
    
    Parameters:
    
    moment - moment id
    
    Returns:
    
    radial bin size
  - getBinNum
```
public int getBinNum(int moment)
```
    This method returns the number of bins defined for the specified moment in a read level II record.
    
    Parameters:
    
    moment - moment id
    
    Returns:
    
    number of bins for this moment
  - getBinData
```
public int getBinData(int moment,
                      int radial,
                      int bin)
```
    This method returns a bin data element from the specified read level II record.
    
    Parameters:
    
    moment - moment id
    
    radial - radial index
    
    bin - bin index
    
    Returns:
    
    bin data element
  - getBinValue
```
public float getBinValue(int moment,
                         int radial,
                         int bin)
```
    This method returns a bin data value from the specified read level II record.
    
    Parameters:
    
    moment - moment ID
    
    radial - radial index
    
    bin - bin index
    
    Returns:
    
    bin data value

Class Level2Record

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

RECORD_HEADER_SIZE

FILE_HEADER_SIZE

RADAR_DATA_SIZE

REFLECTIVITY

VELOCITY

SPECTRUM_WIDTH

SIGNAL_BELOW_THRESHOLD

SIGNAL_OVERLAID

DATA_NOT_FOUND

DOPPLER_RESOLUTION_LOW_CODE

DOPPLER_RESOLUTION_HIGH_CODE

DOPPLER_RESOLUTION_LOW

DOPPLER_RESOLUTION_HIGH

MAX_RADIALS_IN_CUT

HORIZONTAL_BEAM_WIDTH

KM_PER_NM

data_lut_init_flag

Reflectivity_LUT

Velocity_1km_LUT

Velocity_hkm_LUT

Constructor Detail

Level2Record

Method Detail

readAngles

readHeader

readRecord

readCut

getAzimuth

getElevation

getElevationNum

getMessageType

getVCP

eof

getBinSize

getBinNum

getBinData

getBinValue