Skip to main content

Python library for climate indices calculation

Project description

Build Status Python Package Index Build Python Black Documentation Status Conda-forge Build Version Code coverage D.O.I link

icclim is a Python library to compute climate indices. icclim name stands for index, calculation, climate.


From pypi: pip install icclim.

From conda-forge: conda install -c conda-forge icclim.

From sources:
  • Clone the repository git clone

  • Install icclim python -m setup install

How to use icclim

Let’s count the number of days above 25°C for each year, which corresponds to the index SU, from a tasmax variable scattered in multiple netcdf files.

SU is one of the many index that can be computed with icclim. See the documentation to explore what other index you can compute with icclim.

import icclim

summer_days =
    "netcdf_files/", out_file=""

For more examples on how to use icclim, see icclim’s How to … documentation or our notebooks.

Who use icclim

icclim is part of C4I platform backend and is integrated in CLIPC Portal. icclim is also used by some independent researchers.

Who made icclim

icclim has always been an open source project and was successfully made thanks to the joint effort of all its contributors. The lead development is made at CERFACS, a research institution located in Toulouse, France.


This open-source project has been possible thanks to funding by the European Commission projects:

  • FP7-CLIPC (2013-2016)

  • FP7-IS-ENES2 (2013-2017)

  • EUDAT2020 (2015-2018)

  • H2020-IS-ENES3 (2019-2023)

The beautiful icclim logo is a creation of Carole Petetin and has been funded by the H2020 IS-ENES3 project grant agreement No 824084 (2019-2023).


For a detailed description of each ECA&D index, please visit:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

icclim-6.2.0.tar.gz (174.0 kB view hashes)

Uploaded source

Built Distribution

icclim-6.2.0-py3-none-any.whl (102.2 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page