Skip to content

About benchcab

benchcab is a testing framework that tests the CABLE land surface model across a range of model configurations and model versions. The tool:

  • checks out the model versions specified by the user
  • builds the required executables
  • runs each model version across N standard science configurations for a variety of meteorological forcings
  • performs bitwise comparison checks on model outputs across model versions

The user can then pipe the model outputs into a benchmark analysis via modelevaluation.org to assess model performance.

The full documentation is available at benchcab.readthedocs.io.

Supported configurations

benchcab currently tests the following model configurations for CABLE:

  • Flux site simulations (offline) - running CABLE forced with observed eddy covariance data at a single site
  • Global/regional simulations (offline) - running CABLE forced with meteorological fields over a region (global or regional)

License

benchcab is distributed under an Apache License v2.0.

Acknowledgements

benchcab is a continuation of the efforts made by Martin De Kauwe (@mdekauwe) and Gab Abramowitz (@gabsun) in developing a CABLE benchmarking framework - we thank them for their contribution.