==============
Citation Guide
==============

If you use CLIMADA for your work, please cite the appropriate publications.
A list of all CLIMADA code related articles is available on `Zotero <https://www.zotero.org/groups/2502787/climada_open/collections/WZN2U7EK>`_ and can be downloaded as single Bibtex file: :download:`climada_publications.bib`


Publications by Module
----------------------

If you use specific tools and modules of CLIMADA, please cite the appropriate publications presenting these modules according to the following table:

.. list-table::
   :widths: 1 3
   :header-rows: 1

   * - Module or tool used
     - Publication to cite
   * - *Any*
     - The `Zenodo archive <https://doi.org/10.5281/zenodo.4598943>`_ of the CLIMADA version you are using
   * - :doc:`Impact calculations </tutorial/climada_engine_Impact>`
     - Aznar-Siguan, G. and Bresch, D. N. (2019): CLIMADA v1: A global weather and climate risk assessment platform, Geosci. Model Dev., 12, 3085–3097, https://doi.org/10.5194/gmd-14-351-2021
   * - :doc:`Cost-benefit analysis </tutorial/climada_engine_CostBenefit>`
     - Bresch, D. N. and Aznar-Siguan, G. (2021): CLIMADA v1.4.1: Towards a globally consistent adaptation options appraisal tool, Geosci. Model Dev., 14, 351–363, https://doi.org/10.5194/gmd-14-351-2021
   * - :doc:`Uncertainty and sensitivity analysis </tutorial/climada_engine_unsequa>`
     - Kropf, C. M. et al. (2022): Uncertainty and sensitivity analysis for probabilistic weather and climate-risk modelling: an implementation in CLIMADA v.3.1.0. Geosci. Model Dev. 15, 7177–7201, https://doi.org/10.5194/gmd-15-7177-2022
   * - :doc:`Lines and polygons exposures </tutorial/climada_entity_Exposures_polygons_lines>` *or* `Open Street Map exposures <https://climada-petals.readthedocs.io/en/latest/tutorial/climada_exposures_openstreetmap.html>`_
     - Mühlhofer, E., et al. (2023): OpenStreetMap for Multi-Faceted Climate Risk Assessments https://eartharxiv.org/repository/view/5615/
   * - :doc:`LitPop exposures </tutorial/climada_entity_LitPop>`
     - Eberenz, S., et al. (2020): Asset exposure data for global physical risk assessment. Earth System Science Data 12, 817–833, https://doi.org/10.3929/ethz-b-000409595

Please find the code to reprocduce selected CLIMADA-related scientific publications in our `repository of scientific publications <https://github.com/CLIMADA-project/climada_papers>`_.

Links and Logo
--------------

In presentations or other graphical material, as well as in reports etc., where applicable, please add the following logo: :download:`climada_logo_QR.png <https://github.com/CLIMADA-project/climada_python/blob/main/doc/guide/img/CLIMADA_logo_QR.png?raw=true>`:

.. image:: https://github.com/CLIMADA-project/climada_python/blob/main/doc/guide/img/CLIMADA_logo_QR.png?raw=true

As key link, please use https://wcr.ethz.ch/research/climada.html, as it provides a brief introduction especially for those not familiar with GitHub.