Actions

Difference between revisions of "Main Page"

From Lrose Wiki
 
(130 intermediate revisions by 6 users not shown)
Line 1: Line 1:
−
= '''LROSE''' =
+
== '''LROSE: The Lidar Radar Open Software Environment''' ==
  
−
== The Lidar Radar Open Software Environment ==
+
=== Overview ===
 +
[[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 '''“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.
  
−
[https://zenodo.org/badge/latestdoi/199713573 [[File:https://zenodo.org/badge/199713573.svg|DOI]]]
+
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.
  
−
The current LROSE release is called '''“Cyclone”''' (a bright red rose) and encompasses six key toolsets that define a core lidar/radar workflow: ''Convert, Display, QC, Grid, Echo, and Winds''
 
  
−
Blaze can be used from a ‘Virtual Toolbox’ using Docker and a wrapper script, or 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.
  
−
Full documentation for Cyclone is available on the [https://lrose.net LROSE website]
+
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.
  
−
We encourage users to [https://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 [https://github.com/NCAR/lrose-core lrose-core] GitHub repository, via our help mailing list, or Discourse user forum.
−
 
 
−
[https://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:
 
LROSE is a co-operative project between:
Line 22: Line 25:
 
LROSE is funded by the [https://www.nsf.gov National Science Foundation].
 
LROSE is funded by the [https://www.nsf.gov National Science Foundation].
  
−
'''Cyclone''' 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.
+
=== 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.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.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.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.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 ===
 +
 
 +
*'''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 ===
 +
 
 +
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.
 +
 
 +
 
 +
Our old tutorials can be found [http://wiki.lrose.net/index.php/old_lrose_tutorials here].
  
 +
=== Toolsets ===
 
In the current release, the following tools are available:
 
In the current release, the following tools are available:
  
−
== Convert ==
+
==== 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/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/RadxConvert RadxConvert]''' - Convert 24 different lidar and radar formats to CfRadial NetCDF format
−
* '''RadxBufr''' - Convert Bufr format to CfRadial NetCDF format
+
* '''[http://wiki.lrose.net/index.php/RadxBufr RadxBufr]''' - Convert Bufr format to CfRadial NetCDF format
  
−
== Display ==
+
==== Display ====
  
 
* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' - Real-time and archive display suitable for both scanning and vertically pointing radars.
 
* '''[http://wiki.lrose.net/index.php/HawkEye HawkEye]''' - Real-time and archive display suitable for both scanning and vertically pointing radars.
  
−
== Grid ==
+
==== 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
 
* '''[http://wiki.lrose.net/index.php/Radx2Grid Radx2Grid]''' - Gridding and interpolation of ground-based radar data
  
−
== Echo ==
+
==== Echo ====
  
 
* '''[http://wiki.lrose.net/index.php/RadxKdp RadxKdp]''' - KDP and Attenuation calculations
 
* '''[http://wiki.lrose.net/index.php/RadxKdp RadxKdp]''' - KDP and Attenuation calculations
Line 46: Line 94:
 
* '''[http://wiki.lrose.net/index.php/RadxRate RadxRate]''' - KDP, Attenuation, PID, and Rain Rate
 
* '''[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/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/PrecipAccum PrecipAccum]''' - Accumulated Precipitation (''not recommended'')
 
* '''[http://wiki.lrose.net/index.php/RadxBeamBlock RadxBeamBlock]''' - Beam Blockage Estimation
 
* '''[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 ==
+
==== Wind ====
  
−
* '''RadxEvad''' - Extended Velocity Azimuth Display single-Doppler retrieval
+
* '''[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/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/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/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]'''
 +
*'''[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]'''

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.

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

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.

  1. Cartesian Gridding of Polar Radar Data
  2. Convective/Stratiform Partitioning
  3. Kdp Calculation
  4. Rain Rate Calculations
  5. Attenuation Correction
  6. Particle Identification using Fuzzy Logic
  7. Quantitative Precipitation Estimation
  8. Velocity Dealiasing

LROSE Workshops

LROSE AMS 2020 Mini Workshop

LROSE Fall 2021 Virtual Workshop

LROSE AMS 2023 Workshop

Retrieved from "http://wiki.lrose.net/index.php?title=Main_Page&oldid=1049"