lrose-core-20250105 - Colette final release
NOTE - This document is still under development.
- TODO - NEEDS UPDATE DOI: https://doi.org/10.5281/zenodo.14624762
RELEASE NOTES
There are detailed release notes at:
Highlights.
- OSX support for Intel and M1/M2 machines (Sonoma 14.7.1).
- Debian support for: 11, 12.
- Ubuntu support for: 20.04, 22.04, 24.04.
- Fedora support for: 39, 40, 41.
- Alma Linux (and therefore RHEL) support for : 8, 9.
- Rocky Linux (and therefore RHEL) support for: 8, 9.
- Oracle Linux support for: 9.
- Suse 15.6 support.
- Bug fixes and updates.
- cmake upgrade to support qt6.
OSX support and build notes
- OSX - homebrew installs have been tested on sonoma.
- For the Intel macs, brew is installed in /usr/local.
- For M1/M2 macs, brew is installed in /opt.
- The CMakeLists.txt files have been updated to search for Qt5 and QT6 in both /usr/local and /opt.
Installing on Mac OSX using brew
Testing of the installation of this release, using brew, has been tested on:
- Sequoia
For the full compile preparation on mac OSX, see:
From this release, download:
lrose-core.rb
and then run:
brew install lrose-core.rb
To install fractl, vortrac and samurai using brew, download:
lrose-fractl.rb
lrose-vortrac.rb
lrose-samurai.rb
and then run:
brew install lrose-fractl.rb
brew install lrose-vortrac.rb
brew install lrose-samurai.rb
Installing display apps on Mac OSX using disk images
There are three disk images for MacOS:
- vortrac.dmg : Vortex Object Radar Tracking and Circulation (same as the 20221229 version).
- HawkEye.dmg: HawkEye polar radar display
- HawkEdit.dmg: HawkEdit is similar to HawkEye but with soloii-like editing capability (same as the 20230711 version from lrose-HawkEdit repository).
To install a disk image file (.dmg), download the .dmg file to your computer. Click on the .dmg file, and drag the application to your Applications folder. The first time you start one of the LROSE applications, it may appear as a Mac app from an unidentified developer. The application is signed by UCAR. Follow these steps:
- Control-click the app icon, then choose Open from the shortcut menu.
- Click Open. The app is saved as an exception to your security settings. You can open the app in the future by double-clicking the icon.
cmake builds
This release includes cmake-based builds for all of our packages, except for CIDD.
To build on your own host, see:
cmake and miniforge3
- If miniforge is installed, cmake can get confused by the libraries under miniforge.
- In CMakeLists.txt, we have added CMAKE_IGNORE_PREFIX_PATH to ignore $HOME/miniforge3.
- So if you install anaconda in the standard locations, that should be OK.
- If you install miniforge in non-standard locations, you will need to modify codebase/CMakeLists.txt to add your miniforge location to CMAKE_IGNORE_PREFIX_PATH.
Installing from LINUX packages
For most common LINUX systems, you can install lrose from the packages on this page.
OS-version | fractl | vortrac | samurai | HawkEye | CIDD available? |
---|---|---|---|---|---|
Alma 8 | Yes | Yes | Yes | Yes | Yes |
Alma 9 | Yes | No | Yes | Yes | Yes |
Rocky 8 | Yes | Yes | Yes | Yes | Yes |
Rocky 9 | Yes | No | Yes | Yes | Yes |
Fedora 39 | Yes | Yes | Yes | Yes | Yes |
Fedora 40 | Yes | Yes | Yes | Yes | Yes |
Fedora 41 | Yes | Yes | Yes | Yes | Yes |
Debian 11 | Yes | Yes | Yes | Yes | Yes |
Debian 12 | Yes | Yes | Yes | Yes | Yes |
Ubuntu 20.04 | Yes | Yes | Yes | Yes | Yes |
Ubuntu 22.04 | Yes | Yes | Yes | Yes | Yes |
Ubuntu 24.04 | Yes | Yes | Yes | Yes | Yes |
Oracle 9 | Yes | No | Yes | Yes | Yes |
Suse 15.6 | No | No | No | Yes | Yes |
Notes:
- AlmaLinux 9 and RockyLinux 9 are missing full support for armadillo. Therefore vortrac will not build on these OSs.
- Suse is lacking support for armadillo and eigen3, so fractl, vortrac and samurai are not available.
The installation directories are:
/usr/local/lrose/bin
/usr/local/lrose/lib
/usr/local/lrose/include
so you will need to add /usr/local/lrose/bin
to your path.
For Debian and Ubuntu installs, you may need to set the LD_LIBRARY_PATH as follows:
export LD_LIBRARY_PATH=/usr/local/lrose/lib (bash)
setenv LD_LIBRARY_PATH /usr/local/lrose/lib (csh)
Wind analysis applications (fractl, vortrac and samurai)
This release bundles the wind-related applications along with the core.
These apps are:
- fractl - geometry-based analysis for multi-Doppler wind retrieval
- samurai - variational analysis for multi-Doppler wind retrieval
- vortrac - Vortex Object Radar Tracking and Circulation
The code for these apps may be found at:
Vortrac will use qt5 if available, otherwise qt6.
NOTE: Cartesian data MDV files - NetCDF default
Please note that in this version of LROSE (and TITAN), any Cartesian files will be written out
by default using the NetCDF version of the MDV format. Radx2Grid is an example of an application that writes MDV files.
Previously the default was to write the binary version of MDV.
Both formats should worked interchangeably within LROSE and TITAN. But for non-LROSE applications this can cause confusion.
The output format for Cartesian MDV files can be controlled via the MDV_WRITE_FORMAT environment variable. To force writing of binary MDV files, use on of the following:
setenv MDV_WRITE_FORMAT FORMAT_MDV (csh or tcsh)
export MDV_WRITE_FORMAT=FORMAT_MDV (sh or bash)
and to force the usage of NetCDF, the default, use:
setenv MDV_WRITE_FORMAT FORMAT_NCF (csh or tcsh)
export MDV_WRITE_FORMAT=FORMAT_NCF (sh or bash)
Installing the CIDD binary release
The CIDD display application is not included in the standard lrose-core packages (above).
CIDD depends on a 32-bit build, which complicates the build and install for the core.
To download and install the CIDD binary release, see:
CIDD binaries have become problematic, due to library changes in some Linux distributions.
It is suggested that you first try:
lrose-cidd-20210524.bin.x86_64.tgz
Downloading the release
The files for download appear below, marked as Assets.
If you do not see them, open them up by clicking on Assets.