Main Page

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: Convert, Display, QC, Grid, Echo, and 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 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-cyclone Github repository, via our help mailing list, or Discourse user forum.

LROSE is a co-operative project between:

• Dept. of Atmospheric Science at Colorado State University (CSU) and the
• The Earth Observing Lab at the National Center for Atmospheric Research (NCAR).

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.

• [comingupsoon lrose-elle]: Michael M. Bell, Michael Dixon, Brenda Javornik, Wen-Chau Lee, Jennifer DeHart and Ting-Yu Cha (2021). nsf-lrose/lrose-elle: lrose-elle-20210216.
• lrose-cyclone: 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
• lrose-blaze: 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

• 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.

1. Download, install, and run Homebrew
2. Download the lrose-core formula lrose-core.rb
3. Go to the directory stored lrose-core.rb, and install lrose-core by typing the following command in a terminal:

  brew install lrose-core.rb

You are done with installation! Go to the Documentation to learn how to run LROSE-Elle

Source Installation

Intended for users who wish to do a manual build or build in a non-standard location. Source compilation on the Mac is best performed using a supplied Python script.

• Mac Build

• Linux Build

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

• quick start
  • lrose quickstart tutorial - Go over the basics to get up and running quickly with LROSE.

• echo tutorials
  • 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.
  • 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.
  • full elle echo tutorial - This tutorial assumes the user has radar data downloaded in an 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
  • 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
  • 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

• 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

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
• RadxBeamBlock - Beam Blockage Estimation

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

LROSE Workshops

LROSE AMS 2020 Mini Workshop

• Meeting Notes
• LROSE Mini-Workshop Slides
• LROSE Cyclone Multi-Doppler Tutorial Slides
• Brief Hawkeye Tutorial Slides