Skip to main content

The International Land Model Benchmarking Package

Project description

It has been a while since our last release, but ILAMB continues to evolve. Many of the changes are ‘under the hood’ or bugfixes that are not readily seen. In the following, we present a few key changes and draw attention in particular to those that will change scores. We also have worked to make ILAMB ready to integrate with tools being developed as part of the Coordinated Model Evaluation Capabilities (CMEC).

Changes - May 2021

CMEC

  • Added CMEC-compliant JSON output to the standard outputs

  • Added an alternative landing page for ILAMB results which uses the LMT Unified Dashboard

  • Added support files for using cmec-driver as an alternative run environment

Quality of Life

  • Top page overhaul moving to a single result panel with a colorblind friendly palette

  • Shifted score colormaps to be more qualitative and colorblind friendly

  • ILAMB now has continuous integration testing using Azure Pipelines on each commit or pull request

  • ModelResults can be passed a list of paths to search for results, objects are cached as pickle files

  • Plotting limits are now based on the middle 98% across all models to help reduce the effect of a single model with extreme values washing out all the map plots

  • The configure file used to generate a run is now copied into the output directory as ilamb.cfg

  • ILAMB logfiles will now provide an estimate for peak memory usage in each confrontation which can be used in debugging and when running on large clusters with limited memory

Scoring

  • For scoring coupled models, we find that scoring the RMSE of the annual cycle is more reasonable. While the default is still set to score the full time series, this may be changed at runtime with –rmse_score_basis {series|cycle}

  • We have found that when comparing a set of models which contain a multimodel mean, the mean model’s interannual variability is typically lower which serendipitously better matches that of our reference data products. This makes the multimodel mean look even better relative to individual models but not for good reasons. We have disabled the interannual variability in our scoring.

  • We have updated a number of reference datasets to their most current version as well as many new datasets and comparions, run ilamb-fetch to update

  • Support for using observational uncertainty in scoring, currently disabled

Useful Information

  • Documentation - installation and basic usage tutorials

  • Sample Output

    • ILAMB - land comparison against a collection of CMIP5 and CMIP6 models

    • IOMB - ocean comparison against a collection of CMIP5 and CMIP6 models

  • Paper published in JAMES which details the design and methodology employed in the ILAMB package. If you find the package or the output helpful in your research or development efforts, we kindly ask you to cite this work.

Description

The International Land Model Benchmarking (ILAMB) project is a model-data intercomparison and integration project designed to improve the performance of land models and, in parallel, improve the design of new measurement campaigns to reduce uncertainties associated with key land surface processes. Building upon past model evaluation studies, the goals of ILAMB are to:

  • develop internationally accepted benchmarks for land model performance, promote the use of these benchmarks by the international community for model intercomparison,

  • strengthen linkages between experimental, remote sensing, and climate modeling communities in the design of new model tests and new measurement programs, and

  • support the design and development of a new, open source, benchmarking software system for use by the international community.

It is the last of these goals to which this repository is concerned. We have developed a python-based generic benchmarking system, initially focused on assessing land model performance.

Funding

This research was performed for the Reducing Uncertainties in Biogeochemical Interactions through Synthesis and Computation (RUBISCO) Scientific Focus Area, which is sponsored by the Regional and Global Climate Modeling (RGCM) Program in the Climate and Environmental Sciences Division (CESD) of the Biological and Environmental Research (BER) Program in the U.S. Department of Energy Office of Science.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ILAMB-2.6.tar.gz (160.4 kB view details)

Uploaded Source

Built Distribution

ILAMB-2.6-py3-none-any.whl (176.6 kB view details)

Uploaded Python 3

File details

Details for the file ILAMB-2.6.tar.gz.

File metadata

  • Download URL: ILAMB-2.6.tar.gz
  • Upload date:
  • Size: 160.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.8.6

File hashes

Hashes for ILAMB-2.6.tar.gz
Algorithm Hash digest
SHA256 4363afb2ca9299917e2a31827b1563d0408e8cd736e2188e84bdd3b72d22ecb0
MD5 d9d1081cba87df38f5884673335946bf
BLAKE2b-256 0f9818b782fd8528290d740972ae37b944a7c08bfc0049b2ed383e5eb91506a2

See more details on using hashes here.

File details

Details for the file ILAMB-2.6-py3-none-any.whl.

File metadata

  • Download URL: ILAMB-2.6-py3-none-any.whl
  • Upload date:
  • Size: 176.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.8.6

File hashes

Hashes for ILAMB-2.6-py3-none-any.whl
Algorithm Hash digest
SHA256 ead5f517e447b16122cf9819666da5ad976995b3674a28aa335055c7f476887c
MD5 7f780ddda3e74b92256a7b321a6011f3
BLAKE2b-256 538a06a3b02ece5a0928e6c43e188c3d75d5a582e5d1d71bfd503ef277f80952

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page