Lrose Wiki - User contributions [en]

Main Page

2021-11-17T18:52:06Z

Tingyucha: /* Overview */

== '''LROSE: The Lidar Radar Open Software Environment''' ==

=== Overview ===
[[File:Topaz-small.png|thumb|right|'''Topaz''']]
The current LROSE release is called '''“Topaz”''' (a bright hot pink rose) and encompasses six key toolsets that define a core lidar/radar workflow: ''[http://wiki.lrose.net/index.php?title=Main_Page#Convert Convert], [http://wiki.lrose.net/index.php?title=Main_Page#Display Display], [http://wiki.lrose.net/index.php?title=Main_Page#Quality_Control QC], [http://wiki.lrose.net/index.php?title=Main_Page#Grid Grid], [http://wiki.lrose.net/index.php?title=Main_Page#Echo Echo], and [http://wiki.lrose.net/index.php?title=Main_Page#Wind Winds].'' '''Topaz''' focuses on high-quality, well-tested, well-maintained and well-documented key applications as ‘building blocks’, allowing users to assemble trusted, reproducible workflows to accomplish more complex scientific tasks.

Some highlights for Topaz:
* This release contains further refinements in radial data format translation.
* The cmake-based build option is available.
* Packages are available for Centos, Ubuntu, Fedora 32, 33, 34, Alma Linux, Suse.
* Only dependent on the HDF5 C library, the C++ library is now included in libs/Ncxx in LROSE.
* HawkEdit is now a beta version, and has undergone considerable testing from users.

Topaz can be compiled in C++ for native apps on Linux or Mac. Preliminary support is available for some tools on Windows.

We encourage users to [http://lrose.net/software.html register] in order to receive critical software updates, and sign up for the mailing list to help build the LROSE community.

[http://lrose.net/help.html Help] can be obtained by posting issues directly to the lrose-cyclone Github repository, via our help mailing list, or Discourse user forum.

LROSE is a co-operative project between:

* [http://www.atmos.colostate.edu/ Dept. of Atmospheric Science at Colorado State University (CSU)] and the
* [https://www.eol.ucar.edu/content/lidar-radar-open-software-environment The Earth Observing Lab at the National Center for Atmospheric Research (NCAR)].

LROSE is funded by the [https://www.nsf.gov National Science Foundation].

=== Citations for LROSE tools ===

Please cite the version of LROSE tools you use for publication. If you are unsure of the version, please cite the latest stable release.

* '''lrose-topaz'''
* '''[https://doi.org/10.5281/zenodo.5523312 lrose-elle, 2021]''': Michael M. Bell, Michael Dixon, Wen-Chau Lee, Brenda Jarvornik, Jennifer DeHart, & Ting-Yu Cha. (2021). nsf-lrose/lrose-elle: lrose-elle stable final release 20210312 (lrose-elle-20210312). Zenodo. https://doi.org/10.5281/zenodo.5523312
* '''[https://doi.org/10.5281/zenodo.3604387 lrose-cyclone, 2020]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2020). nsf-lrose/lrose-cyclone: lrose-cyclone release 20200110 (lrose-cyclone-20200110). Zenodo. https://doi.org/10.5281/zenodo.3604387
* '''[https://doi.org/10.5281/zenodo.2532758 lrose-blaze, 2019]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2019). nsf-lrose/lrose-blaze: lrose-blaze-20190105 (lrose-blaze-20190105). Zenodo. https://doi.org/10.5281/zenodo.2532758

=== Installation Instructions ===

*'''Homebrew Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/install_using_homebrew.mac_osx.md Mac Homebrew installation]''' - For Native applications on the Mac, the recommended method is to use Homebrew. The formula contains all the necessary dependencies and builds instructions.

* '''Source Installation''' - Intended for users who wish to do a manual build or build in a non-standard location. Source compilation is best performed using a supplied Python script.
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/build/LROSE_build_main_page.md Build system]''' - For LINUX and MAC OS cmake/autoconf/manual builds and code development

* '''CIDD Binary Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/CIDD_binary_download_and_install.linux.md CIDD Binary Release]''' - CIDD depends on a 32-bit build, which complicates the build and install for the core. The CIDD display application is not included in the standard lrose-core packages (above).

=== Tutorials ===

* '''quick start'''
** '''[http://wiki.lrose.net/index.php/lrose_quickstart lrose quickstart tutorial]''' - Go over the basics to get up and running quickly with LROSE.

* '''echo tutorials'''
** '''[http://wiki.lrose.net/index.php/elle_basic basic elle echo tutorial]''' - Go through the basic steps necessary to convert a raw radar file to CfRadial, calculate Kdp and three-dimensional rain rate, and estimate the surface rainfall. The purpose of this tutorial is to confirm that the install process was successful and that some programs are working.
** '''[http://wiki.lrose.net/index.php/elle_basic_plus basic+ elle echo tutorial]''' - Similar to the basic elle tutorial with the added tasks of downloading GFS analysis from which to estimate a sounding near the radar and running the RadxBeamBlock application.
** '''[http://wiki.lrose.net/index.php/elle_full full elle echo tutorial]''' - This tutorial assumes the user has radar data downloaded in an [http://wiki.lrose.net/index.php/RadxConvert acceptable radar format] and walks through the most important parameters that need to be edited to run the Quantitative Precipitation Estimation (QPE) workflow.

* '''grid tutorial'''
** '''[http://wiki.lrose.net/index.php/elle_grid elle regrid and convective/stratiform tutorial]''' - Convert raw NEXRAD data to the cfradial format and then interpolate to a cartesian grid and applies a convective stratiform separation algorithm.

* '''wind tutorial'''
** '''[http://wiki.lrose.net/index.php/vortrac_tutorial VORTRAC tutorial]''' - run VORTRAC to retrieve the winds using the GBVTD/GVTD algorithm from a single Doppler radar data.

* '''CSU Radartools tutorial'''
** '''[http://wiki.lrose.net/index.php/csu_radartools_tutorial CSU-Radartools tutorial]''' - Step through the processing of a raw radar file through editing, QC and gridding using LROSE and CSU-Radartools

* ''' Airborne radar navigation correction tutorial'''
** '''[https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction/blob/main/Tutorial.md Airborne radar navigation correction]''' - Go through the steps of applying navigation correction on airborne radar data. Airborne radar navigation correction package can be found [https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction here].

=== Toolsets ===
In the current release, the following tools are available:

==== Convert ====

* '''[http://wiki.lrose.net/index.php/RadxPrint RadxPrint]''' - Query files to determine properties and support by the Radx engine
* '''[http://wiki.lrose.net/index.php/RadxConvert RadxConvert]''' - Convert 24 different lidar and radar formats to CfRadial NetCDF format
* '''[http://wiki.lrose.net/index.php/RadxBufr RadxBufr]''' - Convert Bufr format to CfRadial NetCDF format

==== Display ====

* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' - Real-time and archive display suitable for both scanning and vertically pointing radars.

==== Quality Control ====

* '''[http://wiki.lrose.net/index.php/RadxDiffFields RadxDiffFields]''' - Compare two fields in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxDiffVol RadxDiffVol]''' - Compare two volumes in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxMergeFields RadxMergeFields]''' - Merge fields from different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxFilter RadxFilter]''' - Perform simple filtering operations
* '''[http://wiki.lrose.net/index.php/RadxPersistentClutter RadxPersistentClutter]''' - Create a mask for persistent ground clutter
* '''[http://wiki.lrose.net/index.php/RadxDealias RadxDealias]''' - Dealias single-Doppler data
* '''[http://wiki.lrose.net/index.php/RadxQc RadxQc]''' - General quality control
* '''[http://wiki.lrose.net/index.php/IntfRemove IntfRemove]''' - Identify and remove interference in Titan data
* '''[http://wiki.lrose.net/index.php/RadxModelQc RadxModelQc]''' - Filter Radx data
* '''[http://wiki.lrose.net/index.php/RadxClutMon RadxClutMon]''' - Clutter analysis
* '''[http://wiki.lrose.net/index.php/TsCalAuto TsCalAuto]''' - Radar calibration analysis
* '''[http://wiki.lrose.net/index.php/RadarCal RadarCal]''' - Analyze calibration data
* '''[http://wiki.lrose.net/index.php/RadxSunMon RadxSunMon]''' - Search for sun spikes and perform solar analysis
* '''[http://wiki.lrose.net/index.php/SunCal SunCal]''' - Analyze time series data from sun scans

==== Grid ====

* '''[http://wiki.lrose.net/index.php/Radx2Grid Radx2Grid]''' - Gridding and interpolation of ground-based radar data

==== Echo ====

* '''[http://wiki.lrose.net/index.php/RadxKdp RadxKdp]''' - KDP and Attenuation calculations
* '''[http://wiki.lrose.net/index.php/RadxPid RadxPid]''' - KDP, Attenuation, and Particle Identification
* '''[http://wiki.lrose.net/index.php/RadxRate RadxRate]''' - KDP, Attenuation, PID, and Rain Rate
* '''[http://wiki.lrose.net/index.php/RadxQpe RadxQpe]''' - Accumulated Quantitative Precipitation Estimation
* '''[http://wiki.lrose.net/index.php/RadxHca RadxHca]''' - NEXRAD Hydrometeor Classification Algorithm
* '''[http://wiki.lrose.net/index.php/PrecipAccum PrecipAccum]''' - Accumulated Precipitation
* '''[http://wiki.lrose.net/index.php/RadxBeamBlock RadxBeamBlock]''' - Beam Blockage Estimation
* '''[http://wiki.lrose.net/index.php/ConvStrat ConvStrat]''' - Identify convective and stratiform regions in Cartesian radar volume
* '''[http://wiki.lrose.net/index.php/RadxMesoCyclone RadxMesoCyclone]''' - Identify mesocyclones in radar data
* '''[http://wiki.lrose.net/index.php/QpeVerify QpeVerify]''' - Compare radar-derived and observed precipitation accumulation
* '''[http://wiki.lrose.net/index.php/RefractCompute RefractCompute]''' - Compute refractivity
* '''[http://wiki.lrose.net/index.php/RefractCalib RefractCalib]''' - Create calibration file used by RefractCompute
* '''[http://wiki.lrose.net/index.php/CalcMoisture CalcMoisture]''' - Calculate moisture fields from refractivity
* '''[http://wiki.lrose.net/index.php/Titan Titan]''' - Thunderstorm Identification, Tracking, Analysis, and Nowcasting application
* '''[http://wiki.lrose.net/index.php/Tracks2Ascii Tracks2Ascii]''' - Print out storm and track data in ASCII format
* '''[http://wiki.lrose.net/index.php/Tstorms2Xml Tstorms2Xml]''' - Convert storms data to XML or Spdb
* '''[http://wiki.lrose.net/index.php/StormInitLocation StormInitLocation]''' - Write out the initiation location of significant storms
* '''[http://wiki.lrose.net/index.php/ScaleSep ScaleSep]''' - Separate a radar image into different spatial scales
* '''[http://wiki.lrose.net/index.php/Colide Colide]''' - Detect and extrapolate boundaries
* '''[http://wiki.lrose.net/index.php/ctrec ctrec]''' - Track echo motion
* '''[http://wiki.lrose.net/index.php/Rview Rview]''' - Visualize Titan data (spatially)
* '''[http://wiki.lrose.net/index.php/TimeHist TimeHist]''' - Visualize Titan data (through time)

==== Wind ====

* '''[http://wiki.lrose.net/index.php/RadxEvad RadxEvad]''' - Extended Velocity Azimuth Display single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/FRACTL FRACTL]''' - Fast Reorder and CEDRIC Technique in LROSE multi-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/SAMURAI SAMURAI]''' - Variational multi-Doppler retrieval and analysis package
* '''[http://wiki.lrose.net/index.php/VORTRAC VORTRAC]''' - Vortex Objective Radar Tracking and Circulation single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/OpticalFlow OpticalFlow]''' - Estimate 2-D velocity of a radar field

== '''Practical Radar Meteorology''' ==

The material contained here is designed to supplement radar textbooks and course materials with scientific background on common procedures used in radar meteorology. When combined with the above tutorials and documentation, these practical guides will help apply LROSE tools for scientific applications.

# [http://wiki.lrose.net/index.php/Radx2Grid_Gridding_Options Cartesian Gridding of Polar Radar Data]
# [http://wiki.lrose.net/index.php/Radx2Grid_Convective_Stratiform Convective/Stratiform Partitioning]
# [http://wiki.lrose.net/index.php/KDP_estimation Kdp Calculation]
# [http://wiki.lrose.net/index.php/RadxRate_equations Rain Rate Calculations]
# [http://wiki.lrose.net/index.php/Estimated_Attenuation Attenuation Correction]
# [http://wiki.lrose.net/index.php/RadxPid_fuzzylogic Particle Identification using Fuzzy Logic]
# [http://wiki.lrose.net/index.php/RadxQpe_expanded Quantitative Precipitation Estimation]
# [http://wiki.lrose.net/index.php/RadxDealias_James_and_Houze_2001 Velocity Dealiasing]

== '''LROSE Workshops''' ==

=== LROSE AMS 2020 Mini Workshop ===
*'''[http://wiki.lrose.net/images/a/ae/LROSE_AMS_2020_Mini-Workshop_Agenda.pdf Meeting Notes]'''
*'''[http://wiki.lrose.net/images/8/89/Mmbell_LROSE_AMSannual2020_small.pdf LROSE Mini-Workshop Slides]'''
*'''[http://wiki.lrose.net/images/9/9c/LROSE-CycloneDoppler_small.pdf LROSE Cyclone Multi-Doppler Tutorial Slides]'''
*'''[http://wiki.lrose.net/images/0/09/HawkEye_Tutorial.pdf Brief Hawkeye Tutorial Slides]'''

=== LROSE Fall 2021 Virtual Workshop ===
*'''Meeting Notes'''
*'''[http://wiki.lrose.net/index.php/2021_Fall_Workshop_Videos Pre-recorded Videos]'''

2021 Fall Workshop Videos

2021-11-16T17:21:46Z

Tingyucha: /* Videos */

=== '''Overview''' ===
This page holds all the pre-recorded videos for the 2021 Fall Workshop.

=== '''Videos''' ===
* [https://drive.google.com/file/d/1oYxuObVQGKtv57L75h0tNmqnZk0mgohb/view?usp=sharing Install LROSE on Mac using Homebrew]
* [https://drive.google.com/file/d/1Y9FNm2q9RW8fjhItVEKfYTdtasw7fWFb/view?usp=sharing HawkEdit Tutorial]
* [https://drive.google.com/file/d/16AejZxYuxFQOJc9UiHodJU34i__EDSow/view?usp=sharing HawkEye Tutorial]
* [https://www.youtube.com/watch?v=K4uXX8RXY-E LROSE Gateway Overview] (recorded for the [https://sciencegateways.org/gateways2021 Gateways 2021] conference)
* [https://drive.google.com/file/d/1SkG5W6uOABtjwo5ku5Ffi5t8BSHxmnDm/view?usp=sharing Echo Overview]
* Echo Processing
* [https://drive.google.com/file/d/19Kx3-iQNv5ZzPyp_3sLsDByb4tu6vTaC/view Multi-Doppler Synthesis] (recorded for the [http://precip.org/ PRECIP] Education Workshop)
* [https://drive.google.com/file/d/1U7NhyJ_kfm9HzWGKPgXxi1_7GaYkh1YX/view?usp=sharing Introduction to SAMURAI]
* [https://drive.google.com/file/d/1Ejs7MlLCQAuVcesEYipzgux1YTp3auin/view?usp=sharing LROSE+Community Tools Demo]

Main Page

2021-11-15T20:00:41Z

Tingyucha: /* LROSE: The Lidar Radar Open Software Environment */

Main Page

2021-11-15T19:23:19Z

Tingyucha: /* LROSE: The Lidar Radar Open Software Environment */

== '''LROSE: The Lidar Radar Open Software Environment''' ==

=== Overview ===
[[File:Topaz-small.png|thumb|right|'''Topaz''']]
The current LROSE release is called '''“Topaz”''' (a bright hot pink rose) and encompasses six key toolsets that define a core lidar/radar workflow: ''[http://wiki.lrose.net/index.php?title=Main_Page#Convert Convert], [http://wiki.lrose.net/index.php?title=Main_Page#Display Display], [http://wiki.lrose.net/index.php?title=Main_Page#Quality_Control QC], [http://wiki.lrose.net/index.php?title=Main_Page#Grid Grid], [http://wiki.lrose.net/index.php?title=Main_Page#Echo Echo], and [http://wiki.lrose.net/index.php?title=Main_Page#Wind Winds].'' '''Topaz''' focuses on high-quality, well-tested, well-maintained and well-documented key applications as ‘building blocks’, allowing users to assemble trusted, reproducible workflows to accomplish more complex scientific tasks.

Topaz can be compiled in C++ for native apps on Linux or Mac. Preliminary support is available for some tools on Windows.

We encourage users to [http://lrose.net/software.html register] in order to receive critical software updates, and sign up for the mailing list to help build the LROSE community.

[http://lrose.net/help.html Help] can be obtained by posting issues directly to the lrose-cyclone Github repository, via our help mailing list, or Discourse user forum.

LROSE is a co-operative project between:

* [http://www.atmos.colostate.edu/ Dept. of Atmospheric Science at Colorado State University (CSU)] and the
* [https://www.eol.ucar.edu/content/lidar-radar-open-software-environment The Earth Observing Lab at the National Center for Atmospheric Research (NCAR)].

LROSE is funded by the [https://www.nsf.gov National Science Foundation].

=== Citations for LROSE tools ===

Please cite the version of LROSE tools you use for publication. If you are unsure of the version, please cite the latest stable release.

* '''lrose-topaz'''
* '''[https://doi.org/10.5281/zenodo.5523312 lrose-elle, 2021]''': Michael M. Bell, Michael Dixon, Wen-Chau Lee, Brenda Jarvornik, Jennifer DeHart, & Ting-Yu Cha. (2021). nsf-lrose/lrose-elle: lrose-elle stable final release 20210312 (lrose-elle-20210312). Zenodo. https://doi.org/10.5281/zenodo.5523312
* '''[https://doi.org/10.5281/zenodo.3604387 lrose-cyclone, 2020]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2020). nsf-lrose/lrose-cyclone: lrose-cyclone release 20200110 (lrose-cyclone-20200110). Zenodo. https://doi.org/10.5281/zenodo.3604387
* '''[https://doi.org/10.5281/zenodo.2532758 lrose-blaze, 2019]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2019). nsf-lrose/lrose-blaze: lrose-blaze-20190105 (lrose-blaze-20190105). Zenodo. https://doi.org/10.5281/zenodo.2532758

=== Installation Instructions ===

*'''Homebrew Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/install_using_homebrew.mac_osx.md Mac Homebrew installation]''' - For Native applications on the Mac, the recommended method is to use Homebrew. The formula contains all the necessary dependencies and builds instructions.

* '''Source Installation''' - Intended for users who wish to do a manual build or build in a non-standard location. Source compilation is best performed using a supplied Python script.
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/build/LROSE_build_main_page.md Build system]''' - For LINUX and MAC OS cmake/autoconf/manual builds and code development

* '''CIDD Binary Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/CIDD_binary_download_and_install.linux.md CIDD Binary Release]''' - CIDD depends on a 32-bit build, which complicates the build and install for the core. The CIDD display application is not included in the standard lrose-core packages (above).

=== Tutorials ===

* '''quick start'''
** '''[http://wiki.lrose.net/index.php/lrose_quickstart lrose quickstart tutorial]''' - Go over the basics to get up and running quickly with LROSE.

* '''echo tutorials'''
** '''[http://wiki.lrose.net/index.php/elle_basic basic elle echo tutorial]''' - Go through the basic steps necessary to convert a raw radar file to CfRadial, calculate Kdp and three-dimensional rain rate, and estimate the surface rainfall. The purpose of this tutorial is to confirm that the install process was successful and that some programs are working.
** '''[http://wiki.lrose.net/index.php/elle_basic_plus basic+ elle echo tutorial]''' - Similar to the basic elle tutorial with the added tasks of downloading GFS analysis from which to estimate a sounding near the radar and running the RadxBeamBlock application.
** '''[http://wiki.lrose.net/index.php/elle_full full elle echo tutorial]''' - This tutorial assumes the user has radar data downloaded in an [http://wiki.lrose.net/index.php/RadxConvert acceptable radar format] and walks through the most important parameters that need to be edited to run the Quantitative Precipitation Estimation (QPE) workflow.

* '''grid tutorial'''
** '''[http://wiki.lrose.net/index.php/elle_grid elle regrid and convective/stratiform tutorial]''' - Convert raw NEXRAD data to the cfradial format and then interpolate to a cartesian grid and applies a convective stratiform separation algorithm.

* '''wind tutorial'''
** '''[http://wiki.lrose.net/index.php/vortrac_tutorial VORTRAC tutorial]''' - run VORTRAC to retrieve the winds using the GBVTD/GVTD algorithm from a single Doppler radar data.

* '''CSU Radartools tutorial'''
** '''[http://wiki.lrose.net/index.php/csu_radartools_tutorial CSU-Radartools tutorial]''' - Step through the processing of a raw radar file through editing, QC and gridding using LROSE and CSU-Radartools

* ''' Airborne radar navigation correction tutorial'''
** '''[https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction/blob/main/Tutorial.md Airborne radar navigation correction]''' - Go through the steps of applying navigation correction on airborne radar data. Airborne radar navigation correction package can be found [https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction here].

=== Toolsets ===
In the current release, the following tools are available:

==== Convert ====

* '''[http://wiki.lrose.net/index.php/RadxPrint RadxPrint]''' - Query files to determine properties and support by the Radx engine
* '''[http://wiki.lrose.net/index.php/RadxConvert RadxConvert]''' - Convert 24 different lidar and radar formats to CfRadial NetCDF format
* '''[http://wiki.lrose.net/index.php/RadxBufr RadxBufr]''' - Convert Bufr format to CfRadial NetCDF format

==== Display ====

* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' - Real-time and archive display suitable for both scanning and vertically pointing radars.

==== Quality Control ====

* '''[http://wiki.lrose.net/index.php/RadxDiffFields RadxDiffFields]''' - Compare two fields in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxDiffVol RadxDiffVol]''' - Compare two volumes in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxMergeFields RadxMergeFields]''' - Merge fields from different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxFilter RadxFilter]''' - Perform simple filtering operations
* '''[http://wiki.lrose.net/index.php/RadxPersistentClutter RadxPersistentClutter]''' - Create a mask for persistent ground clutter
* '''[http://wiki.lrose.net/index.php/RadxDealias RadxDealias]''' - Dealias single-Doppler data
* '''[http://wiki.lrose.net/index.php/RadxQc RadxQc]''' - General quality control
* '''[http://wiki.lrose.net/index.php/IntfRemove IntfRemove]''' - Identify and remove interference in Titan data
* '''[http://wiki.lrose.net/index.php/RadxModelQc RadxModelQc]''' - Filter Radx data
* '''[http://wiki.lrose.net/index.php/RadxClutMon RadxClutMon]''' - Clutter analysis
* '''[http://wiki.lrose.net/index.php/TsCalAuto TsCalAuto]''' - Radar calibration analysis
* '''[http://wiki.lrose.net/index.php/RadarCal RadarCal]''' - Analyze calibration data
* '''[http://wiki.lrose.net/index.php/RadxSunMon RadxSunMon]''' - Search for sun spikes and perform solar analysis
* '''[http://wiki.lrose.net/index.php/SunCal SunCal]''' - Analyze time series data from sun scans

==== Grid ====

* '''[http://wiki.lrose.net/index.php/Radx2Grid Radx2Grid]''' - Gridding and interpolation of ground-based radar data

==== Echo ====

* '''[http://wiki.lrose.net/index.php/RadxKdp RadxKdp]''' - KDP and Attenuation calculations
* '''[http://wiki.lrose.net/index.php/RadxPid RadxPid]''' - KDP, Attenuation, and Particle Identification
* '''[http://wiki.lrose.net/index.php/RadxRate RadxRate]''' - KDP, Attenuation, PID, and Rain Rate
* '''[http://wiki.lrose.net/index.php/RadxQpe RadxQpe]''' - Accumulated Quantitative Precipitation Estimation
* '''[http://wiki.lrose.net/index.php/RadxHca RadxHca]''' - NEXRAD Hydrometeor Classification Algorithm
* '''[http://wiki.lrose.net/index.php/PrecipAccum PrecipAccum]''' - Accumulated Precipitation
* '''[http://wiki.lrose.net/index.php/RadxBeamBlock RadxBeamBlock]''' - Beam Blockage Estimation
* '''[http://wiki.lrose.net/index.php/ConvStrat ConvStrat]''' - Identify convective and stratiform regions in Cartesian radar volume
* '''[http://wiki.lrose.net/index.php/RadxMesoCyclone RadxMesoCyclone]''' - Identify mesocyclones in radar data
* '''[http://wiki.lrose.net/index.php/QpeVerify QpeVerify]''' - Compare radar-derived and observed precipitation accumulation
* '''[http://wiki.lrose.net/index.php/RefractCompute RefractCompute]''' - Compute refractivity
* '''[http://wiki.lrose.net/index.php/RefractCalib RefractCalib]''' - Create calibration file used by RefractCompute
* '''[http://wiki.lrose.net/index.php/CalcMoisture CalcMoisture]''' - Calculate moisture fields from refractivity
* '''[http://wiki.lrose.net/index.php/Titan Titan]''' - Thunderstorm Identification, Tracking, Analysis, and Nowcasting application
* '''[http://wiki.lrose.net/index.php/Tracks2Ascii Tracks2Ascii]''' - Print out storm and track data in ASCII format
* '''[http://wiki.lrose.net/index.php/Tstorms2Xml Tstorms2Xml]''' - Convert storms data to XML or Spdb
* '''[http://wiki.lrose.net/index.php/StormInitLocation StormInitLocation]''' - Write out the initiation location of significant storms
* '''[http://wiki.lrose.net/index.php/ScaleSep ScaleSep]''' - Separate a radar image into different spatial scales
* '''[http://wiki.lrose.net/index.php/Colide Colide]''' - Detect and extrapolate boundaries
* '''[http://wiki.lrose.net/index.php/ctrec ctrec]''' - Track echo motion
* '''[http://wiki.lrose.net/index.php/Rview Rview]''' - Visualize Titan data (spatially)
* '''[http://wiki.lrose.net/index.php/TimeHist TimeHist]''' - Visualize Titan data (through time)

==== Wind ====

* '''[http://wiki.lrose.net/index.php/RadxEvad RadxEvad]''' - Extended Velocity Azimuth Display single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/FRACTL FRACTL]''' - Fast Reorder and CEDRIC Technique in LROSE multi-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/SAMURAI SAMURAI]''' - Variational multi-Doppler retrieval and analysis package
* '''[http://wiki.lrose.net/index.php/VORTRAC VORTRAC]''' - Vortex Objective Radar Tracking and Circulation single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/OpticalFlow OpticalFlow]''' - Estimate 2-D velocity of a radar field

== '''Practical Radar Meteorology''' ==

The material contained here is designed to supplement radar textbooks and course materials with scientific background on common procedures used in radar meteorology. When combined with the above tutorials and documentation, these practical guides will help apply LROSE tools for scientific applications.

# [http://wiki.lrose.net/index.php/Radx2Grid_Gridding_Options Cartesian Gridding of Polar Radar Data]
# [http://wiki.lrose.net/index.php/Radx2Grid_Convective_Stratiform Convective/Stratiform Partitioning]
# [http://wiki.lrose.net/index.php/KDP_estimation Kdp Calculation]
# [http://wiki.lrose.net/index.php/RadxRate_equations Rain Rate Calculations]
# [http://wiki.lrose.net/index.php/Estimated_Attenuation Attenuation Correction]
# [http://wiki.lrose.net/index.php/RadxPid_fuzzylogic Particle Identification using Fuzzy Logic]
# [http://wiki.lrose.net/index.php/RadxQpe_expanded Quantitative Precipitation Estimation]
# [http://wiki.lrose.net/index.php/RadxDealias_James_and_Houze_2001 Velocity Dealiasing]

== '''LROSE Workshops''' ==

=== LROSE AMS 2020 Mini Workshop ===
*'''[http://wiki.lrose.net/images/a/ae/LROSE_AMS_2020_Mini-Workshop_Agenda.pdf Meeting Notes]'''
*'''[http://wiki.lrose.net/images/8/89/Mmbell_LROSE_AMSannual2020_small.pdf LROSE Mini-Workshop Slides]'''
*'''[http://wiki.lrose.net/images/9/9c/LROSE-CycloneDoppler_small.pdf LROSE Cyclone Multi-Doppler Tutorial Slides]'''
*'''[http://wiki.lrose.net/images/0/09/HawkEye_Tutorial.pdf Brief Hawkeye Tutorial Slides]'''

=== LROSE Fall 2021 Virtual Workshop ===
*'''Meeting Notes'''
*'''[http://wiki.lrose.net/index.php/2021_Fall_Workshop_Videos Pre-recorded Videos]'''

File:Topaz-small.png

2021-11-15T19:20:54Z

Tingyucha:

Main Page

2021-11-15T19:19:41Z

Tingyucha: /* Overview */

== '''LROSE: The Lidar Radar Open Software Environment''' ==

=== Overview ===

The current LROSE release is called '''“Topaz”''' (a bright hot pink rose) and encompasses six key toolsets that define a core lidar/radar workflow: ''[http://wiki.lrose.net/index.php?title=Main_Page#Convert Convert], [http://wiki.lrose.net/index.php?title=Main_Page#Display Display], [http://wiki.lrose.net/index.php?title=Main_Page#Quality_Control QC], [http://wiki.lrose.net/index.php?title=Main_Page#Grid Grid], [http://wiki.lrose.net/index.php?title=Main_Page#Echo Echo], and [http://wiki.lrose.net/index.php?title=Main_Page#Wind Winds].'' '''Topaz''' focuses on high-quality, well-tested, well-maintained and well-documented key applications as ‘building blocks’, allowing users to assemble trusted, reproducible workflows to accomplish more complex scientific tasks.

Topaz can be compiled in C++ for native apps on Linux or Mac. Preliminary support is available for some tools on Windows.

We encourage users to [http://lrose.net/software.html register] in order to receive critical software updates, and sign up for the mailing list to help build the LROSE community.

[http://lrose.net/help.html Help] can be obtained by posting issues directly to the lrose-cyclone Github repository, via our help mailing list, or Discourse user forum.

LROSE is a co-operative project between:

* [http://www.atmos.colostate.edu/ Dept. of Atmospheric Science at Colorado State University (CSU)] and the
* [https://www.eol.ucar.edu/content/lidar-radar-open-software-environment The Earth Observing Lab at the National Center for Atmospheric Research (NCAR)].

LROSE is funded by the [https://www.nsf.gov National Science Foundation].

=== Citations for LROSE tools ===

Please cite the version of LROSE tools you use for publication. If you are unsure of the version, please cite the latest stable release.

* '''lrose-topaz'''
* '''[https://doi.org/10.5281/zenodo.5523312 lrose-elle, 2021]''': Michael M. Bell, Michael Dixon, Wen-Chau Lee, Brenda Jarvornik, Jennifer DeHart, & Ting-Yu Cha. (2021). nsf-lrose/lrose-elle: lrose-elle stable final release 20210312 (lrose-elle-20210312). Zenodo. https://doi.org/10.5281/zenodo.5523312
* '''[https://doi.org/10.5281/zenodo.3604387 lrose-cyclone, 2020]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2020). nsf-lrose/lrose-cyclone: lrose-cyclone release 20200110 (lrose-cyclone-20200110). Zenodo. https://doi.org/10.5281/zenodo.3604387
* '''[https://doi.org/10.5281/zenodo.2532758 lrose-blaze, 2019]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2019). nsf-lrose/lrose-blaze: lrose-blaze-20190105 (lrose-blaze-20190105). Zenodo. https://doi.org/10.5281/zenodo.2532758

=== Installation Instructions ===

*'''Homebrew Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/install_using_homebrew.mac_osx.md Mac Homebrew installation]''' - For Native applications on the Mac, the recommended method is to use Homebrew. The formula contains all the necessary dependencies and builds instructions.

* '''Source Installation''' - Intended for users who wish to do a manual build or build in a non-standard location. Source compilation is best performed using a supplied Python script.
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/build/LROSE_build_main_page.md Build system]''' - For LINUX and MAC OS cmake/autoconf/manual builds and code development

* '''CIDD Binary Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/CIDD_binary_download_and_install.linux.md CIDD Binary Release]''' - CIDD depends on a 32-bit build, which complicates the build and install for the core. The CIDD display application is not included in the standard lrose-core packages (above).

=== Tutorials ===

* '''quick start'''
** '''[http://wiki.lrose.net/index.php/lrose_quickstart lrose quickstart tutorial]''' - Go over the basics to get up and running quickly with LROSE.

* '''echo tutorials'''
** '''[http://wiki.lrose.net/index.php/elle_basic basic elle echo tutorial]''' - Go through the basic steps necessary to convert a raw radar file to CfRadial, calculate Kdp and three-dimensional rain rate, and estimate the surface rainfall. The purpose of this tutorial is to confirm that the install process was successful and that some programs are working.
** '''[http://wiki.lrose.net/index.php/elle_basic_plus basic+ elle echo tutorial]''' - Similar to the basic elle tutorial with the added tasks of downloading GFS analysis from which to estimate a sounding near the radar and running the RadxBeamBlock application.
** '''[http://wiki.lrose.net/index.php/elle_full full elle echo tutorial]''' - This tutorial assumes the user has radar data downloaded in an [http://wiki.lrose.net/index.php/RadxConvert acceptable radar format] and walks through the most important parameters that need to be edited to run the Quantitative Precipitation Estimation (QPE) workflow.

* '''grid tutorial'''
** '''[http://wiki.lrose.net/index.php/elle_grid elle regrid and convective/stratiform tutorial]''' - Convert raw NEXRAD data to the cfradial format and then interpolate to a cartesian grid and applies a convective stratiform separation algorithm.

* '''wind tutorial'''
** '''[http://wiki.lrose.net/index.php/vortrac_tutorial VORTRAC tutorial]''' - run VORTRAC to retrieve the winds using the GBVTD/GVTD algorithm from a single Doppler radar data.

* '''CSU Radartools tutorial'''
** '''[http://wiki.lrose.net/index.php/csu_radartools_tutorial CSU-Radartools tutorial]''' - Step through the processing of a raw radar file through editing, QC and gridding using LROSE and CSU-Radartools

* ''' Airborne radar navigation correction tutorial'''
** '''[https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction/blob/main/Tutorial.md Airborne radar navigation correction]''' - Go through the steps of applying navigation correction on airborne radar data. Airborne radar navigation correction package can be found [https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction here].

=== Toolsets ===
In the current release, the following tools are available:

==== Convert ====

* '''[http://wiki.lrose.net/index.php/RadxPrint RadxPrint]''' - Query files to determine properties and support by the Radx engine
* '''[http://wiki.lrose.net/index.php/RadxConvert RadxConvert]''' - Convert 24 different lidar and radar formats to CfRadial NetCDF format
* '''[http://wiki.lrose.net/index.php/RadxBufr RadxBufr]''' - Convert Bufr format to CfRadial NetCDF format

==== Display ====

* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' - Real-time and archive display suitable for both scanning and vertically pointing radars.

==== Quality Control ====

* '''[http://wiki.lrose.net/index.php/RadxDiffFields RadxDiffFields]''' - Compare two fields in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxDiffVol RadxDiffVol]''' - Compare two volumes in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxMergeFields RadxMergeFields]''' - Merge fields from different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxFilter RadxFilter]''' - Perform simple filtering operations
* '''[http://wiki.lrose.net/index.php/RadxPersistentClutter RadxPersistentClutter]''' - Create a mask for persistent ground clutter
* '''[http://wiki.lrose.net/index.php/RadxDealias RadxDealias]''' - Dealias single-Doppler data
* '''[http://wiki.lrose.net/index.php/RadxQc RadxQc]''' - General quality control
* '''[http://wiki.lrose.net/index.php/IntfRemove IntfRemove]''' - Identify and remove interference in Titan data
* '''[http://wiki.lrose.net/index.php/RadxModelQc RadxModelQc]''' - Filter Radx data
* '''[http://wiki.lrose.net/index.php/RadxClutMon RadxClutMon]''' - Clutter analysis
* '''[http://wiki.lrose.net/index.php/TsCalAuto TsCalAuto]''' - Radar calibration analysis
* '''[http://wiki.lrose.net/index.php/RadarCal RadarCal]''' - Analyze calibration data
* '''[http://wiki.lrose.net/index.php/RadxSunMon RadxSunMon]''' - Search for sun spikes and perform solar analysis
* '''[http://wiki.lrose.net/index.php/SunCal SunCal]''' - Analyze time series data from sun scans

==== Grid ====

* '''[http://wiki.lrose.net/index.php/Radx2Grid Radx2Grid]''' - Gridding and interpolation of ground-based radar data

==== Echo ====

* '''[http://wiki.lrose.net/index.php/RadxKdp RadxKdp]''' - KDP and Attenuation calculations
* '''[http://wiki.lrose.net/index.php/RadxPid RadxPid]''' - KDP, Attenuation, and Particle Identification
* '''[http://wiki.lrose.net/index.php/RadxRate RadxRate]''' - KDP, Attenuation, PID, and Rain Rate
* '''[http://wiki.lrose.net/index.php/RadxQpe RadxQpe]''' - Accumulated Quantitative Precipitation Estimation
* '''[http://wiki.lrose.net/index.php/RadxHca RadxHca]''' - NEXRAD Hydrometeor Classification Algorithm
* '''[http://wiki.lrose.net/index.php/PrecipAccum PrecipAccum]''' - Accumulated Precipitation
* '''[http://wiki.lrose.net/index.php/RadxBeamBlock RadxBeamBlock]''' - Beam Blockage Estimation
* '''[http://wiki.lrose.net/index.php/ConvStrat ConvStrat]''' - Identify convective and stratiform regions in Cartesian radar volume
* '''[http://wiki.lrose.net/index.php/RadxMesoCyclone RadxMesoCyclone]''' - Identify mesocyclones in radar data
* '''[http://wiki.lrose.net/index.php/QpeVerify QpeVerify]''' - Compare radar-derived and observed precipitation accumulation
* '''[http://wiki.lrose.net/index.php/RefractCompute RefractCompute]''' - Compute refractivity
* '''[http://wiki.lrose.net/index.php/RefractCalib RefractCalib]''' - Create calibration file used by RefractCompute
* '''[http://wiki.lrose.net/index.php/CalcMoisture CalcMoisture]''' - Calculate moisture fields from refractivity
* '''[http://wiki.lrose.net/index.php/Titan Titan]''' - Thunderstorm Identification, Tracking, Analysis, and Nowcasting application
* '''[http://wiki.lrose.net/index.php/Tracks2Ascii Tracks2Ascii]''' - Print out storm and track data in ASCII format
* '''[http://wiki.lrose.net/index.php/Tstorms2Xml Tstorms2Xml]''' - Convert storms data to XML or Spdb
* '''[http://wiki.lrose.net/index.php/StormInitLocation StormInitLocation]''' - Write out the initiation location of significant storms
* '''[http://wiki.lrose.net/index.php/ScaleSep ScaleSep]''' - Separate a radar image into different spatial scales
* '''[http://wiki.lrose.net/index.php/Colide Colide]''' - Detect and extrapolate boundaries
* '''[http://wiki.lrose.net/index.php/ctrec ctrec]''' - Track echo motion
* '''[http://wiki.lrose.net/index.php/Rview Rview]''' - Visualize Titan data (spatially)
* '''[http://wiki.lrose.net/index.php/TimeHist TimeHist]''' - Visualize Titan data (through time)

==== Wind ====

* '''[http://wiki.lrose.net/index.php/RadxEvad RadxEvad]''' - Extended Velocity Azimuth Display single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/FRACTL FRACTL]''' - Fast Reorder and CEDRIC Technique in LROSE multi-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/SAMURAI SAMURAI]''' - Variational multi-Doppler retrieval and analysis package
* '''[http://wiki.lrose.net/index.php/VORTRAC VORTRAC]''' - Vortex Objective Radar Tracking and Circulation single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/OpticalFlow OpticalFlow]''' - Estimate 2-D velocity of a radar field

== '''Practical Radar Meteorology''' ==

The material contained here is designed to supplement radar textbooks and course materials with scientific background on common procedures used in radar meteorology. When combined with the above tutorials and documentation, these practical guides will help apply LROSE tools for scientific applications.

# [http://wiki.lrose.net/index.php/Radx2Grid_Gridding_Options Cartesian Gridding of Polar Radar Data]
# [http://wiki.lrose.net/index.php/Radx2Grid_Convective_Stratiform Convective/Stratiform Partitioning]
# [http://wiki.lrose.net/index.php/KDP_estimation Kdp Calculation]
# [http://wiki.lrose.net/index.php/RadxRate_equations Rain Rate Calculations]
# [http://wiki.lrose.net/index.php/Estimated_Attenuation Attenuation Correction]
# [http://wiki.lrose.net/index.php/RadxPid_fuzzylogic Particle Identification using Fuzzy Logic]
# [http://wiki.lrose.net/index.php/RadxQpe_expanded Quantitative Precipitation Estimation]
# [http://wiki.lrose.net/index.php/RadxDealias_James_and_Houze_2001 Velocity Dealiasing]

== '''LROSE Workshops''' ==

=== LROSE AMS 2020 Mini Workshop ===
*'''[http://wiki.lrose.net/images/a/ae/LROSE_AMS_2020_Mini-Workshop_Agenda.pdf Meeting Notes]'''
*'''[http://wiki.lrose.net/images/8/89/Mmbell_LROSE_AMSannual2020_small.pdf LROSE Mini-Workshop Slides]'''
*'''[http://wiki.lrose.net/images/9/9c/LROSE-CycloneDoppler_small.pdf LROSE Cyclone Multi-Doppler Tutorial Slides]'''
*'''[http://wiki.lrose.net/images/0/09/HawkEye_Tutorial.pdf Brief Hawkeye Tutorial Slides]'''

=== LROSE Fall 2021 Virtual Workshop ===
*'''Meeting Notes'''
*'''[http://wiki.lrose.net/index.php/2021_Fall_Workshop_Videos Pre-recorded Videos]'''

Main Page

2021-11-15T15:06:20Z

Tingyucha: /* Citations for LROSE tools */

== '''LROSE: The Lidar Radar Open Software Environment''' ==

=== Overview ===

The current LROSE release is called '''“Elle”''' (a pink blend fragrant rose) and encompasses six key toolsets that define a core lidar/radar workflow: ''[http://wiki.lrose.net/index.php?title=Main_Page#Convert Convert], [http://wiki.lrose.net/index.php?title=Main_Page#Display Display], [http://wiki.lrose.net/index.php?title=Main_Page#Quality_Control QC], [http://wiki.lrose.net/index.php?title=Main_Page#Grid Grid], [http://wiki.lrose.net/index.php?title=Main_Page#Echo Echo], and [http://wiki.lrose.net/index.php?title=Main_Page#Wind Winds].'' '''Elle''' focuses on high-quality, well-tested, well-maintained and well-documented key applications as ‘building blocks’, allowing users to assemble trusted, reproducible workflows to accomplish more complex scientific tasks.

Elle can be compiled in C++ for native apps on Linux or Mac. Preliminary support is available for some tools on Windows.

We encourage users to [http://lrose.net/software.html register] in order to receive critical software updates, and sign up for the mailing list to help build the LROSE community.

[http://lrose.net/help.html Help] can be obtained by posting issues directly to the lrose-cyclone Github repository, via our help mailing list, or Discourse user forum.

LROSE is a co-operative project between:

* [http://www.atmos.colostate.edu/ Dept. of Atmospheric Science at Colorado State University (CSU)] and the
* [https://www.eol.ucar.edu/content/lidar-radar-open-software-environment The Earth Observing Lab at the National Center for Atmospheric Research (NCAR)].

LROSE is funded by the [https://www.nsf.gov National Science Foundation].

=== Citations for LROSE tools ===

Please cite the version of LROSE tools you use for publication. If you are unsure of the version, please cite the latest stable release.

* '''lrose-topaz'''
* '''[https://doi.org/10.5281/zenodo.5523312 lrose-elle, 2021]''': Michael M. Bell, Michael Dixon, Wen-Chau Lee, Brenda Jarvornik, Jennifer DeHart, & Ting-Yu Cha. (2021). nsf-lrose/lrose-elle: lrose-elle stable final release 20210312 (lrose-elle-20210312). Zenodo. https://doi.org/10.5281/zenodo.5523312
* '''[https://doi.org/10.5281/zenodo.3604387 lrose-cyclone, 2020]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2020). nsf-lrose/lrose-cyclone: lrose-cyclone release 20200110 (lrose-cyclone-20200110). Zenodo. https://doi.org/10.5281/zenodo.3604387
* '''[https://doi.org/10.5281/zenodo.2532758 lrose-blaze, 2019]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2019). nsf-lrose/lrose-blaze: lrose-blaze-20190105 (lrose-blaze-20190105). Zenodo. https://doi.org/10.5281/zenodo.2532758

=== Installation Instructions ===

*'''Homebrew Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/install_using_homebrew.mac_osx.md Mac Homebrew installation]''' - For Native applications on the Mac, the recommended method is to use Homebrew. The formula contains all the necessary dependencies and builds instructions.

* '''Source Installation''' - Intended for users who wish to do a manual build or build in a non-standard location. Source compilation is best performed using a supplied Python script.
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/build/LROSE_build_main_page.md Build system]''' - For LINUX and MAC OS cmake/autoconf/manual builds and code development

* '''CIDD Binary Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/CIDD_binary_download_and_install.linux.md CIDD Binary Release]''' - CIDD depends on a 32-bit build, which complicates the build and install for the core. The CIDD display application is not included in the standard lrose-core packages (above).

=== Tutorials ===

* '''quick start'''
** '''[http://wiki.lrose.net/index.php/lrose_quickstart lrose quickstart tutorial]''' - Go over the basics to get up and running quickly with LROSE.

* '''echo tutorials'''
** '''[http://wiki.lrose.net/index.php/elle_basic basic elle echo tutorial]''' - Go through the basic steps necessary to convert a raw radar file to CfRadial, calculate Kdp and three-dimensional rain rate, and estimate the surface rainfall. The purpose of this tutorial is to confirm that the install process was successful and that some programs are working.
** '''[http://wiki.lrose.net/index.php/elle_basic_plus basic+ elle echo tutorial]''' - Similar to the basic elle tutorial with the added tasks of downloading GFS analysis from which to estimate a sounding near the radar and running the RadxBeamBlock application.
** '''[http://wiki.lrose.net/index.php/elle_full full elle echo tutorial]''' - This tutorial assumes the user has radar data downloaded in an [http://wiki.lrose.net/index.php/RadxConvert acceptable radar format] and walks through the most important parameters that need to be edited to run the Quantitative Precipitation Estimation (QPE) workflow.

* '''grid tutorial'''
** '''[http://wiki.lrose.net/index.php/elle_grid elle regrid and convective/stratiform tutorial]''' - Convert raw NEXRAD data to the cfradial format and then interpolate to a cartesian grid and applies a convective stratiform separation algorithm.

* '''wind tutorial'''
** '''[http://wiki.lrose.net/index.php/vortrac_tutorial VORTRAC tutorial]''' - run VORTRAC to retrieve the winds using the GBVTD/GVTD algorithm from a single Doppler radar data.

* '''CSU Radartools tutorial'''
** '''[http://wiki.lrose.net/index.php/csu_radartools_tutorial CSU-Radartools tutorial]''' - Step through the processing of a raw radar file through editing, QC and gridding using LROSE and CSU-Radartools

* ''' Airborne radar navigation correction tutorial'''
** '''[https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction/blob/main/Tutorial.md Airborne radar navigation correction]''' - Go through the steps of applying navigation correction on airborne radar data. Airborne radar navigation correction package can be found [https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction here].

=== Toolsets ===
In the current release, the following tools are available:

==== Convert ====

* '''[http://wiki.lrose.net/index.php/RadxPrint RadxPrint]''' - Query files to determine properties and support by the Radx engine
* '''[http://wiki.lrose.net/index.php/RadxConvert RadxConvert]''' - Convert 24 different lidar and radar formats to CfRadial NetCDF format
* '''[http://wiki.lrose.net/index.php/RadxBufr RadxBufr]''' - Convert Bufr format to CfRadial NetCDF format

==== Display ====

* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' - Real-time and archive display suitable for both scanning and vertically pointing radars.

==== Quality Control ====

* '''[http://wiki.lrose.net/index.php/RadxDiffFields RadxDiffFields]''' - Compare two fields in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxDiffVol RadxDiffVol]''' - Compare two volumes in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxMergeFields RadxMergeFields]''' - Merge fields from different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxFilter RadxFilter]''' - Perform simple filtering operations
* '''[http://wiki.lrose.net/index.php/RadxPersistentClutter RadxPersistentClutter]''' - Create a mask for persistent ground clutter
* '''[http://wiki.lrose.net/index.php/RadxDealias RadxDealias]''' - Dealias single-Doppler data
* '''[http://wiki.lrose.net/index.php/RadxQc RadxQc]''' - General quality control
* '''[http://wiki.lrose.net/index.php/IntfRemove IntfRemove]''' - Identify and remove interference in Titan data
* '''[http://wiki.lrose.net/index.php/RadxModelQc RadxModelQc]''' - Filter Radx data
* '''[http://wiki.lrose.net/index.php/RadxClutMon RadxClutMon]''' - Clutter analysis
* '''[http://wiki.lrose.net/index.php/TsCalAuto TsCalAuto]''' - Radar calibration analysis
* '''[http://wiki.lrose.net/index.php/RadarCal RadarCal]''' - Analyze calibration data
* '''[http://wiki.lrose.net/index.php/RadxSunMon RadxSunMon]''' - Search for sun spikes and perform solar analysis
* '''[http://wiki.lrose.net/index.php/SunCal SunCal]''' - Analyze time series data from sun scans

==== Grid ====

* '''[http://wiki.lrose.net/index.php/Radx2Grid Radx2Grid]''' - Gridding and interpolation of ground-based radar data

==== Echo ====

* '''[http://wiki.lrose.net/index.php/RadxKdp RadxKdp]''' - KDP and Attenuation calculations
* '''[http://wiki.lrose.net/index.php/RadxPid RadxPid]''' - KDP, Attenuation, and Particle Identification
* '''[http://wiki.lrose.net/index.php/RadxRate RadxRate]''' - KDP, Attenuation, PID, and Rain Rate
* '''[http://wiki.lrose.net/index.php/RadxQpe RadxQpe]''' - Accumulated Quantitative Precipitation Estimation
* '''[http://wiki.lrose.net/index.php/RadxHca RadxHca]''' - NEXRAD Hydrometeor Classification Algorithm
* '''[http://wiki.lrose.net/index.php/PrecipAccum PrecipAccum]''' - Accumulated Precipitation
* '''[http://wiki.lrose.net/index.php/RadxBeamBlock RadxBeamBlock]''' - Beam Blockage Estimation
* '''[http://wiki.lrose.net/index.php/ConvStrat ConvStrat]''' - Identify convective and stratiform regions in Cartesian radar volume
* '''[http://wiki.lrose.net/index.php/RadxMesoCyclone RadxMesoCyclone]''' - Identify mesocyclones in radar data
* '''[http://wiki.lrose.net/index.php/QpeVerify QpeVerify]''' - Compare radar-derived and observed precipitation accumulation
* '''[http://wiki.lrose.net/index.php/RefractCompute RefractCompute]''' - Compute refractivity
* '''[http://wiki.lrose.net/index.php/RefractCalib RefractCalib]''' - Create calibration file used by RefractCompute
* '''[http://wiki.lrose.net/index.php/CalcMoisture CalcMoisture]''' - Calculate moisture fields from refractivity
* '''[http://wiki.lrose.net/index.php/Titan Titan]''' - Thunderstorm Identification, Tracking, Analysis, and Nowcasting application
* '''[http://wiki.lrose.net/index.php/Tracks2Ascii Tracks2Ascii]''' - Print out storm and track data in ASCII format
* '''[http://wiki.lrose.net/index.php/Tstorms2Xml Tstorms2Xml]''' - Convert storms data to XML or Spdb
* '''[http://wiki.lrose.net/index.php/StormInitLocation StormInitLocation]''' - Write out the initiation location of significant storms
* '''[http://wiki.lrose.net/index.php/ScaleSep ScaleSep]''' - Separate a radar image into different spatial scales
* '''[http://wiki.lrose.net/index.php/Colide Colide]''' - Detect and extrapolate boundaries
* '''[http://wiki.lrose.net/index.php/ctrec ctrec]''' - Track echo motion
* '''[http://wiki.lrose.net/index.php/Rview Rview]''' - Visualize Titan data (spatially)
* '''[http://wiki.lrose.net/index.php/TimeHist TimeHist]''' - Visualize Titan data (through time)

==== Wind ====

* '''[http://wiki.lrose.net/index.php/RadxEvad RadxEvad]''' - Extended Velocity Azimuth Display single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/FRACTL FRACTL]''' - Fast Reorder and CEDRIC Technique in LROSE multi-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/SAMURAI SAMURAI]''' - Variational multi-Doppler retrieval and analysis package
* '''[http://wiki.lrose.net/index.php/VORTRAC VORTRAC]''' - Vortex Objective Radar Tracking and Circulation single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/OpticalFlow OpticalFlow]''' - Estimate 2-D velocity of a radar field

== '''Practical Radar Meteorology''' ==

The material contained here is designed to supplement radar textbooks and course materials with scientific background on common procedures used in radar meteorology. When combined with the above tutorials and documentation, these practical guides will help apply LROSE tools for scientific applications.

# [http://wiki.lrose.net/index.php/Radx2Grid_Gridding_Options Cartesian Gridding of Polar Radar Data]
# [http://wiki.lrose.net/index.php/Radx2Grid_Convective_Stratiform Convective/Stratiform Partitioning]
# [http://wiki.lrose.net/index.php/KDP_estimation Kdp Calculation]
# [http://wiki.lrose.net/index.php/RadxRate_equations Rain Rate Calculations]
# [http://wiki.lrose.net/index.php/Estimated_Attenuation Attenuation Correction]
# [http://wiki.lrose.net/index.php/RadxPid_fuzzylogic Particle Identification using Fuzzy Logic]
# [http://wiki.lrose.net/index.php/RadxQpe_expanded Quantitative Precipitation Estimation]
# [http://wiki.lrose.net/index.php/RadxDealias_James_and_Houze_2001 Velocity Dealiasing]

== '''LROSE Workshops''' ==

=== LROSE AMS 2020 Mini Workshop ===
*'''[http://wiki.lrose.net/images/a/ae/LROSE_AMS_2020_Mini-Workshop_Agenda.pdf Meeting Notes]'''
*'''[http://wiki.lrose.net/images/8/89/Mmbell_LROSE_AMSannual2020_small.pdf LROSE Mini-Workshop Slides]'''
*'''[http://wiki.lrose.net/images/9/9c/LROSE-CycloneDoppler_small.pdf LROSE Cyclone Multi-Doppler Tutorial Slides]'''
*'''[http://wiki.lrose.net/images/0/09/HawkEye_Tutorial.pdf Brief Hawkeye Tutorial Slides]'''

=== LROSE Fall 2021 Virtual Workshop ===
*'''Meeting Notes'''
*'''[http://wiki.lrose.net/index.php/2021_Fall_Workshop_Videos Pre-recorded Videos]'''

Main Page

2021-11-15T15:06:02Z

Tingyucha: /* Citations for LROSE tools */

== '''LROSE: The Lidar Radar Open Software Environment''' ==

=== Overview ===

The current LROSE release is called '''“Elle”''' (a pink blend fragrant rose) and encompasses six key toolsets that define a core lidar/radar workflow: ''[http://wiki.lrose.net/index.php?title=Main_Page#Convert Convert], [http://wiki.lrose.net/index.php?title=Main_Page#Display Display], [http://wiki.lrose.net/index.php?title=Main_Page#Quality_Control QC], [http://wiki.lrose.net/index.php?title=Main_Page#Grid Grid], [http://wiki.lrose.net/index.php?title=Main_Page#Echo Echo], and [http://wiki.lrose.net/index.php?title=Main_Page#Wind Winds].'' '''Elle''' focuses on high-quality, well-tested, well-maintained and well-documented key applications as ‘building blocks’, allowing users to assemble trusted, reproducible workflows to accomplish more complex scientific tasks.

Elle can be compiled in C++ for native apps on Linux or Mac. Preliminary support is available for some tools on Windows.

We encourage users to [http://lrose.net/software.html register] in order to receive critical software updates, and sign up for the mailing list to help build the LROSE community.

[http://lrose.net/help.html Help] can be obtained by posting issues directly to the lrose-cyclone Github repository, via our help mailing list, or Discourse user forum.

LROSE is a co-operative project between:

* [http://www.atmos.colostate.edu/ Dept. of Atmospheric Science at Colorado State University (CSU)] and the
* [https://www.eol.ucar.edu/content/lidar-radar-open-software-environment The Earth Observing Lab at the National Center for Atmospheric Research (NCAR)].

LROSE is funded by the [https://www.nsf.gov National Science Foundation].

=== Citations for LROSE tools ===

Please cite the version of LROSE tools you use for publication. If you are unsure of the version, please cite the latest stable release.

* lrose-topaz
* '''[https://doi.org/10.5281/zenodo.5523312 lrose-elle, 2021]''': Michael M. Bell, Michael Dixon, Wen-Chau Lee, Brenda Jarvornik, Jennifer DeHart, & Ting-Yu Cha. (2021). nsf-lrose/lrose-elle: lrose-elle stable final release 20210312 (lrose-elle-20210312). Zenodo. https://doi.org/10.5281/zenodo.5523312
* '''[https://doi.org/10.5281/zenodo.3604387 lrose-cyclone, 2020]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2020). nsf-lrose/lrose-cyclone: lrose-cyclone release 20200110 (lrose-cyclone-20200110). Zenodo. https://doi.org/10.5281/zenodo.3604387
* '''[https://doi.org/10.5281/zenodo.2532758 lrose-blaze, 2019]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2019). nsf-lrose/lrose-blaze: lrose-blaze-20190105 (lrose-blaze-20190105). Zenodo. https://doi.org/10.5281/zenodo.2532758

=== Installation Instructions ===

*'''Homebrew Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/install_using_homebrew.mac_osx.md Mac Homebrew installation]''' - For Native applications on the Mac, the recommended method is to use Homebrew. The formula contains all the necessary dependencies and builds instructions.

* '''Source Installation''' - Intended for users who wish to do a manual build or build in a non-standard location. Source compilation is best performed using a supplied Python script.
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/build/LROSE_build_main_page.md Build system]''' - For LINUX and MAC OS cmake/autoconf/manual builds and code development

* '''CIDD Binary Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/CIDD_binary_download_and_install.linux.md CIDD Binary Release]''' - CIDD depends on a 32-bit build, which complicates the build and install for the core. The CIDD display application is not included in the standard lrose-core packages (above).

=== Tutorials ===

* '''quick start'''
** '''[http://wiki.lrose.net/index.php/lrose_quickstart lrose quickstart tutorial]''' - Go over the basics to get up and running quickly with LROSE.

* '''echo tutorials'''
** '''[http://wiki.lrose.net/index.php/elle_basic basic elle echo tutorial]''' - Go through the basic steps necessary to convert a raw radar file to CfRadial, calculate Kdp and three-dimensional rain rate, and estimate the surface rainfall. The purpose of this tutorial is to confirm that the install process was successful and that some programs are working.
** '''[http://wiki.lrose.net/index.php/elle_basic_plus basic+ elle echo tutorial]''' - Similar to the basic elle tutorial with the added tasks of downloading GFS analysis from which to estimate a sounding near the radar and running the RadxBeamBlock application.
** '''[http://wiki.lrose.net/index.php/elle_full full elle echo tutorial]''' - This tutorial assumes the user has radar data downloaded in an [http://wiki.lrose.net/index.php/RadxConvert acceptable radar format] and walks through the most important parameters that need to be edited to run the Quantitative Precipitation Estimation (QPE) workflow.

* '''grid tutorial'''
** '''[http://wiki.lrose.net/index.php/elle_grid elle regrid and convective/stratiform tutorial]''' - Convert raw NEXRAD data to the cfradial format and then interpolate to a cartesian grid and applies a convective stratiform separation algorithm.

* '''wind tutorial'''
** '''[http://wiki.lrose.net/index.php/vortrac_tutorial VORTRAC tutorial]''' - run VORTRAC to retrieve the winds using the GBVTD/GVTD algorithm from a single Doppler radar data.

* '''CSU Radartools tutorial'''
** '''[http://wiki.lrose.net/index.php/csu_radartools_tutorial CSU-Radartools tutorial]''' - Step through the processing of a raw radar file through editing, QC and gridding using LROSE and CSU-Radartools

* ''' Airborne radar navigation correction tutorial'''
** '''[https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction/blob/main/Tutorial.md Airborne radar navigation correction]''' - Go through the steps of applying navigation correction on airborne radar data. Airborne radar navigation correction package can be found [https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction here].

=== Toolsets ===
In the current release, the following tools are available:

==== Convert ====

* '''[http://wiki.lrose.net/index.php/RadxPrint RadxPrint]''' - Query files to determine properties and support by the Radx engine
* '''[http://wiki.lrose.net/index.php/RadxConvert RadxConvert]''' - Convert 24 different lidar and radar formats to CfRadial NetCDF format
* '''[http://wiki.lrose.net/index.php/RadxBufr RadxBufr]''' - Convert Bufr format to CfRadial NetCDF format

==== Display ====

* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' - Real-time and archive display suitable for both scanning and vertically pointing radars.

==== Quality Control ====

* '''[http://wiki.lrose.net/index.php/RadxDiffFields RadxDiffFields]''' - Compare two fields in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxDiffVol RadxDiffVol]''' - Compare two volumes in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxMergeFields RadxMergeFields]''' - Merge fields from different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxFilter RadxFilter]''' - Perform simple filtering operations
* '''[http://wiki.lrose.net/index.php/RadxPersistentClutter RadxPersistentClutter]''' - Create a mask for persistent ground clutter
* '''[http://wiki.lrose.net/index.php/RadxDealias RadxDealias]''' - Dealias single-Doppler data
* '''[http://wiki.lrose.net/index.php/RadxQc RadxQc]''' - General quality control
* '''[http://wiki.lrose.net/index.php/IntfRemove IntfRemove]''' - Identify and remove interference in Titan data
* '''[http://wiki.lrose.net/index.php/RadxModelQc RadxModelQc]''' - Filter Radx data
* '''[http://wiki.lrose.net/index.php/RadxClutMon RadxClutMon]''' - Clutter analysis
* '''[http://wiki.lrose.net/index.php/TsCalAuto TsCalAuto]''' - Radar calibration analysis
* '''[http://wiki.lrose.net/index.php/RadarCal RadarCal]''' - Analyze calibration data
* '''[http://wiki.lrose.net/index.php/RadxSunMon RadxSunMon]''' - Search for sun spikes and perform solar analysis
* '''[http://wiki.lrose.net/index.php/SunCal SunCal]''' - Analyze time series data from sun scans

==== Grid ====

* '''[http://wiki.lrose.net/index.php/Radx2Grid Radx2Grid]''' - Gridding and interpolation of ground-based radar data

==== Echo ====

* '''[http://wiki.lrose.net/index.php/RadxKdp RadxKdp]''' - KDP and Attenuation calculations
* '''[http://wiki.lrose.net/index.php/RadxPid RadxPid]''' - KDP, Attenuation, and Particle Identification
* '''[http://wiki.lrose.net/index.php/RadxRate RadxRate]''' - KDP, Attenuation, PID, and Rain Rate
* '''[http://wiki.lrose.net/index.php/RadxQpe RadxQpe]''' - Accumulated Quantitative Precipitation Estimation
* '''[http://wiki.lrose.net/index.php/RadxHca RadxHca]''' - NEXRAD Hydrometeor Classification Algorithm
* '''[http://wiki.lrose.net/index.php/PrecipAccum PrecipAccum]''' - Accumulated Precipitation
* '''[http://wiki.lrose.net/index.php/RadxBeamBlock RadxBeamBlock]''' - Beam Blockage Estimation
* '''[http://wiki.lrose.net/index.php/ConvStrat ConvStrat]''' - Identify convective and stratiform regions in Cartesian radar volume
* '''[http://wiki.lrose.net/index.php/RadxMesoCyclone RadxMesoCyclone]''' - Identify mesocyclones in radar data
* '''[http://wiki.lrose.net/index.php/QpeVerify QpeVerify]''' - Compare radar-derived and observed precipitation accumulation
* '''[http://wiki.lrose.net/index.php/RefractCompute RefractCompute]''' - Compute refractivity
* '''[http://wiki.lrose.net/index.php/RefractCalib RefractCalib]''' - Create calibration file used by RefractCompute
* '''[http://wiki.lrose.net/index.php/CalcMoisture CalcMoisture]''' - Calculate moisture fields from refractivity
* '''[http://wiki.lrose.net/index.php/Titan Titan]''' - Thunderstorm Identification, Tracking, Analysis, and Nowcasting application
* '''[http://wiki.lrose.net/index.php/Tracks2Ascii Tracks2Ascii]''' - Print out storm and track data in ASCII format
* '''[http://wiki.lrose.net/index.php/Tstorms2Xml Tstorms2Xml]''' - Convert storms data to XML or Spdb
* '''[http://wiki.lrose.net/index.php/StormInitLocation StormInitLocation]''' - Write out the initiation location of significant storms
* '''[http://wiki.lrose.net/index.php/ScaleSep ScaleSep]''' - Separate a radar image into different spatial scales
* '''[http://wiki.lrose.net/index.php/Colide Colide]''' - Detect and extrapolate boundaries
* '''[http://wiki.lrose.net/index.php/ctrec ctrec]''' - Track echo motion
* '''[http://wiki.lrose.net/index.php/Rview Rview]''' - Visualize Titan data (spatially)
* '''[http://wiki.lrose.net/index.php/TimeHist TimeHist]''' - Visualize Titan data (through time)

==== Wind ====

* '''[http://wiki.lrose.net/index.php/RadxEvad RadxEvad]''' - Extended Velocity Azimuth Display single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/FRACTL FRACTL]''' - Fast Reorder and CEDRIC Technique in LROSE multi-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/SAMURAI SAMURAI]''' - Variational multi-Doppler retrieval and analysis package
* '''[http://wiki.lrose.net/index.php/VORTRAC VORTRAC]''' - Vortex Objective Radar Tracking and Circulation single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/OpticalFlow OpticalFlow]''' - Estimate 2-D velocity of a radar field

== '''Practical Radar Meteorology''' ==

The material contained here is designed to supplement radar textbooks and course materials with scientific background on common procedures used in radar meteorology. When combined with the above tutorials and documentation, these practical guides will help apply LROSE tools for scientific applications.

# [http://wiki.lrose.net/index.php/Radx2Grid_Gridding_Options Cartesian Gridding of Polar Radar Data]
# [http://wiki.lrose.net/index.php/Radx2Grid_Convective_Stratiform Convective/Stratiform Partitioning]
# [http://wiki.lrose.net/index.php/KDP_estimation Kdp Calculation]
# [http://wiki.lrose.net/index.php/RadxRate_equations Rain Rate Calculations]
# [http://wiki.lrose.net/index.php/Estimated_Attenuation Attenuation Correction]
# [http://wiki.lrose.net/index.php/RadxPid_fuzzylogic Particle Identification using Fuzzy Logic]
# [http://wiki.lrose.net/index.php/RadxQpe_expanded Quantitative Precipitation Estimation]
# [http://wiki.lrose.net/index.php/RadxDealias_James_and_Houze_2001 Velocity Dealiasing]

== '''LROSE Workshops''' ==

=== LROSE AMS 2020 Mini Workshop ===
*'''[http://wiki.lrose.net/images/a/ae/LROSE_AMS_2020_Mini-Workshop_Agenda.pdf Meeting Notes]'''
*'''[http://wiki.lrose.net/images/8/89/Mmbell_LROSE_AMSannual2020_small.pdf LROSE Mini-Workshop Slides]'''
*'''[http://wiki.lrose.net/images/9/9c/LROSE-CycloneDoppler_small.pdf LROSE Cyclone Multi-Doppler Tutorial Slides]'''
*'''[http://wiki.lrose.net/images/0/09/HawkEye_Tutorial.pdf Brief Hawkeye Tutorial Slides]'''

=== LROSE Fall 2021 Virtual Workshop ===
*'''Meeting Notes'''
*'''[http://wiki.lrose.net/index.php/2021_Fall_Workshop_Videos Pre-recorded Videos]'''

2021 Fall Workshop Videos

2021-11-14T23:26:33Z

Tingyucha: /* Videos */

=== '''Overview''' ===
This page holds all the pre-recorded videos for the 2021 Fall Workshop.

=== '''Videos''' ===
* [https://drive.google.com/file/d/1Y9FNm2q9RW8fjhItVEKfYTdtasw7fWFb/view?usp=sharing HawkEdit Tutorial]
* [https://drive.google.com/file/d/16AejZxYuxFQOJc9UiHodJU34i__EDSow/view?usp=sharing HawkEye Tutorial]
* [https://www.youtube.com/watch?v=K4uXX8RXY-E LROSE Gateway Overview] (recorded for the [https://sciencegateways.org/gateways2021 Gateways 2021] conference)
* [https://drive.google.com/file/d/1SkG5W6uOABtjwo5ku5Ffi5t8BSHxmnDm/view?usp=sharing Echo Overview]
* Echo Processing
* [https://drive.google.com/file/d/19Kx3-iQNv5ZzPyp_3sLsDByb4tu6vTaC/view Multi-Doppler Synthesis] (recorded for the [http://precip.org/ PRECIP] Education Workshop)
* Introduction to SAMURAI
* [https://drive.google.com/file/d/1Ejs7MlLCQAuVcesEYipzgux1YTp3auin/view?usp=sharing LROSE+Community Tools Demo]

Main Page

2021-09-22T22:13:35Z

Tingyucha: /* Citations for LROSE tools */

== '''LROSE: The Lidar Radar Open Software Environment''' ==

=== Overview ===

The current LROSE release is called '''“Elle”''' (a pink blend fragrant rose) and encompasses six key toolsets that define a core lidar/radar workflow: ''[http://wiki.lrose.net/index.php?title=Main_Page#Convert Convert], [http://wiki.lrose.net/index.php?title=Main_Page#Display Display], [http://wiki.lrose.net/index.php?title=Main_Page#Quality_Control QC], [http://wiki.lrose.net/index.php?title=Main_Page#Grid Grid], [http://wiki.lrose.net/index.php?title=Main_Page#Echo Echo], and [http://wiki.lrose.net/index.php?title=Main_Page#Wind Winds].'' '''Elle''' focuses on high-quality, well-tested, well-maintained and well-documented key applications as ‘building blocks’, allowing users to assemble trusted, reproducible workflows to accomplish more complex scientific tasks.

Elle can be compiled in C++ for native apps on Linux or Mac. Preliminary support is available for some tools on Windows.

We encourage users to [http://lrose.net/software.html register] in order to receive critical software updates, and sign up for the mailing list to help build the LROSE community.

[http://lrose.net/help.html Help] can be obtained by posting issues directly to the lrose-cyclone Github repository, via our help mailing list, or Discourse user forum.

LROSE is a co-operative project between:

* [http://www.atmos.colostate.edu/ Dept. of Atmospheric Science at Colorado State University (CSU)] and the
* [https://www.eol.ucar.edu/content/lidar-radar-open-software-environment The Earth Observing Lab at the National Center for Atmospheric Research (NCAR)].

LROSE is funded by the [https://www.nsf.gov National Science Foundation].

=== Citations for LROSE tools ===

Please cite the version of LROSE tools you use for publication. If you are unsure of the version, please cite the latest stable release.

* '''[https://doi.org/10.5281/zenodo.5523312 lrose-elle, 2021]''': Michael M. Bell, Michael Dixon, Wen-Chau Lee, Brenda Jarvornik, Jennifer DeHart, & Ting-Yu Cha. (2021). nsf-lrose/lrose-elle: lrose-elle stable final release 20210312 (lrose-elle-20210312). Zenodo. https://doi.org/10.5281/zenodo.5523312
* '''[https://doi.org/10.5281/zenodo.3604387 lrose-cyclone, 2020]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2020). nsf-lrose/lrose-cyclone: lrose-cyclone release 20200110 (lrose-cyclone-20200110). Zenodo. https://doi.org/10.5281/zenodo.3604387
* '''[https://doi.org/10.5281/zenodo.2532758 lrose-blaze, 2019]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2019). nsf-lrose/lrose-blaze: lrose-blaze-20190105 (lrose-blaze-20190105). Zenodo. https://doi.org/10.5281/zenodo.2532758

=== Installation Instructions ===

*'''Homebrew Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/install_using_homebrew.mac_osx.md Mac Homebrew installation]''' - For Native applications on the Mac, the recommended method is to use Homebrew. The formula contains all the necessary dependencies and builds instructions.

* '''Source Installation''' - Intended for users who wish to do a manual build or build in a non-standard location. Source compilation is best performed using a supplied Python script.
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/build/LROSE_build_main_page.md Build system]''' - For LINUX and MAC OS cmake/autoconf/manual builds and code development

* '''CIDD Binary Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/CIDD_binary_download_and_install.linux.md CIDD Binary Release]''' - CIDD depends on a 32-bit build, which complicates the build and install for the core. The CIDD display application is not included in the standard lrose-core packages (above).

=== Tutorials ===

* '''quick start'''
** '''[http://wiki.lrose.net/index.php/lrose_quickstart lrose quickstart tutorial]''' - Go over the basics to get up and running quickly with LROSE.

* '''echo tutorials'''
** '''[http://wiki.lrose.net/index.php/elle_basic basic elle echo tutorial]''' - Go through the basic steps necessary to convert a raw radar file to CfRadial, calculate Kdp and three-dimensional rain rate, and estimate the surface rainfall. The purpose of this tutorial is to confirm that the install process was successful and that some programs are working.
** '''[http://wiki.lrose.net/index.php/elle_basic_plus basic+ elle echo tutorial]''' - Similar to the basic elle tutorial with the added tasks of downloading GFS analysis from which to estimate a sounding near the radar and running the RadxBeamBlock application.
** '''[http://wiki.lrose.net/index.php/elle_full full elle echo tutorial]''' - This tutorial assumes the user has radar data downloaded in an [http://wiki.lrose.net/index.php/RadxConvert acceptable radar format] and walks through the most important parameters that need to be edited to run the Quantitative Precipitation Estimation (QPE) workflow.

* '''grid tutorial'''
** '''[http://wiki.lrose.net/index.php/elle_grid elle regrid and convective/stratiform tutorial]''' - Convert raw NEXRAD data to the cfradial format and then interpolate to a cartesian grid and applies a convective stratiform separation algorithm.

* '''wind tutorial'''
** '''[http://wiki.lrose.net/index.php/vortrac_tutorial VORTRAC tutorial]''' - run VORTRAC to retrieve the winds using the GBVTD/GVTD algorithm from a single Doppler radar data.

* '''CSU Radartools tutorial'''
** '''[http://wiki.lrose.net/index.php/csu_radartools_tutorial CSU-Radartools tutorial]''' - Step through the processing of a raw radar file through editing, QC and gridding using LROSE and CSU-Radartools

* ''' Airborne radar navigation correction tutorial'''
** '''[https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction/blob/main/Tutorial.md Airborne radar navigation correction]''' - Go through the steps of applying navigation correction on airborne radar data. Airborne radar navigation correction package can be found [https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction here].

=== Toolsets ===
In the current release, the following tools are available:

==== Convert ====

* '''[http://wiki.lrose.net/index.php/RadxPrint RadxPrint]''' - Query files to determine properties and support by the Radx engine
* '''[http://wiki.lrose.net/index.php/RadxConvert RadxConvert]''' - Convert 24 different lidar and radar formats to CfRadial NetCDF format
* '''[http://wiki.lrose.net/index.php/RadxBufr RadxBufr]''' - Convert Bufr format to CfRadial NetCDF format

==== Display ====

* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' - Real-time and archive display suitable for both scanning and vertically pointing radars.

==== Quality Control ====

* '''[http://wiki.lrose.net/index.php/RadxDiffFields RadxDiffFields]''' - Compare two fields in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxDiffVol RadxDiffVol]''' - Compare two volumes in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxMergeFields RadxMergeFields]''' - Merge fields from different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxFilter RadxFilter]''' - Perform simple filtering operations
* '''[http://wiki.lrose.net/index.php/RadxPersistentClutter RadxPersistentClutter]''' - Create a mask for persistent ground clutter
* '''[http://wiki.lrose.net/index.php/RadxDealias RadxDealias]''' - Dealias single-Doppler data
* '''[http://wiki.lrose.net/index.php/RadxQc RadxQc]''' - General quality control
* '''[http://wiki.lrose.net/index.php/IntfRemove IntfRemove]''' - Identify and remove interference in Titan data
* '''[http://wiki.lrose.net/index.php/RadxModelQc RadxModelQc]''' - Filter Radx data
* '''[http://wiki.lrose.net/index.php/RadxClutMon RadxClutMon]''' - Clutter analysis
* '''[http://wiki.lrose.net/index.php/TsCalAuto TsCalAuto]''' - Radar calibration analysis
* '''[http://wiki.lrose.net/index.php/RadarCal RadarCal]''' - Analyze calibration data
* '''[http://wiki.lrose.net/index.php/RadxSunMon RadxSunMon]''' - Search for sun spikes and perform solar analysis
* '''[http://wiki.lrose.net/index.php/SunCal SunCal]''' - Analyze time series data from sun scans

==== Grid ====

* '''[http://wiki.lrose.net/index.php/Radx2Grid Radx2Grid]''' - Gridding and interpolation of ground-based radar data

==== Echo ====

* '''[http://wiki.lrose.net/index.php/RadxKdp RadxKdp]''' - KDP and Attenuation calculations
* '''[http://wiki.lrose.net/index.php/RadxPid RadxPid]''' - KDP, Attenuation, and Particle Identification
* '''[http://wiki.lrose.net/index.php/RadxRate RadxRate]''' - KDP, Attenuation, PID, and Rain Rate
* '''[http://wiki.lrose.net/index.php/RadxQpe RadxQpe]''' - Accumulated Quantitative Precipitation Estimation
* '''[http://wiki.lrose.net/index.php/RadxHca RadxHca]''' - NEXRAD Hydrometeor Classification Algorithm
* '''[http://wiki.lrose.net/index.php/PrecipAccum PrecipAccum]''' - Accumulated Precipitation
* '''[http://wiki.lrose.net/index.php/RadxBeamBlock RadxBeamBlock]''' - Beam Blockage Estimation
* '''[http://wiki.lrose.net/index.php/ConvStrat ConvStrat]''' - Identify convective and stratiform regions in Cartesian radar volume
* '''[http://wiki.lrose.net/index.php/RadxMesoCyclone RadxMesoCyclone]''' - Identify mesocyclones in radar data
* '''[http://wiki.lrose.net/index.php/QpeVerify QpeVerify]''' - Compare radar-derived and observed precipitation accumulation
* '''[http://wiki.lrose.net/index.php/RefractCompute RefractCompute]''' - Compute refractivity
* '''[http://wiki.lrose.net/index.php/RefractCalib RefractCalib]''' - Create calibration file used by RefractCompute
* '''[http://wiki.lrose.net/index.php/CalcMoisture CalcMoisture]''' - Calculate moisture fields from refractivity
* '''[http://wiki.lrose.net/index.php/Titan Titan]''' - Thunderstorm Identification, Tracking, Analysis, and Nowcasting application
* '''[http://wiki.lrose.net/index.php/Tracks2Ascii Tracks2Ascii]''' - Print out storm and track data in ASCII format
* '''[http://wiki.lrose.net/index.php/Tstorms2Xml Tstorms2Xml]''' - Convert storms data to XML or Spdb
* '''[http://wiki.lrose.net/index.php/StormInitLocation StormInitLocation]''' - Write out the initiation location of significant storms
* '''[http://wiki.lrose.net/index.php/ScaleSep ScaleSep]''' - Separate a radar image into different spatial scales
* '''[http://wiki.lrose.net/index.php/Colide Colide]''' - Detect and extrapolate boundaries
* '''[http://wiki.lrose.net/index.php/ctrec ctrec]''' - Track echo motion
* '''[http://wiki.lrose.net/index.php/Rview Rview]''' - Visualize Titan data (spatially)
* '''[http://wiki.lrose.net/index.php/TimeHist TimeHist]''' - Visualize Titan data (through time)

==== Wind ====

* '''[http://wiki.lrose.net/index.php/RadxEvad RadxEvad]''' - Extended Velocity Azimuth Display single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/FRACTL FRACTL]''' - Fast Reorder and CEDRIC Technique in LROSE multi-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/SAMURAI SAMURAI]''' - Variational multi-Doppler retrieval and analysis package
* '''[http://wiki.lrose.net/index.php/VORTRAC VORTRAC]''' - Vortex Objective Radar Tracking and Circulation single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/OpticalFlow OpticalFlow]''' - Estimate 2-D velocity of a radar field

== '''Practical Radar Meteorology''' ==

The material contained here is designed to supplement radar textbooks and course materials with scientific background on common procedures used in radar meteorology. When combined with the above tutorials and documentation, these practical guides will help apply LROSE tools for scientific applications.

# [http://wiki.lrose.net/index.php/Radx2Grid_Gridding_Options Cartesian Gridding of Polar Radar Data]
# [http://wiki.lrose.net/index.php/Radx2Grid_Convective_Stratiform Convective/Stratiform Partitioning]
# [http://wiki.lrose.net/index.php/KDP_estimation Kdp Calculation]
# [http://wiki.lrose.net/index.php/RadxRate_equations Rain Rate Calculations]
# [http://wiki.lrose.net/index.php/Estimated_Attenuation Attenuation Correction]
# [http://wiki.lrose.net/index.php/RadxPid_fuzzylogic Particle Identification using Fuzzy Logic]
# [http://wiki.lrose.net/index.php/RadxQpe_expanded Quantitative Precipitation Estimation]
# [http://wiki.lrose.net/index.php/RadxDealias_James_and_Houze_2001 Velocity Dealiasing]

== '''LROSE Workshops''' ==

=== LROSE AMS 2020 Mini Workshop ===
*'''[http://wiki.lrose.net/images/a/ae/LROSE_AMS_2020_Mini-Workshop_Agenda.pdf Meeting Notes]'''
*'''[http://wiki.lrose.net/images/8/89/Mmbell_LROSE_AMSannual2020_small.pdf LROSE Mini-Workshop Slides]'''
*'''[http://wiki.lrose.net/images/9/9c/LROSE-CycloneDoppler_small.pdf LROSE Cyclone Multi-Doppler Tutorial Slides]'''
*'''[http://wiki.lrose.net/images/0/09/HawkEye_Tutorial.pdf Brief Hawkeye Tutorial Slides]'''

Main Page

2021-09-22T22:12:47Z

Tingyucha: /* Citations for LROSE tools */

== '''LROSE: The Lidar Radar Open Software Environment''' ==

=== Overview ===

The current LROSE release is called '''“Elle”''' (a pink blend fragrant rose) and encompasses six key toolsets that define a core lidar/radar workflow: ''[http://wiki.lrose.net/index.php?title=Main_Page#Convert Convert], [http://wiki.lrose.net/index.php?title=Main_Page#Display Display], [http://wiki.lrose.net/index.php?title=Main_Page#Quality_Control QC], [http://wiki.lrose.net/index.php?title=Main_Page#Grid Grid], [http://wiki.lrose.net/index.php?title=Main_Page#Echo Echo], and [http://wiki.lrose.net/index.php?title=Main_Page#Wind Winds].'' '''Elle''' focuses on high-quality, well-tested, well-maintained and well-documented key applications as ‘building blocks’, allowing users to assemble trusted, reproducible workflows to accomplish more complex scientific tasks.

Elle can be compiled in C++ for native apps on Linux or Mac. Preliminary support is available for some tools on Windows.

We encourage users to [http://lrose.net/software.html register] in order to receive critical software updates, and sign up for the mailing list to help build the LROSE community.

[http://lrose.net/help.html Help] can be obtained by posting issues directly to the lrose-cyclone Github repository, via our help mailing list, or Discourse user forum.

LROSE is a co-operative project between:

* [http://www.atmos.colostate.edu/ Dept. of Atmospheric Science at Colorado State University (CSU)] and the
* [https://www.eol.ucar.edu/content/lidar-radar-open-software-environment The Earth Observing Lab at the National Center for Atmospheric Research (NCAR)].

LROSE is funded by the [https://www.nsf.gov National Science Foundation].

=== Citations for LROSE tools ===

Please cite the version of LROSE tools you use for publication. If you are unsure of the version, please cite the latest stable release.

* '''lrose-elle, 2021''': Michael M. Bell, Michael Dixon, Wen-Chau Lee, Brenda Jarvornik, Jennifer DeHart, & Ting-Yu Cha. (2021). nsf-lrose/lrose-elle: lrose-elle stable final release 20210312 (lrose-elle-20210312). Zenodo. https://doi.org/10.5281/zenodo.5523312
* '''[https://doi.org/10.5281/zenodo.3604387 lrose-cyclone, 2020]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2020). nsf-lrose/lrose-cyclone: lrose-cyclone release 20200110 (lrose-cyclone-20200110). Zenodo. https://doi.org/10.5281/zenodo.3604387
* '''[https://doi.org/10.5281/zenodo.2532758 lrose-blaze, 2019]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2019). nsf-lrose/lrose-blaze: lrose-blaze-20190105 (lrose-blaze-20190105). Zenodo. https://doi.org/10.5281/zenodo.2532758

=== Installation Instructions ===

*'''Homebrew Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/install_using_homebrew.mac_osx.md Mac Homebrew installation]''' - For Native applications on the Mac, the recommended method is to use Homebrew. The formula contains all the necessary dependencies and builds instructions.

* '''Source Installation''' - Intended for users who wish to do a manual build or build in a non-standard location. Source compilation is best performed using a supplied Python script.
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/build/LROSE_build_main_page.md Build system]''' - For LINUX and MAC OS cmake/autoconf/manual builds and code development

* '''CIDD Binary Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/CIDD_binary_download_and_install.linux.md CIDD Binary Release]''' - CIDD depends on a 32-bit build, which complicates the build and install for the core. The CIDD display application is not included in the standard lrose-core packages (above).

=== Tutorials ===

* '''quick start'''
** '''[http://wiki.lrose.net/index.php/lrose_quickstart lrose quickstart tutorial]''' - Go over the basics to get up and running quickly with LROSE.

* '''echo tutorials'''
** '''[http://wiki.lrose.net/index.php/elle_basic basic elle echo tutorial]''' - Go through the basic steps necessary to convert a raw radar file to CfRadial, calculate Kdp and three-dimensional rain rate, and estimate the surface rainfall. The purpose of this tutorial is to confirm that the install process was successful and that some programs are working.
** '''[http://wiki.lrose.net/index.php/elle_basic_plus basic+ elle echo tutorial]''' - Similar to the basic elle tutorial with the added tasks of downloading GFS analysis from which to estimate a sounding near the radar and running the RadxBeamBlock application.
** '''[http://wiki.lrose.net/index.php/elle_full full elle echo tutorial]''' - This tutorial assumes the user has radar data downloaded in an [http://wiki.lrose.net/index.php/RadxConvert acceptable radar format] and walks through the most important parameters that need to be edited to run the Quantitative Precipitation Estimation (QPE) workflow.

* '''grid tutorial'''
** '''[http://wiki.lrose.net/index.php/elle_grid elle regrid and convective/stratiform tutorial]''' - Convert raw NEXRAD data to the cfradial format and then interpolate to a cartesian grid and applies a convective stratiform separation algorithm.

* '''wind tutorial'''
** '''[http://wiki.lrose.net/index.php/vortrac_tutorial VORTRAC tutorial]''' - run VORTRAC to retrieve the winds using the GBVTD/GVTD algorithm from a single Doppler radar data.

* '''CSU Radartools tutorial'''
** '''[http://wiki.lrose.net/index.php/csu_radartools_tutorial CSU-Radartools tutorial]''' - Step through the processing of a raw radar file through editing, QC and gridding using LROSE and CSU-Radartools

* ''' Airborne radar navigation correction tutorial'''
** '''[https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction/blob/main/Tutorial.md Airborne radar navigation correction]''' - Go through the steps of applying navigation correction on airborne radar data. Airborne radar navigation correction package can be found [https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction here].

=== Toolsets ===
In the current release, the following tools are available:

==== Convert ====

* '''[http://wiki.lrose.net/index.php/RadxPrint RadxPrint]''' - Query files to determine properties and support by the Radx engine
* '''[http://wiki.lrose.net/index.php/RadxConvert RadxConvert]''' - Convert 24 different lidar and radar formats to CfRadial NetCDF format
* '''[http://wiki.lrose.net/index.php/RadxBufr RadxBufr]''' - Convert Bufr format to CfRadial NetCDF format

==== Display ====

* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' - Real-time and archive display suitable for both scanning and vertically pointing radars.

==== Quality Control ====

* '''[http://wiki.lrose.net/index.php/RadxDiffFields RadxDiffFields]''' - Compare two fields in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxDiffVol RadxDiffVol]''' - Compare two volumes in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxMergeFields RadxMergeFields]''' - Merge fields from different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxFilter RadxFilter]''' - Perform simple filtering operations
* '''[http://wiki.lrose.net/index.php/RadxPersistentClutter RadxPersistentClutter]''' - Create a mask for persistent ground clutter
* '''[http://wiki.lrose.net/index.php/RadxDealias RadxDealias]''' - Dealias single-Doppler data
* '''[http://wiki.lrose.net/index.php/RadxQc RadxQc]''' - General quality control
* '''[http://wiki.lrose.net/index.php/IntfRemove IntfRemove]''' - Identify and remove interference in Titan data
* '''[http://wiki.lrose.net/index.php/RadxModelQc RadxModelQc]''' - Filter Radx data
* '''[http://wiki.lrose.net/index.php/RadxClutMon RadxClutMon]''' - Clutter analysis
* '''[http://wiki.lrose.net/index.php/TsCalAuto TsCalAuto]''' - Radar calibration analysis
* '''[http://wiki.lrose.net/index.php/RadarCal RadarCal]''' - Analyze calibration data
* '''[http://wiki.lrose.net/index.php/RadxSunMon RadxSunMon]''' - Search for sun spikes and perform solar analysis
* '''[http://wiki.lrose.net/index.php/SunCal SunCal]''' - Analyze time series data from sun scans

==== Grid ====

* '''[http://wiki.lrose.net/index.php/Radx2Grid Radx2Grid]''' - Gridding and interpolation of ground-based radar data

==== Echo ====

* '''[http://wiki.lrose.net/index.php/RadxKdp RadxKdp]''' - KDP and Attenuation calculations
* '''[http://wiki.lrose.net/index.php/RadxPid RadxPid]''' - KDP, Attenuation, and Particle Identification
* '''[http://wiki.lrose.net/index.php/RadxRate RadxRate]''' - KDP, Attenuation, PID, and Rain Rate
* '''[http://wiki.lrose.net/index.php/RadxQpe RadxQpe]''' - Accumulated Quantitative Precipitation Estimation
* '''[http://wiki.lrose.net/index.php/RadxHca RadxHca]''' - NEXRAD Hydrometeor Classification Algorithm
* '''[http://wiki.lrose.net/index.php/PrecipAccum PrecipAccum]''' - Accumulated Precipitation
* '''[http://wiki.lrose.net/index.php/RadxBeamBlock RadxBeamBlock]''' - Beam Blockage Estimation
* '''[http://wiki.lrose.net/index.php/ConvStrat ConvStrat]''' - Identify convective and stratiform regions in Cartesian radar volume
* '''[http://wiki.lrose.net/index.php/RadxMesoCyclone RadxMesoCyclone]''' - Identify mesocyclones in radar data
* '''[http://wiki.lrose.net/index.php/QpeVerify QpeVerify]''' - Compare radar-derived and observed precipitation accumulation
* '''[http://wiki.lrose.net/index.php/RefractCompute RefractCompute]''' - Compute refractivity
* '''[http://wiki.lrose.net/index.php/RefractCalib RefractCalib]''' - Create calibration file used by RefractCompute
* '''[http://wiki.lrose.net/index.php/CalcMoisture CalcMoisture]''' - Calculate moisture fields from refractivity
* '''[http://wiki.lrose.net/index.php/Titan Titan]''' - Thunderstorm Identification, Tracking, Analysis, and Nowcasting application
* '''[http://wiki.lrose.net/index.php/Tracks2Ascii Tracks2Ascii]''' - Print out storm and track data in ASCII format
* '''[http://wiki.lrose.net/index.php/Tstorms2Xml Tstorms2Xml]''' - Convert storms data to XML or Spdb
* '''[http://wiki.lrose.net/index.php/StormInitLocation StormInitLocation]''' - Write out the initiation location of significant storms
* '''[http://wiki.lrose.net/index.php/ScaleSep ScaleSep]''' - Separate a radar image into different spatial scales
* '''[http://wiki.lrose.net/index.php/Colide Colide]''' - Detect and extrapolate boundaries
* '''[http://wiki.lrose.net/index.php/ctrec ctrec]''' - Track echo motion
* '''[http://wiki.lrose.net/index.php/Rview Rview]''' - Visualize Titan data (spatially)
* '''[http://wiki.lrose.net/index.php/TimeHist TimeHist]''' - Visualize Titan data (through time)

==== Wind ====

* '''[http://wiki.lrose.net/index.php/RadxEvad RadxEvad]''' - Extended Velocity Azimuth Display single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/FRACTL FRACTL]''' - Fast Reorder and CEDRIC Technique in LROSE multi-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/SAMURAI SAMURAI]''' - Variational multi-Doppler retrieval and analysis package
* '''[http://wiki.lrose.net/index.php/VORTRAC VORTRAC]''' - Vortex Objective Radar Tracking and Circulation single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/OpticalFlow OpticalFlow]''' - Estimate 2-D velocity of a radar field

== '''Practical Radar Meteorology''' ==

The material contained here is designed to supplement radar textbooks and course materials with scientific background on common procedures used in radar meteorology. When combined with the above tutorials and documentation, these practical guides will help apply LROSE tools for scientific applications.

# [http://wiki.lrose.net/index.php/Radx2Grid_Gridding_Options Cartesian Gridding of Polar Radar Data]
# [http://wiki.lrose.net/index.php/Radx2Grid_Convective_Stratiform Convective/Stratiform Partitioning]
# [http://wiki.lrose.net/index.php/KDP_estimation Kdp Calculation]
# [http://wiki.lrose.net/index.php/RadxRate_equations Rain Rate Calculations]
# [http://wiki.lrose.net/index.php/Estimated_Attenuation Attenuation Correction]
# [http://wiki.lrose.net/index.php/RadxPid_fuzzylogic Particle Identification using Fuzzy Logic]
# [http://wiki.lrose.net/index.php/RadxQpe_expanded Quantitative Precipitation Estimation]
# [http://wiki.lrose.net/index.php/RadxDealias_James_and_Houze_2001 Velocity Dealiasing]

== '''LROSE Workshops''' ==

=== LROSE AMS 2020 Mini Workshop ===
*'''[http://wiki.lrose.net/images/a/ae/LROSE_AMS_2020_Mini-Workshop_Agenda.pdf Meeting Notes]'''
*'''[http://wiki.lrose.net/images/8/89/Mmbell_LROSE_AMSannual2020_small.pdf LROSE Mini-Workshop Slides]'''
*'''[http://wiki.lrose.net/images/9/9c/LROSE-CycloneDoppler_small.pdf LROSE Cyclone Multi-Doppler Tutorial Slides]'''
*'''[http://wiki.lrose.net/images/0/09/HawkEye_Tutorial.pdf Brief Hawkeye Tutorial Slides]'''

Main Page

2021-09-22T22:11:52Z

Tingyucha: /* Citations for LROSE tools */

== '''LROSE: The Lidar Radar Open Software Environment''' ==

=== Overview ===

The current LROSE release is called '''“Elle”''' (a pink blend fragrant rose) and encompasses six key toolsets that define a core lidar/radar workflow: ''[http://wiki.lrose.net/index.php?title=Main_Page#Convert Convert], [http://wiki.lrose.net/index.php?title=Main_Page#Display Display], [http://wiki.lrose.net/index.php?title=Main_Page#Quality_Control QC], [http://wiki.lrose.net/index.php?title=Main_Page#Grid Grid], [http://wiki.lrose.net/index.php?title=Main_Page#Echo Echo], and [http://wiki.lrose.net/index.php?title=Main_Page#Wind Winds].'' '''Elle''' focuses on high-quality, well-tested, well-maintained and well-documented key applications as ‘building blocks’, allowing users to assemble trusted, reproducible workflows to accomplish more complex scientific tasks.

Elle can be compiled in C++ for native apps on Linux or Mac. Preliminary support is available for some tools on Windows.

We encourage users to [http://lrose.net/software.html register] in order to receive critical software updates, and sign up for the mailing list to help build the LROSE community.

[http://lrose.net/help.html Help] can be obtained by posting issues directly to the lrose-cyclone Github repository, via our help mailing list, or Discourse user forum.

LROSE is a co-operative project between:

* [http://www.atmos.colostate.edu/ Dept. of Atmospheric Science at Colorado State University (CSU)] and the
* [https://www.eol.ucar.edu/content/lidar-radar-open-software-environment The Earth Observing Lab at the National Center for Atmospheric Research (NCAR)].

LROSE is funded by the [https://www.nsf.gov National Science Foundation].

=== Citations for LROSE tools ===

Please cite the version of LROSE tools you use for publication. If you are unsure of the version, please cite the latest stable release.

* '''lrose-elle, 2021''': Michael M. Bell, Michael Dixon, Wen-Chau Lee, Brenda Jarvornik, Jennifer DeHart, & Ting-Yu Cha. (2021). nsf-lrose/lrose-elle: lrose-elle stable final release 20210312 (lrose-elle-20210312). Zenodo. https://doi.org/10.5281/zenodo.5523312
* '''[https://doi.org/10.5281/zenodo.3604387 lrose-cyclone, 2020]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2020). nsf-lrose/lrose-cyclone: lrose-cyclone-20200110. https://doi.org/10.5281/zenodo.3604387
* '''[https://doi.org/10.5281/zenodo.2532758 lrose-blaze, 2019]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2019). nsf‐lrose/lrose‐blaze: lrose‐blaze‐20190105. https://doi.org/10.5281/zenodo.2532758

=== Installation Instructions ===

*'''Homebrew Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/install_using_homebrew.mac_osx.md Mac Homebrew installation]''' - For Native applications on the Mac, the recommended method is to use Homebrew. The formula contains all the necessary dependencies and builds instructions.

* '''Source Installation''' - Intended for users who wish to do a manual build or build in a non-standard location. Source compilation is best performed using a supplied Python script.
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/build/LROSE_build_main_page.md Build system]''' - For LINUX and MAC OS cmake/autoconf/manual builds and code development

* '''CIDD Binary Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/CIDD_binary_download_and_install.linux.md CIDD Binary Release]''' - CIDD depends on a 32-bit build, which complicates the build and install for the core. The CIDD display application is not included in the standard lrose-core packages (above).

=== Tutorials ===

* '''quick start'''
** '''[http://wiki.lrose.net/index.php/lrose_quickstart lrose quickstart tutorial]''' - Go over the basics to get up and running quickly with LROSE.

* '''echo tutorials'''
** '''[http://wiki.lrose.net/index.php/elle_basic basic elle echo tutorial]''' - Go through the basic steps necessary to convert a raw radar file to CfRadial, calculate Kdp and three-dimensional rain rate, and estimate the surface rainfall. The purpose of this tutorial is to confirm that the install process was successful and that some programs are working.
** '''[http://wiki.lrose.net/index.php/elle_basic_plus basic+ elle echo tutorial]''' - Similar to the basic elle tutorial with the added tasks of downloading GFS analysis from which to estimate a sounding near the radar and running the RadxBeamBlock application.
** '''[http://wiki.lrose.net/index.php/elle_full full elle echo tutorial]''' - This tutorial assumes the user has radar data downloaded in an [http://wiki.lrose.net/index.php/RadxConvert acceptable radar format] and walks through the most important parameters that need to be edited to run the Quantitative Precipitation Estimation (QPE) workflow.

* '''grid tutorial'''
** '''[http://wiki.lrose.net/index.php/elle_grid elle regrid and convective/stratiform tutorial]''' - Convert raw NEXRAD data to the cfradial format and then interpolate to a cartesian grid and applies a convective stratiform separation algorithm.

* '''wind tutorial'''
** '''[http://wiki.lrose.net/index.php/vortrac_tutorial VORTRAC tutorial]''' - run VORTRAC to retrieve the winds using the GBVTD/GVTD algorithm from a single Doppler radar data.

* '''CSU Radartools tutorial'''
** '''[http://wiki.lrose.net/index.php/csu_radartools_tutorial CSU-Radartools tutorial]''' - Step through the processing of a raw radar file through editing, QC and gridding using LROSE and CSU-Radartools

* ''' Airborne radar navigation correction tutorial'''
** '''[https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction/blob/main/Tutorial.md Airborne radar navigation correction]''' - Go through the steps of applying navigation correction on airborne radar data. Airborne radar navigation correction package can be found [https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction here].

=== Toolsets ===
In the current release, the following tools are available:

==== Convert ====

* '''[http://wiki.lrose.net/index.php/RadxPrint RadxPrint]''' - Query files to determine properties and support by the Radx engine
* '''[http://wiki.lrose.net/index.php/RadxConvert RadxConvert]''' - Convert 24 different lidar and radar formats to CfRadial NetCDF format
* '''[http://wiki.lrose.net/index.php/RadxBufr RadxBufr]''' - Convert Bufr format to CfRadial NetCDF format

==== Display ====

* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' - Real-time and archive display suitable for both scanning and vertically pointing radars.

==== Quality Control ====

* '''[http://wiki.lrose.net/index.php/RadxDiffFields RadxDiffFields]''' - Compare two fields in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxDiffVol RadxDiffVol]''' - Compare two volumes in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxMergeFields RadxMergeFields]''' - Merge fields from different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxFilter RadxFilter]''' - Perform simple filtering operations
* '''[http://wiki.lrose.net/index.php/RadxPersistentClutter RadxPersistentClutter]''' - Create a mask for persistent ground clutter
* '''[http://wiki.lrose.net/index.php/RadxDealias RadxDealias]''' - Dealias single-Doppler data
* '''[http://wiki.lrose.net/index.php/RadxQc RadxQc]''' - General quality control
* '''[http://wiki.lrose.net/index.php/IntfRemove IntfRemove]''' - Identify and remove interference in Titan data
* '''[http://wiki.lrose.net/index.php/RadxModelQc RadxModelQc]''' - Filter Radx data
* '''[http://wiki.lrose.net/index.php/RadxClutMon RadxClutMon]''' - Clutter analysis
* '''[http://wiki.lrose.net/index.php/TsCalAuto TsCalAuto]''' - Radar calibration analysis
* '''[http://wiki.lrose.net/index.php/RadarCal RadarCal]''' - Analyze calibration data
* '''[http://wiki.lrose.net/index.php/RadxSunMon RadxSunMon]''' - Search for sun spikes and perform solar analysis
* '''[http://wiki.lrose.net/index.php/SunCal SunCal]''' - Analyze time series data from sun scans

==== Grid ====

* '''[http://wiki.lrose.net/index.php/Radx2Grid Radx2Grid]''' - Gridding and interpolation of ground-based radar data

==== Echo ====

* '''[http://wiki.lrose.net/index.php/RadxKdp RadxKdp]''' - KDP and Attenuation calculations
* '''[http://wiki.lrose.net/index.php/RadxPid RadxPid]''' - KDP, Attenuation, and Particle Identification
* '''[http://wiki.lrose.net/index.php/RadxRate RadxRate]''' - KDP, Attenuation, PID, and Rain Rate
* '''[http://wiki.lrose.net/index.php/RadxQpe RadxQpe]''' - Accumulated Quantitative Precipitation Estimation
* '''[http://wiki.lrose.net/index.php/RadxHca RadxHca]''' - NEXRAD Hydrometeor Classification Algorithm
* '''[http://wiki.lrose.net/index.php/PrecipAccum PrecipAccum]''' - Accumulated Precipitation
* '''[http://wiki.lrose.net/index.php/RadxBeamBlock RadxBeamBlock]''' - Beam Blockage Estimation
* '''[http://wiki.lrose.net/index.php/ConvStrat ConvStrat]''' - Identify convective and stratiform regions in Cartesian radar volume
* '''[http://wiki.lrose.net/index.php/RadxMesoCyclone RadxMesoCyclone]''' - Identify mesocyclones in radar data
* '''[http://wiki.lrose.net/index.php/QpeVerify QpeVerify]''' - Compare radar-derived and observed precipitation accumulation
* '''[http://wiki.lrose.net/index.php/RefractCompute RefractCompute]''' - Compute refractivity
* '''[http://wiki.lrose.net/index.php/RefractCalib RefractCalib]''' - Create calibration file used by RefractCompute
* '''[http://wiki.lrose.net/index.php/CalcMoisture CalcMoisture]''' - Calculate moisture fields from refractivity
* '''[http://wiki.lrose.net/index.php/Titan Titan]''' - Thunderstorm Identification, Tracking, Analysis, and Nowcasting application
* '''[http://wiki.lrose.net/index.php/Tracks2Ascii Tracks2Ascii]''' - Print out storm and track data in ASCII format
* '''[http://wiki.lrose.net/index.php/Tstorms2Xml Tstorms2Xml]''' - Convert storms data to XML or Spdb
* '''[http://wiki.lrose.net/index.php/StormInitLocation StormInitLocation]''' - Write out the initiation location of significant storms
* '''[http://wiki.lrose.net/index.php/ScaleSep ScaleSep]''' - Separate a radar image into different spatial scales
* '''[http://wiki.lrose.net/index.php/Colide Colide]''' - Detect and extrapolate boundaries
* '''[http://wiki.lrose.net/index.php/ctrec ctrec]''' - Track echo motion
* '''[http://wiki.lrose.net/index.php/Rview Rview]''' - Visualize Titan data (spatially)
* '''[http://wiki.lrose.net/index.php/TimeHist TimeHist]''' - Visualize Titan data (through time)

==== Wind ====

* '''[http://wiki.lrose.net/index.php/RadxEvad RadxEvad]''' - Extended Velocity Azimuth Display single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/FRACTL FRACTL]''' - Fast Reorder and CEDRIC Technique in LROSE multi-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/SAMURAI SAMURAI]''' - Variational multi-Doppler retrieval and analysis package
* '''[http://wiki.lrose.net/index.php/VORTRAC VORTRAC]''' - Vortex Objective Radar Tracking and Circulation single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/OpticalFlow OpticalFlow]''' - Estimate 2-D velocity of a radar field

== '''Practical Radar Meteorology''' ==

The material contained here is designed to supplement radar textbooks and course materials with scientific background on common procedures used in radar meteorology. When combined with the above tutorials and documentation, these practical guides will help apply LROSE tools for scientific applications.

# [http://wiki.lrose.net/index.php/Radx2Grid_Gridding_Options Cartesian Gridding of Polar Radar Data]
# [http://wiki.lrose.net/index.php/Radx2Grid_Convective_Stratiform Convective/Stratiform Partitioning]
# [http://wiki.lrose.net/index.php/KDP_estimation Kdp Calculation]
# [http://wiki.lrose.net/index.php/RadxRate_equations Rain Rate Calculations]
# [http://wiki.lrose.net/index.php/Estimated_Attenuation Attenuation Correction]
# [http://wiki.lrose.net/index.php/RadxPid_fuzzylogic Particle Identification using Fuzzy Logic]
# [http://wiki.lrose.net/index.php/RadxQpe_expanded Quantitative Precipitation Estimation]
# [http://wiki.lrose.net/index.php/RadxDealias_James_and_Houze_2001 Velocity Dealiasing]

== '''LROSE Workshops''' ==

=== LROSE AMS 2020 Mini Workshop ===
*'''[http://wiki.lrose.net/images/a/ae/LROSE_AMS_2020_Mini-Workshop_Agenda.pdf Meeting Notes]'''
*'''[http://wiki.lrose.net/images/8/89/Mmbell_LROSE_AMSannual2020_small.pdf LROSE Mini-Workshop Slides]'''
*'''[http://wiki.lrose.net/images/9/9c/LROSE-CycloneDoppler_small.pdf LROSE Cyclone Multi-Doppler Tutorial Slides]'''
*'''[http://wiki.lrose.net/images/0/09/HawkEye_Tutorial.pdf Brief Hawkeye Tutorial Slides]'''

Main Page

2021-09-22T21:42:09Z

Tingyucha: /* Citations for LROSE tools */

== '''LROSE: The Lidar Radar Open Software Environment''' ==

=== Overview ===

The current LROSE release is called '''“Elle”''' (a pink blend fragrant rose) and encompasses six key toolsets that define a core lidar/radar workflow: ''[http://wiki.lrose.net/index.php?title=Main_Page#Convert Convert], [http://wiki.lrose.net/index.php?title=Main_Page#Display Display], [http://wiki.lrose.net/index.php?title=Main_Page#Quality_Control QC], [http://wiki.lrose.net/index.php?title=Main_Page#Grid Grid], [http://wiki.lrose.net/index.php?title=Main_Page#Echo Echo], and [http://wiki.lrose.net/index.php?title=Main_Page#Wind Winds].'' '''Elle''' focuses on high-quality, well-tested, well-maintained and well-documented key applications as ‘building blocks’, allowing users to assemble trusted, reproducible workflows to accomplish more complex scientific tasks.

Elle can be compiled in C++ for native apps on Linux or Mac. Preliminary support is available for some tools on Windows.

We encourage users to [http://lrose.net/software.html register] in order to receive critical software updates, and sign up for the mailing list to help build the LROSE community.

[http://lrose.net/help.html Help] can be obtained by posting issues directly to the lrose-cyclone Github repository, via our help mailing list, or Discourse user forum.

LROSE is a co-operative project between:

* [http://www.atmos.colostate.edu/ Dept. of Atmospheric Science at Colorado State University (CSU)] and the
* [https://www.eol.ucar.edu/content/lidar-radar-open-software-environment The Earth Observing Lab at the National Center for Atmospheric Research (NCAR)].

LROSE is funded by the [https://www.nsf.gov National Science Foundation].

=== Citations for LROSE tools ===

Please cite the version of LROSE tools you use for publication. If you are unsure of the version, please cite the latest stable release.

* '''lrose-elle, 2021''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Jennifer DeHart and Ting-Yu Cha (2021). nsf-lrose/lrose-elle: lrose-elle-20210312.
* '''[https://doi.org/10.5281/zenodo.3604387 lrose-cyclone, 2020]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2020). nsf-lrose/lrose-cyclone: lrose-cyclone-20200110. https://doi.org/10.5281/zenodo.3604387
* '''[https://doi.org/10.5281/zenodo.2532758 lrose-blaze, 2019]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2019). nsf‐lrose/lrose‐blaze: lrose‐blaze‐20190105. https://doi.org/10.5281/zenodo.2532758

=== Installation Instructions ===

*'''Homebrew Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/install_using_homebrew.mac_osx.md Mac Homebrew installation]''' - For Native applications on the Mac, the recommended method is to use Homebrew. The formula contains all the necessary dependencies and builds instructions.

* '''Source Installation''' - Intended for users who wish to do a manual build or build in a non-standard location. Source compilation is best performed using a supplied Python script.
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/build/LROSE_build_main_page.md Build system]''' - For LINUX and MAC OS cmake/autoconf/manual builds and code development

* '''CIDD Binary Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/CIDD_binary_download_and_install.linux.md CIDD Binary Release]''' - CIDD depends on a 32-bit build, which complicates the build and install for the core. The CIDD display application is not included in the standard lrose-core packages (above).

=== Tutorials ===

* '''quick start'''
** '''[http://wiki.lrose.net/index.php/lrose_quickstart lrose quickstart tutorial]''' - Go over the basics to get up and running quickly with LROSE.

* '''echo tutorials'''
** '''[http://wiki.lrose.net/index.php/elle_basic basic elle echo tutorial]''' - Go through the basic steps necessary to convert a raw radar file to CfRadial, calculate Kdp and three-dimensional rain rate, and estimate the surface rainfall. The purpose of this tutorial is to confirm that the install process was successful and that some programs are working.
** '''[http://wiki.lrose.net/index.php/elle_basic_plus basic+ elle echo tutorial]''' - Similar to the basic elle tutorial with the added tasks of downloading GFS analysis from which to estimate a sounding near the radar and running the RadxBeamBlock application.
** '''[http://wiki.lrose.net/index.php/elle_full full elle echo tutorial]''' - This tutorial assumes the user has radar data downloaded in an [http://wiki.lrose.net/index.php/RadxConvert acceptable radar format] and walks through the most important parameters that need to be edited to run the Quantitative Precipitation Estimation (QPE) workflow.

* '''grid tutorial'''
** '''[http://wiki.lrose.net/index.php/elle_grid elle regrid and convective/stratiform tutorial]''' - Convert raw NEXRAD data to the cfradial format and then interpolate to a cartesian grid and applies a convective stratiform separation algorithm.

* '''wind tutorial'''
** '''[http://wiki.lrose.net/index.php/vortrac_tutorial VORTRAC tutorial]''' - run VORTRAC to retrieve the winds using the GBVTD/GVTD algorithm from a single Doppler radar data.

* '''CSU Radartools tutorial'''
** '''[http://wiki.lrose.net/index.php/csu_radartools_tutorial CSU-Radartools tutorial]''' - Step through the processing of a raw radar file through editing, QC and gridding using LROSE and CSU-Radartools

* ''' Airborne radar navigation correction tutorial'''
** '''[https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction/blob/main/Tutorial.md Airborne radar navigation correction]''' - Go through the steps of applying navigation correction on airborne radar data. Airborne radar navigation correction package can be found [https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction here].

=== Toolsets ===
In the current release, the following tools are available:

==== Convert ====

* '''[http://wiki.lrose.net/index.php/RadxPrint RadxPrint]''' - Query files to determine properties and support by the Radx engine
* '''[http://wiki.lrose.net/index.php/RadxConvert RadxConvert]''' - Convert 24 different lidar and radar formats to CfRadial NetCDF format
* '''[http://wiki.lrose.net/index.php/RadxBufr RadxBufr]''' - Convert Bufr format to CfRadial NetCDF format

==== Display ====

* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' - Real-time and archive display suitable for both scanning and vertically pointing radars.

==== Quality Control ====

* '''[http://wiki.lrose.net/index.php/RadxDiffFields RadxDiffFields]''' - Compare two fields in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxDiffVol RadxDiffVol]''' - Compare two volumes in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxMergeFields RadxMergeFields]''' - Merge fields from different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxFilter RadxFilter]''' - Perform simple filtering operations
* '''[http://wiki.lrose.net/index.php/RadxPersistentClutter RadxPersistentClutter]''' - Create a mask for persistent ground clutter
* '''[http://wiki.lrose.net/index.php/RadxDealias RadxDealias]''' - Dealias single-Doppler data
* '''[http://wiki.lrose.net/index.php/RadxQc RadxQc]''' - General quality control
* '''[http://wiki.lrose.net/index.php/IntfRemove IntfRemove]''' - Identify and remove interference in Titan data
* '''[http://wiki.lrose.net/index.php/RadxModelQc RadxModelQc]''' - Filter Radx data
* '''[http://wiki.lrose.net/index.php/RadxClutMon RadxClutMon]''' - Clutter analysis
* '''[http://wiki.lrose.net/index.php/TsCalAuto TsCalAuto]''' - Radar calibration analysis
* '''[http://wiki.lrose.net/index.php/RadarCal RadarCal]''' - Analyze calibration data
* '''[http://wiki.lrose.net/index.php/RadxSunMon RadxSunMon]''' - Search for sun spikes and perform solar analysis
* '''[http://wiki.lrose.net/index.php/SunCal SunCal]''' - Analyze time series data from sun scans

==== Grid ====

* '''[http://wiki.lrose.net/index.php/Radx2Grid Radx2Grid]''' - Gridding and interpolation of ground-based radar data

==== Echo ====

* '''[http://wiki.lrose.net/index.php/RadxKdp RadxKdp]''' - KDP and Attenuation calculations
* '''[http://wiki.lrose.net/index.php/RadxPid RadxPid]''' - KDP, Attenuation, and Particle Identification
* '''[http://wiki.lrose.net/index.php/RadxRate RadxRate]''' - KDP, Attenuation, PID, and Rain Rate
* '''[http://wiki.lrose.net/index.php/RadxQpe RadxQpe]''' - Accumulated Quantitative Precipitation Estimation
* '''[http://wiki.lrose.net/index.php/RadxHca RadxHca]''' - NEXRAD Hydrometeor Classification Algorithm
* '''[http://wiki.lrose.net/index.php/PrecipAccum PrecipAccum]''' - Accumulated Precipitation
* '''[http://wiki.lrose.net/index.php/RadxBeamBlock RadxBeamBlock]''' - Beam Blockage Estimation
* '''[http://wiki.lrose.net/index.php/ConvStrat ConvStrat]''' - Identify convective and stratiform regions in Cartesian radar volume
* '''[http://wiki.lrose.net/index.php/RadxMesoCyclone RadxMesoCyclone]''' - Identify mesocyclones in radar data
* '''[http://wiki.lrose.net/index.php/QpeVerify QpeVerify]''' - Compare radar-derived and observed precipitation accumulation
* '''[http://wiki.lrose.net/index.php/RefractCompute RefractCompute]''' - Compute refractivity
* '''[http://wiki.lrose.net/index.php/RefractCalib RefractCalib]''' - Create calibration file used by RefractCompute
* '''[http://wiki.lrose.net/index.php/CalcMoisture CalcMoisture]''' - Calculate moisture fields from refractivity
* '''[http://wiki.lrose.net/index.php/Titan Titan]''' - Thunderstorm Identification, Tracking, Analysis, and Nowcasting application
* '''[http://wiki.lrose.net/index.php/Tracks2Ascii Tracks2Ascii]''' - Print out storm and track data in ASCII format
* '''[http://wiki.lrose.net/index.php/Tstorms2Xml Tstorms2Xml]''' - Convert storms data to XML or Spdb
* '''[http://wiki.lrose.net/index.php/StormInitLocation StormInitLocation]''' - Write out the initiation location of significant storms
* '''[http://wiki.lrose.net/index.php/ScaleSep ScaleSep]''' - Separate a radar image into different spatial scales
* '''[http://wiki.lrose.net/index.php/Colide Colide]''' - Detect and extrapolate boundaries
* '''[http://wiki.lrose.net/index.php/ctrec ctrec]''' - Track echo motion
* '''[http://wiki.lrose.net/index.php/Rview Rview]''' - Visualize Titan data (spatially)
* '''[http://wiki.lrose.net/index.php/TimeHist TimeHist]''' - Visualize Titan data (through time)

==== Wind ====

* '''[http://wiki.lrose.net/index.php/RadxEvad RadxEvad]''' - Extended Velocity Azimuth Display single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/FRACTL FRACTL]''' - Fast Reorder and CEDRIC Technique in LROSE multi-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/SAMURAI SAMURAI]''' - Variational multi-Doppler retrieval and analysis package
* '''[http://wiki.lrose.net/index.php/VORTRAC VORTRAC]''' - Vortex Objective Radar Tracking and Circulation single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/OpticalFlow OpticalFlow]''' - Estimate 2-D velocity of a radar field

== '''Practical Radar Meteorology''' ==

The material contained here is designed to supplement radar textbooks and course materials with scientific background on common procedures used in radar meteorology. When combined with the above tutorials and documentation, these practical guides will help apply LROSE tools for scientific applications.

# [http://wiki.lrose.net/index.php/Radx2Grid_Gridding_Options Cartesian Gridding of Polar Radar Data]
# [http://wiki.lrose.net/index.php/Radx2Grid_Convective_Stratiform Convective/Stratiform Partitioning]
# [http://wiki.lrose.net/index.php/KDP_estimation Kdp Calculation]
# [http://wiki.lrose.net/index.php/RadxRate_equations Rain Rate Calculations]
# [http://wiki.lrose.net/index.php/Estimated_Attenuation Attenuation Correction]
# [http://wiki.lrose.net/index.php/RadxPid_fuzzylogic Particle Identification using Fuzzy Logic]
# [http://wiki.lrose.net/index.php/RadxQpe_expanded Quantitative Precipitation Estimation]
# [http://wiki.lrose.net/index.php/RadxDealias_James_and_Houze_2001 Velocity Dealiasing]

== '''LROSE Workshops''' ==

=== LROSE AMS 2020 Mini Workshop ===
*'''[http://wiki.lrose.net/images/a/ae/LROSE_AMS_2020_Mini-Workshop_Agenda.pdf Meeting Notes]'''
*'''[http://wiki.lrose.net/images/8/89/Mmbell_LROSE_AMSannual2020_small.pdf LROSE Mini-Workshop Slides]'''
*'''[http://wiki.lrose.net/images/9/9c/LROSE-CycloneDoppler_small.pdf LROSE Cyclone Multi-Doppler Tutorial Slides]'''
*'''[http://wiki.lrose.net/images/0/09/HawkEye_Tutorial.pdf Brief Hawkeye Tutorial Slides]'''

Main Page

2021-09-22T21:41:11Z

Tingyucha: /* Installation Instructions */

== '''LROSE: The Lidar Radar Open Software Environment''' ==

=== Overview ===

The current LROSE release is called '''“Elle”''' (a pink blend fragrant rose) and encompasses six key toolsets that define a core lidar/radar workflow: ''[http://wiki.lrose.net/index.php?title=Main_Page#Convert Convert], [http://wiki.lrose.net/index.php?title=Main_Page#Display Display], [http://wiki.lrose.net/index.php?title=Main_Page#Quality_Control QC], [http://wiki.lrose.net/index.php?title=Main_Page#Grid Grid], [http://wiki.lrose.net/index.php?title=Main_Page#Echo Echo], and [http://wiki.lrose.net/index.php?title=Main_Page#Wind Winds].'' '''Elle''' focuses on high-quality, well-tested, well-maintained and well-documented key applications as ‘building blocks’, allowing users to assemble trusted, reproducible workflows to accomplish more complex scientific tasks.

Elle can be compiled in C++ for native apps on Linux or Mac. Preliminary support is available for some tools on Windows.

We encourage users to [http://lrose.net/software.html register] in order to receive critical software updates, and sign up for the mailing list to help build the LROSE community.

[http://lrose.net/help.html Help] can be obtained by posting issues directly to the lrose-cyclone Github repository, via our help mailing list, or Discourse user forum.

LROSE is a co-operative project between:

* [http://www.atmos.colostate.edu/ Dept. of Atmospheric Science at Colorado State University (CSU)] and the
* [https://www.eol.ucar.edu/content/lidar-radar-open-software-environment The Earth Observing Lab at the National Center for Atmospheric Research (NCAR)].

LROSE is funded by the [https://www.nsf.gov National Science Foundation].

=== Citations for LROSE tools ===

Please cite the version of LROSE tools you use for publication. If you are unsure of the version, please cite the latest stable release.

* '''lrose-elle, 2021''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Jennifer DeHart and Ting-Yu Cha (2021). nsf-lrose/lrose-elle: lrose-elle-20210216.
* '''[https://doi.org/10.5281/zenodo.3604387 lrose-cyclone, 2020]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2020). nsf-lrose/lrose-cyclone: lrose-cyclone-20200110. https://doi.org/10.5281/zenodo.3604387
* '''[https://doi.org/10.5281/zenodo.2532758 lrose-blaze, 2019]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2019). nsf‐lrose/lrose‐blaze: lrose‐blaze‐20190105. https://doi.org/10.5281/zenodo.2532758

=== Installation Instructions ===

*'''Homebrew Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/install_using_homebrew.mac_osx.md Mac Homebrew installation]''' - For Native applications on the Mac, the recommended method is to use Homebrew. The formula contains all the necessary dependencies and builds instructions.

* '''Source Installation''' - Intended for users who wish to do a manual build or build in a non-standard location. Source compilation is best performed using a supplied Python script.
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/build/LROSE_build_main_page.md Build system]''' - For LINUX and MAC OS cmake/autoconf/manual builds and code development

* '''CIDD Binary Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/CIDD_binary_download_and_install.linux.md CIDD Binary Release]''' - CIDD depends on a 32-bit build, which complicates the build and install for the core. The CIDD display application is not included in the standard lrose-core packages (above).

=== Tutorials ===

* '''quick start'''
** '''[http://wiki.lrose.net/index.php/lrose_quickstart lrose quickstart tutorial]''' - Go over the basics to get up and running quickly with LROSE.

* '''echo tutorials'''
** '''[http://wiki.lrose.net/index.php/elle_basic basic elle echo tutorial]''' - Go through the basic steps necessary to convert a raw radar file to CfRadial, calculate Kdp and three-dimensional rain rate, and estimate the surface rainfall. The purpose of this tutorial is to confirm that the install process was successful and that some programs are working.
** '''[http://wiki.lrose.net/index.php/elle_basic_plus basic+ elle echo tutorial]''' - Similar to the basic elle tutorial with the added tasks of downloading GFS analysis from which to estimate a sounding near the radar and running the RadxBeamBlock application.
** '''[http://wiki.lrose.net/index.php/elle_full full elle echo tutorial]''' - This tutorial assumes the user has radar data downloaded in an [http://wiki.lrose.net/index.php/RadxConvert acceptable radar format] and walks through the most important parameters that need to be edited to run the Quantitative Precipitation Estimation (QPE) workflow.

* '''grid tutorial'''
** '''[http://wiki.lrose.net/index.php/elle_grid elle regrid and convective/stratiform tutorial]''' - Convert raw NEXRAD data to the cfradial format and then interpolate to a cartesian grid and applies a convective stratiform separation algorithm.

* '''wind tutorial'''
** '''[http://wiki.lrose.net/index.php/vortrac_tutorial VORTRAC tutorial]''' - run VORTRAC to retrieve the winds using the GBVTD/GVTD algorithm from a single Doppler radar data.

* '''CSU Radartools tutorial'''
** '''[http://wiki.lrose.net/index.php/csu_radartools_tutorial CSU-Radartools tutorial]''' - Step through the processing of a raw radar file through editing, QC and gridding using LROSE and CSU-Radartools

* ''' Airborne radar navigation correction tutorial'''
** '''[https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction/blob/main/Tutorial.md Airborne radar navigation correction]''' - Go through the steps of applying navigation correction on airborne radar data. Airborne radar navigation correction package can be found [https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction here].

=== Toolsets ===
In the current release, the following tools are available:

==== Convert ====

* '''[http://wiki.lrose.net/index.php/RadxPrint RadxPrint]''' - Query files to determine properties and support by the Radx engine
* '''[http://wiki.lrose.net/index.php/RadxConvert RadxConvert]''' - Convert 24 different lidar and radar formats to CfRadial NetCDF format
* '''[http://wiki.lrose.net/index.php/RadxBufr RadxBufr]''' - Convert Bufr format to CfRadial NetCDF format

==== Display ====

* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' - Real-time and archive display suitable for both scanning and vertically pointing radars.

==== Quality Control ====

* '''[http://wiki.lrose.net/index.php/RadxDiffFields RadxDiffFields]''' - Compare two fields in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxDiffVol RadxDiffVol]''' - Compare two volumes in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxMergeFields RadxMergeFields]''' - Merge fields from different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxFilter RadxFilter]''' - Perform simple filtering operations
* '''[http://wiki.lrose.net/index.php/RadxPersistentClutter RadxPersistentClutter]''' - Create a mask for persistent ground clutter
* '''[http://wiki.lrose.net/index.php/RadxDealias RadxDealias]''' - Dealias single-Doppler data
* '''[http://wiki.lrose.net/index.php/RadxQc RadxQc]''' - General quality control
* '''[http://wiki.lrose.net/index.php/IntfRemove IntfRemove]''' - Identify and remove interference in Titan data
* '''[http://wiki.lrose.net/index.php/RadxModelQc RadxModelQc]''' - Filter Radx data
* '''[http://wiki.lrose.net/index.php/RadxClutMon RadxClutMon]''' - Clutter analysis
* '''[http://wiki.lrose.net/index.php/TsCalAuto TsCalAuto]''' - Radar calibration analysis
* '''[http://wiki.lrose.net/index.php/RadarCal RadarCal]''' - Analyze calibration data
* '''[http://wiki.lrose.net/index.php/RadxSunMon RadxSunMon]''' - Search for sun spikes and perform solar analysis
* '''[http://wiki.lrose.net/index.php/SunCal SunCal]''' - Analyze time series data from sun scans

==== Grid ====

* '''[http://wiki.lrose.net/index.php/Radx2Grid Radx2Grid]''' - Gridding and interpolation of ground-based radar data

==== Echo ====

* '''[http://wiki.lrose.net/index.php/RadxKdp RadxKdp]''' - KDP and Attenuation calculations
* '''[http://wiki.lrose.net/index.php/RadxPid RadxPid]''' - KDP, Attenuation, and Particle Identification
* '''[http://wiki.lrose.net/index.php/RadxRate RadxRate]''' - KDP, Attenuation, PID, and Rain Rate
* '''[http://wiki.lrose.net/index.php/RadxQpe RadxQpe]''' - Accumulated Quantitative Precipitation Estimation
* '''[http://wiki.lrose.net/index.php/RadxHca RadxHca]''' - NEXRAD Hydrometeor Classification Algorithm
* '''[http://wiki.lrose.net/index.php/PrecipAccum PrecipAccum]''' - Accumulated Precipitation
* '''[http://wiki.lrose.net/index.php/RadxBeamBlock RadxBeamBlock]''' - Beam Blockage Estimation
* '''[http://wiki.lrose.net/index.php/ConvStrat ConvStrat]''' - Identify convective and stratiform regions in Cartesian radar volume
* '''[http://wiki.lrose.net/index.php/RadxMesoCyclone RadxMesoCyclone]''' - Identify mesocyclones in radar data
* '''[http://wiki.lrose.net/index.php/QpeVerify QpeVerify]''' - Compare radar-derived and observed precipitation accumulation
* '''[http://wiki.lrose.net/index.php/RefractCompute RefractCompute]''' - Compute refractivity
* '''[http://wiki.lrose.net/index.php/RefractCalib RefractCalib]''' - Create calibration file used by RefractCompute
* '''[http://wiki.lrose.net/index.php/CalcMoisture CalcMoisture]''' - Calculate moisture fields from refractivity
* '''[http://wiki.lrose.net/index.php/Titan Titan]''' - Thunderstorm Identification, Tracking, Analysis, and Nowcasting application
* '''[http://wiki.lrose.net/index.php/Tracks2Ascii Tracks2Ascii]''' - Print out storm and track data in ASCII format
* '''[http://wiki.lrose.net/index.php/Tstorms2Xml Tstorms2Xml]''' - Convert storms data to XML or Spdb
* '''[http://wiki.lrose.net/index.php/StormInitLocation StormInitLocation]''' - Write out the initiation location of significant storms
* '''[http://wiki.lrose.net/index.php/ScaleSep ScaleSep]''' - Separate a radar image into different spatial scales
* '''[http://wiki.lrose.net/index.php/Colide Colide]''' - Detect and extrapolate boundaries
* '''[http://wiki.lrose.net/index.php/ctrec ctrec]''' - Track echo motion
* '''[http://wiki.lrose.net/index.php/Rview Rview]''' - Visualize Titan data (spatially)
* '''[http://wiki.lrose.net/index.php/TimeHist TimeHist]''' - Visualize Titan data (through time)

==== Wind ====

* '''[http://wiki.lrose.net/index.php/RadxEvad RadxEvad]''' - Extended Velocity Azimuth Display single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/FRACTL FRACTL]''' - Fast Reorder and CEDRIC Technique in LROSE multi-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/SAMURAI SAMURAI]''' - Variational multi-Doppler retrieval and analysis package
* '''[http://wiki.lrose.net/index.php/VORTRAC VORTRAC]''' - Vortex Objective Radar Tracking and Circulation single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/OpticalFlow OpticalFlow]''' - Estimate 2-D velocity of a radar field

== '''Practical Radar Meteorology''' ==

The material contained here is designed to supplement radar textbooks and course materials with scientific background on common procedures used in radar meteorology. When combined with the above tutorials and documentation, these practical guides will help apply LROSE tools for scientific applications.

# [http://wiki.lrose.net/index.php/Radx2Grid_Gridding_Options Cartesian Gridding of Polar Radar Data]
# [http://wiki.lrose.net/index.php/Radx2Grid_Convective_Stratiform Convective/Stratiform Partitioning]
# [http://wiki.lrose.net/index.php/KDP_estimation Kdp Calculation]
# [http://wiki.lrose.net/index.php/RadxRate_equations Rain Rate Calculations]
# [http://wiki.lrose.net/index.php/Estimated_Attenuation Attenuation Correction]
# [http://wiki.lrose.net/index.php/RadxPid_fuzzylogic Particle Identification using Fuzzy Logic]
# [http://wiki.lrose.net/index.php/RadxQpe_expanded Quantitative Precipitation Estimation]
# [http://wiki.lrose.net/index.php/RadxDealias_James_and_Houze_2001 Velocity Dealiasing]

== '''LROSE Workshops''' ==

=== LROSE AMS 2020 Mini Workshop ===
*'''[http://wiki.lrose.net/images/a/ae/LROSE_AMS_2020_Mini-Workshop_Agenda.pdf Meeting Notes]'''
*'''[http://wiki.lrose.net/images/8/89/Mmbell_LROSE_AMSannual2020_small.pdf LROSE Mini-Workshop Slides]'''
*'''[http://wiki.lrose.net/images/9/9c/LROSE-CycloneDoppler_small.pdf LROSE Cyclone Multi-Doppler Tutorial Slides]'''
*'''[http://wiki.lrose.net/images/0/09/HawkEye_Tutorial.pdf Brief Hawkeye Tutorial Slides]'''

Main Page

2021-07-08T19:50:53Z

Tingyucha: /* Tutorials */

== '''LROSE: The Lidar Radar Open Software Environment''' ==

=== Overview ===

The current LROSE release is called '''“Elle”''' (a pink blend fragrant rose) and encompasses six key toolsets that define a core lidar/radar workflow: ''[http://wiki.lrose.net/index.php?title=Main_Page#Convert Convert], [http://wiki.lrose.net/index.php?title=Main_Page#Display Display], [http://wiki.lrose.net/index.php?title=Main_Page#Quality_Control QC], [http://wiki.lrose.net/index.php?title=Main_Page#Grid Grid], [http://wiki.lrose.net/index.php?title=Main_Page#Echo Echo], and [http://wiki.lrose.net/index.php?title=Main_Page#Wind Winds].'' '''Elle''' focuses on high-quality, well-tested, well-maintained and well-documented key applications as ‘building blocks’, allowing users to assemble trusted, reproducible workflows to accomplish more complex scientific tasks.

Elle can be compiled in C++ for native apps on Linux or Mac. Preliminary support is available for some tools on Windows.

We encourage users to [http://lrose.net/software.html register] in order to receive critical software updates, and sign up for the mailing list to help build the LROSE community.

[http://lrose.net/help.html Help] can be obtained by posting issues directly to the lrose-cyclone Github repository, via our help mailing list, or Discourse user forum.

LROSE is a co-operative project between:

* [http://www.atmos.colostate.edu/ Dept. of Atmospheric Science at Colorado State University (CSU)] and the
* [https://www.eol.ucar.edu/content/lidar-radar-open-software-environment The Earth Observing Lab at the National Center for Atmospheric Research (NCAR)].

LROSE is funded by the [https://www.nsf.gov National Science Foundation].

=== Citations for LROSE tools ===

Please cite the version of LROSE tools you use for publication. If you are unsure of the version, please cite the latest stable release.

* '''lrose-elle, 2021''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Jennifer DeHart and Ting-Yu Cha (2021). nsf-lrose/lrose-elle: lrose-elle-20210216.
* '''[https://doi.org/10.5281/zenodo.3604387 lrose-cyclone, 2020]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2020). nsf-lrose/lrose-cyclone: lrose-cyclone-20200110. https://doi.org/10.5281/zenodo.3604387
* '''[https://doi.org/10.5281/zenodo.2532758 lrose-blaze, 2019]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2019). nsf‐lrose/lrose‐blaze: lrose‐blaze‐20190105. https://doi.org/10.5281/zenodo.2532758

=== Installation Instructions ===

*'''Homebrew Installation'''
** '''[http://wiki.lrose.net/index.php/Mac-Homebrew-Installation Mac Homebrew installation]''' - For Native applications on the Mac, the recommended method is to use Homebrew. The formula contains all the necessary dependencies and builds instructions.

* '''Source Installation''' - Intended for users who wish to do a manual build or build in a non-standard location. Source compilation is best performed using a supplied Python script.
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/build/LROSE_build_main_page.md Build system]''' - For LINUX and MAC OS cmake/autoconf/manual builds and code development

* '''CIDD Binary Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/CIDD_binary_download_and_install.linux.md CIDD Binary Release]''' - CIDD depends on a 32-bit build, which complicates the build and install for the core. The CIDD display application is not included in the standard lrose-core packages (above).

=== Tutorials ===

* '''quick start'''
** '''[http://wiki.lrose.net/index.php/lrose_quickstart lrose quickstart tutorial]''' - Go over the basics to get up and running quickly with LROSE.

* '''echo tutorials'''
** '''[http://wiki.lrose.net/index.php/elle_basic basic elle echo tutorial]''' - Go through the basic steps necessary to convert a raw radar file to CfRadial, calculate Kdp and three-dimensional rain rate, and estimate the surface rainfall. The purpose of this tutorial is to confirm that the install process was successful and that some programs are working.
** '''[http://wiki.lrose.net/index.php/elle_basic_plus basic+ elle echo tutorial]''' - Similar to the basic elle tutorial with the added tasks of downloading GFS analysis from which to estimate a sounding near the radar and running the RadxBeamBlock application.
** '''[http://wiki.lrose.net/index.php/elle_full full elle echo tutorial]''' - This tutorial assumes the user has radar data downloaded in an [http://wiki.lrose.net/index.php/RadxConvert acceptable radar format] and walks through the most important parameters that need to be edited to run the Quantitative Precipitation Estimation (QPE) workflow.

* '''grid tutorial'''
** '''[http://wiki.lrose.net/index.php/elle_grid elle regrid and convective/stratiform tutorial]''' - Convert raw NEXRAD data to the cfradial format and then interpolate to a cartesian grid and applies a convective stratiform separation algorithm.

* '''wind tutorial'''
** '''[http://wiki.lrose.net/index.php/vortrac_tutorial VORTRAC tutorial]''' - run VORTRAC to retrieve the winds using the GBVTD/GVTD algorithm from a single Doppler radar data.

* '''CSU Radartools tutorial'''
** '''[http://wiki.lrose.net/index.php/csu_radartools_tutorial CSU-Radartools tutorial]''' - Step through the processing of a raw radar file through editing, QC and gridding using LROSE and CSU-Radartools

* ''' Airborne radar navigation correction tutorial'''
** '''[https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction/blob/main/Tutorial.md Airborne radar navigation correction]''' - Go through the steps of applying navigation correction on airborne radar data. Airborne radar navigation correction package can be found [https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction here].

=== Toolsets ===
In the current release, the following tools are available:

==== Convert ====

* '''[http://wiki.lrose.net/index.php/RadxPrint RadxPrint]''' - Query files to determine properties and support by the Radx engine
* '''[http://wiki.lrose.net/index.php/RadxConvert RadxConvert]''' - Convert 24 different lidar and radar formats to CfRadial NetCDF format
* '''[http://wiki.lrose.net/index.php/RadxBufr RadxBufr]''' - Convert Bufr format to CfRadial NetCDF format

==== Display ====

* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' - Real-time and archive display suitable for both scanning and vertically pointing radars.

==== Quality Control ====

* '''[http://wiki.lrose.net/index.php/RadxDiffFields RadxDiffFields]''' - Compare two fields in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxDiffVol RadxDiffVol]''' - Compare two volumes in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxMergeFields RadxMergeFields]''' - Merge fields from different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxFilter RadxFilter]''' - Perform simple filtering operations
* '''[http://wiki.lrose.net/index.php/RadxPersistentClutter RadxPersistentClutter]''' - Create a mask for persistent ground clutter
* '''[http://wiki.lrose.net/index.php/RadxDealias RadxDealias]''' - Dealias single-Doppler data
* '''[http://wiki.lrose.net/index.php/RadxQc RadxQc]''' - General quality control
* '''[http://wiki.lrose.net/index.php/IntfRemove IntfRemove]''' - Identify and remove interference in Titan data
* '''[http://wiki.lrose.net/index.php/RadxModelQc RadxModelQc]''' - Filter Radx data
* '''[http://wiki.lrose.net/index.php/RadxClutMon RadxClutMon]''' - Clutter analysis
* '''[http://wiki.lrose.net/index.php/TsCalAuto TsCalAuto]''' - Radar calibration analysis

==== Grid ====

* '''[http://wiki.lrose.net/index.php/Radx2Grid Radx2Grid]''' - Gridding and interpolation of ground-based radar data

==== Echo ====

* '''[http://wiki.lrose.net/index.php/RadxKdp RadxKdp]''' - KDP and Attenuation calculations
* '''[http://wiki.lrose.net/index.php/RadxPid RadxPid]''' - KDP, Attenuation, and Particle Identification
* '''[http://wiki.lrose.net/index.php/RadxRate RadxRate]''' - KDP, Attenuation, PID, and Rain Rate
* '''[http://wiki.lrose.net/index.php/RadxQpe RadxQpe]''' - Accumulated Quantitative Precipitation Estimation
* '''[http://wiki.lrose.net/index.php/RadxHca RadxHca]''' - NEXRAD Hydrometeor Classification Algorithm
* '''[http://wiki.lrose.net/index.php/PrecipAccum PrecipAccum]''' - Accumulated Precipitation
* '''[http://wiki.lrose.net/index.php/RadxBeamBlock RadxBeamBlock]''' - Beam Blockage Estimation
* '''[http://wiki.lrose.net/index.php/ConvStrat ConvStrat]''' - Identify convective and stratiform regions in Cartesian radar volume
* '''[http://wiki.lrose.net/index.php/RadxMesoCyclone RadxMesoCyclone]''' - Identify mesocyclones in radar data
* '''[http://wiki.lrose.net/index.php/QpeVerify QpeVerify]''' - Compare radar-derived and observed precipitation accumulation
* '''[http://wiki.lrose.net/index.php/RefractCompute RefractCompute]''' - Compute refractivity
* '''[http://wiki.lrose.net/index.php/RefractCalib RefractCalib]''' - Create calibration file used by RefractCompute
* '''[http://wiki.lrose.net/index.php/Titan Titan]''' - Thunderstorm Identification, Tracking, Analysis, and Nowcasting application

==== Wind ====

* '''[http://wiki.lrose.net/index.php/RadxEvad RadxEvad]''' - Extended Velocity Azimuth Display single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/FRACTL FRACTL]''' - Fast Reorder and CEDRIC Technique in LROSE multi-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/SAMURAI SAMURAI]''' - Variational multi-Doppler retrieval and analysis package
* '''[http://wiki.lrose.net/index.php/VORTRAC VORTRAC]''' - Vortex Objective Radar Tracking and Circulation single-Doppler retrieval

==== Other ====

* '''[http://wiki.lrose.net/index.php/RadarCal RadarCal]''' - Analyze calibration data
* '''[http://wiki.lrose.net/index.php/CalcMoisture CalcMoisture]''' - Calculate moisture fields from refractivity
* '''[http://wiki.lrose.net/index.php/Tracks2Ascii Tracks2Ascii]''' - Print out storm and track data in ASCII format
* '''[http://wiki.lrose.net/index.php/Tstorms2Xml Tstorms2Xml]''' - Convert storms data to XML or Spdb
* '''[http://wiki.lrose.net/index.php/StormInitLocation StormInitLocation]''' - Write out the initiation location of significant storms
* '''[http://wiki.lrose.net/index.php/OpticalFlow OpticalFlow]''' - Estimate 2-D velocity of a radar field
* '''[http://wiki.lrose.net/index.php/ScaleSep ScaleSep]''' - Separate a radar image into different spatial scales
* '''[http://wiki.lrose.net/index.php/Colide Colide]''' - Detect and extrapolate boundaries
* '''[http://wiki.lrose.net/index.php/RadxSunMon RadxSunMon]''' - Search for sun spikes and perform solar analysis
* '''[http://wiki.lrose.net/index.php/SunCal SunCal]''' - Analyze time series data from sun scans
* '''[http://wiki.lrose.net/index.php/ctrec ctrec]''' - Track echo motion

== '''Practical Radar Meteorology''' ==

The material contained here is designed to supplement radar textbooks and course materials with scientific background on common procedures used in radar meteorology. When combined with the above tutorials and documentation, these practical guides will help apply LROSE tools for scientific applications.

# [http://wiki.lrose.net/index.php/Radx2Grid_Gridding_Options Cartesian Gridding of Polar Radar Data]
# [http://wiki.lrose.net/index.php/Radx2Grid_Convective_Stratiform Convective/Stratiform Partitioning]
# [http://wiki.lrose.net/index.php/KDP_estimation Kdp Calculation]
# [http://wiki.lrose.net/index.php/RadxRate_equations Rain Rate Calculations]
# [http://wiki.lrose.net/index.php/Estimated_Attenuation Attenuation Correction]
# [http://wiki.lrose.net/index.php/RadxPid_fuzzylogic Particle Identification using Fuzzy Logic]
# [http://wiki.lrose.net/index.php/RadxQpe_expanded Quantitative Precipitation Estimation]
# [http://wiki.lrose.net/index.php/RadxDealias_James_and_Houze_2001 Velocity Dealiasing]

== '''LROSE Workshops''' ==

=== LROSE AMS 2020 Mini Workshop ===
*'''[http://wiki.lrose.net/images/a/ae/LROSE_AMS_2020_Mini-Workshop_Agenda.pdf Meeting Notes]'''
*'''[http://wiki.lrose.net/images/8/89/Mmbell_LROSE_AMSannual2020_small.pdf LROSE Mini-Workshop Slides]'''
*'''[http://wiki.lrose.net/images/9/9c/LROSE-CycloneDoppler_small.pdf LROSE Cyclone Multi-Doppler Tutorial Slides]'''
*'''[http://wiki.lrose.net/images/0/09/HawkEye_Tutorial.pdf Brief Hawkeye Tutorial Slides]'''

Main Page

2021-07-08T19:48:09Z

Tingyucha: /* Tutorials */

== '''LROSE: The Lidar Radar Open Software Environment''' ==

=== Overview ===

The current LROSE release is called '''“Elle”''' (a pink blend fragrant rose) and encompasses six key toolsets that define a core lidar/radar workflow: ''[http://wiki.lrose.net/index.php?title=Main_Page#Convert Convert], [http://wiki.lrose.net/index.php?title=Main_Page#Display Display], [http://wiki.lrose.net/index.php?title=Main_Page#Quality_Control QC], [http://wiki.lrose.net/index.php?title=Main_Page#Grid Grid], [http://wiki.lrose.net/index.php?title=Main_Page#Echo Echo], and [http://wiki.lrose.net/index.php?title=Main_Page#Wind Winds].'' '''Elle''' focuses on high-quality, well-tested, well-maintained and well-documented key applications as ‘building blocks’, allowing users to assemble trusted, reproducible workflows to accomplish more complex scientific tasks.

Elle can be compiled in C++ for native apps on Linux or Mac. Preliminary support is available for some tools on Windows.

We encourage users to [http://lrose.net/software.html register] in order to receive critical software updates, and sign up for the mailing list to help build the LROSE community.

[http://lrose.net/help.html Help] can be obtained by posting issues directly to the lrose-cyclone Github repository, via our help mailing list, or Discourse user forum.

LROSE is a co-operative project between:

* [http://www.atmos.colostate.edu/ Dept. of Atmospheric Science at Colorado State University (CSU)] and the
* [https://www.eol.ucar.edu/content/lidar-radar-open-software-environment The Earth Observing Lab at the National Center for Atmospheric Research (NCAR)].

LROSE is funded by the [https://www.nsf.gov National Science Foundation].

=== Citations for LROSE tools ===

Please cite the version of LROSE tools you use for publication. If you are unsure of the version, please cite the latest stable release.

* '''lrose-elle, 2021''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Jennifer DeHart and Ting-Yu Cha (2021). nsf-lrose/lrose-elle: lrose-elle-20210216.
* '''[https://doi.org/10.5281/zenodo.3604387 lrose-cyclone, 2020]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2020). nsf-lrose/lrose-cyclone: lrose-cyclone-20200110. https://doi.org/10.5281/zenodo.3604387
* '''[https://doi.org/10.5281/zenodo.2532758 lrose-blaze, 2019]''': Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Bruno Melli, Jennifer DeHart and Ting-Yu Cha (2019). nsf‐lrose/lrose‐blaze: lrose‐blaze‐20190105. https://doi.org/10.5281/zenodo.2532758

=== Installation Instructions ===

*'''Homebrew Installation'''
** '''[http://wiki.lrose.net/index.php/Mac-Homebrew-Installation Mac Homebrew installation]''' - For Native applications on the Mac, the recommended method is to use Homebrew. The formula contains all the necessary dependencies and builds instructions.

* '''Source Installation''' - Intended for users who wish to do a manual build or build in a non-standard location. Source compilation is best performed using a supplied Python script.
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/build/LROSE_build_main_page.md Build system]''' - For LINUX and MAC OS cmake/autoconf/manual builds and code development

* '''CIDD Binary Installation'''
** '''[https://github.com/NCAR/lrose-core/blob/master/docs/download/CIDD_binary_download_and_install.linux.md CIDD Binary Release]''' - CIDD depends on a 32-bit build, which complicates the build and install for the core. The CIDD display application is not included in the standard lrose-core packages (above).

=== Tutorials ===

* '''quick start'''
** '''[http://wiki.lrose.net/index.php/lrose_quickstart lrose quickstart tutorial]''' - Go over the basics to get up and running quickly with LROSE.

* '''echo tutorials'''
** '''[http://wiki.lrose.net/index.php/elle_basic basic elle echo tutorial]''' - Go through the basic steps necessary to convert a raw radar file to CfRadial, calculate Kdp and three-dimensional rain rate, and estimate the surface rainfall. The purpose of this tutorial is to confirm that the install process was successful and that some programs are working.
** '''[http://wiki.lrose.net/index.php/elle_basic_plus basic+ elle echo tutorial]''' - Similar to the basic elle tutorial with the added tasks of downloading GFS analysis from which to estimate a sounding near the radar and running the RadxBeamBlock application.
** '''[http://wiki.lrose.net/index.php/elle_full full elle echo tutorial]''' - This tutorial assumes the user has radar data downloaded in an [http://wiki.lrose.net/index.php/RadxConvert acceptable radar format] and walks through the most important parameters that need to be edited to run the Quantitative Precipitation Estimation (QPE) workflow.

* '''grid tutorial'''
** '''[http://wiki.lrose.net/index.php/elle_grid elle regrid and convective/stratiform tutorial]''' - Convert raw NEXRAD data to the cfradial format and then interpolate to a cartesian grid and applies a convective stratiform separation algorithm.

* '''wind tutorial'''
** '''[http://wiki.lrose.net/index.php/vortrac_tutorial VORTRAC tutorial]''' - run VORTRAC to retrieve the winds using the GBVTD/GVTD algorithm from a single Doppler radar data.

* '''CSU Radartools tutorial'''
** '''[http://wiki.lrose.net/index.php/csu_radartools_tutorial CSU-Radartools tutorial]''' - Step through the processing of a raw radar file through editing, QC and gridding using LROSE and CSU-Radartools

* ''' Airborne radar navigation correction tutorial'''
** '''[https://github.com/csu-tropical/Airborne-Radar-Navigation-Correction/blob/main/Tutorial.md Airborne radar navigation correction]''' - Go through the steps of applying navigation correction on airborne radar data.

=== Toolsets ===
In the current release, the following tools are available:

==== Convert ====

* '''[http://wiki.lrose.net/index.php/RadxPrint RadxPrint]''' - Query files to determine properties and support by the Radx engine
* '''[http://wiki.lrose.net/index.php/RadxConvert RadxConvert]''' - Convert 24 different lidar and radar formats to CfRadial NetCDF format
* '''[http://wiki.lrose.net/index.php/RadxBufr RadxBufr]''' - Convert Bufr format to CfRadial NetCDF format

==== Display ====

* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' - Real-time and archive display suitable for both scanning and vertically pointing radars.

==== Quality Control ====

* '''[http://wiki.lrose.net/index.php/RadxDiffFields RadxDiffFields]''' - Compare two fields in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxDiffVol RadxDiffVol]''' - Compare two volumes in different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxMergeFields RadxMergeFields]''' - Merge fields from different CfRadial files
* '''[http://wiki.lrose.net/index.php/RadxFilter RadxFilter]''' - Perform simple filtering operations
* '''[http://wiki.lrose.net/index.php/RadxPersistentClutter RadxPersistentClutter]''' - Create a mask for persistent ground clutter
* '''[http://wiki.lrose.net/index.php/RadxDealias RadxDealias]''' - Dealias single-Doppler data
* '''[http://wiki.lrose.net/index.php/RadxQc RadxQc]''' - General quality control
* '''[http://wiki.lrose.net/index.php/IntfRemove IntfRemove]''' - Identify and remove interference in Titan data
* '''[http://wiki.lrose.net/index.php/RadxModelQc RadxModelQc]''' - Filter Radx data
* '''[http://wiki.lrose.net/index.php/RadxClutMon RadxClutMon]''' - Clutter analysis
* '''[http://wiki.lrose.net/index.php/TsCalAuto TsCalAuto]''' - Radar calibration analysis

==== Grid ====

* '''[http://wiki.lrose.net/index.php/Radx2Grid Radx2Grid]''' - Gridding and interpolation of ground-based radar data

==== Echo ====

* '''[http://wiki.lrose.net/index.php/RadxKdp RadxKdp]''' - KDP and Attenuation calculations
* '''[http://wiki.lrose.net/index.php/RadxPid RadxPid]''' - KDP, Attenuation, and Particle Identification
* '''[http://wiki.lrose.net/index.php/RadxRate RadxRate]''' - KDP, Attenuation, PID, and Rain Rate
* '''[http://wiki.lrose.net/index.php/RadxQpe RadxQpe]''' - Accumulated Quantitative Precipitation Estimation
* '''[http://wiki.lrose.net/index.php/RadxHca RadxHca]''' - NEXRAD Hydrometeor Classification Algorithm
* '''[http://wiki.lrose.net/index.php/PrecipAccum PrecipAccum]''' - Accumulated Precipitation
* '''[http://wiki.lrose.net/index.php/RadxBeamBlock RadxBeamBlock]''' - Beam Blockage Estimation
* '''[http://wiki.lrose.net/index.php/ConvStrat ConvStrat]''' - Identify convective and stratiform regions in Cartesian radar volume
* '''[http://wiki.lrose.net/index.php/RadxMesoCyclone RadxMesoCyclone]''' - Identify mesocyclones in radar data
* '''[http://wiki.lrose.net/index.php/QpeVerify QpeVerify]''' - Compare radar-derived and observed precipitation accumulation
* '''[http://wiki.lrose.net/index.php/RefractCompute RefractCompute]''' - Compute refractivity
* '''[http://wiki.lrose.net/index.php/RefractCalib RefractCalib]''' - Create calibration file used by RefractCompute
* '''[http://wiki.lrose.net/index.php/Titan Titan]''' - Thunderstorm Identification, Tracking, Analysis, and Nowcasting application

==== Wind ====

* '''[http://wiki.lrose.net/index.php/RadxEvad RadxEvad]''' - Extended Velocity Azimuth Display single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/FRACTL FRACTL]''' - Fast Reorder and CEDRIC Technique in LROSE multi-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/SAMURAI SAMURAI]''' - Variational multi-Doppler retrieval and analysis package
* '''[http://wiki.lrose.net/index.php/VORTRAC VORTRAC]''' - Vortex Objective Radar Tracking and Circulation single-Doppler retrieval

==== Other ====

* '''[http://wiki.lrose.net/index.php/RadarCal RadarCal]''' - Analyze calibration data
* '''[http://wiki.lrose.net/index.php/CalcMoisture CalcMoisture]''' - Calculate moisture fields from refractivity
* '''[http://wiki.lrose.net/index.php/Tracks2Ascii Tracks2Ascii]''' - Print out storm and track data in ASCII format
* '''[http://wiki.lrose.net/index.php/Tstorms2Xml Tstorms2Xml]''' - Convert storms data to XML or Spdb
* '''[http://wiki.lrose.net/index.php/StormInitLocation StormInitLocation]''' - Write out the initiation location of significant storms
* '''[http://wiki.lrose.net/index.php/OpticalFlow OpticalFlow]''' - Estimate 2-D velocity of a radar field
* '''[http://wiki.lrose.net/index.php/ScaleSep ScaleSep]''' - Separate a radar image into different spatial scales
* '''[http://wiki.lrose.net/index.php/Colide Colide]''' - Detect and extrapolate boundaries
* '''[http://wiki.lrose.net/index.php/RadxSunMon RadxSunMon]''' - Search for sun spikes and perform solar analysis
* '''[http://wiki.lrose.net/index.php/SunCal SunCal]''' - Analyze time series data from sun scans
* '''[http://wiki.lrose.net/index.php/ctrec ctrec]''' - Track echo motion

== '''Practical Radar Meteorology''' ==

The material contained here is designed to supplement radar textbooks and course materials with scientific background on common procedures used in radar meteorology. When combined with the above tutorials and documentation, these practical guides will help apply LROSE tools for scientific applications.

# [http://wiki.lrose.net/index.php/Radx2Grid_Gridding_Options Cartesian Gridding of Polar Radar Data]
# [http://wiki.lrose.net/index.php/Radx2Grid_Convective_Stratiform Convective/Stratiform Partitioning]
# [http://wiki.lrose.net/index.php/KDP_estimation Kdp Calculation]
# [http://wiki.lrose.net/index.php/RadxRate_equations Rain Rate Calculations]
# [http://wiki.lrose.net/index.php/Estimated_Attenuation Attenuation Correction]
# [http://wiki.lrose.net/index.php/RadxPid_fuzzylogic Particle Identification using Fuzzy Logic]
# [http://wiki.lrose.net/index.php/RadxQpe_expanded Quantitative Precipitation Estimation]
# [http://wiki.lrose.net/index.php/RadxDealias_James_and_Houze_2001 Velocity Dealiasing]

== '''LROSE Workshops''' ==

=== LROSE AMS 2020 Mini Workshop ===
*'''[http://wiki.lrose.net/images/a/ae/LROSE_AMS_2020_Mini-Workshop_Agenda.pdf Meeting Notes]'''
*'''[http://wiki.lrose.net/images/8/89/Mmbell_LROSE_AMSannual2020_small.pdf LROSE Mini-Workshop Slides]'''
*'''[http://wiki.lrose.net/images/9/9c/LROSE-CycloneDoppler_small.pdf LROSE Cyclone Multi-Doppler Tutorial Slides]'''
*'''[http://wiki.lrose.net/images/0/09/HawkEye_Tutorial.pdf Brief Hawkeye Tutorial Slides]'''

Main Page

2021-03-01T23:02:13Z

Tingyucha: /* Tutorials */

Main Page

2021-03-01T23:01:24Z

Tingyucha: /* Tutorials */

VORTRAC

2021-03-01T22:44:14Z

Tingyucha:

=== '''Overview''' ===

The Vortex Objective Radar Tracking and Circulation software is a collection of radar algorithms designed to provide real-time or post-analysis information about hurricane location and structure from a single Doppler radar using the GBVTD or GVTD algorithms. These algorithms are written in C++ and combined with a graphical user interface (GUI) that allows the user to control the software operation and display critical storm parameters for use in an operational environment. The primary display shows a timeline of estimated central surface pressure and the radius of maximum wind (RMW) that updates as new radar volumes are processed. Additional information about the radar data and program operation is also displayed to the user, including a constant altitude plan-position indicator (CAPPI), maximum velocity, storm signal, status light, operation log, and progress bar. This development was funded under a grant from the NOAA Joint Hurricane Testbed program from 2005 – 2007.

=== '''Prerequesites''' ===

The following items are required:

* Cartesian gridded radar volume in NetCDF format (if not, go to '''[http://wiki.lrose.net/index.php/RadxConvert RadxConvert]''' and '''[http://wiki.lrose.net/index.php/Radx2Grid Radx2Grid]''' to learn how to get gridded radar volume!)
* One XML file to run VORTRAC (the configuration details of the XML file can be found '''[http://wiki.lrose.net/index.php/VORTRAC#Configuration here]'''
* Create several folders in the same directory as the XML file. The details can be found '''[http://wiki.lrose.net/index.php/VORTRAC#Running_VORTRAC here]'''

''For the details on the GBVTD and GVTD algorithms, please refer to the [http://wiki.lrose.net/index.php/VORTRAC#References references].''

=== '''Copyright, License, and Patent''' ===
The VORTRAC code is governed under two copyrights and licenses, and contains a patented algorithm.

The majority of the code is licensed under the Apache License Version 2.0, with the exception of the code in the NRL subdirectory. The code in the NRL subdirectory has contributions from Paul Harasti at the Naval Research Laboratory and is governed by a separate license. The Generalized Velocity Track Display (GVTD) algorithm was patented in 2010 as “Method for generating a representation of an atmospheric vortex kinematic structure” – '''[http://patft.uspto.gov/netacgi/nph-Parser?Sect1=PTO1&Sect2=HITOFF&d=PALL&p=1&u=%2Fnetahtml%2FPTO%2Fsrchnum.htm&r=1&f=G&l=50&s1=7,728,760.PN.&OS=PN/7,728,760&RS=PN/7,728,760 US Patent No. 7728760 B2]'''

=== '''Main code copyright and license''' ===
Copyright 2005 - 2018, Colorado State University and University Corporation for Atmospheric Research

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at '''[http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0]'''

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

=== '''References''' ===
* Cha, T.-Y., and Bell, M. M., 2020: Comparison of Single Doppler and Multiple Doppler Wind Retrievals in Hurricane Matthew (2016), Atmos. Meas. Tech. Discuss. [preprint], https://doi.org/10.5194/amt-2020-240, in review, 2020.
* Harasti, P.R., 2014: An Expanded VVP Technique to Resolve Primary and Environmental Circulations in Hurricanes. J. Atmos. Oceanic Technol., 31, 249–271.

* Jou, B. J.-D., W.-C. Lee, S.-P. Liu, and Y.-C. Kao, 2008: Generalized VTD retrieval of atmospheric vortex kinematic structure. Part I: Formulation and error analysis. Mon. Wea. Rev., 136 (3), 995–1012, doi: 10.1175/2007MWR2116.1.

* Lee, W.-C. and F. D. Marks, 2000: Tropical cyclone kinematic structure retrieved from single-Doppler radar observations. Part II: The GBVTD-Simplex center finding algorithm. Mon. Wea. Rev., 128 (6), 1925–1936, doi: 10.1175/1520-0493(2000)128<1925:TCKSRF>2.0.CO;2.

* Lee, W.-C., B. J.-D. Jou, P.-L. Chang, and S.-M. Deng, 1999: Tropical cyclone kinematic structure retrieved from single-Doppler radar observations. Part I: Interpretation of Doppler velocity patterns and the GBVTD technique. Mon. Wea. Rev., 127 (10), 2419–2439, doi: 10.1175/1520- 0493(1999)127<2419:TCKSRF>2.0.CO;2.

=== '''Running VORTRAC''' ===

# Create several folders in the same directory as the xml file:

* cappi
* center
* choosecenter
* radar
* pressure
* vtd

<ol start="2" style="list-style-type: decimal;">
<li>Put the radar files in the radar folder.</li></ol>

''If you select to use NetCDF pregridded data, make sure to convert the raw file format to CfRadial using '''[http://wiki.lrose.net/index.php/RadxConvert RadxConvert]''' then grid the data on Cartesian coordinate using '''[http://wiki.lrose.net/index.php/Radx2Grid Radx2Grid]'''.''

<ol start="3" style="list-style-type: decimal;">
<li>Edit the xml file and configure the information.
*:Descriptions of the xml file can be found below: '''[http://wiki.lrose.net/index.php/VORTRAC#Configuration Configuration]'''.

*:The xml example file can be found here: '''[https://github.com/tingyucha/NEXRAD_level2_data_process/blob/master/myconfig.xml myconfig.xml]'''</li>

<blockquote style="color: grey; border: solid thin gray;">
'''Important Note:''' Current vortrac_radarList.xml file only has the United States NEXRAD radar information. If the user would like to use other radar outside of the United States, you will have to manually insert the radar configuration in the vortrac_radarList.xml file under the <code lang="bash">Resources</code> directory.
</blockquote>

<li>To initiate a new run, execute VORTRAC using the following command:</li></ol>

: <code lang="bash">/path/to/lrose/install/bin/vortrac</code>

Click “File”, and open the configured xml file. Then, the user can initiate the analysis with the “Run” button on the bottom right.

<ol start="5" style="list-style-type: decimal;">
<li>After VORTRAC finishes all the analysis, the program will generate four files:</li></ol>

* {TC_name}_{Radar_name}_{Year_of_the_TC}_coefficientlist.csv
* {TC_name}_{Radar_name}_{Year_of_the_TC}_simplexlist.xml
* {TC_name}_{Radar_name}_{Year_of_the_TC}_vortexlist.xml
* VORTRAC_status_{The_time_of_analysis}.log

<code>TC_name</code>, <code>Radar_name</code>, and <code>Year_of_the_TC</code> will be generated based on the configured xml file, and <code>The_time_of_analysis</code> depends on the time when the user initiates a new run.

<ol start="6" style="list-style-type: decimal;">
<li>Convert the retrieved coefficients into a netCDF file with the coefficintlist and log files by using the following command:</li></ol>

: <code lang="bash">/path/to/lrose/install/bin/vo2nc -c {TC_name}_{Radar_name}_{Year_of_the_TC}_coefficientlist.csv -l VORTRAC_status_{The_time_of_analysis}.log -o output.nc</code>

From here, you can read in the netCDF file using Julia, Python, or other programming languages for further analysis.

= '''Configuration '''=

Edit the configuration in the XML file. Each section in the XML file is explained by the following:

== vortex ==

XML Label: '''name''' (default: New Hurricane)

* Input: Vortex Name
* Description: This parameter holds the name of the tropical cyclone that VORTRAC is tracking. This parameter is used internally for labeling and also for labeling various output files.

XML Label: '''lat''' (default: 0 deg)

* Input: Vortex Latitude
* Range: [-90, 90] deg

XML Label: '''lon''' (default: 0 deg)

* Input: Vortex Longitude
* Range: [-180, 180] deg
* Description: These parameters hold the first observation latitude and longitude of the tropical cyclone. The latitude and longitude of the storm given here should correspond with the time shown in “Time of Above Observation” so that VORTRAC can accurately locate the tropical cyclone. VORTRAC accepts latitude (longitude) in a decimal format where a negative value is in the Northern (Western) hemisphere and a positive value is in the Southern (Eastern) hemisphere. Initializing the VORTRAC analysis with an accurate storm location and time is required for a successful run and the accuracy of these parameters affects VORTRAC’s ability to follow the storm as it evolves.

XML Label: '''direction''' (default: 0 deg)

* Input: Direction of Vortex Movement (Degrees clockwise from North)
* Range: [0, 359.9] deg

XML Label: '''speed''' (default: 0 m/s)

* Input: Speed of Vortex Movement (Degrees clockwise from North)
* Range: [0, 100] m/s
* Description: These parameters should hold the direction and speed of the initial storm movement. These measurements should correspond with the time set in “Time of Above Observation” so that VORTRAC can accurately follow the tropical cyclone. While these parameters are not required for a successful run, it is highly recommended that the user obtain this information about the storm. These parameters are particularly useful when the initial observation (observation time, latitude and longitude on the VORTEX panel) is outside of the range of the Doppler radar. When the initial observation is outside Doppler range VORTRAC will linearly interpolate the initial position based on direction of storm movement and storm speed until the circulation enters the Doppler range of the radar.

XML Label: '''obsdate''' (default: current date UTC)

* Input: Time of Above Observation
* Range: Any Valid Date (format: YYYY-MM-DD)

XML Label: '''obstime''' (default: current time UTC)

* Input: Time of Above Observation
* Range: Any Valid UTC Time (format: HH:MM:SS)
* Description: These parameters are used to set the time of the initial observation which is described by Vortex Latitude, Vortex Longitude, Vortex Speed and Vortex Direction parameters contained in this panel. If this time of observation occurs before the starting time in RADAR CONFIGURATION PANEL, then VORTRAC will attempt to interpolate a starting location that is in the Doppler domain after the indicated initial time in the RADAR CONFIGURATION PANEL.

XML Label: '''dir''' (default: ‘default’ sets to current working directory at run time)
* Input: Working Directory
* Range: Any directory where the user has permission to read and write files
* Description: This parameter holds the location of the working directory which will contain many of the products and temporary files that VORTRAC uses during a run. When other directories in the configuration are left on the default setting they will default to subdirectories of this working directory. It is recommended that the user not change the working directory once a run has begun processing because this can cause difficulties in locating data products and intermediates. The working directory is also important when restarting an old run, since VORTRAC will search the working directory for traces of previous runs to restart.

XML Label: '''centers''' (optional, data format: YYYY-MM-DD:HH:MM,lat,lon)
* Input: Center file directory
* Range: Any directory where the user has permission to read and write files
* Description: This parameter should hold the directory of the csv file that contains the centers information. VORTRAC can use the csv file as a first guess to perform the simplex algorithm or as a final center to perform the GBVTD/GVTD algorithm. It is optional to include the center file, and the center format is <code>YYYY-MM-DD:HH:MM,lat,lon</code>.

== radar ==

XML Label: '''name''' (default: WSR-88D)
* Input: Radar Name
* Range: Any four letters (preferably radar call letters)
* Description: This parameter is intended to hold the radar call letters for WRS-88D radar that is being used to observe the storm. The drop down box in the RADAR CONFIGURATION PANEL can be used to select from several existing radars near the Atlantic and Gulf coasts. Additionally the user may choose to add new radars to this list by clicking ‘Other Radar …’ and entering or editing parameters as necessary. The radar call letters entered here are used for identifying radar volume data, in addition to internal labeling and naming data products, so entering these correctly is highly recommended.

XML Label: '''lat''' (default: 0 deg)
* Input: Radar Latitude (deg)
* Range: [-90, 90] decimal degrees

XML Label: '''lon''' (default: 0 deg)
* Input: Radar Longitude (deg)
* Range: [-180, 180] decimal degrees

XML Label: '''alt''' (default: 0 m)
* Panel Label: Radar Altitude (meters)
* Range: [-999, 999]
* Description: These three parameters describe the location of the radar in latitude, longitude and altitude. They will be automatically set when a radar is selected from the radar name drop box. These can be manually adjusted in the panel or in the radar list dialog which can be accessed by choosing ‘Other Radar …’ in the Radar Name drop box. These three parameters are all required to successfully run VORTRAC.

XML Label: dir (default: ‘default’)
* Input: Radar Data Directory -Range: Any existing directory where the user has read permissions
* Description: This parameter should hold the name of the directory that contains the level II radar data from the radar specified in this panel. The level II data in this directory should be the same format as that selected in the format drop box on this panel. Additionally, the level II data should be named in the following format: <code>KXXXyyyyMMdd_hhmmss</code>

where KXXX is the station call letters specified in the radar name parameter. The call letters are followed by the UTC time stamp of the volume in the above format. This parameter will default to the working directory if no other directory is given.

XML Label: '''format''' (default: LEVELII)
* Input: Data Format
* Range: [LDMLEVELII, NCDCLEVELII,NETCDF]
* Description: This parameter is used to select the radar data format of the files contained in the directory specified in dir. These formats are explained in greater detail in Sec 1A. This is a required parameter, selecting a format that doesn’t correspond with the files located in the Radar Data Directory will cause VORTRAC to run improperly.

XML Label: '''startdate''' (default: current date UTC, format: YYYY-MM-DD)

XML Label: '''starttime''' (default: current time UTC, format: HH:MM:SS)

* Input: Start Date and Time
* Range: Any valid date and time
* Description: These date and time parameters indicate the earliest time stamp that a volume of level II radar data may have in order to be processed by VORTRAC. This parameter is intended to help the user control which volumes are read in by VORTRAC for each analysis.

XML Label: '''enddate''' (default: current date UTC + 3 days, format: YYYY-MM-DD)

XML Label: '''endtime''' (default: current time UTC, format: HH:MM:SS) -Panel Label: End Date and Time
* Range: Any valid date and time -Description: These date and time parameters indicate the latest time stamp that a volume of level II radar data may have in order to be processed by VORTRAC. This parameter is intended to help the user control which volumes are read in by VORTRAC for each analysis.

== cappi ==

XML Label: '''dir''' (default: default)
* Input: CAPPI Output Directory -Range: Any directory where the user has read and write permission
* Description: This directory will be used to store CAPPI output files in the .asi format. More information on the .asi format can be found in Sec 1A. When the xml parameter dir is set to ‘default’ this directory will default to subdirectory of the working directory selected in the VORTEX CONFIGURATION PANEL. If such a subdirectory does not exist, one will be created. The user can also choose to adjust this directory independent of the main working directory.

XML Label: '''xdim''' (default: 150)
* Input: Grid Dimension in X Direction
* Range: [0, no maximum limit]

XML Label: '''ydim''' (default: 150)
* Input: Grid Dimension in Y Direction
* Range: [0, no maximum limit]

XML Label: '''zdim''' (default: 3)
* Input: Grid Dimension in Z Direction
* Range: [0, no maximum limit]
* Description: These three parameters allow the user to adjust the size of the CAPPI used in the analysis. The default dimensions are intended to meet the needs of the ‘average’ circulation, but these parameters can be adjusted to meet specific needs. Larger grids provide more data for analysis, but they also increase processing times considerably.

XML Label: '''xgridsp''' (default: 1.0 km)
* Input: X Grid Spacing (km)

XML Label: '''ygridsp''' (default: 1.0 km)
* Input: Y Grid Spacing (km)

XML Label: '''zgridsp''' (default: 1.0 km)
* Input: Z Grid Spacing (km)
* Description: These values control the grid spacing of the CAPPI. Currently these value are fixed at 1 km, but VORTRAC’s functionality may be expanded later to allow adjustments in these parameters.

XML Label: '''interpolation''' (default: cressman)
* Input: Interpolation
* Range: [cressman]
* Description: This parameter contains the interpolation method used for mapping data from the level II radar volume to the CAPPI for further processing. Currently Cressman interpolation is the only option for interpolating.

== center ==

XML Label: '''dir''' (default: ‘default’)
* Input: Center Output Directory
* Range: Any directory where the user has read and write permission -Description: This parameter stores the directory where the results of each simplex search will be stored. These files are intermediates which are only valuable to the advanced user, but if they are discarded the user will be unable to restart the VORTRAC run. A list of these files are stored in the working directory (file ending in simplexList.xml). This directory will default to use or create a center subdirectory in the working directory if its value is not altered.

XML Label: '''skipsimplex''' (default: false)
* Input: skip the simplex to find the center
* Range: [false,true]
* Description: This parameter determines whether to perform the center finding algorithm for the VORTRAC analysis. The user can put predetermined centers into a file (in the vortex section) and use them for the VORTRAC analysis.

XML Label: '''geometry''' (default: GBVTD)
* Input: Geometry
* Range: [GBVTD,GVTD]
* Description: This parameter holds the geometry for the VORTRAC analysis. Currently only the GBVTD geometry is implemented so this parameter should not be changed.

XML Label: '''closure''' (default: original)
* Input: Closure 
* Range: [original]
* Description: This parameter holds the closure assumption to be used in the VORTRAC analysis. Currently only the original closure assumption is available for use. This closure assumption is used in the simplex search for the vorticity center. For more about closure assumptions see Sec. 3A Algorithm Overview.

XML Label: '''reflectivity''' (default: DZ)
* Input: Reflectivity
* Range: [DZ]
* Description: This parameter holds the letters that identify the reflectivity data within the radar volumes. There is currently only one option for this parameter but it may be expanded later to suit user needs.

XML Label: '''velocity''' (default: VE)
* Input: Velocity
* Range: [VE] -Description: This parameter holds the letters that identify the velocity data within the radar volumes. There is currently only one option for this parameter but it may be expanded later to suit user needs.

XML Label: '''bottomlevel''' (default: 1 km)
* Input: Bottom Level (km) -Range: [0, 5] km

XML Label: '''toplevel''' (default: 3)
* Input: Top Level (km)
* Range: [2, 20] (km)
* Description: These two parameters control which height range within the CAPPI is used in the SIMPLEX search algorithms. The user can adjust these parameters, but the total number of levels used cannot exceed 20 due to memory constraints. Examining a greater number of levels may provide greater accuracy, but at the cost of computation time. The default values for these parameters should be appropriate for most cases. The user should also be cautioned that trying to examine levels outside of those contained in the CAPPI could yield undesirable results due to absent data.

XML Label: '''innerradius''' (default: 10)
* Input: Inner Radius (km)
* Range: [1, 120] XML Label: '''outerradius''' (default: 35)
* Input: Outer Radius (km)
* Range: [2, 150]
* Description: These two parameters control the range that the SIMPLEX algorithm searches for a circulations radius of maximum wind. These parameters should be adjusted based on outside information on the approximate radius of the tropical cyclone. If a cyclone’s RMW is not enclosed in this range SIMPLEX is unlikely to accurately locate a center. These are required parameters, they should also be adjusted if the storm changes size during the analysis. The SIMPLEX radius search range is displayed on the CAPPI DISPLAY once VORTRAC has completely processed a volume. This visual display should help the user locate the best radius range for subsequent simplex searches.

XML Label: '''ringwidth''' (default: 1.0 km)
* Input: Width of Search Rings (km) 
* Range: [0.01, 10.00] km
* Description: This parameter controls the width of the search ring for each radius search preformed by the SIMPLEX algorithm. This parameter does not change the ring spacing (SIMLEX will search in 1 km increments between the Inner Radius and the Outer Radius). This parameter controls the thickness of the annuli of data points from the CAPPI that are used for each search. It may be useful to increase this value when data in the region of interest is very sparse. However, increasing this value significantly may cause greater uncertainty in the radius of maximum wind.

XML Label: '''search''' (default: MAXVT0)
* Input: Center Finding Criteria
* Range: [MAXVT0]
* Description: This parameter contains the criteria that simplex searches for when attempting to locate the tropical cyclone center. Currently the only available option is MAXVT0. This selection indicates that the SIMPLEX search will attempt to locate the tropical cyclone based on the greatest primary circulation wind that it can locate during its search.

XML Label: '''influenceradius''' (default: 4.0)
* Input: Radius of Influence (km) * Range: [2, 10] km
* Description: This parameter controls the initial spacing of points in the SIMPLEX search algorithm. While this parameter can be adjusted to begin searching smaller or greater areas based on user needs, it is recommended that this parameter only be adjusted by advanced users.

XML Label: '''convergence''' (default: 0.05)
* Input: Convergence Requirements
* Range: [0.001, 2.000]
* Description: This parameter controls the extent of the convergence of centers required by the SIMPLEX algorithm for agreement between separate searches. While this parameter can be adjusted to require more or less convergence based on user needs, it is recommended that this parameter only be adjusted by advanced users.

XML Label: '''maxiterations''' (default: 60)
* Input: Maximum Iterations for Process
* Range: [10, 100]
* Description: This parameter sets the maximum number of iterations possible within a SIMPLEX search. Increasing this parameter may increase computation time. It is recommended that this parameter only be adjusted by advanced users.

XML Label: '''boxdiameter''' (default: 12.0 km)
* Input: Width of Search Zone (km)
* Range: [9, 25]

XML Label: '''numpoints''' (default: 16, recommended the number can be a square of an integer)
* Input: Number of Center Points
* Range: [1, 25]
* Description: These two parameters control the distribution of initial SIMPLEX searches that are independently run to locate the circulation center. The Width of Search Zone parameter controls the width of the initial range where SIMPLEX searches are started. The Number of Center Points parameter controls the number of starting points distributed within this box. It is recommended that these parameters only be changed by advanced users, the defaults should perform well for most cases.

XML Label: '''maxwavenum''' (default: 1)
* Input: Maximum Wave Number of TC
* Range: [0, no maximum limit]

XML Label: '''maxdatagap''' (default: 0 deg) 
* Input: Wave #
* Range: [0, 359] deg
* Description: These parameters control how much data can be missing within a ring of analysis at each wave number. The Maximum Wave Number controls the order of the Fourier fit used to calculate the winds at each ring. The SIMPLEX CONFIGURATION PANEL will hold multiple Wave # boxes corresponding to the value assigned maxwavenum. The maximum data gap for each wave number should be assigned based on an understanding of how missing data affects the quality of the fit. The defaults should work well form most cases.

== choosecenter ==

XML Label: '''dir''' (default: ‘default’) 
* Input: Choosecenter Output Directory
* Description: This parameter designates a directory where the user has read and write permissions to store choose center intermediate outputs and diagnostics. This parameter is not currently implemented.

XML Label: '''startdate''' (default: current date UTC, format: YYYY-MM-DD)

XML Label: '''starttime''' (default: current time UTC, format: HH:MM:SS)

* Input: Start Date and Time
* Range: Any valid date and time
* Description: These date and time parameters indicate the earliest time stamp that a volume of radar data may have in order to be included in the polynomial fit. This parameter is intended to help the user control which results are used to guide the center finding algorithm for future volumes. We recommend excluding volumes where the circulation center is near the edge of the radar range.

XML Label: '''enddate''' (default: current date UTC + 3 days, format: YYYY-MM-DD)

XML Label: '''endtime''' (default: current time UTC, format: HH:MM:SS)
* Input: End Date and Time
* Range: Any valid date and time
* Description: These date and time parameters indicate the latest time stamp that a volume of radar data may have in order to be included in the polynomial fit. This parameter is intended to help the user control which results are used to guide the centering algorithm for future volumes. We recommend excluding volumes where the circulation center is near the edge of the radar range.

XML Label: '''min_volumes''' (default: 6)
* Input: Number of Volumes Required to Begin Curve Fitting
* Range: [3, 100]
* Description: This parameter controls the minimum number of volumes that must process successfully before curve fitting begins. The user can avoid curve fitting by setting this parameter higher than the number of volumes he expects to process.

XML Label: '''wind_weight''' (default: 0.20)
* Input: Maximum Wind Score Weight

XML Label: '''stddev_weight''' (default: 0.60)
* Input: Standard Deviation Score Weight

XML Label: '''pts_weight''' (default: 0.20)
* Input: Number of Converging Centers Score Weight
* Range: [0.0, 1.0]
* Description: This set of weights determines the mean centers and the radius of maximum wind on each level of the CAPPI from the centers located by the SIMPLEX algorithm. The sum of all three of these weights should add to one. Adjusting these weights allows the user to put greater emphasis on a specific characteristic when determining the location of the circulation center and corresponding radius of maximum wind. It is recommended that these parameters only be adjusted by the advanced user.

XML Label: '''position_weight''' (default: 0.40)
* Input: Distance Score Weight

XML Label: '''rmw_weight''' (default: 0.40)
* Input: Radius of Maximum Wind Score Weight

XML Label: '''vt_weight''' (default: 0.20)
* Input: Maximum Velocity Score Weight
* Range: [0.0, 1.0]
* Description: This set of weights determines the fitted center and radius of maximum wind on each level of the CAPPI based on information from previously processed volumes. The sum of all three of these weights should add to one. A polynomial fit is constructed based no the position, radius of maximum wind, and the maximum wind from all previous volumes included in the fit to determine the best circulation center of those located by simplex. Adjusting these parameters will effect which characteristics are given a greater emphasis is determining the best center, it is recommended that these parameters only be adjusted by the advanced user.

XML Label: '''stats''' (default: 95)
* Input: fTest Precision
* Range: {95, 99} %
* Description: This parameter determines the statistical significance level required to increase the order of the polynomial curve fits used to constrain the selected centers. The higher significance level results in a stricter requirement, and therefore most likely a lower order fit. It is recommended that this parameter only be adjusted by the advanced user.

== VTD ==

XML Label: '''dir''' (default: ‘default’)
* Input: VTD Output Directory -Range: Any directory where the user has read and write permission -Description: This parameter stores the directory where the results of the final GBVTD search will be stored. These files are intermediates which are only valuable to the advanced user, but if they are discarded the user will be unable to restart the VORTRAC run. A list of these files are stored in the working directory (file ending in vortexList.xml). This directory will default to use or create a center subdirectory in the working directory if its value is not altered.

XML Label: '''geometry''' (default: GBVTD)
* Input: Geometry
* Range: [GBVTD, GVTD] Description: This parameter holds the geometry for the VORTRAC analysis. Currently only the GBVTD geometry is implemented so this parameter should not be changed. This parameter controls the same functionality as the parameter of the same name in the SIMPLEX Configuration Panel, but is only used in the final calculation of the circulation winds.

XML Label: '''closure''' (default: original_hvvp)
* Input: Closure 
* Range: [original, original_hvvp]
* Description: This parameter holds the closure assumption to be used in the VORTRAC analysis. Selecting the ‘original’ closure assumption assumes the component of the environmental wind perpendicular to the radar’s line of view to the storm is negligible. Selecting ‘original_hvvp’ allows VORTRAC to use the HVVP algorithm to calculate this environmental wind component. This closure assumption is used in the GBVTD final analysis of the selected vorticity center. For more about closure assumptions see Sec. 3A Algorithm Overview. This parameter controls the same functionality as the parameter of the same name in the SIMPLEX CONFIGURATION PANEL, but is only used in the final calculation of the circulation winds. The ‘original_hvvp’ closure assumption is not available in the simplex search because it increases calculation times considerably.

XML Label: '''reflectivity''' (default: DZ)
* Input: Reflectivity
* Range: [DZ]
* Description: This parameter holds the letters that identify the reflectivity data within the radar volumes. There is currently only one option for this parameter but it may be expanded later to suit user needs. This parameter controls the same functionality as the parameter of the same name in the SIMPLEX CONFIGURATION PANEL, but is only used in the final calculation of the circulation winds.

XML Label: '''velocity''' (default: VE)
* Input: Velocity
* Range: [VE] -Description: This parameter holds the letters that identify the velocity data within the radar volumes. There is currently only one option for this parameter but it may be expanded later to suit user needs. This parameter controls the same functionality as the parameter of the same name in the SIMPLEX CONFIGURATION PANEL, but is only used in the final calculation of the circulation winds.

XML Label: '''bottomlevel''' (default: 1 km)
* Input: Bottom Level (km) -Range: [0, 5] km

XML Label: '''toplevel''' (default: 3)
* Input: Top Level (km)
* Range: [2, 20] (km)
* Description: These two parameters control which height range within the CAPPI is used in the final calculation of the circulation winds. The user can adjust these parameters, but the total number of levels used cannot exceed 15 due to memory constraints. Examining a greater number of levels may provide greater accuracy, but at the cost of computation time. The default values for these parameters should be appropriate for most cases. The user should also be cautioned that trying to examine levels outside of those contained in the CAPPI and those processed by SIMPLEX could yield undesirable results due to absent data.

XML Label: '''innerradius''' (default: 1)
* Input: Inner Radius (km) -Range: [1, 100]

XML Label: '''outerradius''' (default: 60)
* Input: Outer Radius (km) -Range: [2, 150]
* Description: These two parameters control the range of radii that are included in the pressure deficit calculation using the final circulation winds. These parameters should be adjusted to encompass as much of the circulation as possible without exceeding memory limitations (current memory limitations are 150 rings). These are required parameters, they should also be adjusted if the storm changes size during the analysis. It is highly recommended that the user leave the inner radius at the 1 km default. The Outer VTD radius is displayed on the CAPPI DISPLAY once VORTRAC has completely processed a volume. This visual display should help the user locate the best radius range for analysis of subsequent volumes.

XML Label: '''ringwidth''' (default: 1.0 km)
* Input: Width of Search Rings (km) 
* Range: [0.01, 10.00] km
* Description: This parameter controls the width of the search ring for each radius analysis preformed in the final calculation of circulation winds. This parameter does not change the ring spacing (VTD will extract information on circulation winds in 1 km increments between the Inner Radius and the Outer Radius). This parameter controls the thickness of the annuli of data points from the CAPPI that are used for each search. It may be useful to increase this value when data in the region of interest is very sparse. However, increasing this value significantly may cause greater uncertainty in the radius of maximum wind.

XML Label: '''maxwavenum''' (default: 1)
* Input: Maximum Wave Number of TC
* Range: [0, no maximum limit]

XML Label: '''maxdatagap''' (default: 0 deg) 
* Input: Wave #
* Range: [0, 359] deg
* Description: These parameters control how much data can be missing within a ring of analysis at each wave number. The Maximum Wave Number controls the order of the Fourier fit used to calculate the winds at each ring. The VTD CONFIGURATION Panel will hold multiple Wave # boxes corresponding to the value assigned maxwavenum. The maximum data gap for each wave number should be assigned based on an understanding of how missing data affects the quality of the fit. The defaults should work well form most cases.

== hvvp ==

Currently, HVVP is not used in the VORTRAC analysis, so the user can leave it as default setting.

== pressure ==

XML Label: '''dir''' (default: default)
* Input: Directory Containing Pressure Data
* Range: Any directory where the user has read permissions
* Description: This parameter is used to specify the directory that holds files containing the pressure anchor data for the tropical cyclone that is currently being processed. This directory will be repeatedly checked for any additional pressure data files while the algorithm is running.

XML Label: '''format''' (default: AWIPS)
* Input: Data Format
* Range: [AWIPS, Hwind]
* Description: This parameter indicates the format of the incoming pressure data that is found in the directory specified by the Directory Containing Pressure Data parameter. More information about the expected input format is found in Sec. 4B.

XML Label: '''height''' (default: 1 km)
* Input: Height at which Pressure Gradient is Calculated (km)
* Range: [1, 20] km
* Description: This parameter is used to specify the height that will be used when the pressure deficit is calculated. The height is measured in km above the radar. Best results are obtained when examining the lowest level containing viable data. Usually this is 1 km but in some circumstances the user may want to adjust this parameter.

XML Label: '''maxobstime''' (default: 59 min)
* Input: Discard Pressure Observations After (minutes)
* Range: [1, 1000] minutes
* Description: This parameter indicates the maximum number of minutes which can elapse between the time a volume is created and time of the external pressure observation used to anchor the VORTRAC pressure calculation. VORTRAC requires external pressure anchors to accurately calculate the central pressure of the circulation. The algorithm will use near by pressure observations in conjunction with the pressure gradient of the storm to calculate the central pressure. The pressure observations used to anchor the calculation of the central pressure for each volume are limited to those which were recorded maxobstime minutes before the volume.

XML Label: '''maxobsdist''' (default: 50 km)
* Input: Maximum Distance (km)
* Range: [1, 1000]
* Description: External pressure observations used to anchor the VORTRAC central pressure estimate are also weighted by the distance of the external observation from the tropical storm. This parameter specifies the maximum distance between a pressure measurement and the tropical cyclone being examined which permits the measurement to be used in the anchoring calculation. External pressure observations beyond this distance will not be used as part of the anchor pressure calculation.

XML Label: '''maxobsmethod''' (default: ring)
* Input: Maximum Distance to Pressure Observations. Measure from TC Center or measure from Edge of Analysis
* Range: [ring, center]
* Description: Checking one of the two radio buttons in this box will set the method for deciding which pressure estimates should be used as anchors in the VORTRAC pressure calculation. If ‘Measure from TC Center’ is down only pressure within the Maximum Distance parameter value of the tropical cyclone center are used to calculate the anchor pressure for the VORTRAC central pressure estimate. If ‘Measure from Edge of Analysis’ is down then the pressure observations used in this calculation must be less than the Maximum Distance parameter value from the edge of the VORTRAC analysis domain (described in VTD Configuration Panel in the Outer Radius parameter).

XML Label: '''av_interval''' (default: 8)
* Input: Number of Volumes Averaged
* Range: [3, 12]
* Description: This parameter holds the number of volumes that will be averaged together to determine the rate of change in central pressure for the tropical cyclone. The Storm Signal on the VORTRAC display will indicate when there has been a significant change in the pressure trend of the storm being analyzed. In order to avoid signals based on small volume to volume fluctuations several volumes are averaged and compared to radar volumes collected during the previous hour to diagnose the rate of change of storm central pressure.

XML Label: '''rapidlimit''' (default: 3)
* Input: Pressure Change for Warnings (mb/hr)
* Range: [1, 10] mb/hr
* Description: This value sets the rate of change in the tropical cyclone central pressure that will trigger a change in the Storm Signal on the VORTRAC display. This parameter is used in conjunction with the Number of Volumes Averaged parameter to determine the thresholds for displaying pressure change warnings.

== graphics ==

XML Label: '''autolimits''' (default: on)
* Input: Parameters for Graph Display (radio button)
* Range: {on, off}
* Description: This box of items is used to manually adjust the scale and parameters of the radius of maximum wind (RMW) and pressure display in the GUI. The Pressure/RMW Display is set to automatically adjust the scales to include the results from every successfully processed volume. Should the user want to adjust these parameters, the xml autolimits parameter can be turned off (by checking the Parameters for Graph Display box), making available a number of adjustment parameters.

XML Label: '''pressmin''' (default: 900.00 mb)
* Input: Minimum Pressure (mb). Only available when “Parameters for Graph Display” is checked
* Range: [0, 1000] mb
* Description: This value is the user defined minimum pressure measurement that will be displayed on the Pressure/RMW Display. Any pressure measurements below this value will not be displayed on the graph.

XML Label: '''pressmax''' (default: 1020 mb)
* Input: Maximum Pressure (mb). Only available when “Parameters for Graph Display” is checked
* Range: [700, 1100] mb
* Description: This value is the user-defined maximum pressure measurement that will be displayed on the Pressure/RMW Display. Any pressure measurements above this value will not be displayed on the graph.

XML Label: '''rmwmin''' (default: 0 km)
* Input: Minimum RMW (km). Only available when “Parameters for Graph Display” is checked
* Range: [0, 200]
* Description: This value is the user-defined minimum radius of maximum wind (RMW) measurement that will be displayed on the Pressure/RMW Display. Any RMW measurements above this value will not be displayed on the graph.

XML Label: '''rmwmax''' (default: 60 km)
* Input: Maximum RMW (km). Only available when “Parameters for Graph Display” is checked
* Range: [0, 200]
* Description: This value is the user-defined maximum radius of maximum wind (RMW) measurement that will be displayed on the Pressure/RMW Display. Any RMW measurements above this value will not be displayed on the graph.

XML Label: '''startdate''' (default: current date UTC, format: YYYY-MM-DD)

XML Label: '''starttime''' (default: current time UTC, format: HH:MM:SS) -Input: First Graph Display Time. Only available when “Parameters for Graph Display” is checked * Range: Any valid date and time -Description: This is the user-defined minimum time for pressure and RMW measurements that will be displayed on the Pressure/RMW Display. This value should be within the period of currently processed radar data.

XML Label: '''enddate''' (default: current date UTC + 3 days, format: YYYY-MM-DD)

XML Label: '''endtime''' (default: current time, format: HH:MM:SS)
* Input: Final Graph Display Time. Only available when “Parameters for Graph Display” is checked
* Range: Any valid date and time -Description: This time is the user-defined maximum time for pressure and RMW measurements that will be displayed on the Pressure/RMW Display. This value should be within the period of currently processed radar data

Main Page

2021-03-01T22:43:45Z

Tingyucha: /* Citations for LROSE tools */

Main Page

2021-03-01T22:42:38Z

Tingyucha: /* Installation Instructions */

Main Page

2021-03-01T22:25:34Z

Tingyucha: /* Installation Instructions */

Linux-Build

2021-02-24T21:38:28Z

Tingyucha: /* How to install LROSE source on Mac/Linux? */

=== '''Overview''' ===
For most common LINUX systems, you can install lrose from the packages on this page.

For some of the versions of LINUX, we are still having problems with the Qt5-based applications. These problems include both compile errors, and run-time errors related to problems with dynamically-linked libraries. We are working to identify the cause of the problems. In the meantime, we have documented which applications are available on each OS version.

{| class="wikitable"
! OS-version !! fractl !! vortrac !! samurai !! HawkEye !! CIDD available?
|-
| CENTOS 7 || Yes || Yes || Yes || Yes || Yes
|-
| CENTOS 8 || Yes || Yes || Yes || Yes || Yes
|-
| CENTOS stream (latest) || Yes || Yes || Yes || Yes || Yes
|-
| Fedora 31 || Yes || Yes || Yes || Yes || Yes
|-
| Fedora 32 || Yes || Yes || Yes || Yes || Yes
|-
| Fedora 33 || Yes || Yes || Yes || Yes || Yes
|-
| Debian 9 || Yes || Yes || Yes || Yes || Yes
|-
| Debian 10 || Yes || Yes || Yes || Yes || Yes
|-
| Ubuntu 16.04 || Yes || Yes || Yes || Yes || Yes
|-
| Ubuntu 18.04 || Yes || Yes || Yes || Yes || Yes
|-
| Ubuntu 20.04 || Yes || Yes || Yes || Yes || Yes
|-
| Suse leap || Yes || Yes || Yes || Yes || Yes
|-
| Suse latest || Yes || Yes || Yes || Yes || Yes
|-
| Oracle 8 (latest) || No || No || No || Yes || Yes
|}

=== '''Prerequesites''' ===
1. Most good, up-to-date LINUX distributions should work.

Recommended distributions are:

* Debian
* Ubuntu (based on Debian)
* RedHat
* Centos (based on RedHat)
* Fedora (based on RedHat)

First, you will need to install the required packages.

See: '''[https://github.com/NCAR/lrose-core/blob/master/docs/build/lrose_package_dependencies.md LROSE package dependencies]'''

2. Download the source tar file for Linux from: '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20210216/lrose-core-20210216.src.tgz Release]'''

A typical source release would be:

<code lang="bash"> lrose-core-20210216.src.tgz </code>

* Create a working directory for building the distribution:

<code lang="bash"> mkdir ~/lrose_build </code>

<code lang="bash"> cd ~/lrose_build </code>

* Untar

<code lang="bash"> tar xvfz lrose-core-20210216.src.tgz </code>

The distribution will be unpacked into a subdirectory:

<code lang="bash"> cd ~/lrose_build/lrose-core-20210216.src</code>

=== '''Build''' ===

* Run the build script:

To see the usage:

<code lang="bash"> ./build_src_release.py --help </code>

To build and install into the default directory: <code lang="bash"> /usr/local/lrose </code>

<code lang="bash"> ./build_src_release.py </code>

Or set an install directory:

<code lang="bash"> ./build_src_release.py --prefix /my/install/dir </code>

=== '''Verification''' ===

* Look in ~/lrose or /my/install/dir for

<code lang="bash"> include </code>

<code lang="bash"> lib </code>

<code lang="bash"> bin </code>

* Try the commands:
<code lang="bash"> /usr/local/lrose/bin/RadxPrint -h </code>

<code lang="bash"> /usr/local/lrose/bin/RadxConvert -h </code>

<code lang="bash"> /usr/local/lrose/bin/Radx2Grid -h </code>

<code lang="bash"> /usr/local/lrose/bin/HawkEye </code>

=== '''Errors tracking''' ===

If the build does not complete successfully, you will need to
track down the errors.

The very first errors in the build are the most important.

If you get errors, go into the directory giving problems, and
run the make as follows:

<code lang="bash"> make |& less </code>

and scroll down searching for '''error'''.

Alternatively, run

<code lang="bash"> make >& make.log </code>

and then inspect the make.log file, searching for '''error'''.

=== '''Update a new version''' ===

To update, just repeat the procedure in sections 2, 3 and 4 above.

The new version will be installed over the previous version.

Linux-Build

2021-02-24T21:37:44Z

Tingyucha: /* Prerequesites */

=== '''How to install LROSE source on Mac/Linux?''' ===
For most common LINUX systems, you can install lrose from the packages on this page.

For some of the versions of LINUX, we are still having problems with the Qt5-based applications. These problems include both compile errors, and run-time errors related to problems with dynamically-linked libraries. We are working to identify the cause of the problems. In the meantime, we have documented which applications are available on each OS version.

{| class="wikitable"
! OS-version !! fractl !! vortrac !! samurai !! HawkEye !! CIDD available?
|-
| CENTOS 7 || Yes || Yes || Yes || Yes || Yes
|-
| CENTOS 8 || Yes || Yes || Yes || Yes || Yes
|-
| CENTOS stream (latest) || Yes || Yes || Yes || Yes || Yes
|-
| Fedora 31 || Yes || Yes || Yes || Yes || Yes
|-
| Fedora 32 || Yes || Yes || Yes || Yes || Yes
|-
| Fedora 33 || Yes || Yes || Yes || Yes || Yes
|-
| Debian 9 || Yes || Yes || Yes || Yes || Yes
|-
| Debian 10 || Yes || Yes || Yes || Yes || Yes
|-
| Ubuntu 16.04 || Yes || Yes || Yes || Yes || Yes
|-
| Ubuntu 18.04 || Yes || Yes || Yes || Yes || Yes
|-
| Ubuntu 20.04 || Yes || Yes || Yes || Yes || Yes
|-
| Suse leap || Yes || Yes || Yes || Yes || Yes
|-
| Suse latest || Yes || Yes || Yes || Yes || Yes
|-
| Oracle 8 (latest) || No || No || No || Yes || Yes
|}

=== '''Prerequesites''' ===
1. Most good, up-to-date LINUX distributions should work.

Recommended distributions are:

* Debian
* Ubuntu (based on Debian)
* RedHat
* Centos (based on RedHat)
* Fedora (based on RedHat)

First, you will need to install the required packages.

See: '''[https://github.com/NCAR/lrose-core/blob/master/docs/build/lrose_package_dependencies.md LROSE package dependencies]'''

2. Download the source tar file for Linux from: '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20210216/lrose-core-20210216.src.tgz Release]'''

A typical source release would be:

<code lang="bash"> lrose-core-20210216.src.tgz </code>

* Create a working directory for building the distribution:

<code lang="bash"> mkdir ~/lrose_build </code>

<code lang="bash"> cd ~/lrose_build </code>

* Untar

<code lang="bash"> tar xvfz lrose-core-20210216.src.tgz </code>

The distribution will be unpacked into a subdirectory:

<code lang="bash"> cd ~/lrose_build/lrose-core-20210216.src</code>

=== '''Build''' ===

* Run the build script:

To see the usage:

<code lang="bash"> ./build_src_release.py --help </code>

To build and install into the default directory: <code lang="bash"> /usr/local/lrose </code>

<code lang="bash"> ./build_src_release.py </code>

Or set an install directory:

<code lang="bash"> ./build_src_release.py --prefix /my/install/dir </code>

=== '''Verification''' ===

* Look in ~/lrose or /my/install/dir for

<code lang="bash"> include </code>

<code lang="bash"> lib </code>

<code lang="bash"> bin </code>

* Try the commands:
<code lang="bash"> /usr/local/lrose/bin/RadxPrint -h </code>

<code lang="bash"> /usr/local/lrose/bin/RadxConvert -h </code>

<code lang="bash"> /usr/local/lrose/bin/Radx2Grid -h </code>

<code lang="bash"> /usr/local/lrose/bin/HawkEye </code>

=== '''Errors tracking''' ===

If the build does not complete successfully, you will need to
track down the errors.

The very first errors in the build are the most important.

If you get errors, go into the directory giving problems, and
run the make as follows:

<code lang="bash"> make |& less </code>

and scroll down searching for '''error'''.

Alternatively, run

<code lang="bash"> make >& make.log </code>

and then inspect the make.log file, searching for '''error'''.

=== '''Update a new version''' ===

To update, just repeat the procedure in sections 2, 3 and 4 above.

The new version will be installed over the previous version.

Linux-Build

2021-02-24T21:36:26Z

Tingyucha: /* How to install LROSE source on Mac/Linux? */

Linux-Build

2021-02-24T21:31:20Z

Tingyucha: /* How to install LROSE source on Mac/Linux? */

=== '''How to install LROSE source on Mac/Linux?''' ===
For most common LINUX systems, you can install lrose from the packages on this page.

For some of the versions of LINUX, we are still having problems with the Qt5-based applications. These problems include both compile errors, and run-time errors related to problems with dynamically-linked libraries. We are working to identify the cause of the problems. In the meantime, we have documented which applications are available on each OS version.

{| class="wikitable"
|- style="text-align:center;"
! OS-version
! fractl
! vortrac
! samurai
! HawkEye
! CIDD available?
|-
| CENTOS 6
| No
| No
| No
| Yes
| No
|-
| CENTOS 7
| Yes
| Yes
| Yes
| Yes
| Yes
|-
| CENTOS 8
| Yes
| Yes
| Yes
| Yes
| Yes
|-
| Fedora 29
| Yes
| No
| Yes
| No
| Yes
|-
| Fedora 30
| Yes
| No
| Yes
| No
| Yes
|-
| Fedora 31
| Yes
| No
| Yes
| No
| Yes
|-
| Debian 9
| Yes
| Yes
| Yes
| No
| Yes
|-
| Debian 10
| Yes
| Yes
| Yes
| No
| Yes
|-
| Ubuntu 16.04
| Yes
| Yes
| Yes
| Yes
| Yes
|-
| Ubuntu 18.04
| Yes
| Yes
| Yes
| Yes
| Yes
|-
| Suse leap
| Yes
| Yes
| Yes
| Yes
| Yes
|-
| Suse latest
| Yes
| Yes
| Yes
| Yes
| Yes
|}

=== '''Prerequesites''' ===
1. Most good, up-to-date LINUX distributions should work.

Recommended distributions are:

* Debian
* Ubuntu (based on Debian)
* RedHat
* Centos (based on RedHat)
* Fedora (based on RedHat)

First, you will need to install the required packages.

See: '''[https://github.com/NCAR/lrose-core/blob/master/docs/build/lrose_package_dependencies.md LROSE package dependencies]'''

2. Download the source tar file for Linux from: '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20210216/lrose-core-20210216.src.tgz Release]'''

A typical source release would be:

<code lang="bash"> lrose-core-20210216.src.tgz </code>

* Create a working directory for building the distribution:

<code lang="bash"> mkdir ~/lrose_build </code>

<code lang="bash"> cd ~/lrose_build </code>

* Untar

<code lang="bash"> tar xvfz lrose-core-20210216.src.tgz </code>

The distribution will be unpacked into a subdirectory:

<code lang="bash"> cd ~/lrose_build/lrose-core-20210216.src</code>

=== '''Build''' ===

* Run the build script:

To see the usage:

<code lang="bash"> ./build_src_release.py --help </code>

To build and install into the default directory: <code lang="bash"> /usr/local/lrose </code>

<code lang="bash"> ./build_src_release.py </code>

Or set an install directory:

<code lang="bash"> ./build_src_release.py --prefix /my/install/dir </code>

=== '''Verification''' ===

* Look in ~/lrose or /my/install/dir for

<code lang="bash"> include </code>

<code lang="bash"> lib </code>

<code lang="bash"> bin </code>

* Try the commands:
<code lang="bash"> /usr/local/lrose/bin/RadxPrint -h </code>

<code lang="bash"> /usr/local/lrose/bin/RadxConvert -h </code>

<code lang="bash"> /usr/local/lrose/bin/Radx2Grid -h </code>

<code lang="bash"> /usr/local/lrose/bin/HawkEye </code>

=== '''Errors tracking''' ===

If the build does not complete successfully, you will need to
track down the errors.

The very first errors in the build are the most important.

If you get errors, go into the directory giving problems, and
run the make as follows:

<code lang="bash"> make |& less </code>

and scroll down searching for '''error'''.

Alternatively, run

<code lang="bash"> make >& make.log </code>

and then inspect the make.log file, searching for '''error'''.

=== '''Update a new version''' ===

To update, just repeat the procedure in sections 2, 3 and 4 above.

The new version will be installed over the previous version.

Linux-Build

2021-02-24T21:26:53Z

Tingyucha: /* How to install LROSE source on Linux? */

== How to install LROSE source on Mac/Linux? ==
For most common LINUX systems, you can install lrose from the packages on this page.

For some of the versions of LINUX, we are still having problems with the Qt5-based applications. These problems include both compile errors, and run-time errors related to problems with dynamically-linked libraries. We are working to identify the cause of the problems. In the meantime, we have documented which applications are available on each OS version.

{| class="wikitable"
|- style="text-align:center;"
! OS-version
! fractl
! vortrac
! samurai
! HawkEye
! CIDD available?
|-
| CENTOS 6
| No
| No
| No
| Yes
| No
|-
| CENTOS 7
| Yes
| Yes
| Yes
| Yes
| Yes
|-
| CENTOS 8
| Yes
| Yes
| Yes
| Yes
| Yes
|-
| Fedora 29
| Yes
| No
| Yes
| No
| Yes
|-
| Fedora 30
| Yes
| No
| Yes
| No
| Yes
|-
| Fedora 31
| Yes
| No
| Yes
| No
| Yes
|-
| Debian 9
| Yes
| Yes
| Yes
| No
| Yes
|-
| Debian 10
| Yes
| Yes
| Yes
| No
| Yes
|-
| Ubuntu 16.04
| Yes
| Yes
| Yes
| Yes
| Yes
|-
| Ubuntu 18.04
| Yes
| Yes
| Yes
| Yes
| Yes
|-
| Suse leap
| Yes
| Yes
| Yes
| Yes
| Yes
|-
| Suse latest
| Yes
| Yes
| Yes
| Yes
| Yes
|}

1. Prepare:
Most good, up-to-date LINUX distributions should work.

Recommended distributions are:

* Debian
* Ubuntu (based on Debian)
* RedHat
* Centos (based on RedHat)
* Fedora (based on RedHat)

First, you will need to install the required packages.

See: '''[https://github.com/NCAR/lrose-core/blob/master/docs/build/lrose_package_dependencies.md LROSE package dependencies]'''

2. Download the source tar file for Linux from: '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20210216/lrose-core-20210216.src.tgz Release]'''

A typical source release would be:

<code lang="bash"> lrose-core-20210216.src.tgz </code>

* Create a working directory for building the distribution:

<code lang="bash"> mkdir ~/lrose_build </code>

<code lang="bash"> cd ~/lrose_build </code>

* Untar

<code lang="bash"> tar xvfz lrose-core-20210216.src.tgz </code>

The distribution will be unpacked into a subdirectory:

<code lang="bash"> cd ~/lrose_build/lrose-core-20210216.src</code>

3. Build

* Run the build script:

To see the usage:

<code lang="bash"> ./build_src_release.py --help </code>

To build and install into the default directory: <code lang="bash"> /usr/local/lrose </code>

<code lang="bash"> ./build_src_release.py </code>

Or set an install directory:

<code lang="bash"> ./build_src_release.py --prefix /my/install/dir </code>

4. Verify

* Look in ~/lrose or /my/install/dir for

<code lang="bash"> include </code>

<code lang="bash"> lib </code>

<code lang="bash"> bin </code>

* Try the commands:
<code lang="bash"> /usr/local/lrose/bin/RadxPrint -h </code>

<code lang="bash"> /usr/local/lrose/bin/RadxConvert -h </code>

<code lang="bash"> /usr/local/lrose/bin/Radx2Grid -h </code>

<code lang="bash"> /usr/local/lrose/bin/HawkEye </code>

5. Handling build errors

If the build does not complete successfully, you will need to
track down the errors.

The very first errors in the build are the most important.

If you get errors, go into the directory giving problems, and
run the make as follows:

<code lang="bash"> make |& less </code>

and scroll down searching for '''error'''.

Alternatively, run

<code lang="bash"> make >& make.log </code>

and then inspect the make.log file, searching for '''error'''.

6. Update

To update, just repeat the procedure in sections 2, 3 and 4 above.

The new version will be installed over the previous version.

Main Page

2021-02-24T21:22:19Z

Tingyucha: /* Installation Instructions */

Mac-Homebrew-Installation

2021-02-24T20:57:17Z

Tingyucha: /* How to install LROSE on a Mac? */

=== '''How to install LROSE on a Mac?''' ===

1. Download, install, and run '''[https://brew.sh/ Homebrew]'''

2. Download the LROSE-core formula '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20210216/lrose-core.rb lrose-core.rb]'''

3. In a terminal, install lrose-core:

: <code lang="bash"> brew install lrose-core.rb </code>

<blockquote style="color: grey; border: solid thin gray;">
'''Important Note:''' If users have the previous versions of lrose installed, please uninstall them first before install the new version.
: <code lang="bash"> brew uninstall lrose-core </code>
: <code lang="bash"> brew uninstall lrose-cyclone </code>
: <code lang="bash"> brew uninstall lrose-blaze </code>
</blockquote>

=== '''HawkEye and wind tools (VORTRAC, SAMURAI, FRACTL) installation''' ===

Users are not required to install HawkEye, VORTRAC, SAMURAI, and FRACTL to run LROSE, unless users are in need of these tools. However, these tools depend on installing lrose-core first.

* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' installation:
: Download the disk images:

** '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20200701/HawkEye.dmg HawkEye.dmg]''': HawkEye polar radar display
** '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20200701/HawkEye_Elle.dmg HawkEye-Elle.dmg]''': HawkEye with soloii-like editing capability

'''Important Note: All disk images are only for MacOS 10.15. '''

* '''[http://wiki.lrose.net/index.php/VORTRAC VORTRAC]''' (Vortex Object Radar Tracking and Circulation) installation:
: There are two ways to install VORTRAC:

** Download the disk image: '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20200701/vortrac.dmg vortrac.dmg]'''
** Download the lrose-vortrac formula '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20200701/lrose-vortrac.rb lrose-vortrac.rb]'''
:: In a terminal, type:
:: <code lang="bash"> brew install lrose-vortrac.rb </code>

: The code for VORTRAC can be found at: '''[https://github.com/mmbell/vortrac/ https://github.com/mmbell/vortrac/]'''

'''Users are suggested to install VORTRAC via lrose-vortrac formula if their MacOS systems are below 10.15. '''

* '''[http://wiki.lrose.net/index.php/SAMURAI SAMURAI]''' (Variational multi-Doppler retrieval and analysis package) installation:
** Download the lrose-samurai formula '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20200701/lrose-samurai.rb lrose-samurai.rb]'''
** In a terminal, type:
:: <code lang="bash"> brew install lrose-samurai.rb </code>

: The code for SAMURAI can be found at: '''[https://github.com/mmbell/samurai/ https://github.com/mmbell/samurai/]'''

* '''[http://wiki.lrose.net/index.php/FRACTL FRACTL]''' (Fast Reorder and CEDRIC Technique in LROSE multi-Doppler retrieval) installation:
** Download the lrose-samurai formula '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20200701/lrose-fractl.rb lrose-fractl.rb]'''
** In a terminal, type:
:: <code lang="bash"> brew install lrose-fractl.rb </code>

4. You are done with the installation! The LROSE apps will be under: <code lang="bash">/usr/local/bin/RadxConvert </code>. Go to the '''[http://wiki.lrose.net/index.php/Main_Page#Convert documentation]''' to learn how to run LROSE tools!

Main Page

2021-02-24T20:55:15Z

Tingyucha: /* Installation Instructions */

Main Page

2021-02-24T20:54:57Z

Tingyucha: /* Installation Instructions */

Main Page

2021-02-24T03:55:28Z

Tingyucha: /* Installation Instructions */

Main Page

2021-02-22T19:10:19Z

Tingyucha: /* Citations for LROSE tools */

Main Page

2021-02-22T19:09:55Z

Tingyucha: /* Citations for LROSE tools */

Main Page

2021-02-22T19:07:40Z

Tingyucha: /* Citations for LROSE tools */

Main Page

2021-02-10T11:12:51Z

Tingyucha: /* Citations for LROSE tools */

Vortrac tutorial

2021-02-02T15:51:35Z

Tingyucha: /* Set up the environment on the command line */

=== '''VORTRAC tutorial''' ===

This workflow will go through the steps to run VORTRAC, and provide gridded radar data, a center file (.csv) and the XML file. For more information on how to obtain the gridded radar files from the raw radar files, please refer to the '''[http://wiki.lrose.net/index.php/Elle_grid grid tutorial]'''.

==== '''Set up the environment and XML file on the command line''' ====
<ol start="1" style="list-style-type: decimal;">
<li>Download the [https://drive.google.com/file/d/18Z9PC6-a2lqMkaFEbecZ3Fsy8lMFmkPl/view?usp=sharing vortrac_tutorial.tar.gz] file</li></ol>
<ol start="2" style="list-style-type: decimal;">
<li>Extract contents into the desired directory</li></ol>

* Create a new folder called vortrac_example (or the user's desired directory)
<code lang="bash">mkdir ~/vortrac_example </code>

* Move the tar file to the vortrac_example folder
<code lang="bash">mv vortrac_tutorial.tar.gz ~/vortrac_example </code>

* Extract contents
<code lang="bash">tar -zxvf vortrac_tutorial.tar.gz </code>

You'll end up with a directory that includes the gridded radar data, a center file (.csv) and the XML file to run VORTRAC.

<ol start="3" style="list-style-type: decimal;">
<li>Create the following folders under the same directory as the XML file, center file, and the folder of '''radar''' </li></ol>

<code lang="bash">mkdir cappi </code>

<code lang="bash">mkdir center </code>

<code lang="bash">mkdir choosecenter </code>

<code lang="bash">mkdir pressure </code>

<code lang="bash">mkdir vtd </code>

You'll end up with a directory that includes '''6 folders''', '''one XML file''' and '''one center (.csv) file'''.

<ol start="4" style="list-style-type: decimal;">
<li>Modify the XML file</li></ol>

* Set the directory. Find the line starting with <code lang="bash">dir</code> and <code lang="bash">centers</code>, and modify them to your current directory. (8 lines in total)

In the tutorial, you do not need to modify further parameters, but we recommend the users go through the details about the '''[http://wiki.lrose.net/index.php/VORTRAC#Configuration XML configuration]'''.

==== '''Execute VORTRAC''' ====
<ol start="1" style="list-style-type: decimal;">
<li>Run VORTRAC</li></ol>

<code lang="bash">/path/to/vortrac/bin/vortrac </code>

Vortrac tutorial

2021-02-02T15:51:16Z

Tingyucha: /* Run program on the command line */

=== '''VORTRAC tutorial''' ===

This workflow will go through the steps to run VORTRAC, and provide gridded radar data, a center file (.csv) and the XML file. For more information on how to obtain the gridded radar files from the raw radar files, please refer to the '''[http://wiki.lrose.net/index.php/Elle_grid grid tutorial]'''.

==== '''Set up the environment on the command line''' ====
<ol start="1" style="list-style-type: decimal;">
<li>Download the [https://drive.google.com/file/d/18Z9PC6-a2lqMkaFEbecZ3Fsy8lMFmkPl/view?usp=sharing vortrac_tutorial.tar.gz] file</li></ol>
<ol start="2" style="list-style-type: decimal;">
<li>Extract contents into the desired directory</li></ol>

* Create a new folder called vortrac_example (or the user's desired directory)
<code lang="bash">mkdir ~/vortrac_example </code>

* Move the tar file to the vortrac_example folder
<code lang="bash">mv vortrac_tutorial.tar.gz ~/vortrac_example </code>

* Extract contents
<code lang="bash">tar -zxvf vortrac_tutorial.tar.gz </code>

You'll end up with a directory that includes the gridded radar data, a center file (.csv) and the XML file to run VORTRAC.

<ol start="3" style="list-style-type: decimal;">
<li>Create the following folders under the same directory as the XML file, center file, and the folder of '''radar''' </li></ol>

<code lang="bash">mkdir cappi </code>

<code lang="bash">mkdir center </code>

<code lang="bash">mkdir choosecenter </code>

<code lang="bash">mkdir pressure </code>

<code lang="bash">mkdir vtd </code>

You'll end up with a directory that includes '''6 folders''', '''one XML file''' and '''one center (.csv) file'''.

<ol start="4" style="list-style-type: decimal;">
<li>Modify the XML file</li></ol>

* Set the directory. Find the line starting with <code lang="bash">dir</code> and <code lang="bash">centers</code>, and modify them to your current directory. (8 lines in total)

In the tutorial, you do not need to modify further parameters, but we recommend the users go through the details about the '''[http://wiki.lrose.net/index.php/VORTRAC#Configuration XML configuration]'''.

==== '''Execute VORTRAC''' ====
<ol start="1" style="list-style-type: decimal;">
<li>Run VORTRAC</li></ol>

<code lang="bash">/path/to/vortrac/bin/vortrac </code>

Vortrac tutorial

2021-02-02T15:49:33Z

Tingyucha: /* Run program on the command line */

=== '''VORTRAC tutorial''' ===

This workflow will go through the steps to run VORTRAC, and provide gridded radar data, a center file (.csv) and the XML file. For more information on how to obtain the gridded radar files from the raw radar files, please refer to the '''[http://wiki.lrose.net/index.php/Elle_grid grid tutorial]'''.

==== '''Run program on the command line''' ====
<ol start="1" style="list-style-type: decimal;">
<li>Download the [https://drive.google.com/file/d/18Z9PC6-a2lqMkaFEbecZ3Fsy8lMFmkPl/view?usp=sharing vortrac_tutorial.tar.gz] file</li></ol>
<ol start="2" style="list-style-type: decimal;">
<li>Extract contents into the desired directory</li></ol>

* Create a new folder called vortrac_example (or the user's desired directory)
<code lang="bash">mkdir ~/vortrac_example </code>

* Move the tar file to the vortrac_example folder
<code lang="bash">mv vortrac_tutorial.tar.gz ~/vortrac_example </code>

* Extract contents
<code lang="bash">tar -zxvf vortrac_tutorial.tar.gz </code>

You'll end up with a directory that includes the gridded radar data, a center file (.csv) and the XML file to run VORTRAC.

<ol start="3" style="list-style-type: decimal;">
<li>Create the following folders under the same directory as the XML file, center file, and the folder of '''radar''' </li></ol>

<code lang="bash">mkdir cappi </code>

<code lang="bash">mkdir center </code>

<code lang="bash">mkdir choosecenter </code>

<code lang="bash">mkdir pressure </code>

<code lang="bash">mkdir vtd </code>

You'll end up with a directory that includes '''6 folders''', '''one XML file''' and '''one center (.csv) file'''.

<ol start="4" style="list-style-type: decimal;">
<li>Modify the XML file</li></ol>

* Set the directory. Find the line starting with <code lang="bash">dir</code> and <code lang="bash">centers</code>, and modify them to your current directory. (8 lines in total)

In the tutorial, you do not need to modify further parameters, but we recommend the users go through the details about the '''[http://wiki.lrose.net/index.php/VORTRAC#Configuration XML configuration]'''.

<ol start="5" style="list-style-type: decimal;">
<li>Run VORTRAC</li></ol>

<code lang="bash">/path/to/vortrac/bin/vortrac </code>

Vortrac tutorial

2021-02-02T15:49:01Z

Tingyucha: /* Run program on the command line */

=== '''VORTRAC tutorial''' ===

This workflow will go through the steps to run VORTRAC, and provide gridded radar data, a center file (.csv) and the XML file. For more information on how to obtain the gridded radar files from the raw radar files, please refer to the '''[http://wiki.lrose.net/index.php/Elle_grid grid tutorial]'''.

==== '''Run program on the command line''' ====
<ol start="1" style="list-style-type: decimal;">
<li>Download the [https://drive.google.com/file/d/18Z9PC6-a2lqMkaFEbecZ3Fsy8lMFmkPl/view?usp=sharing vortrac_tutorial.tar.gz] file</li></ol>
<ol start="2" style="list-style-type: decimal;">
<li>Extract contents into the desired directory</li></ol>

* Create a new folder called vortrac_example (or the user's desired directory)
<code lang="bash">mkdir ~/vortrac_example </code>

* Move the tar file to the vortrac_example folder
<code lang="bash">mv vortrac_tutorial.tar.gz ~/vortrac_example </code>

* Extract contents
<code lang="bash">tar -zxvf vortrac_tutorial.tar.gz </code>

You'll end up with a directory that includes the gridded radar data, a center file (.csv) and the XML file to run VORTRAC.

<ol start="3" style="list-style-type: decimal;">
<li>Create the following folders under the same directory as the XML file, center file, and the folder of '''radar''' </li></ol>

<code lang="bash">mkdir cappi </code>

<code lang="bash">mkdir center </code>

<code lang="bash">mkdir choosecenter </code>

<code lang="bash">mkdir pressure </code>

<code lang="bash">mkdir vtd </code>

You'll end up with a directory that includes '''6 folders''', '''one XML file''' and '''one center (.csv) file'''.

<ol start="4" style="list-style-type: decimal;">
<li>Modify the XML file</li></ol>

* Set the directory. Find the line beginning with <code lang="bash">dir</code> and <code lang="bash">centers</code>, and modify them to your current directory. (8 lines in total)

In the tutorial, you do not need to modify further parameters, but we recommend the users go through the details about the '''[http://wiki.lrose.net/index.php/VORTRAC#Configuration XML configuration]'''.

<ol start="5" style="list-style-type: decimal;">
<li>Run VORTRAC</li></ol>

<code lang="bash">/path/to/vortrac/bin/vortrac </code>

Mac-Homebrew-Installation

2021-02-02T15:41:14Z

Tingyucha:

=== '''How to install LROSE on a Mac?''' ===

1. Download, install, and run '''[https://brew.sh/ Homebrew]'''

2. Download the LROSE-core formula '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20200701/lrose-core.rb lrose-core.rb]'''

3. In a terminal, install lrose-core:

: <code lang="bash"> brew install lrose-core.rb </code>

<blockquote style="color: grey; border: solid thin gray;">
'''Important Note:''' If users have the previous versions of lrose installed, please uninstall them first before install the new version.
: <code lang="bash"> brew uninstall lrose-core </code>
: <code lang="bash"> brew uninstall lrose-cyclone </code>
: <code lang="bash"> brew uninstall lrose-blaze </code>
</blockquote>

=== '''HawkEye and wind tools (VORTRAC, SAMURAI, FRACTL) installation''' ===

Users are not required to install HawkEye, VORTRAC, SAMURAI, and FRACTL to run LROSE, unless users are in need of these tools. However, these tools depend on installing lrose-core first.

* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' installation:
: Download the disk images:

** '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20200701/HawkEye.dmg HawkEye.dmg]''': HawkEye polar radar display
** '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20200701/HawkEye-Elle.dmg HawkEye-Elle.dmg]''': HawkEye with soloii-like editing capability

'''Important Note: All disk images are only for MacOS 10.15. '''

* '''[http://wiki.lrose.net/index.php/VORTRAC VORTRAC]''' (Vortex Object Radar Tracking and Circulation) installation:
: There are two ways to install VORTRAC:

** Download the disk image: '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20200701/vortrac.dmg vortrac.dmg]'''
** Download the lrose-vortrac formula '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20200701/lrose-vortrac.rb lrose-vortrac.rb]'''
:: In a terminal, type:
:: <code lang="bash"> brew install lrose-vortrac.rb </code>

: The code for VORTRAC can be found at: '''[https://github.com/mmbell/vortrac/ https://github.com/mmbell/vortrac/]'''

'''Users are suggested to install VORTRAC via lrose-vortrac formula if their MacOS systems are below 10.15. '''

* '''[http://wiki.lrose.net/index.php/SAMURAI SAMURAI]''' (Variational multi-Doppler retrieval and analysis package) installation:
** Download the lrose-samurai formula '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20200701/lrose-samurai.rb lrose-samurai.rb]'''
** In a terminal, type:
:: <code lang="bash"> brew install lrose-samurai.rb </code>

: The code for SAMURAI can be found at: '''[https://github.com/mmbell/samurai/ https://github.com/mmbell/samurai/]'''

* '''[http://wiki.lrose.net/index.php/FRACTL FRACTL]''' (Fast Reorder and CEDRIC Technique in LROSE multi-Doppler retrieval) installation:
** Download the lrose-samurai formula '''[https://github.com/NCAR/lrose-core/releases/download/lrose-core-20200701/lrose-fractl.rb lrose-fractl.rb]'''
** In a terminal, type:
:: <code lang="bash"> brew install lrose-fractl.rb </code>

4. You are done with the installation! The LROSE apps will be under: <code lang="bash">/usr/local/bin/RadxConvert </code>. Go to the '''[http://wiki.lrose.net/index.php/Main_Page#Convert documentation]''' to learn how to run LROSE tools!

Radx2Grid

2021-02-02T15:32:40Z

Tingyucha:

Radx2Grid performs coordinate transformations for ground-based radars from a spherical grid on which radar data is collected to a regular grid.

=== '''Overview''' ===

All of the LROSE tools presented so far (RadxPrint, RadxConvert, and HawkEye) work directly on lidar or radar data in its native coordinate system. For many workflows it is desirable to put the data onto a regular grid for scientific analysis. The workflow steps to this point have not modified data, but gridding can be considered the first '''analysis''' step in that scientific decisions have to be made about how to project the data from spherical coordinates to a regular grid. Note that quality control tools (which also involve scientific decision making) will be added in the next update, which can be applied either before or after gridding.

 Radx2Grid uses a SPRINT-style interpolation that is suitable for ground-based radars and vertically pointing airborne lidar and radar data. It is a well-established interpolation method that was designed to have minimal impact for subsequent analysis. More details on the interpolation method can be found in the original user's guide for [https://wiki.ucar.edu/download/attachments/41487211/sprint.99feb_doc.pdf SPRINT], and will be added to this documentation in the near future. 

<blockquote style="color: grey; border: solid thin gray;">
'''Important Note:''' Due to the more complex geometry of airborne scanning radars such as ELDORA and the NOAA P-3 tail radar the current interpolation method is not appropriate and Radx2Grid will not work properly. [http://wiki.lrose.net/index.php/FRACTL FRACTL (Fast Reorder and CEDRIC Technique in LROSE)] will do both gridding and multi-Doppler synthesis for airborne radars.
</blockquote>

=== '''Supported regular grids''' ===
* Cartesian grid in (Z,Y,X)
* PPI grid in (EL, Y, Z) - performs Cartesian transformation on each elevation angle separately
* Polar grid, regular in (EL, AZ, RANGE)

=== '''Running Radx2Grid''' ===

Recent software development in Radx2Grid has streamlined options in parameter file for typical use cases, but with extensive flexibility for power users. To check all command line options for Radx2Grid, including debugging options and file paths, the typical '-h' flag can be invoked:

<code lang="bash">/path/to/lrose/install/bin/Radx2Grid -h</code>

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

<code lang="bash">/path/to/lrose/install/bin/Radx2Grid -print_params > Radx2Grid.params</code>

While there are many options for Radx2Grid, a basic gridding technique can be accomplished simply:

<code lang="bash">/path/to/lrose/install/bin/Radx2Grid -f <path/to/data/file_name> -outdir $PWD/grid</code>

Recall that during the RadxConvert step the CfRadial files can be created as an aggregation of sweep files that make up a single volume scan. Assuming that option was invoked (which is the default for NEXRAD Level II files) you should now have a Cartesian gridded volume in NetCDF format in the 'grid' subdirectory to use for further analysis. Note that if you first convert data to DORADE sweep files for editing in soloii, and then convert to CfRadial you must explicitly aggregate the sweeps during that conversion. A common source of confusion is that only a single sweep is gridded into the volume if the CfRadial file only contains a single sweep.

==== The Radx2Grid Parameter file ====

* Radx2Grid is a large application with many parameters available for controlling its operation. This makes the use of the parameter file confusing to a new user. Therefore, the parameters are separated into sections. The more common sections are at the top of the file, and the less common parameters lower down in the file.

* Each section is preceded by a header starting and ending with a line of ======================== characters.

* A few key parameters to look for are listed below.
** start_time, end_time: set the start time and end time for ARCHIVE mode analysis. The format should be ‘yyyy mm dd hh mm ss’.
** input_dir: input directory for searching for files. Files will be searched for in this directory.
** interp_mode: set the interpolation mode. There are five different modes that you can choose.
** grid_z_geom: specify vertical grid levels. nz, minz, dz represent the number of levels, the lowest level, and constant spacing of the vertical level respectively.
** grid_xy_geom: similar as grid_z_geom. It specifies the grid parameters in x and y.
** netcdf_style: specify different format of netCDF. If output_format is CFRADIAL, specify the netCDF format.
** ncf_title: title string for netCDF file.
** ncf_institution: institution string for netCDF file.
** ncf_source: source string for netCDF file.

* The full parameter file description can be found here: '''[http://wiki.lrose.net/index.php/Radx2Grid_param Radx2Grid parameter file]'''

From here, you can read in the CfRadial or gridded netCDF file using Julia, Python, or other programming languages for further analysis. Additional LROSE tools including applications for QC, '''[http://wiki.lrose.net/index.php/Main_Page#Echo Echo]''', and '''[http://wiki.lrose.net/index.php/Main_Page#Wind Wind]''' can be utilized for analysis.

Radx2Grid

2021-02-02T15:31:44Z

Tingyucha:

Radx2Grid performs coordinate transformations for ground-based radars from a spherical grid on which radar data is collected to a regular grid.

=== '''Overview''' ===

All of the LROSE tools presented so far (RadxPrint, RadxConvert, and HawkEye) work directly on lidar or radar data in its native coordinate system. For many workflows it is desirable to put the data onto a regular grid for scientific analysis. The workflow steps to this point have not modified data, but gridding can be considered the first '''analysis''' step in that scientific decisions have to be made about how to project the data from spherical coordinates to a regular grid. Note that quality control tools (which also involve scientific decision making) will be added in the next update, which can be applied either before or after gridding.

 Radx2Grid uses a SPRINT-style interpolation that is suitable for ground-based radars and vertically pointing airborne lidar and radar data. It is a well-established interpolation method that was designed to have minimal impact for subsequent analysis. More details on the interpolation method can be found in the original user's guide for [https://wiki.ucar.edu/download/attachments/41487211/sprint.99feb_doc.pdf SPRINT], and will be added to this documentation in the near future. 

<blockquote style="color: grey; border: solid thin gray;">
'''Important Note:''' Due to the more complex geometry of airborne scanning radars such as ELDORA and the NOAA P-3 tail radar the current interpolation method is not appropriate and Radx2Grid will not work properly. [http://wiki.lrose.net/index.php/FRACTL FRACTL (Fast Reorder and CEDRIC Technique in LROSE)] will do both gridding and multi-Doppler synthesis for airborne radars.
</blockquote>

=== '''Supported regular grids''' ===
* Cartesian grid in (Z,Y,X)
* PPI grid in (EL, Y, Z) - performs Cartesian transformation on each elevation angle separately
* Polar grid, regular in (EL, AZ, RANGE)

=== '''Running Radx2Grid''' ===

Recent software development in Radx2Grid has streamlined options in parameter file for typical use cases, but with extensive flexibility for power users. To check all command line options for Radx2Grid, including debugging options and file paths, the typical '-h' flag can be invoked:

<code lang="bash">/path/to/lrose/install/bin/Radx2Grid -h</code>

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

<code lang="bash">/path/to/lrose/install/bin/Radx2Grid -print_params > Radx2Grid.params</code>

While there are many options for Radx2Grid, a basic gridding technique can be accomplished simply:

<code lang="bash">/path/to/lrose/install/bin/Radx2Grid -f <path/to/data/file_name> -outdir $PWD/grid</code>

Recall that during the RadxConvert step the CfRadial files can be created as an aggregation of sweep files that make up a single volume scan. Assuming that option was invoked (which is the default for NEXRAD Level II files) you should now have a Cartesian gridded volume in NetCDF format in the 'grid' subdirectory to use for further analysis. Note that if you first convert data to DORADE sweep files for editing in soloii, and then convert to CfRadial you must explicitly aggregate the sweeps during that conversion. A common source of confusion is that only a single sweep is gridded into the volume if the CfRadial file only contains a single sweep.

== The Radx2Grid Parameter file ==
* Radx2Grid is a large application with many parameters available for controlling its operation. This makes the use of the parameter file confusing to a new user. Therefore, the parameters are separated into sections. The more common sections are at the top of the file, and the less common parameters lower down in the file.

* Each section is preceded by a header starting and ending with a line of ======================== characters.

* A few key parameters to look for are listed below.
** start_time, end_time: set the start time and end time for ARCHIVE mode analysis. The format should be ‘yyyy mm dd hh mm ss’.
** input_dir: input directory for searching for files. Files will be searched for in this directory.
** interp_mode: set the interpolation mode. There are five different modes that you can choose.
** grid_z_geom: specify vertical grid levels. nz, minz, dz represent the number of levels, the lowest level, and constant spacing of the vertical level respectively.
** grid_xy_geom: similar as grid_z_geom. It specifies the grid parameters in x and y.
** netcdf_style: specify different format of netCDF. If output_format is CFRADIAL, specify the netCDF format.
** ncf_title: title string for netCDF file.
** ncf_institution: institution string for netCDF file.
** ncf_source: source string for netCDF file.

* The full parameter file description can be found here: '''[http://wiki.lrose.net/index.php/Radx2Grid_param Radx2Grid parameter file]'''

From here, you can read in the CfRadial or gridded netCDF file using Julia, Python, or other programming languages for further analysis. Additional LROSE tools including applications for QC, '''[http://wiki.lrose.net/index.php/Main_Page#Echo Echo]''', and '''[http://wiki.lrose.net/index.php/Main_Page#Wind Wind]''' can be utilized for analysis.

Radx2Grid

2021-02-02T15:31:11Z

Tingyucha: /* Overview */

Radx2Grid performs coordinate transformations for ground-based radars from a spherical grid on which radar data is collected to a regular grid.

=== '''Overview''' ===

All of the LROSE tools presented so far (RadxPrint, RadxConvert, and HawkEye) work directly on lidar or radar data in its native coordinate system. For many workflows it is desirable to put the data onto a regular grid for scientific analysis. The workflow steps to this point have not modified data, but gridding can be considered the first '''analysis''' step in that scientific decisions have to be made about how to project the data from spherical coordinates to a regular grid. Note that quality control tools (which also involve scientific decision making) will be added in the next update, which can be applied either before or after gridding.

 Radx2Grid uses a SPRINT-style interpolation that is suitable for ground-based radars and vertically pointing airborne lidar and radar data. It is a well-established interpolation method that was designed to have minimal impact for subsequent analysis. More details on the interpolation method can be found in the original user's guide for [https://wiki.ucar.edu/download/attachments/41487211/sprint.99feb_doc.pdf SPRINT], and will be added to this documentation in the near future. 

<blockquote style="color: grey; border: solid thin gray;">
'''Important Note:''' Due to the more complex geometry of airborne scanning radars such as ELDORA and the NOAA P-3 tail radar the current interpolation method is not appropriate and Radx2Grid will not work properly. [http://wiki.lrose.net/index.php/FRACTL FRACTL (Fast Reorder and CEDRIC Technique in LROSE)] will do both gridding and multi-Doppler synthesis for airborne radars.
</blockquote>

= Supported regular grids =
* Cartesian grid in (Z,Y,X)
* PPI grid in (EL, Y, Z) - performs Cartesian transformation on each elevation angle separately
* Polar grid, regular in (EL, AZ, RANGE)

= Running Radx2Grid =

Recent software development in Radx2Grid has streamlined options in parameter file for typical use cases, but with extensive flexibility for power users. To check all command line options for Radx2Grid, including debugging options and file paths, the typical '-h' flag can be invoked:

<code lang="bash">/path/to/lrose/install/bin/Radx2Grid -h</code>

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

<code lang="bash">/path/to/lrose/install/bin/Radx2Grid -print_params > Radx2Grid.params</code>

While there are many options for Radx2Grid, a basic gridding technique can be accomplished simply:

<code lang="bash">/path/to/lrose/install/bin/Radx2Grid -f <path/to/data/file_name> -outdir $PWD/grid</code>

Recall that during the RadxConvert step the CfRadial files can be created as an aggregation of sweep files that make up a single volume scan. Assuming that option was invoked (which is the default for NEXRAD Level II files) you should now have a Cartesian gridded volume in NetCDF format in the 'grid' subdirectory to use for further analysis. Note that if you first convert data to DORADE sweep files for editing in soloii, and then convert to CfRadial you must explicitly aggregate the sweeps during that conversion. A common source of confusion is that only a single sweep is gridded into the volume if the CfRadial file only contains a single sweep.

== The Radx2Grid Parameter file ==
* Radx2Grid is a large application with many parameters available for controlling its operation. This makes the use of the parameter file confusing to a new user. Therefore, the parameters are separated into sections. The more common sections are at the top of the file, and the less common parameters lower down in the file.

* Each section is preceded by a header starting and ending with a line of ======================== characters.

* A few key parameters to look for are listed below.
** start_time, end_time: set the start time and end time for ARCHIVE mode analysis. The format should be ‘yyyy mm dd hh mm ss’.
** input_dir: input directory for searching for files. Files will be searched for in this directory.
** interp_mode: set the interpolation mode. There are five different modes that you can choose.
** grid_z_geom: specify vertical grid levels. nz, minz, dz represent the number of levels, the lowest level, and constant spacing of the vertical level respectively.
** grid_xy_geom: similar as grid_z_geom. It specifies the grid parameters in x and y.
** netcdf_style: specify different format of netCDF. If output_format is CFRADIAL, specify the netCDF format.
** ncf_title: title string for netCDF file.
** ncf_institution: institution string for netCDF file.
** ncf_source: source string for netCDF file.

* The full parameter file description can be found here: '''[http://wiki.lrose.net/index.php/Radx2Grid_param Radx2Grid parameter file]'''

From here, you can read in the CfRadial or gridded netCDF file using Julia, Python, or other programming languages for further analysis. Additional LROSE tools including applications for QC, '''[http://wiki.lrose.net/index.php/Main_Page#Echo Echo]''', and '''[http://wiki.lrose.net/index.php/Main_Page#Wind Wind]''' can be utilized for analysis.

Main Page

2021-02-02T15:29:30Z

Tingyucha: /* LROSE AMS 2020 Mini Workshop */

Main Page

2021-02-02T15:28:56Z

Tingyucha: /* LROSE */

Main Page

2021-02-02T03:23:46Z

Tingyucha: /* Tutorials */

== '''LROSE''' ==

=== The Lidar Radar Open Software Environment ===

[https://zenodo.org/badge/latestdoi/199713573 [[File:https://zenodo.org/badge/199713573.svg|DOI]]]

The current LROSE release is called '''“Elle”''' (a pink blend fragrant rose) and encompasses six key toolsets that define a core lidar/radar workflow: ''[http://wiki.lrose.net/index.php?title=Main_Page#Convert Convert], [http://wiki.lrose.net/index.php?title=Main_Page#Display Display], [http://wiki.lrose.net/index.php?title=Main_Page#Quality_Control QC], [http://wiki.lrose.net/index.php?title=Main_Page#Grid Grid], [http://wiki.lrose.net/index.php?title=Main_Page#Echo Echo], and [http://wiki.lrose.net/index.php?title=Main_Page#Wind Winds].'' '''Elle''' focuses on high-quality, well-tested, well-maintained and well-documented key applications as ‘building blocks’, allowing users to assemble trusted, reproducible workflows to accomplish more complex scientific tasks.

Elle can be compiled in C++ for native apps on Linux or Mac. Preliminary support is available for some tools on Windows.

We encourage users to [http://lrose.net/software.html register] in order to receive critical software updates, and sign up for the mailing list to help build the LROSE community.

[http://lrose.net/help.html Help] can be obtained by posting issues directly to the lrose-cyclone Github repository, via our help mailing list, or Discourse user forum.

LROSE is a co-operative project between:

* [http://www.atmos.colostate.edu/ Dept. of Atmospheric Science at Colorado State University (CSU)] and the
* [https://www.eol.ucar.edu/content/lidar-radar-open-software-environment The Earth Observing Lab at the National Center for Atmospheric Research (NCAR)].

LROSE is funded by the [https://www.nsf.gov National Science Foundation].

=== Citations for LROSE tools ===

Please cite the version of LROSE you use for publication.

* '''[https://doi.org/10.5281/zenodo.2532758 lrose-blaze]''': Bell, M. M. (2019). nsf‐lrose/lrose‐blaze: lrose‐blaze‐20190105. https://doi.org/10.5281/zenodo.2532758
* '''[https://doi.org/10.5281/zenodo.3604387 lrose-cyclone]''': Bell, M. M. and Melli B. (2020). nsf-lrose/lrose-cyclone: lrose-cyclone-20200110. https://doi.org/10.5281/zenodo.3604387

=== Installation Instructions ===

* '''[http://wiki.lrose.net/index.php/Mac-Homebrew-Installation Mac Homebrew installation]''' - For Native applications on the Mac, the recommended method is to use Homebrew. The formula contains all the necessary dependencies and builds instructions.

* '''[http://wiki.lrose.net/index.php/Mac-Build Mac Build]''' - Source compilation on the Mac is best performed using a supplied Python script.

* '''[http://wiki.lrose.net/index.php/Linux-Build Linux Build]''' - Source compilation on the Linux is best performed using a supplied Python script.

* '''[http://wiki.lrose.net/index.php/CIDD-Binary-Release CIDD Binary Release]''' - CIDD depends on a 32-bit build, which complicates the build and install for the core. The CIDD display application is not included in the standard lrose-core packages (above).

=== Tutorials ===

* '''quick start'''
** '''[http://wiki.lrose.net/index.php/lrose_quickstart lrose quickstart tutorial]''' - Go over the basics to get up and running quickly with LROSE.

* '''echo tutorials'''
** '''[http://wiki.lrose.net/index.php/elle_basic basic elle echo tutorial]''' - Go through the basic steps necessary to convert a raw radar file to CfRadial, calculate Kdp and three-dimensional rain rate, and estimate the surface rainfall. The purpose of this tutorial is to confirm that the install process was successful and that some programs are working.
** '''[http://wiki.lrose.net/index.php/elle_basic_plus basic+ elle echo tutorial]''' - Similar to the basic elle tutorial with the added tasks of downloading GFS analysis from which to estimate a sounding near the radar and running the RadxBeamBlock application.
** '''[http://wiki.lrose.net/index.php/elle_full full elle echo tutorial]''' - This tutorial assumes the user has radar data downloaded in an [http://wiki.lrose.net/index.php/RadxConvert acceptable radar format] and walks through the most important parameters that need to be edited to run the Quantitative Precipitation Estimation (QPE) workflow.

* '''grid tutorial'''
** '''[http://wiki.lrose.net/index.php/elle_grid elle regrid and convective/stratiform tutorial]''' - Convert raw NEXRAD data to the cfradial format and then interpolate to a cartesian grid and applies a convective stratiform separation algorithm.

* '''wind tutorial'''
** '''[http://wiki.lrose.net/index.php/vortrac_tutorial VORTRAC tutorial]''' - run VORTRAC to retrieve the winds from the single Doppler radar data.

=== Toolsets ===
In the current release, the following tools are available:

==== Convert ====

* '''[http://wiki.lrose.net/index.php/RadxPrint RadxPrint]''' - Query files to determine properties and support by the Radx engine
* '''[http://wiki.lrose.net/index.php/RadxConvert RadxConvert]''' - Convert 24 different lidar and radar formats to CfRadial NetCDF format
* '''RadxBufr''' - Convert Bufr format to CfRadial NetCDF format

==== Display ====

* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' - Real-time and archive display suitable for both scanning and vertically pointing radars.

==== Quality Control ====

* '''RadxDiffFields''' - Compare two fields in different CfRadial files
* '''RadxDiffVol''' - Compare two volumes in different CfRadial files
* '''RadxMergeFields''' - Merge fields from different CfRadial files
* '''RadxFilter''' - Perform simple filtering operations
* '''RadxPersistentClutter''' - Create a mask for persistent ground clutter

==== Grid ====

* '''[http://wiki.lrose.net/index.php/Radx2Grid Radx2Grid]''' - Gridding and interpolation of ground-based radar data

==== Echo ====

* '''[http://wiki.lrose.net/index.php/RadxKdp RadxKdp]''' - KDP and Attenuation calculations
* '''[http://wiki.lrose.net/index.php/RadxPid RadxPid]''' - KDP, Attenuation, and Particle Identification
* '''[http://wiki.lrose.net/index.php/RadxRate RadxRate]''' - KDP, Attenuation, PID, and Rain Rate
* '''[http://wiki.lrose.net/index.php/RadxQpe RadxQpe]''' - Accumulated Quantitative Precipitation Estimation
* '''[http://wiki.lrose.net/index.php/RadxBeamBlock RadxBeamBlock]''' - Beam Blockage Estimation

==== Wind ====

* '''[http://wiki.lrose.net/index.php/RadxEvad RadxEvad]''' - Extended Velocity Azimuth Display single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/FRACTL FRACTL]''' - Fast Reorder and CEDRIC Technique in LROSE multi-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/SAMURAI SAMURAI]''' - Variational multi-Doppler retrieval and analysis package
* '''[http://wiki.lrose.net/index.php/VORTRAC VORTRAC]''' - Vortex Objective Radar Tracking and Circulation single-Doppler retrieval

== '''LROSE Workshops''' ==

=== LROSE AMS 2020 Mini Workshop ===
*'''[https://transcripts.gotomeeting.com/#/s/a474c7b072a229b924b0ba8706d65629eff94e847fa6c62b401a27772e442b6b Recorded GoToMeeting Presentation]'''
*'''[http://wiki.lrose.net/images/a/ae/LROSE_AMS_2020_Mini-Workshop_Agenda.pdf Meeting Notes]'''
*'''[http://wiki.lrose.net/images/8/89/Mmbell_LROSE_AMSannual2020_small.pdf LROSE Mini-Workshop Slides]'''
*'''[http://wiki.lrose.net/images/9/9c/LROSE-CycloneDoppler_small.pdf LROSE Cyclone Multi-Doppler Tutorial Slides]'''
*'''[http://wiki.lrose.net/images/0/09/HawkEye_Tutorial.pdf Brief Hawkeye Tutorial Slides]'''

Main Page

2021-02-02T03:14:39Z

Tingyucha:

== '''LROSE''' ==

=== The Lidar Radar Open Software Environment ===

[https://zenodo.org/badge/latestdoi/199713573 [[File:https://zenodo.org/badge/199713573.svg|DOI]]]

The current LROSE release is called '''“Elle”''' (a pink blend fragrant rose) and encompasses six key toolsets that define a core lidar/radar workflow: ''[http://wiki.lrose.net/index.php?title=Main_Page#Convert Convert], [http://wiki.lrose.net/index.php?title=Main_Page#Display Display], [http://wiki.lrose.net/index.php?title=Main_Page#Quality_Control QC], [http://wiki.lrose.net/index.php?title=Main_Page#Grid Grid], [http://wiki.lrose.net/index.php?title=Main_Page#Echo Echo], and [http://wiki.lrose.net/index.php?title=Main_Page#Wind Winds].'' '''Elle''' focuses on high-quality, well-tested, well-maintained and well-documented key applications as ‘building blocks’, allowing users to assemble trusted, reproducible workflows to accomplish more complex scientific tasks.

Elle can be compiled in C++ for native apps on Linux or Mac. Preliminary support is available for some tools on Windows.

We encourage users to [http://lrose.net/software.html register] in order to receive critical software updates, and sign up for the mailing list to help build the LROSE community.

[http://lrose.net/help.html Help] can be obtained by posting issues directly to the lrose-cyclone Github repository, via our help mailing list, or Discourse user forum.

LROSE is a co-operative project between:

* [http://www.atmos.colostate.edu/ Dept. of Atmospheric Science at Colorado State University (CSU)] and the
* [https://www.eol.ucar.edu/content/lidar-radar-open-software-environment The Earth Observing Lab at the National Center for Atmospheric Research (NCAR)].

LROSE is funded by the [https://www.nsf.gov National Science Foundation].

=== Citations for LROSE tools ===

Please cite the version of LROSE you use for publication.

* '''[https://doi.org/10.5281/zenodo.2532758 lrose-blaze]''': Bell, M. M. (2019). nsf‐lrose/lrose‐blaze: lrose‐blaze‐20190105. https://doi.org/10.5281/zenodo.2532758
* '''[https://doi.org/10.5281/zenodo.3604387 lrose-cyclone]''': Bell, M. M. and Melli B. (2020). nsf-lrose/lrose-cyclone: lrose-cyclone-20200110. https://doi.org/10.5281/zenodo.3604387

=== Installation Instructions ===

* '''[http://wiki.lrose.net/index.php/Mac-Homebrew-Installation Mac Homebrew installation]''' - For Native applications on the Mac, the recommended method is to use Homebrew. The formula contains all the necessary dependencies and builds instructions.

* '''[http://wiki.lrose.net/index.php/Mac-Build Mac Build]''' - Source compilation on the Mac is best performed using a supplied Python script.

* '''[http://wiki.lrose.net/index.php/Linux-Build Linux Build]''' - Source compilation on the Linux is best performed using a supplied Python script.

* '''[http://wiki.lrose.net/index.php/CIDD-Binary-Release CIDD Binary Release]''' - CIDD depends on a 32-bit build, which complicates the build and install for the core. The CIDD display application is not included in the standard lrose-core packages (above).

=== Tutorials ===

* '''quick start'''
** '''[http://wiki.lrose.net/index.php/lrose_quickstart lrose quickstart tutorial]''' - Go over the basics to get up and running quickly with LROSE.

* '''echo tutorials'''
** '''[http://wiki.lrose.net/index.php/elle_basic basic elle echo tutorial]''' - Go through the basic steps necessary to convert a raw radar file to CfRadial, calculate Kdp and three-dimensional rain rate, and estimate the surface rainfall. The purpose of this tutorial is to confirm that the install process was successful and that some programs are working.
** '''[http://wiki.lrose.net/index.php/elle_basic_plus basic+ elle echo tutorial]''' - Similar to the basic elle tutorial with the added tasks of downloading GFS analysis from which to estimate a sounding near the radar and running the RadxBeamBlock application.
** '''[http://wiki.lrose.net/index.php/elle_full full elle echo tutorial]''' - This tutorial assumes the user has radar data downloaded in an [http://wiki.lrose.net/index.php/RadxConvert acceptable radar format] and walks through the most important parameters that need to be edited to run the Quantitative Precipitation Estimation (QPE) workflow.

* '''grid tutorial'''
** '''[http://wiki.lrose.net/index.php/elle_grid elle regrid and convective/stratiform tutorial]''' - Convert raw NEXRAD data to the cfradial format and then interpolate to a cartesian grid and applies a convective stratiform separation algorithm.

* '''wind tutorial'''
** '''[http://wiki.lrose.net/index.php/vortrac_tutorial VORTRAC tutorial]''' - Convert raw NEXRAD data to the cfradial format and then interpolate to a cartesian grid and feeds the data into VORTRAC to retrieve the wind components.

=== Toolsets ===
In the current release, the following tools are available:

==== Convert ====

* '''[http://wiki.lrose.net/index.php/RadxPrint RadxPrint]''' - Query files to determine properties and support by the Radx engine
* '''[http://wiki.lrose.net/index.php/RadxConvert RadxConvert]''' - Convert 24 different lidar and radar formats to CfRadial NetCDF format
* '''RadxBufr''' - Convert Bufr format to CfRadial NetCDF format

==== Display ====

* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' - Real-time and archive display suitable for both scanning and vertically pointing radars.

==== Quality Control ====

* '''RadxDiffFields''' - Compare two fields in different CfRadial files
* '''RadxDiffVol''' - Compare two volumes in different CfRadial files
* '''RadxMergeFields''' - Merge fields from different CfRadial files
* '''RadxFilter''' - Perform simple filtering operations
* '''RadxPersistentClutter''' - Create a mask for persistent ground clutter

==== Grid ====

* '''[http://wiki.lrose.net/index.php/Radx2Grid Radx2Grid]''' - Gridding and interpolation of ground-based radar data

==== Echo ====

* '''[http://wiki.lrose.net/index.php/RadxKdp RadxKdp]''' - KDP and Attenuation calculations
* '''[http://wiki.lrose.net/index.php/RadxPid RadxPid]''' - KDP, Attenuation, and Particle Identification
* '''[http://wiki.lrose.net/index.php/RadxRate RadxRate]''' - KDP, Attenuation, PID, and Rain Rate
* '''[http://wiki.lrose.net/index.php/RadxQpe RadxQpe]''' - Accumulated Quantitative Precipitation Estimation
* '''[http://wiki.lrose.net/index.php/RadxBeamBlock RadxBeamBlock]''' - Beam Blockage Estimation

==== Wind ====

* '''[http://wiki.lrose.net/index.php/RadxEvad RadxEvad]''' - Extended Velocity Azimuth Display single-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/FRACTL FRACTL]''' - Fast Reorder and CEDRIC Technique in LROSE multi-Doppler retrieval
* '''[http://wiki.lrose.net/index.php/SAMURAI SAMURAI]''' - Variational multi-Doppler retrieval and analysis package
* '''[http://wiki.lrose.net/index.php/VORTRAC VORTRAC]''' - Vortex Objective Radar Tracking and Circulation single-Doppler retrieval

== '''LROSE Workshops''' ==

=== LROSE AMS 2020 Mini Workshop ===
*'''[https://transcripts.gotomeeting.com/#/s/a474c7b072a229b924b0ba8706d65629eff94e847fa6c62b401a27772e442b6b Recorded GoToMeeting Presentation]'''
*'''[http://wiki.lrose.net/images/a/ae/LROSE_AMS_2020_Mini-Workshop_Agenda.pdf Meeting Notes]'''
*'''[http://wiki.lrose.net/images/8/89/Mmbell_LROSE_AMSannual2020_small.pdf LROSE Mini-Workshop Slides]'''
*'''[http://wiki.lrose.net/images/9/9c/LROSE-CycloneDoppler_small.pdf LROSE Cyclone Multi-Doppler Tutorial Slides]'''
*'''[http://wiki.lrose.net/images/0/09/HawkEye_Tutorial.pdf Brief Hawkeye Tutorial Slides]'''

Vortrac tutorial

2021-02-02T02:55:32Z

Tingyucha:

=== '''VORTRAC tutorial''' ===

This workflow will go through the steps to run VORTRAC, and provide gridded radar data, a center file (.csv) and the XML file. For more information on how to obtain the gridded radar files from the raw radar files, please refer to the '''[http://wiki.lrose.net/index.php/Elle_grid grid tutorial]'''.

==== '''Run program on the command line''' ====
<ol start="1" style="list-style-type: decimal;">
<li>Download the [https://drive.google.com/file/d/18Z9PC6-a2lqMkaFEbecZ3Fsy8lMFmkPl/view?usp=sharing vortrac_tutorial.tar.gz] file</li></ol>
<ol start="2" style="list-style-type: decimal;">
<li>Extract contents into the desired directory</li></ol>

* Create a new folder called vortrac_example (or the user's desired directory)
<code lang="bash">mkdir ~/vortrac_example </code>

* Move the tar file to the vortrac_example folder
<code lang="bash">mv vortrac_tutorial.tar.gz ~/vortrac_example </code>

* Extract contents
<code lang="bash">tar -zxvf vortrac_tutorial.tar.gz </code>

You'll end up with a directory that includes the gridded radar data, a center file (.csv) and the XML file to run VORTRAC.

<ol start="3" style="list-style-type: decimal;">
<li>Create the following folders under the same directory as the XML file, center file, and the folder of '''radar''' </li></ol>

<code lang="bash">mkdir cappi </code>

<code lang="bash">mkdir center </code>

<code lang="bash">mkdir choosecenter </code>

<code lang="bash">mkdir pressure </code>

<code lang="bash">mkdir vtd </code>

You'll end up with a directory that includes 6 folders, a XML file and a center (.csv) file.

<ol start="4" style="list-style-type: decimal;">
<li>Modify the XML file</li></ol>

* Set the directory. Find the line beginning with <code lang="bash">dir</code> and <code lang="bash">centers</code>, and modify them to your current directory. (8 lines in total)

In the tutorial, you do not need to modify further parameters, but we recommend the users go through the details about the '''[http://wiki.lrose.net/index.php/VORTRAC#Configuration XML configuration]'''.

<ol start="5" style="list-style-type: decimal;">
<li>Run VORTRAC</li></ol>

<code lang="bash">/path/to/vortrac/bin/vortrac </code>

Vortrac tutorial

2021-02-02T02:55:12Z

Tingyucha:

=== '''VORTRAC tutorial''' ===

This workflow will go through the steps to run VORTRAC, and provide gridded radar data, a center file (.csv) and the XML file. For more information on how to obtain the gridded radar files from the raw radar files, please refer to the '''[http://wiki.lrose.net/index.php/Elle_grid grid tutorial]'''.

==== '''Run program on the command line''' ====
<ol start="1" style="list-style-type: decimal;">
<li>Download the [https://drive.google.com/file/d/18Z9PC6-a2lqMkaFEbecZ3Fsy8lMFmkPl/view?usp=sharing vortrac_tutorial.tar.gz] file</li></ol>
<ol start="2" style="list-style-type: decimal;">
<li>Extract contents into the desired directory</li></ol>

* Create a new folder called vortrac_example (or the user's desired directory)
<code lang="bash">mkdir ~/vortrac_example </code>

* Move the tar file to the vortrac_example folder
<code lang="bash">mv vortrac_tutorial.tar.gz ~/vortrac_example </code>

* Extract contents
<code lang="bash">tar -zxvf vortrac_tutorial.tar.gz </code>

You'll end up with a directory that includes the gridded radar data, a center file (.csv) and the XML file to run VORTRAC.

<ol start="3" style="list-style-type: decimal;">
<li>Create the following folders under the same directory as the XML file, center file, and the folder of '''radar''' </li></ol>

<code lang="bash">mkdir cappi </code>

<code lang="bash">mkdir center </code>

<code lang="bash">mkdir choosecenter </code>

<code lang="bash">mkdir pressure </code>

<code lang="bash">mkdir vtd </code>

You'll end up with a directory that includes 6 folders, a XML file and a center (.csv) file.

<ol start="4" style="list-style-type: decimal;">
<li>Modify the XML file</li></ol>

* Set the directory. Find the line beginning with <code lang="bash">dir</code> and <code lang="bash">centers</code>, and modify them to your current directory. (8 lines in total)

In the tutorial, you do not need to modify further parameters, but we recommend the users go through the details about the '''[http://wiki.lrose.net/index.php/VORTRAC#Configuration XML configuration]'''.

<ol start="5" style="list-style-type: decimal;">
<li>Run VORTRAC</li></ol>

<code lang="bash">/path/to/vortrac/bin/vortrac </code>

*