The Python package evaltools is designed to assess surface atmosphere composition prediction models with respect to in-situ observations. This package provides different tools to compute and plot model scores. It is used to evaluate air quality models from the Copernicus Atmosphere Monitoring Service (CAMS).
The concept of evaltools is to compare observations (measured over time at fixed lat/lon locations) with simulations (which may have a forecast horizon of several days) computed over a period of several days. It can therefore be used for other data types like AERONET data, but will not handle data with a vertical component.
Several python libraries are required to run evaltools. To install them, you can do
pip3 install -r requirements.txtOptionally, you can also install
pip3 install -r optional-requirements.txtwhich are dependencies needed for plotting maps or build the documentation.
The version numbers specified inside these two requirement files are the ones that have been used to test the library.
Then, go to the package directory and execute
pip3 install . --no-build-isolationOnline doc of the latest release on master branch is available at https://umr-cnrm.github.io/EvalTools
To compile html documentation, draw example charts with
make testand then compile the html documentation with
make docTo look at the documentation then open doc/_build/html/index.html with
a web navigator.
Copyright Météo France (2017 - )
This software is governed by the CeCILL-C license under French law and abiding by the rules of distribution of free software. You can use, modify and/ or redistribute the software under the terms of the CeCILL-C license as circulated by CEA, CNRS and INRIA at the following URL “http://www.cecill.info”.