RadxQpe - Revision history

Jcdehart: /* Running RadxQpe */

2024-04-19T20:38:48Z

Running RadxQpe

Jcdehart at 23:51, 23 February 2021

2021-02-23T23:51:43Z

Jcdehart: /* Overview */

2021-01-25T23:07:53Z

Overview

Jcdehart: /* Overview */

2021-01-22T18:02:32Z

Overview

Jcdehart at 21:05, 11 January 2021

2021-01-11T21:05:52Z

Jcdehart at 20:42, 11 January 2021

2021-01-11T20:42:09Z

Jcdehart at 20:42, 3 August 2020

2020-08-03T20:42:37Z

Jcdehart: Created page with "RadxQpe ingests three-dimensional output from RadxRate and determines the precipitation rate closest to the surface that satisfies beam blockage and data quality requirements...."

2019-07-16T17:13:16Z

Created page with "RadxQpe ingests three-dimensional output from RadxRate and determines the precipitation rate closest to the surface that satisfies beam blockage and data quality requirements...."

New page

RadxQpe ingests three-dimensional output from RadxRate and determines the precipitation rate closest to the surface that satisfies beam blockage and data quality requirements.

= Prerequesites =

The following items are required:

* Three-dimensional file of rain rates created by RadxRate (cfradial)
* Beamblock file created by RadxBeamBlock (cfradial)
* Parameter file for running RadxQpe

= Overview =

RadxQpe synthesizes the files created by RadxRate and RadxBeamBlock to determine the best estimate of surface rainfall. RadxBeamBlock data is used to determine the data closest to the surface with minimal blocking by terrain. For irregularly-spaced elevation angles, RadxQpe finds the elevation angle in BeamBlock closest to the elevation angle in the files from RadxRate. Additional constraints based on the signal to noise ratio, beam height, and minimum precipitation rate can be set to constrain where data is reported.

= Parameter files =

RadxQpe 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, and other parameters that specify when precipitation rates will be written to the output file.

== 1) Main parameter file ==

=== Ensure file is up to date ===

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

<code lang="bash">lrose -- RadxQpe -print_params > 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">lrose -- RadxQpe -params orig_param_file_name -print_params > new_param_file_name</code>

=== Important parameters ===

Inputs/outputs

* data_url: directory containing the output from RadxRate
* snr_field: name of the SNR field in the RadxRate files (empty if no field)
* pid_field: name of the PID field in the RadxRate files
* beam_block_path: path to the RadxBeamBlock file
* beam_block_field: field name of the maximum beam blockage percentage (accumulated)

Polar output format

* output_format: select the preferred file type

Polar output directory and filename

* output_dir: file will be written to this directory (set to empty if the user does not want polar output)

Cartesian grid projection and XY details, and output specification

* output_cartesian_dir: file will be written to this directory (set to empty if the user does not want cartesian output)

= Running RadxQpe =

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

<code lang="bash">lrose -- RadxQpe -h</code>

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

<code lang="bash">lrose -- RadxQpe -params param_file_name</code>

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

<code lang="bash">lrose -- RadxQpe -f /path/to/cfradial/files/ -params param_file_name</code>

= Other relevant items =

== Additional parameters to edit ==

Caution: this is not an exhaustive list. We urge each user to read through the entire parameter file carefully.

=== Main parameter file ===

Algorithm parameters

* azimuthal_resolution_degrees: sets the azimuthal resolution of the output files
* min_snr: if the SNR lies below this threshold for a gate, a higher elevation angle is used
* max_beam_block_percent: beam blockage percentage must be below this threshold or else a higher elevation angle will be used
* max_beam_height_km_msl: the beam must not be above this height, otherwise the precipitation will be set to 0
* min_valid_precip_rate: any precipitation rates less than this threshold will be set to 0

Inputs/outputs

* rainrate_fields: sets the precipitation rates that are saved to the final files; the user can choose their preferred rate from the four options
* output_fields: additional fields the user would like to see in the final files

Cartesian grid projection and XY details, and output specification

* grid_projection: map projection for the cartesian grid
* grid_xy_geom: sets the lower left corner of the cartesian grid, grid size, and grid spacing
* center_grid_on_radar: centers the grid on the radar and not a (lat, lon) location
* min_nvalid_for_interp: the number of points required for interpolation to occur
* set_discrete_fields: option to use discrete values for certain fields instead of interpolation
* discrete_fields: list of fields that should use nearest neighbor instead of interpolation (e.g., PID)

@@ Line 63: / Line 63: @@
 <code lang="bash">/path/to/lrose/install/bin/RadxQpe -h</code>
-Once your parameter file is complete, use a command similar to the following to run the application:
+Once your parameter file is complete, use a command similar to the following to run the application. ''Note: this command will '''''not''''' work for the FILELIST mode.''
 <code lang="bash">/path/to/lrose/install/bin/RadxQpe -params param_file_name</code>
-The user can also specify the location of cfradial files in the following manner:
+If using FILELIST mode, the user needs to specify the location of cfradial files using the <code lang="bash">-f</code> flag:
 <code lang="bash">/path/to/lrose/install/bin/RadxQpe -f /path/to/cfradial/files/ -params param_file_name</code>

@@ Line 1: / Line 1: @@
 RadxQpe ingests three-dimensional output from RadxRate and determines the precipitation rate closest to the surface that satisfies beam blockage and data quality requirements.
 === '''Prerequesites''' ===
@@ Line 9: / Line 18: @@
 * Parameter file for running RadxQpe
 === '''Parameter files''' ===

@@ Line 13: / Line 13: @@
 RadxQpe synthesizes the files created by RadxRate and RadxBeamBlock to determine the best estimate of surface rainfall. RadxBeamBlock data is used to determine the data closest to the surface with minimal blocking by terrain. For irregularly-spaced elevation angles, RadxQpe finds the elevation angle in BeamBlock closest to the elevation angle in the files from RadxRate. Additional constraints based on the signal to noise ratio, beam height, and minimum precipitation rate can be set to constrain where data is reported.
-For a more detailed description on how RadxQpe works, please refer to [http://wiki.lrose.net/index.php/RadxQpe_expanded this page].
+''For a more detailed description on how RadxQpe works, please refer to [http://wiki.lrose.net/index.php/RadxQpe_expanded this page].''
 === '''Parameter files''' ===

← Older revision		Revision as of 18:02, 22 January 2021
Line 12:		Line 12:

	RadxQpe synthesizes the files created by RadxRate and RadxBeamBlock to determine the best estimate of surface rainfall. RadxBeamBlock data is used to determine the data closest to the surface with minimal blocking by terrain. For irregularly-spaced elevation angles, RadxQpe finds the elevation angle in BeamBlock closest to the elevation angle in the files from RadxRate. Additional constraints based on the signal to noise ratio, beam height, and minimum precipitation rate can be set to constrain where data is reported.		RadxQpe synthesizes the files created by RadxRate and RadxBeamBlock to determine the best estimate of surface rainfall. RadxBeamBlock data is used to determine the data closest to the surface with minimal blocking by terrain. For irregularly-spaced elevation angles, RadxQpe finds the elevation angle in BeamBlock closest to the elevation angle in the files from RadxRate. Additional constraints based on the signal to noise ratio, beam height, and minimum precipitation rate can be set to constrain where data is reported.
		+
		+	For a more detailed description on how RadxQpe works, please refer to [http://wiki.lrose.net/index.php/RadxQpe_expanded this page].

	=== '''Parameter files''' ===		=== '''Parameter files''' ===

@@ Line 1: / Line 1: @@
 RadxQpe ingests three-dimensional output from RadxRate and determines the precipitation rate closest to the surface that satisfies beam blockage and data quality requirements.
-=== Prerequesites ===
+=== '''Prerequesites''' ===
 The following items are required:
@@ Line 9: / Line 9: @@
 * Parameter file for running RadxQpe
-=== Overview ===
+=== '''Overview''' ===
 RadxQpe synthesizes the files created by RadxRate and RadxBeamBlock to determine the best estimate of surface rainfall. RadxBeamBlock data is used to determine the data closest to the surface with minimal blocking by terrain. For irregularly-spaced elevation angles, RadxQpe finds the elevation angle in BeamBlock closest to the elevation angle in the files from RadxRate. Additional constraints based on the signal to noise ratio, beam height, and minimum precipitation rate can be set to constrain where data is reported.
-=== Parameter files ===
+=== '''Parameter files''' ===
 RadxQpe 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, and other parameters that specify when precipitation rates will be written to the output file.
-==== 1) Main parameter file ====
+==== '''1) Main parameter file''' ====
-===== Ensure file is up to date =====
+===== '''Ensure file is up to date''' =====
 To obtain the default parameter file, use the following command:
@@ Line 29: / Line 29: @@
 <code lang="bash">/path/to/lrose/install/bin/RadxQpe -params orig_param_file_name -print_params &gt; new_param_file_name</code>
-===== Important parameters =====
+===== '''Important parameters''' =====
 Inputs/outputs
@@ Line 51: / Line 51: @@
 * output_cartesian_dir: file will be written to this directory (set to empty if the user does not want cartesian output)
-=== Running RadxQpe ===
+=== '''Running RadxQpe''' ===
 To check all command line options for RadxQpe, including debugging options and file paths, type the following command into a terminal.
@@ Line 65: / Line 65: @@
 <code lang="bash">/path/to/lrose/install/bin/RadxQpe -f /path/to/cfradial/files/ -params param_file_name</code>
-=== Other relevant items ===
+=== '''Other relevant items''' ===
-==== Additional parameters to edit ====
+==== '''Additional parameters to edit''' ====
 Caution: this is not an exhaustive list. We urge each user to read through the entire parameter file carefully.
-===== Main parameter file =====
+===== '''Main parameter file''' =====
 Algorithm parameters