Actions

Difference between revisions of "RadxPersistentClutter"

From Lrose Wiki

(Created page with "RadxPersistentClutter reads data from Radx-supported format files, runs a filter on specified fields, and writes out the results. === '''Overview''' === RadxPersistentClutte...")
 
 
Line 1: Line 1:
RadxPersistentClutter reads data from Radx-supported format files, runs a filter on specified fields, and writes out the results.
+
RadxPersistentClutter sets clutter locations of one input field.
  
 
=== '''Overview''' ===
 
=== '''Overview''' ===
  
RadxPersistentClutter reads data from Radx-supported format files, runs a filter on specified fields, and writes out the results.
+
RadxPersistentClutter sets clutter locations of one input field.
 +
 
 +
 
 +
=== '''Scientific Background''' ===
 +
 
 +
Based on the following paper.
 +
 
 +
Lakshmanan V., J. Zhang, K. Hondl and C. Langston: A Statistical Approach to Mitigating Persistent Clutter in Radar Reflectivity Data. IEEE Journal of Selected Topics in Applied Earth Observations and Remote Sensing, Vol. 5, No. 2, April 2012.
  
  
Line 30: Line 37:
 
==== '''Important parameters''' ====
 
==== '''Important parameters''' ====
  
Data input
+
TDRP params
  
* input_dir: directory containing radar data (if not specified on the command line and if mode = REALTIME)
+
* input_field: name the field to find clutter in
 +
* output_field: name to give the final clutter field
 
* 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)
 
* 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)
 +
* output_url: files will be written to this directory
  
  
Specifying the fields to be read in
+
Input paths
 
 
* select_fields: option to select fields for interpolation, otherwise all fields will be processed
 
* selected_fields: specify fields to process
 
* rename_fields: option to rename some or all fields
 
* renamed_fields: specify fields to be renamed and new field names
 
 
 
 
 
Filter details
 
 
 
* field_filters: list of field names, filter type (e.g., median, triangular, least squares, none), and filter length (odd number)
 
 
 
 
 
Output format
 
 
 
* output_format: select the preferred file type (usually CFRADIAL)
 
 
 
 
 
Output directory and filename
 
 
 
* output_dir: files will be written to this directory
 
  
 +
* input: index, path, tolerance levels
 +
* field_mapping: list of input fields and index to the path of that data
  
  

Latest revision as of 22:11, 31 March 2021

RadxPersistentClutter sets clutter locations of one input field.

Overview

RadxPersistentClutter sets clutter locations of one input field.


Scientific Background

Based on the following paper.

Lakshmanan V., J. Zhang, K. Hondl and C. Langston: A Statistical Approach to Mitigating Persistent Clutter in Radar Reflectivity Data. IEEE Journal of Selected Topics in Applied Earth Observations and Remote Sensing, Vol. 5, No. 2, April 2012.


Prerequesites

The following items are required:

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


Parameter file

RadxPersistentClutter 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/RadxPersistentClutter -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/RadxPersistentClutter -params orig_param_file_name -print_params > new_param_file_name


Important parameters

TDRP params

  • input_field: name the field to find clutter in
  • output_field: name to give the final clutter field
  • 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)
  • output_url: files will be written to this directory


Input paths

  • input: index, path, tolerance levels
  • field_mapping: list of input fields and index to the path of that data


Running RadxPersistentClutter

To check all command line options for RadxPersistentClutter, including debugging options and file paths, type the following command into a terminal.

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

Once your parameter file is complete, use a command similar to the following to run the application:

/path/to/lrose/install/bin/RadxPersistentClutter -params param_file_name

The user can also specify the location of cfradial files in the following manner:

/path/to/lrose/install/bin/RadxPersistentClutter -f /path/to/cfradial/files/ -params param_file_name