diff --git a/README.md b/README.md index b094347..8793317 100644 --- a/README.md +++ b/README.md @@ -4,22 +4,11 @@ The python package designed to help confront earth system models with reference data products, and then present the results in a hierarchical set of webpages. Please see [ilamb.org](https://www.ilamb.org) where we have details about the datasets we use, the results we catalog, and the methods we employ. -## v2.7 Release - June 2023 +## v2.7.2 Release - September 2024 -* Release of the International Ocean Model Benchmarking (IOMB) configuration. For more details see this [post](https://www.ilamb.org/2023/06/24/IOMB-Release.html). -* Assets used in a virtual hackathon for watershed analysis, organized by the ESS Cyberinfrastructure Model-Data Integration Working Group. For more details, see this [post](https://www.ilamb.org/2023/04/27/Watersheds.html) or these hosted [results](https://www.ilamb.org/~nate/ILAMB-Watersheds/). This includes capabilities to read raw E3SM output, even over smaller regions as well as point models. -* We have implemented an alternative scoring methodology for bias and RMSE which is based on regional quantiles of error across a selection of CMIP5 and CMIP6 models. The main idea is to normalize errors by a regional value which constitutes a poor error with respect to what earth system models have produce in the last generations of models. To use, set the `--df_errs database.parquet` option in `ilamb-run` and point to this pandas [database](https://github.com/rubisco-sfa/ILAMB/blob/master/src/ILAMB/data/quantiles_Whittaker_cmip5v6.parquet) or create your own. This interactive [plot](https://www.climatemodeling.org/~nate/score_comparison_CMIP.html) shows how this changes our understanding of performance of CMIP5 to CMIP6. In the future this will become the default scoring methodology. -* Added many [datasets](https://www.ilamb.org/datasets.html) for use in ILAMB, also available via our [intake](https://github.com/nocollier/intake-ilamb) catalog. These include: - * Biological Nitrogen Fixation from Davies-Barnard - * Gross Primary Productivity, Sensible and Latent Heat from WECANN (Water, Energy, and Carbon with Artificial Neural Networks) - * Latent, Sensible, and Ground Heat Flux, Runoff, Precipitation and Net Radiation from CLASS (Conserving Land-Atmosphere Synthesis Suite) - * Biomass from ESACCI (European Space Agency, Biomass Climate Change Initiative) and XuSaatchi2021 - * Surface Soil Moisture from WangMao - * Growing Season Net Carbon Flux from Loechli - * Methane from Fluxnet -* In particular for biomass comparisons, where the measured quantity can be in total or carbon units and represent the above ground portion or total biomass, we have added a `scale_factor` to the configure language which can apply any factor to the reference data. -* ILAMB regions may now also be defined by shapefile, of particular use when comparing results over watersheds. -* Many bugfixes and visual tweaks. +This update contains many bugfixes found while supporting papers and other model-data comparison work in the community. You may sense that the development of ILAMB has slowed down. Code development at *this* repository has slowed, but ILAMB continues to change. Many datasets are being added to our comparisons but that activity happens in a different repository (see [ILAMB-Data](https://github.com/rubisco-sfa/ILAMB-Data)). + +We have also been developing a rewrite of the ILAMB software which leverages more modern analysis packages, in particular xarray. The new ILAMB version also is meant to address a shift in how scientists work. Originally ILAMB was envisioned as a replacement for diagnostics packages that modeling centers run. However in the past 10 years, it has become more common for scientists to run small analyses in notebooks as part of their model development process. This new version of ILAMB will find a balance between the operational diagnostic package and the ability to import functionality for creative uses. At the moment, we are developing this as a separate package we call [ilamb3](https://github.com/rubisco-sfa/ilamb3). Check it out along with its accompanying [documentation](https://ilamb3.readthedocs.io/en/latest/). ## Funding diff --git a/setup.py b/setup.py index 31e9b2c..0b86583 100644 --- a/setup.py +++ b/setup.py @@ -5,7 +5,7 @@ from setuptools import setup -VERSION = "2.7" +VERSION = "2.7.2" def git_version(): diff --git a/src/ILAMB/__init__.py b/src/ILAMB/__init__.py index 469bd18..6a13b0c 100644 --- a/src/ILAMB/__init__.py +++ b/src/ILAMB/__init__.py @@ -1,3 +1,3 @@ __author__ = "Nathan Collier" -__date__ = "June 2022" -__version__ = "2.7" +__date__ = "Sept 2024" +__version__ = "2.7.2"