Getting started with CLIMADA

This is a short summary of the guides to help you find the information that you need to get started. To learn more about CLIMADA, have a look at the introduction. You can also have a look at the paper repository to get an overview of research projects.


The first step to getting started is installing CLIMADA. To do so you will need: 1. To get the lastest release from the git repository CLIMADA releases or clone the project with git if you are interested in contributing to the development. 2. To build a conda environment with the dependencies needed by CLIMADA.

For details see the Installation Guide.

If you need to run a model on a computational cluster, have a look at this guide to install CLIMADA and run your jobs.

Programming in Python

It is best to have some basic knowledge of Python programming before starting with CLIMADA. But if you need a quick introduction or reminder, have a look at the short Python Tutorial. Also have a look at the python Python Dos and Don’t guide and at the Python Performance Guide for best practice tips.


A good way to start using CLIMADA is to have a look at the Tutorials. The Main Tutorial will introduce you the structure of CLIMADA and how to calculate you first impacts, as well as your first appraisal of adaptation options. You can then look at the specific tutorials for each module (for example if you are interested in a specific hazard, like Tropical Cyclones, or in learning to estimate the value of asset exposure,…).


If you would like to participate in the development of CLIMADA, carefully read the Git and Development Guide. Before making a new feature, discuss with one of the repository admins (Now Chahan, Emmanuel and David). Every new feature or enhancement should be done on a separate branch, which will be merged in the develop branch after being reviewed (see Checklist). Finally, the develop branch is merged in the main branch in each CLIMADA release. Each new feature should come with a tutorial and with Unit and Integration Tests.

Other Questions

If you have any other questions, you might find some information in the Miscellaneous guide. If you cannot find you answer in the guides, you can open an issue for somebody to help you.