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.
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)
benchcab is distributed under an Apache License v2.0.
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.