Skip to content

v1.15

Latest

Choose a tag to compare

@lars2015 lars2015 released this 18 Jul 11:21
· 3 commits to master since this release

Changes in this release

Documentation & Metadata

  • Updated the README, MkDocs manual, Doxygen main page, examples, references, CITATION.cff, and dependency documentation.
  • Added a dedicated DEPENDENCIES.md file and clarified mandatory netCDF/HDF5 requirements and installation instructions.
  • Added a Matrix chat room, AGENTS.md, a JOSS submission badge, and author metadata including an additional ORCID.
  • Expanded the manual with figures, including infrared limb-spectrum illustrations, and corrected inconsistencies across the documentation.
  • Removed the external polyfill.io dependency from the manual.
  • Improved documentation for MPI parallelization, testing, workflows, command-line usage, lookup tables, and file formats.

JOSS Paper

  • Added and iteratively revised the JOSS paper.
  • Added a concise introduction, a statement of need, updated figures, citations, references, and author information.
  • Incorporated reviewer and collaborator feedback and aligned the paper with the current software capabilities and documentation.

Build System, Dependencies & CI/CD

  • Updated Makefiles, library build scripts, GitHub Actions workflows, documentation deployment, and coverage configuration.
  • Removed the obsolete Coveralls workflow.
  • Added and revised CLI, regression, MPI, netCDF, and lookup-table tests in continuous integration.
  • Added an optional hybrid MPI retrieval regression test.
  • Removed explicit -lzstd linking where it caused problems with static builds.
  • Improved workflow guidance, installation notes, and dependency handling.

Command-Line Interface & Tools

  • Added CLI help and usage documentation for all command-line tools.
  • Introduced a shared USAGE macro and expanded cli_test.
  • Improved handling and usability of the -h option.
  • Added clearer help text for control parameters.
  • Improved runtime timer reporting in the forward model, retrieval, and kernel applications.
  • Added or updated tools for zenith geometries, lookup-table reduction, table conversion, and table reading.

netCDF & Binary I/O

  • Added netCDF support for atmospheric profiles, observations, lookup tables, retrieval profile lists, and matrices.
  • Added binary and netCDF matrix I/O together with a matrix-format conversion tool and tests.
  • Added generic profile-index support to shared I/O wrappers.
  • Generalized dataset-aware matrix I/O.
  • Added MPI-safe shared netCDF retrieval I/O.
  • Added shared netCDF profile-list handling for retrieval applications.
  • Added macros and common infrastructure for netCDF support.
  • Improved atmospheric, observational, table, matrix, and retrieval netCDF test coverage.
  • Improved the performance of netCDF lookup-table reading.
  • Allowed netCDF readers to skip empty lookup tables safely.
  • Added distinct rad_* and bt_* netCDF variables for radiance and brightness-temperature observation spectra.

Lookup Tables & Interpolation

  • Added netCDF reading and writing for lookup tables.
  • Added filter functions to binary and netCDF lookup-table files.
  • Stored filter functions together with emissivity lookup tables.
  • Made emissivity lookup tables dynamically allocatable and added explicit cleanup routines.
  • Refactored table writers into per-(id, ig) functions.
  • Empty emissivity tables are now skipped with a warning instead of being written.
  • Reused common table packing and unpacking functions for binary lookup tables.
  • Added tests for lookup-table compression and extended table I/O tests.
  • Switched emissivity-curve interpolation to logarithmic space using precomputed log(u) and log(eps).
  • Added log-pressure interpolation and reused precomputed logarithmic pressure values.
  • Revised interpolation routines and changed invalid logarithmic interpolation fallbacks to linear interpolation.
  • Clamped interpolated segment emissivity to valid bounds.

Retrievals & Parallelization

  • Added MPI parallelization to the retrieval code.
  • Enabled MPI-safe shared access to netCDF retrieval data.
  • Added shared profile-list input and output for retrievals.
  • Refactored common retrieval input-target handling.
  • Added an optional hybrid MPI retrieval regression test.
  • Improved timing reports for retrieval and kernel calculations.

Observation Geometries & RFM Interface

  • Added support for zenith observation geometry.
  • Added a dedicated zenith geometry tool and example.
  • Extended zenith calculations to angles greater than 90 degrees.
  • Fixed zenith geometry handling and updated the associated regression tests.
  • Added zenith support to the RFM interface.
  • Fixed reading of netCDF filter functions through the RFM interface.
  • Updated limb, nadir, and zenith examples and their reference outputs.

Atmospheric Profiles & Vertical Grid

  • Added an option to refine the near-surface atmospheric layer.
  • Modified the vertical grid near the surface.
  • Removed an obsolete surface-level validation check.
  • Revised atmospheric memory allocation.
  • Added and expanded tests for atmospheric profile reading and writing.

Spectroscopy & Physical Parameters

  • Updated the refractivity equation to use dry-air Edlén refraction.
  • Updated regression data for the revised refractivity calculation.
  • Revised the global CO₂ fit using NOAA annual-mean data for 1980–2025.
  • Improved interpolation and emissivity handling for radiative-transfer lookup tables.

Code Quality & Refactoring

  • Revised memory allocation and lookup-table cleanup.
  • Removed unused variables and obsolete code.
  • Updated log messages, comments, Doxygen annotations, and API descriptions.
  • Refactored shared I/O, retrieval, and lookup-table helper functions.
  • Fixed documentation comments, references, manual inconsistencies, and compilation-related issues.

Tests & Examples

  • Added dedicated formod_test, obs_test, and atm_test programs.
  • Added tests for atmospheric and observational netCDF files.
  • Extended lookup-table, matrix, retrieval, CLI, MPI, and geometry regression tests.
  • Updated test scripts and reference datasets for interpolation, refractivity, zenith geometry, netCDF I/O, and examples.
  • Added a zenith example and refreshed the limb and nadir examples.
  • Updated example documentation and workflows.