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.