.. image:: https://ci.appveyor.com/api/projects/status/h9ayx22cxyfwh5rh?svg=true :target: https://ci.appveyor.com/project/JoyMonteiro/climt :alt: Continuous Integration
.. image:: https://img.shields.io/codecov/c/github/climt/climt.svg :target: https://travis-ci.org/climt/climt :alt: Coverage
.. image:: https://readthedocs.org/projects/climt/badge/ :target: https://climt.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status
.. image:: ./docs/climt_logo.jpg :height: 512px :width: 512px :align: center
climt is a Toolkit for building Earth system models in Python. climt stands for Climate Modelling and Diagnostics Toolkit -- it is meant both for creating models and for generating diagnostics (radiative fluxes for an atmospheric column, for example). However, since it might eventually include model components for purposes other than climate modelling (local area models, large-eddy simulation), we prefer to keep the abbreviation un-expanded!
climt hopes to enable researchers to easily perform online analysis and make modifications to existing models by increasing the ease with which models can be understood and modified. It also enables educators to write accessible models that serve as an entry point for students into Earth system modeling, while also containing state-of-the-art components.
Initially climt contains only components for the atmosphere, and does not yet include a coupler. But there are plans to extend climt to a fully coupled Earth system model in the future. The toolkit is also written in such a way that it could enable the development of non-climate models (e.g. weather prediction, large-eddy simulation). To do so requires only that the prognostic and diagnostic schemes are wrapped into the correct Python-accessible interface.
climt builds on sympl, which provides the base classes and array and constants handling functionality. Thanks to sympl and Pint, climt is also a fully units aware model. It is useful to know how sympl works to use climt better. Read more about sympl_ at https://sympl.readthedocs.io.
climt can be installed directly from the python package index using pip.
pip install climt
should work on most systems. From version 0.9.2 onwards, this command will install binary wheels, eliminating the requirement of a compiler on your system.
Detailed instructions for Mac and Linux systems are available in the
DataArrayabstraction to build self describing model arrays.
If you use climt in your research, please cite the following paper documenting sympl_ and climt
This package was created with Cookiecutter and the
audreyr/cookiecutter-pypackage project template.
.. Cookiecutter: https://github.com/audreyr/cookiecutter
.. _sympl: https://github.com/mcgibbon/sympl
.. _Pint: https://pint.readthedocs.io
.. _xarray: http://xarray.pydata.org
.. _documentation: http://climt.readthedocs.io/en/latest/installation.html