==============
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 </user-guide/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-12-3085-2019
   * - :doc:`Cost-benefit analysis </user-guide/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 </user-guide/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 </user-guide/climada_entity_Exposures_polygons_lines>` *or* `Open Street Map exposures <https://climada-petals.readthedocs.io/en/latest/user-guide/climada_exposures_openstreetmap.html>`_
     - Mühlhofer, E., et al. (2024): OpenStreetMap for Multi-Faceted Climate Risk Assessments : Environ. Res. Commun. 6 015005, https://doi.org/10.1088/2515-7620/ad15ab
   * - :doc:`LitPop exposures </user-guide/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
   * - :doc:`Impact function calibration </user-guide/climada_util_calibrate>`
     - Riedel, L., et al. (2024): A Module for Calibrating Impact Functions in the Climate Risk Modeling Platform CLIMADA. Journal of Open Source Software, 9(99), 6755, https://doi.org/10.21105/joss.06755
   * - `GloFAS River Flood Module <https://climada-petals.readthedocs.io/en/latest/user-guide/climada_hazard_glofas_rf.html>`_
     - Riedel, L. et al. (2024): Fluvial flood inundation and socio-economic impact model based on open data, Geosci. Model Dev., 17, 5291–5308, https://doi.org/10.5194/gmd-17-5291-2024

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.