Skip to content

lrose-core-20250105

Latest
Compare
Choose a tag to compare
@mike-dixon mike-dixon released this 05 Jan 15:51
· 47 commits to master since this release

lrose-core-20250105 - Colette final release

NOTE - This document is still under development.

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.