Skip to content

Commit

Permalink
Version (#104)
Browse files Browse the repository at this point in the history
* release notes

* version bump
  • Loading branch information
nocollier authored Sep 9, 2024
1 parent 8a81b7b commit a16fa08
Show file tree
Hide file tree
Showing 3 changed files with 7 additions and 18 deletions.
19 changes: 4 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
2 changes: 1 addition & 1 deletion setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

from setuptools import setup

VERSION = "2.7"
VERSION = "2.7.2"


def git_version():
Expand Down
4 changes: 2 additions & 2 deletions src/ILAMB/__init__.py
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
__author__ = "Nathan Collier"
__date__ = "June 2022"
__version__ = "2.7"
__date__ = "Sept 2024"
__version__ = "2.7.2"

0 comments on commit a16fa08

Please sign in to comment.