v0.30.x series

v0.30.0 (27th March 2025)

In this major release, we add several features related with polarization and aquatic surface modelling. We also further improve the expert interface with additional syntactic sugar and debugging tools.

Warning

The mycena CKD dataset (10 nm resolution) has been updated and fixed. The mycena keyword now routes to this updated version (mycena_v2), both for data download and consumption. The previous version of the dataset is still available as mycena_v1.

Deprecated

  • ⚠️ The eradiate.srf_tools.make_gaussian() function is deprecated. It will be removed in v0.31.0. Use eradiate.spectral.response.make_gaussian() as an alternative.

  • ⚠️ The mycena_v1 CKD absorption database has issues and should not be used. Instead, use mycena_v2 (aliased as mycena now). The previous version of the dataset is still available for backward compatibility.

Removed

Added

  • Added several ocean BRDF models: 6SV-like / “legacy” (PR453), specular polarized / “Mishchenko” (PR466), GRASP (PR480).

  • 🖥️ Improved importance sampling for ocean BRDFs (PR480).

  • Added depolarization factor to the Rayleigh phase function (PR460).

  • Added a new ArrayRadProfile class (PR468). It implements an interface to user-defined raw radiative atmospheric profile data and is mostly used for debugging purposes. Note that it currently only supports monochromatic evaluation and will use it as a fallback in CKD modes.

  • The run() function, Experiment.process() and Experiment.postprocess() now accept a measures argument that allows to specify which measures will be processed (PR471, PR472).

  • Added a new mycena_v2 molecular absorption database (10 nm resolution) (PR473).

  • Added a drop_parameters option to Experiment.init() (PR474).

Changed

  • ⚠️ Transferred the Gaussian SRF dataset creation function make_gaussian() to the eradiate.spectral.response subpackage (PR458).

  • Updated spectral response function database to optimize computational time (PR469).

  • ⚠️ The mycena molecular absorption database is renamed mycena_v1. The mycena database identifier is an alias to mycena_v2 (PR473).

  • ⚠️ The file download lists available from the eradiate data fetch command have been updated (PR473): 3 lists (mycena, mycena_v1 and mycena_v2) are now available (PR473).

  • The missing index files for monochromatic databases have been added to the stable data store and the file download lists (PR477), hopefully preventing frequent database consistency issues.

Fixed

  • Fixed Gaussian SRF padding strategy (PR458).

  • Package metadata now explicitly mentions that supported Python is up to 3.12.

  • Fixed incorrect interpolation method in volume data textures (PR465).

  • The InterpolatedSpectrum constructor now raises if it detects NaN in the values it receives (PR467).

  • Fixed exception occurring when interpolating in a CKD absorption database that had species missing from the atmospheric profile (PR470).

  • Fixed the azimuth convention of MultiPixelDistantMeasure which was discarded after initialization, providing erroneous azimuth outputs (fa9208).

  • Fixed the scene_parameter() decorator, to which Mitsuba scene node lookup protocols were added (0b9cc5).

  • ⚠️ Duplicate measure IDs are no longer permitted (PR472).