Skip to content

Releases: ecmwf-projects/ibicus

v1.1.1

07 Mar 18:36
Compare
Choose a tag to compare

Bugfix: Fixed behaviour of nonparametric quantile mapping: 1) attrs validator would disallow initializing quantile mapping with mapping_type = "nonparametric" and the distribution parameter set to None and 2) the CDF concatenation for quantile mapping was in the wrong direction.

Full Changelog: v1.1.0...v1.1.1

v1.1.0

05 Jan 15:15
Compare
Choose a tag to compare

Improvements:

  • Added a common running window mode for all debiasers through the RunningWindowDebiaser class that inherits from Debiaser class.
  • Some fixes on the existing running window implementation in ISIMIP and other methods which only allowed for data to start on Jan-01 and end on Dec-31 (#21).
  • Improved documentation and added instructions for implementing a new bias adjustment method using ibicus in the tutorial notebook ‘04 - Parallelization and Advanced Topics’. This follows reviewer comments to Spuler et al. 2023.
  • Added new option mapping_type to QuantileMapping for users to apply QM based on nonparametric CDFs (“empirical quantile mapping”).

Full Changelog: v1.0.4...v1.1.0

v1.0.4

13 Nov 17:32
Compare
Choose a tag to compare

Bugfix: Fixed behaviour of _unpack_df_of_numpy_arraysthat would previously lead to not all locations being shown in boxplots in the ibicus.marginal module.

Full Changelog: v1.0.3...v1.0.4

v1.0.3

24 Sep 15:54
Compare
Choose a tag to compare

Improvements: some changes in warnings generated by the package (warnings.warn --> logger.warning as many warnings are non-avoidable by user interventions). Improved robustness of ISIMIP step 6 by defaulting to nonparametric quantile mapping should the parametric CDF fit fail with an error (necessitated due to some changes in the behaviour of scipy).

Full Changelog: v1.0.2...v1.0.3

v1.0.2

22 Sep 15:09
Compare
Choose a tag to compare

Smaller bugfix: changed the behaviour of ISIMIP when not enough future climate model values or pseudo-future observations exist for a stable parametric CDF fit. In this case apply a non-parametric mapping.

Full Changelog: v1.0.1...v1.0.2

v1.0.1

25 Apr 09:41
Compare
Choose a tag to compare

First stable release of ibicus: v1.0.1

Meta

Changes include improvements in code robustness, as well as new features and syntax simplifications. There has also been a substantial review of the documentation.

ibicus.debias

Debiaser.apply

  • parallel option is now stable.
  • verbosity argument has been removed. Instead warnings relevant for the user are generated with the warnings.warning interface and logging is per default now done onto the library logger (“ibicus”) whose behavior can be controlled with the standard logging tools or set_verbosity_library_logger() in utils.
  • progressbar = True option has been added to activate and deactivate the progressbar.
  • failsafe option has been added to continue execution if an error is encountered at a location.
  • Seamless integration with dask as shown in a new notebook.

Debiasers:

  • DeltaChange: interface to initialize and apply debiaser now consistent with the other methods.
  • QuantileMapping, SDM & ECDFM: Added CDF thresholding and reduced the threshold in SDM.
  • CDFt: previously failed when there was no rain event in the running window, this has been fixed.
  • ISIMIP: previously inconsistent results for weibull and rice distribution (tasrange) in parallelization, this has been fixed.

ibicus.evaluate

Extension of the ThresholdMetrics class:

  • Thresholds can now be defined location-wise, with respect to certain months, seasons, days of year, and be initialized from quantiles in the observational period (for example a threshold defined as the 95th percentile of the season for this gridcell is now possible).

evaluate.marginal bias calculation:

  • Added option to calculate the absolute location-wise bias (in [physical unit] for statistics and [days / year] for threshold metrics), compared to previous default of percentage bias.

Visualizations in evaluate.marginal, evaluate.trend, evaluate.metrics and evaluate.multivariate

  • Plots that show distribution of biases across location improved - boxplots instead of violin plots, horizontal line at zero added and title fonts improved.
  • Bug in manual title setting corrected.
  • Outlier removal option removed from calculation function and added to plot function, serves the sole purpose of making plots more readable.
  • New visualization option for spatiotemporal clusters as empirical CDFs added, compared to the previous violin plots.
  • Spatial plots of conditional threshold exceedance added.

v0.1.dev3

12 Sep 18:10
Compare
Choose a tag to compare
v0.1.dev.3

Bump version for new build