/climada_python

Python (3.6+) version of CLIMADA

Primary LanguageJupyter NotebookGNU General Public License v3.0GPL-3.0

Build Status Documentation build status Jenkins Coverage

CLIMADA

CLIMADA stands for CLIMate ADAptation and is a probabilistic natural catastrophe impact model, that also calculates averted damage (benefit) thanks to adaptation measures of any kind (from grey to green infrastructure, behavioural, etc.).

This is the Python (3.6+) version of CLIMADA - please see https://github.com/davidnbresch/climada for backward compatibility (MATLAB).

Getting started

CLIMADA runs on Windows, macOS and Linux. Download the latest release. Install CLIMADA's dependencies specified in the downloaded file climada_python-x.y.z/requirements/env_climada.yml with conda. See the documentation for more information on installing.

Follow the tutorial climada_python-x.y.z/doc/tutorial/1_main_climada.ipynb in a Jupyter Notebook to see what can be done with CLIMADA and how.

Documentation

Documentation is available on Read the Docs:

Citing CLIMADA

If you use CLIMADA for academic work please cite:

Aznar-Siguan, G. and Bresch, D. N., 2019: CLIMADA v1: a global weather and climate risk assessment platform, Geosci. Model Dev. Discuss., https://doi.org/10.5194/gmd-12-3085-2019

Please see all CLIMADA's related scientific publications in our repository of scientific publications.

Contributing

To contribute follow these steps:

  1. Fork the project on GitHub (git clone https://github.com/CLIMADA-project/climada_python.git).
  2. Install the packages in climada_python/requirements/env_climada.yml and climada_python/requirements/env_developer.yml.
  3. Make well commented and clean commits to the repository. You can make a new branch here if you are modifying more than one part or feature.
  4. Make unit and integration tests on your code, preferably during development.
  5. Perform a static code analysis of your code with CLIMADA's configuration .pylintrc.
  6. Add your name to the AUTHORS file.
  7. Push the branch to GitHub (git push origin my-new-feature).
  8. On GitHub, create a new pull request from the feature branch.

See our contribution guidelines for more information.

Versioning

We use SemVer for versioning. For the versions available, see the releases on this repository.

License

Copyright (C) 2017 ETH Zurich, CLIMADA contributors listed in AUTHORS.

CLIMADA is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, version 3.

CLIMADA is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details:

https://www.gnu.org/licenses/lgpl.html