aneris: Harmonization for Integrated Assessment Models 
======================================================

Release v\ |version|.

|pypi| |conda| |license| |latest|

|rtd| |travis| |coveralls|

|doi|

.. |pypi| image:: https://img.shields.io/pypi/v/aneris-iamc.svg
   :target: https://pypi.python.org/pypi/aneris-iamc/

.. |conda| image:: https://anaconda.org/conda-forge/aneris/badges/version.svg
   :target: https://anaconda.org/conda-forge/aneris

.. |license| image:: https://anaconda.org/conda-forge/aneris/badges/license.svg
   :target: https://anaconda.org/conda-forge/aneris

.. |latest| image:: https://anaconda.org/conda-forge/aneris/badges/latest_release_date.svg
   :target: https://anaconda.org/conda-forge/aneris

.. |rtd| image:: https://readthedocs.org/projects/aneris-iamc/badge/?version=latest
   :target: https://aneris-iamc.readthedocs.io/en/latest/?badge=latest
   :alt: Documentation Status

.. |travis| image:: https://travis-ci.org/iiasa/aneris.svg?branch=master
   :target: https://travis-ci.org/iiasa/aneris

.. |coveralls| image:: https://coveralls.io/repos/github/iiasa/aneris/badge.svg?branch=master
   :target: https://coveralls.io/github/iiasa/aneris?branch=master

.. |doi| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.802832.svg
   :target: https://doi.org/10.5281/zenodo.802832
   
The open-source Python package |aneris| :cite:`Gidden:2019:aneris` is a library
and Command Line Interface (CLI) for harmonization of IAM results with
historical data sources. Currently, emissions trajectories are supported.

Documentation
-------------

.. toctree::
   :maxdepth: 1

   install
   data

.. toctree::
   :maxdepth: 2

   design

.. toctree::
   :maxdepth: 1

   cli
   contribute
   api

Get in touch
------------

- Report bugs, suggest features or view the source code `on GitHub`_.
- For less well defined questions or ideas, use the `mailing list`_.

.. _mailing list: https://groups.google.com/forum/#!forum/aneris
.. _on GitHub: http://github.com/gidden/aneris

License
-------

aneris is available under the open source `Apache License`_.

.. _Apache LIcense: http://www.apache.org/licenses/LICENSE-2.0.html


Scientific reference
--------------------

.. bibliography:: _bib/index.bib
   :style: plain
   :all: