Difference between revisions of "Main Page"

Latest revision as of 17:36, 13 November 2024

LROSE: The Lidar Radar Open Software Environment

Overview

Colette
Image: T.Kiya from Japan, CC BY-SA 2.0, via Wikimedia Commons

The current LROSE release is called “Colette” (a versatile climbing rose) and encompasses six key toolsets that define a core lidar/radar workflow: Convert, Display, QC, Grid, Echo, and Winds. Colette 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 Colette:

The cmake build option now supports qt6.
Packages are available for Centos, Ubuntu, Fedora 37, 38, 39, Alma Linux, Suse.
Bug fixes and updates to Radx applications.
HawkEdit is now a beta version, and has undergone considerable testing from users.

Colette 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 register in order to receive critical software updates, and sign up for the mailing list to help build the LROSE community.

Help can be obtained by posting issues directly to the lrose-core GitHub repository, via our help mailing list, or Discourse user forum.

LROSE is a co-operative project between:

LROSE is funded by the 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-colette, 2024: DeHart, J., Dixon, M., Javornik, B., Bell, M., Cha, T.-Y., DesRosiers, A., & Lee, W.-C. (2024). nsf-lrose/lrose-releases: lrose-colette-20240525 (lrose-colette-20240525). Zenodo. https://doi.org/10.5281/zenodo.11510075
lrose-jade, 2023: DeHart, J., Dixon, M., Javornik, B., Bell, M., Cha, T.-Y., DesRosiers, A., & Lee, W.-C. (2024). nsf-lrose/lrose-releases: lrose-jade-20230814 (lrose-jade-20230814). Zenodo. https://doi.org/10.5281/zenodo.11479603
lrose-topaz, 2022: Michael M. Bell. (2022). nsf-lrose/lrose-topaz: lrose-topaz-20220222 (lrose-topaz-20220222). Zenodo. https://doi.org/10.5281/zenodo.6909479
lrose-elle, 2021: Michael M. Bell, Michael Dixon, Wen-Chau Lee, Brenda Javornik, 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
lrose-cyclone, 2020: Michael M. Bell, & Bruno Melli. (2020). nsf-lrose/lrose-cyclone: lrose-cyclone release 20200110 (lrose-cyclone-20200110). Zenodo. https://doi.org/10.5281/zenodo.3604387
lrose-blaze, 2019: Michael M. Bell. (2019). nsf-lrose/lrose-blaze: lrose-blaze-20190105 (lrose-blaze-20190105). Zenodo. https://doi.org/10.5281/zenodo.2532758

Installation Instructions

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.
- Build system - For LINUX and MAC OS cmake/autoconf/manual builds and code development

CIDD Binary Installation
- 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

We are in the process of transitioning most of our tutorials to our new LROSE Science Gateway hosted on JupyterHub servers deployed on NSF's Jetstream2 supercomputer at Indiana University. The notebooks can also be found on our GitHub repository. This work is supported by NSF award AGS-2103776. For more information, please contact the LROSE team directly for JupyterHub access or setting up a classroom exercise or workshop.

Our old tutorials can be found here.

Toolsets

In the current release, the following tools are available:

Convert

RadxPrint - Query files to determine properties and support by the Radx engine
RadxConvert - Convert 24 different lidar and radar formats to CfRadial NetCDF format
RadxBufr - Convert Bufr format to CfRadial NetCDF format

Display

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
RadxDealias - Dealias single-Doppler data
RadxQc - General quality control
IntfRemove - Identify and remove interference in Titan data
RadxModelQc - Filter Radx data
RadxClutMon - Clutter analysis
TsCalAuto - Radar calibration analysis
RadarCal - Analyze calibration data
RadxSunMon - Search for sun spikes and perform solar analysis
SunCal - Analyze time series data from sun scans

Grid

Radx2Grid - Gridding and interpolation of ground-based radar data

Echo

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

Wind

RadxEvad - Extended Velocity Azimuth Display single-Doppler retrieval
FRACTL - Fast Reorder and CEDRIC Technique in LROSE multi-Doppler retrieval
SAMURAI - Variational multi-Doppler retrieval and analysis package
VORTRAC - Vortex Objective Radar Tracking and Circulation single-Doppler retrieval
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.

@@ Line 2: / Line 2: @@
 === Overview ===
-[[File:Topaz-small.png|thumb|right|'''Topaz''']]
+[[File:Colette_rose.jpg|thumb|right|'''Colette <br />Image: [https://commons.wikimedia.org/wiki/File:Rose,_Colette,_%E3%83%90%E3%83%A9,_%E3%82%B3%E3%83%AC%E3%83%83%E3%83%88,_(21149732508).jpg T.Kiya from Japan], [https://creativecommons.org/licenses/by-sa/2.0 CC BY-SA 2.0], via Wikimedia Commons''']]
-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.
+The current LROSE release is called '''“Colette”''' (a versatile climbing 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].'' '''Colette''' 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:
+Some highlights for Colette:
-* This release contains further refinements in radial data format translation.
+* The cmake build option now supports qt6.
-* The cmake-based build option is available.
+* Packages are available for Centos, Ubuntu, Fedora 37, 38, 39, Alma Linux, Suse.
-* Packages are available for Centos, Ubuntu, Fedora 32, 33, 34, Alma Linux, Suse.
+* Bug fixes and updates to Radx applications.
-* 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.
+Colette 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.
+[http://lrose.net/help.html Help] can be obtained by posting issues directly to the [https://github.com/NCAR/lrose-core lrose-core] GitHub repository, via our help mailing list, or Discourse user forum.
 LROSE is a co-operative project between:
@@ Line 30: / Line 29: @@
 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.11510075 lrose-colette, 2024]''': DeHart, J., Dixon, M., Javornik, B., Bell, M., Cha, T.-Y., DesRosiers, A., & Lee, W.-C. (2024). nsf-lrose/lrose-releases: lrose-colette-20240525 (lrose-colette-20240525). Zenodo. https://doi.org/10.5281/zenodo.11510075
-* '''[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.11479603 lrose-jade, 2023]''': DeHart, J., Dixon, M., Javornik, B., Bell, M., Cha, T.-Y., DesRosiers, A., & Lee, W.-C. (2024). nsf-lrose/lrose-releases: lrose-jade-20230814 (lrose-jade-20230814). Zenodo. https://doi.org/10.5281/zenodo.11479603
-* '''[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.6909479 lrose-topaz, 2022]''': Michael M. Bell. (2022). nsf-lrose/lrose-topaz: lrose-topaz-20220222 (lrose-topaz-20220222). Zenodo. https://doi.org/10.5281/zenodo.6909479
-* '''[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
+* '''[https://doi.org/10.5281/zenodo.5523312 lrose-elle, 2021]''': Michael M. Bell, Michael Dixon, Wen-Chau Lee, Brenda Javornik, 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, & Bruno Melli. (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. (2019). nsf-lrose/lrose-blaze: lrose-blaze-20190105 (lrose-blaze-20190105). Zenodo. https://doi.org/10.5281/zenodo.2532758
 === Installation Instructions ===
@@ Line 48: / Line 49: @@
 === Tutorials ===
-* '''quick start'''
+We are in the process of transitioning most of our tutorials to our new LROSE Science Gateway hosted on JupyterHub servers deployed on NSF's Jetstream2 supercomputer at Indiana University. The notebooks can also be found on our [https://github.com/nsf-lrose/lrose-hub GitHub] repository. This work is supported by NSF award AGS-2103776. For more information, please contact the LROSE team directly for JupyterHub access or setting up a classroom exercise or workshop.
-** '''[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'''
+Our old tutorials can be found [http://wiki.lrose.net/index.php/old_lrose_tutorials here].
-** '''[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 ===
@@ Line 109: / Line 95: @@
 * '''[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/RateAccum RateAccum]''' - Accumulated Precipitation (recommended)
+* '''[http://wiki.lrose.net/index.php/RateAccum RateAccum]''' - Accumulated Precipitation (''recommended'')
-* '''[http://wiki.lrose.net/index.php/PrecipAccum PrecipAccum]''' - Accumulated Precipitation (not recommended)
+* '''[http://wiki.lrose.net/index.php/PrecipAccum PrecipAccum]''' - Accumulated Precipitation (''not recommended'')
 * '''[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
@@ Line 160: / Line 146: @@
 *'''Meeting Notes'''
 *'''[http://wiki.lrose.net/index.php/2021_Fall_Workshop_Videos Pre-recorded Videos]'''
-*'''[http://wiki.lrose.net/index.php/2021_Fall_Workshop_Sessions Session Recordings]'''
+*'''[http://wiki.lrose.net/index.php/2021_Fall_Workshop_Sessions Session Recordings and Slides]'''
+=== LROSE AMS 2023 Workshop ===
+*'''Meeting Notes'''
+*'''[http://wiki.lrose.net/index.php/2023_AMS_Workshop_Sessions Session Recordings and Slides]'''