Changelog History

climpred v1.1 (2019-09-23)

Features

• Write information about skill computation to netcdf attributes(GH#213) Aaron Spring
• Temporal and spatial smoothing module (GH#224) Aaron Spring
• Add metrics brier_score, threshold_brier_score and crpss_es (GH#232) Aaron Spring
• Allow compute_hindcast and compute_perfect_model to specify which dimension dim to calculate metric over (GH#232) Aaron Spring

Bug Fixes

• Correct implementation of probabilistic metrics from xskillscore in compute_perfect_model, bootstrap_perfect_model, compute_hindcast and bootstrap_hindcast, now requires xskillscore>=0.05 (GH#232) Aaron Spring

Internals/Minor Fixes

• Rename .stats.DPP to dpp (GH#232) Aaron Spring
• Add matplotlib as a main dependency so that a direct pip installation works (GH#211) Riley X. Brady.
• climpred is now installable from conda-forge (GH#212) Riley X. Brady.
• Fix erroneous descriptions of sample datasets (GH#226) Riley X. Brady.
• Benchmarking time and peak memory of compute functions with asv (GH#231) Aaron Spring

Documentation

• Add scope of package to docs for clarity for users and developers. (GH#235) Riley X. Brady.

climpred v1.0.1 (2019-07-04)

Bug Fixes

• Accomodate for lead-zero within the lead dimension (GH#196) Riley X. Brady.
• Fix issue with adding uninitialized ensemble to HindcastEnsemble object (GH#199) Riley X. Brady.
• Allow max_dof keyword to be passed to compute_metric and compute_persistence for HindcastEnsemble (GH#199) Riley X. Brady.

Internals/Minor Fixes

• Force xskillscore version 0.0.4 or higher to avoid ImportError (GH#204) Riley X. Brady.
• Change max_dfs keyword to max_dof (GH#199) Riley X. Brady.
• Add testing for HindcastEnsemble and PerfectModelEnsemble (GH#199) Riley X. Brady

climpred v1.0.0 (2019-07-03)

climpred v1.0.0 represents the first stable release of the package. It includes HindcastEnsemble and PerfectModelEnsemble objects to perform analysis with. It offers a suite of deterministic and probabilistic metrics that are optimized to be run on single time series or grids of data (e.g., lat, lon, and depth). Currently, climpred only supports annual forecasts.

Features

• Bootstrap prediction skill based on resampling with replacement consistently in ReferenceEnsemble and PerfectModelEnsemble. (GH#128) Aaron Spring
• Consistent bootstrap function for climpred.stats functions via bootstrap_func wrapper. (GH#167) Aaron Spring
• many more metrics: _msss_murphy, _less and probabilistic _crps, _crpss (GH#128) Aaron Spring

Bug Fixes

• compute_uninitialized now trims input data to the same time window. (GH#193) Riley X. Brady
• rm_poly now properly interpolates/fills NaNs. (GH#192) Riley X. Brady

Internals/Minor Fixes

• The climpred version can be printed. (GH#195) Riley X. Brady
• Constants are made elegant and pushed to a separate module. (GH#184) Andrew Huang
• Checks are consolidated to their own module. (GH#173) Andrew Huang

Documentation

• Documentation built extensively in multiple PRs.

climpred v0.3 (2019-04-27)

climpred v0.3 really represents the entire development phase leading up to the version 1 release. This was done in collaboration between Riley X. Brady, Aaron Spring, and Andrew Huang. Future releases will have less additions.

Features

• Introduces object-oriented system to climpred, with classes ReferenceEnsemble and PerfectModelEnsemble. (GH#86) Riley X. Brady

• Expands bootstrapping module for perfect-module configurations. (GH#78, GH#87) Aaron Spring

• Adds functions for computing Relative Entropy (GH#73) Aaron Spring

• Sets more intelligible dimension expectations for climpred (GH#98, GH#105) Riley X. Brady and Aaron Spring:

  • init: initialization dates for the prediction ensemble
  • lead: retrospective forecasts from prediction ensemble; returned dimension for prediction calculations
  • time: time dimension for control runs, references, etc.
  • member: ensemble member dimension.

• Updates open_dataset to display available dataset names when no argument is passed. (GH#123) Riley X. Brady

• Change ReferenceEnsemble to HindcastEnsemble. (GH#124) Riley X. Brady

• Add probabilistic metrics to climpred. (GH#128) Aaron Spring

• Consolidate separate perfect-model and hindcast functions into singular functions. (GH#128) Aaron Spring

• Add option to pass proxy through to open_dataset for firewalled networks. (GH#138) Riley X. Brady

Bug Fixes

• xr_rm_poly can now operate on Datasets and with multiple variables. It also interpolates across NaNs in time series. (GH#94) Andrew Huang
• Travis CI, treon, and pytest all run for automated testing of new features. (GH#98, GH#105, GH#106) Riley X. Brady and Aaron Spring
• Clean up check_xarray decorators and make sure that they work. (GH#142) Andrew Huang
• Ensures that help() returns proper docstring even with decorators. (GH#149) Andrew Huang
• Fixes bootstrap so p values are correct. (GH#170) Aaron Spring

Internals/Minor Fixes

• Adds unit testing for all perfect-model comparisons. (GH#107) Aaron Spring
• Updates CESM-LE uninitialized ensemble sample data to have 34 members. (GH#113) Riley X. Brady
• Adds MPI-ESM hindcast, historical, and assimilation sample data. (GH#119) Aaron Spring
• Replaces check_xarray with a decorator for checking that input arguments are xarray objects. (GH#120) Andrew Huang
• Add custom exceptions for clearer error reporting. (GH#139) Riley X. Brady
• Remove “xr” prefix from stats module. (GH#144) Riley X. Brady
• Add codecoverage for testing. (GH#152) Riley X. Brady
• Update exception messages for more pretty error reporting. (GH#156) Andrew Huang
• Add pre-commit and flake8/black check in CI. (GH#163) Riley X. Brady
• Change loadutils module to tutorial and open_dataset to load_dataset. (GH#164) Riley X. Brady
• Remove predictability horizon function to revisit for v2. (GH#165) Riley X. Brady
• Increase code coverage through more testing. (GH#167) Aaron Spring
• Consolidates checks and constants into modules. (GH#173) Andrew Huang

climpred v0.2 (2019-01-11)

Name changed to climpred, developed enough for basic decadal prediction tasks on a perfect-model ensemble and reference-based ensemble.

climpred v0.1 (2018-12-20)

Collaboration between Riley Brady and Aaron Spring begins.