Actions

Difference between revisions of "RadxEvad"

From Lrose Wiki

Line 1: Line 1:
 +
=== '''Overview''' ===
 +
 
RadxEvad reads in Doppler data from a polar radar file, computes volumetric VAD (VVP) winds and writes them out to NetCDF.
 
RadxEvad reads in Doppler data from a polar radar file, computes volumetric VAD (VVP) winds and writes them out to NetCDF.
 +
 +
 +
=== '''Prerequesites''' ===
 +
 +
The following items are required:
 +
 +
* Radar data (any Radx supported format, e.g., cfradial)
 +
 +
 +
=== '''Parameter file''' ===
 +
 +
RadxBufr uses one parameter file that includes the basic parameters related to data location and field names, which is similar to the parameter files for the other Radx applications.
 +
 +
==== '''Ensure file is up to date''' ====
 +
 +
To obtain the default parameter file, use the following command:
 +
 +
<code lang="bash">/path/to/lrose/install/bin/RadxBufr -print_params &gt; param_file_name</code>
 +
 +
If you already have a parameter file and simply want to check for (and add) updated parameters while retaining current parameters, use the following command:
 +
 +
<code lang="bash">/path/to/lrose/install/bin/RadxBufr -params orig_param_file_name -print_params &gt; new_param_file_name</code>
 +
 +
 +
==== '''Important parameters''' ====
 +
 +
Input params
 +
 +
* input_dir: directory containing radar data (if not specified on the command line and if mode = REALTIME)
 +
 +
 +
Table path
 +
 +
* mode: determines if the program waits for new files (REALTIME), moves through start and end times specified on the command line (ARCHIVE), or moves through list of files specified on the command line (FILELIST)
 +
 +
 +
Option to specify field names and output encoding
 +
 +
* set_output_fields: option to specify fields or include all fields in the final output files
 +
* output_fields: list of field names, units, scaling, offset, etc.
 +
 +
 +
Censoring
 +
 +
* apply_censoring: option to censor fields where gates meet certain criteria
 +
* censoring_fields: list fields, minimum and maximum values, and combination method to determine whether a gate should be censored
 +
 +
 +
Output format
 +
 +
* output_format: select the preferred file type (usually CFRADIAL)
 +
 +
 +
Output directory and file name
 +
 +
* output_dir: files will be written to this directory
 +
  
 
=== '''Running RadxEvad''' ===
 
=== '''Running RadxEvad''' ===

Revision as of 18:18, 14 April 2021

Overview

RadxEvad reads in Doppler data from a polar radar file, computes volumetric VAD (VVP) winds and writes them out to NetCDF.


Prerequesites

The following items are required:

  • Radar data (any Radx supported format, e.g., cfradial)


Parameter file

RadxBufr uses one parameter file that includes the basic parameters related to data location and field names, which is similar to the parameter files for the other Radx applications.

Ensure file is up to date

To obtain the default parameter file, use the following command:

/path/to/lrose/install/bin/RadxBufr -print_params > param_file_name

If you already have a parameter file and simply want to check for (and add) updated parameters while retaining current parameters, use the following command:

/path/to/lrose/install/bin/RadxBufr -params orig_param_file_name -print_params > new_param_file_name


Important parameters

Input params

  • input_dir: directory containing radar data (if not specified on the command line and if mode = REALTIME)


Table path

  • mode: determines if the program waits for new files (REALTIME), moves through start and end times specified on the command line (ARCHIVE), or moves through list of files specified on the command line (FILELIST)


Option to specify field names and output encoding

  • set_output_fields: option to specify fields or include all fields in the final output files
  • output_fields: list of field names, units, scaling, offset, etc.


Censoring

  • apply_censoring: option to censor fields where gates meet certain criteria
  • censoring_fields: list fields, minimum and maximum values, and combination method to determine whether a gate should be censored


Output format

  • output_format: select the preferred file type (usually CFRADIAL)


Output directory and file name

  • output_dir: files will be written to this directory


Running RadxEvad

To check all command line options for RadxEvad, including debugging options and file paths, the typical '-h' flag can be invoked:

/path/to/lrose/install/bin/RadxEvad -h

Likewise, to obtain the default parameter file, use the following command:

/path/to/lrose/install/bin/RadxEvad -print_params > RadxEvad.params

Use the following command to convert using the settings provided by the parameter file:

/path/to/lrose/install/bin/RadxEvad -f <path/to/data/file_name> -params $PWD/RadxEvad.params