Actions

Difference between revisions of "Elle basic"

From Lrose Wiki

 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Basic elle tutorial ==
+
=== '''Basic elle tutorial''' ===
  
 
This workflow will convert a single raw radar file to the CfRadial format and estimate the surface rain rate. Note, the current parameter files are currently optimized to work on Unix systems. This workflow is one way to test that the applications have been installed properly.
 
This workflow will convert a single raw radar file to the CfRadial format and estimate the surface rain rate. Note, the current parameter files are currently optimized to work on Unix systems. This workflow is one way to test that the applications have been installed properly.
  
=== Run each program one by one on the command line ===
+
For more information, refer to the following pages on how LROSE [http://wiki.lrose.net/index.php/KDP_estimation calculates KDP], estimates the [http://wiki.lrose.net/index.php/RadxPid_fuzzylogic dominant PID category], calculates [http://wiki.lrose.net/index.php/RadxRate_equations rain rates], and estimates the [http://wiki.lrose.net/index.php/RadxQpe_expanded surface precipitation rate].
 +
 
 +
==== '''Run each program one by one on the command line''' ====
 
<ol start="1" style="list-style-type: decimal;">
 
<ol start="1" style="list-style-type: decimal;">
 
<li>Download the [https://drive.google.com/file/d/124wMPHMNZyc0_316rya9KTm_5N42kTI9/view?usp=sharing elle_basic.tar.gz] file</li></ol>
 
<li>Download the [https://drive.google.com/file/d/124wMPHMNZyc0_316rya9KTm_5N42kTI9/view?usp=sharing elle_basic.tar.gz] file</li></ol>
Line 16: Line 18:
 
  export HOMED="/path/to/home/directory"
 
  export HOMED="/path/to/home/directory"
 
  export PROJ=“short/path/to/elle_basic”
 
  export PROJ=“short/path/to/elle_basic”
  export RAW="/path/to/elle_basic_raw"
+
  export RAW="/path/to/elle_basic/raw"
 
<ol start="4" style="list-style-type: decimal;">
 
<ol start="4" style="list-style-type: decimal;">
 
<li>Set the variables in the terminal and set the date. Print out the directory structure to make sure it's pointing to the right directory.</li></ol>
 
<li>Set the variables in the terminal and set the date. Print out the directory structure to make sure it's pointing to the right directory.</li></ol>
Line 32: Line 34:
 
<li>Run RadxQpe to estimate the near-surface rainfall using the hybrid method</li></ol>
 
<li>Run RadxQpe to estimate the near-surface rainfall using the hybrid method</li></ol>
 
  /path/to/RadxQpe -params ./params/RadxQpe.* -f ./rate/$RADAR_NAME/$days/*.nc
 
  /path/to/RadxQpe -params ./params/RadxQpe.* -f ./rate/$RADAR_NAME/$days/*.nc
 +
<ol start="8" style="list-style-type: decimal;">
 +
<li>In the elle_basic directory, you should now see 3 new directories: convert, rate, and qpe. You can look through the the files in those directories to inspect the new files and check the quality of the data.</li></ol>
  
=== Run programs from a sample script ===
+
==== '''Run programs from a sample script''' ====
 
<ol start="1" style="list-style-type: decimal;">
 
<ol start="1" style="list-style-type: decimal;">
<li>Download the [https://drive.google.com/file/d/124wMPHMNZyc0_316rya9KTm_5N42kTI9/view?usp=sharing elle_basic.tar.gz] file</li></ol>
+
<li>Follow steps 1-3 from the section above.</li></ol>
 
<ol start="2" style="list-style-type: decimal;">
 
<ol start="2" style="list-style-type: decimal;">
<li>Extract contents into the desired directory</li></ol>
 
tar -zxvf elle_basic.tar.gz
 
You'll end up with a directory structure that includes files to set environment variables, data required to run some of the programs, the raw radar file, and a sample script that will run all the programs in one go.
 
 
[[File:Elle_basic_ls.png|600px]]
 
<ol start="3" style="list-style-type: decimal;">
 
<li>In /elle_basic/env_dirs, edit the directories (note: there is purposely no slash at the beginning of PROJ)</li></ol>
 
export HOMED="/path/to/home/directory"
 
export PROJ=“path/to/project/radx”
 
export RAW="/path/to/raw/radar/data"
 
<ol start="4" style="list-style-type: decimal;">
 
 
<li>Edit directories in run_radx.sh script (lines 3 and 12)</li></ol>
 
<li>Edit directories in run_radx.sh script (lines 3 and 12)</li></ol>
 
  cd /PATH/TO/elle_basic
 
  cd /PATH/TO/elle_basic
 
  rdir="/PATH/TO/lrose/bin"
 
  rdir="/PATH/TO/lrose/bin"
<ol start="5" style="list-style-type: decimal;">
+
<ol start="3" style="list-style-type: decimal;">
 
<li>Make the file executable, if it isn't already</li></ol>
 
<li>Make the file executable, if it isn't already</li></ol>
 
  chmod u+x run_radx.sh
 
  chmod u+x run_radx.sh
<ol start="6" style="list-style-type: decimal;">
+
<ol start="4" style="list-style-type: decimal;">
 
<li>Run shell script/li></ol>
 
<li>Run shell script/li></ol>
 
  ./run_radx.sh
 
  ./run_radx.sh
 +
<ol start="5" style="list-style-type: decimal;">
 +
<li>In the elle_basic directory, you should now see 3 new directories: convert, rate, and qpe. You can look through the the files in those directories to inspect the new files and check the quality of the data.</li></ol>
  
 
+
==== '''Example output''' ====
=== Example output ===
 
 
Shown below are some HawkEye snapshots of data from the files created during each step.
 
Shown below are some HawkEye snapshots of data from the files created during each step.
 
Example of the reflectivity field displayed in HawkEye created by RadxConvert.  
 
Example of the reflectivity field displayed in HawkEye created by RadxConvert.  
 +
 +
To run the HawkEye dmg, use the following command and then select files in the File menu:
 +
 +
<code>/Applications/HawkEye.app/Contents/MacOS/HawkEye -params /path/to/elle_basic/params/HawkEye.params.gen</code>
  
 
[[File:Radxconvert_dbz.png|1000px]]
 
[[File:Radxconvert_dbz.png|1000px]]

Latest revision as of 17:29, 13 July 2021

Basic elle tutorial

This workflow will convert a single raw radar file to the CfRadial format and estimate the surface rain rate. Note, the current parameter files are currently optimized to work on Unix systems. This workflow is one way to test that the applications have been installed properly.

For more information, refer to the following pages on how LROSE calculates KDP, estimates the dominant PID category, calculates rain rates, and estimates the surface precipitation rate.

Run each program one by one on the command line

  1. Download the elle_basic.tar.gz file
  1. Extract contents into the desired directory
tar -zxvf elle_basic.tar.gz

You'll end up with a directory structure that includes files to set environment variables, data required to run some of the programs, the raw radar file, and a sample script that will run all the programs in one go.

Elle basic ls.png

  1. In /elle_basic/env_dirs, edit the directories (note: there is purposely no slash at the beginning of PROJ). Together, HOMED/PROJ should direct you to the elle_basic directory. RAW is the full path to the raw radar data in /elle_basic.
export HOMED="/path/to/home/directory"
export PROJ=“short/path/to/elle_basic”
export RAW="/path/to/elle_basic/raw"
  1. Set the variables in the terminal and set the date. Print out the directory structure to make sure it's pointing to the right directory.
source env_dirs
source env_vars
export days=“20170602”
echo $HOMED/$PROJ
  1. Convert the raw file to a CfRadial file
/path/to/RadxConvert -params ./params/RadxConvert.* -f $RAW/$RADAR_NAME/$days/*.raw*
  1. Run RadxRate to calculate Kdp, the PID, and various rain rates
/path/to/RadxRate -params ./params/RadxRate.* -f ./convert/$RADAR_NAME/$days/*.nc
  1. Run RadxQpe to estimate the near-surface rainfall using the hybrid method
/path/to/RadxQpe -params ./params/RadxQpe.* -f ./rate/$RADAR_NAME/$days/*.nc
  1. In the elle_basic directory, you should now see 3 new directories: convert, rate, and qpe. You can look through the the files in those directories to inspect the new files and check the quality of the data.

Run programs from a sample script

  1. Follow steps 1-3 from the section above.
  1. Edit directories in run_radx.sh script (lines 3 and 12)
cd /PATH/TO/elle_basic
rdir="/PATH/TO/lrose/bin"
  1. Make the file executable, if it isn't already
chmod u+x run_radx.sh
  1. Run shell script/li>
./run_radx.sh
  1. In the elle_basic directory, you should now see 3 new directories: convert, rate, and qpe. You can look through the the files in those directories to inspect the new files and check the quality of the data.

Example output

Shown below are some HawkEye snapshots of data from the files created during each step. Example of the reflectivity field displayed in HawkEye created by RadxConvert.

To run the HawkEye dmg, use the following command and then select files in the File menu:

/Applications/HawkEye.app/Contents/MacOS/HawkEye -params /path/to/elle_basic/params/HawkEye.params.gen

Radxconvert dbz.png

Example of the Kdp field displayed in HawkEye created by RadxRate.

Radxrate kdp.png

Example of the hybrid rain rate field displayed in HawkEye created by RadxRate.

Radxrate hybrid low.png

Example of the estimated surface rain rate field displayed in HawkEye created by RadxQpe.

Radxqpe hybrid.png