Skip to content

lrose-core-20230814
Compare
Choose a tag to compare
@mike-dixon mike-dixon released this 14 Aug 01:55
· 443 commits to master since this release
lrose-core-20230814
ba98240

lrose-core-20230814 - Jade August 2023 release

RELEASE NOTES

Highlights.

  • OSX support for Intel and M1/M2 machines (Ventura).
  • Debian support for: 10, 11, 12
  • Ubuntu support for: 18.04, 20.04, 22.04
  • Centos (and therefore RHEL) support for: 7
  • Fedora support for: 36, 37, 38
  • Alma Linux (and therefore RHEL) support for : 8, 9
  • Rocky Linux (and therefore RHEL) support for: 8, 9
  • Bug fixes and updates to the Radx applications.
  • cmake is the primary compile system.
  • HawkEdit has been updated significantly. HawkEdit is now built as part of the lrose-core package, as well as as a .dmg.

OSX support and build notes

  • OSX - homebrew installs have been tested on monterey and ventura.
  • 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 in both /usr/local and /opt.
  • The dependency on the szip library has been removed.

Installing on Mac OSX using brew

Testing of the installation of this release, using brew, has been tested on:

  • Ventura

For the full compile preparation on mac OSX, see:

From this release, download:

  lrose-core.rb

and then run:

  brew install lrose-core.rb

For Ventura on Intel, if you get the following error when you run the Radx applications:

  RadxPrint -h
    Library not loaded: /usr/local/opt/hdf5/lib/libhdf5.200.dylib

you will need to link the latest hdf5 libraries to the old names:

  ln -s /usr/local/lib/libhdf5_hl.310.dylib /usr/local/lib/libhdf5_hl.200.dylib
  ln -s /usr/local/lib/libhdf5.310.dylib /usr/local/lib/libhdf5.200.dylib

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 anaconda

  • If anaconda is installed, cmake can get confused by the libraries under anaconda.
  • In CMakeLists.txt, we have added CMAKE_IGNORE_PREFIX_PATH to ignore $HOME/anaconda2 and $HOME/anaconda3.
  • So if you install anaconda in the standard locations, that should be OK.
  • If you install anaconda in non-standard locations, you will need to modify codebase/CMakeLists.txt to add your anaconda 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?
Centos 7 Yes Yes Yes Yes Yes
Centos 8 Yes Yes Yes Yes Yes
Alma 8 Yes Yes Yes Yes Yes
Alma 9 No No Yes Yes Yes
Rocky 8 Yes Yes Yes Yes Yes
Rocky 9 No No Yes Yes Yes
Fedora 36 Yes Yes Yes Yes Yes
Fedora 37 Yes Yes Yes Yes Yes
Debian 9 Yes Yes Yes Yes Yes
Debian 10 Yes Yes Yes Yes Yes
Debian 11 Yes Yes Yes Yes Yes
Ubuntu 16.04 Yes Yes Yes Yes Yes
Ubuntu 18.04 Yes Yes Yes Yes Yes
Ubuntu 20.04 Yes Yes Yes Yes Yes
Ubuntu 22.04 Yes Yes Yes Yes Yes

Note: AlmaLinux 9 and RockyLinux 9 are missing full support for eigen3 and armadillo. Therefore fractl and vortrac will not build on these OSs. Once those libraries are added, we should be able to build fractl and vortrac for them.

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)

Updates to Radx applications

Radx app notes
RadxRate Fixed bug in rate parameters.

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:

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.

Assets 29