index_calculator

Calculate climate indicators with standardized project-specific attributes.
https://github.com/climate-service-center/index_calculator

Category: Climate Change
Sub Category: Climate Data Processing and Analysis

Keywords

climate-analysis climate-science dask python xarray xclim

Keywords from Contributors

archiving observation transforms measur conversion optimize projection retry compose threads

Last synced: about 21 hours ago
JSON representation

Repository metadata

Calculate climate indicators based on xclim

• Host: GitHub
• URL: https://github.com/climate-service-center/index_calculator
• Owner: climate-service-center
• License: mit
• Created: 2022-03-08T08:13:53.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2025-04-14T17:34:28.000Z (13 days ago)
• Last Synced: 2025-04-18T23:17:12.444Z (9 days ago)
• Topics: climate-analysis, climate-science, dask, python, xarray, xclim
• Language: Jupyter Notebook
• Homepage: https://index-calculator.readthedocs.io
• Size: 113 MB
• Stars: 7
• Watchers: 3
• Forks: 6
• Open Issues: 12
• Releases: 36
• Metadata Files:
  • Readme: README.rst
  • Changelog: HISTORY.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE
  • Authors: AUTHORS.rst
  • Zenodo: .zenodo.json

README.rst

          ============================================================================================
Calculate climate indicators with standardized project-specific attributes: index_calculator
============================================================================================

+----------------------------+-----------------------------------------------------+
| Versions                   | |pypi| |versions|                                   |
+----------------------------+-----------------------------------------------------+
| Documentation and Support  | |docs|                                              |
+----------------------------+-----------------------------------------------------+
| Open Source                | |license| |zenodo|                                  |
+----------------------------+-----------------------------------------------------+
| Coding Standards           | |black| |ruff| |pre-commit| |security| |fossa|      |
+----------------------------+-----------------------------------------------------+
| Development Status         | |status| |build| |coveralls|                        |
+----------------------------+-----------------------------------------------------+

Python index_calculator is an xclim wrapper to calculate climate indicators from CMORized netCDF files.

Documentation
-------------
The official documentation is at https://index-calculator.readthedocs.io/

Features
--------
* Calculate climate indices via xclim_.
* Write standardized netCDF attributes.
* Write on disk with a project-specific output file name.

Available projects
------------------
You can calculate climate indicators using index_calculator with the projects listed in the table below.

+--------------------+--------------+
| CMIP               | CMIP5, CMIP6 |
+--------------------+--------------+
| CORDEX             | CORDEX       |
+--------------------+--------------+
| Observational data | E-OBS, HYRAS |
+--------------------+--------------+
| Reanalysis data    | ERA5         |
+--------------------+--------------+

Installation
------------

You can install the package directly with pip:

.. code-block:: console

     pip install index_calculator

If you want to contribute, we recommend cloning the repository, setup a conda environmant and installing the package in development mode, e.g.

.. code-block:: console

    git clone https://github.com/climate-service-center/index_calculator
    cd index_calculator
    conda env create -f ci/requirements/environment.yml
    conda activate xcalc-tests
    pip install -e . --no-deps

This will install the package but you can still edit it and you don't need the package in your :code:`PYTHONPATH`


Requirements
------------

* python3.6 or higher

* xclim

* numpy

* pandas

* xarray

* cf_xarray

* cftime

Credits
-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _xclim: https://xclim.readthedocs.io/en/latest/

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage

.. |pypi| image:: https://img.shields.io/pypi/v/index_calculator.svg
        :target: https://pypi.python.org/pypi/index_calculator
        :alt: Python Package Index Build

.. |docs| image:: https://readthedocs.org/projects/index_calculator/badge/?version=latest
        :target: https://index-calculator.readthedocs.io/en/latest/?version=latest
        :alt: Documentation Status

.. |versions| image:: https://img.shields.io/pypi/pyversions/index_calculator.svg
        :target: https://pypi.python.org/pypi/index_calculator
        :alt: Supported Python Versions

.. |license| image:: https://img.shields.io/github/license/ludwiglierhammer/index_calculator.svg
        :target: https://github.com/ludwiglierhammer/index_calculator/blob/master/LICENSE
        :alt: License

.. |black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
        :target: https://github.com/psf/black
        :alt: Python Black

.. |ruff| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
        :target: https://github.com/astral-sh/ruff
        :alt: Ruff

.. |pre-commit| image:: https://results.pre-commit.ci/badge/github/climate-service-center/index_calculator/main.svg
        :target: https://results.pre-commit.ci/latest/github/climate-service-center/index_calculator/main
        :alt: pre-commit.ci status

.. |fossa| image:: https://app.fossa.com/api/projects/git%2Bgithub.com%2Fludwiglierhammer%2Findex_calculator.svg?type=shield
        :target: https://app.fossa.com/projects/git%2Bgithub.com%2Fludwiglierhammer%2Findex_calculator?ref=badge_shield
        :alt: FOSSA

.. |security| image:: https://www.bestpractices.dev/projects/8143/badge
        :target: https://www.bestpractices.dev/projects/8143
        :alt: Open Source Security Foundation

.. |status| image:: https://www.repostatus.org/badges/latest/active.svg
        :target: https://www.repostatus.org/#active
        :alt: Project Status: Active – The project has reached a stable, usable state and is being actively developed.

.. |build| image:: https://github.com/ludwiglierhammer/index_calculator/actions/workflows/ci.yml/badge.svg
        :target: https://github.com/ludwiglierhammer/index_calculator/actions/workflows/ci.yml
        :alt: Build Status

.. |coveralls| image:: https://codecov.io/gh/ludwiglierhammer/index_calculator/branch/master/graph/badge.svg
	      :target: https://codecov.io/gh/ludwiglierhammer/index_calculator
	      :alt: Coveralls

.. |zenodo| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.7762679.svg
        :target: https://doi.org/10.5281/zenodo.7762679
        :alt:   DOI

        

---

Owner metadata

• Name: GERICS
• Login: climate-service-center
• Email:
• Kind: organization
• Description: Climate Service Center Germany
• Website: www.gerics.de
• Location: Germany
• Twitter: GERICS_Germany
• Company:
• Icon url: https://avatars.githubusercontent.com/u/154221270?v=4
• Repositories: 2
• Last ynced at: 2023-12-22T06:07:56.339Z
• Profile URL: https://github.com/climate-service-center

---

GitHub Events

Total

• Issues event: 1
• Watch event: 2
• Delete event: 13
• Issue comment event: 1
• Push event: 26
• Pull request event: 30
• Fork event: 1
• Create event: 13

Last Year

• Issues event: 1
• Watch event: 2
• Delete event: 13
• Issue comment event: 1
• Push event: 26
• Pull request event: 30
• Fork event: 1
• Create event: 13

---

Committers metadata

Last synced: 6 days ago

Name	Email	Commits
Ludwig.Lierhammer	l****r@h****e	402
pre-commit-ci[bot]	6****]	49
Lars Buntemeyer	l****r@g****m	48
Ludwig.Lierhammer	l****r@h****e	22
dependabot[bot]	4****]	10
SusannePfeifer007	1****7	7
Katharina Bülow	k****w@h****e	4
Sonali Manimaran	4****i	1
Katharina Bülow	g****7@l****e	1

Committer domains:

• hereon.de: 2
• levante5.lvt.dkrz.de: 1
• hzg.de: 1

---

Issue and Pull Request metadata

Last synced: 2 days ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/climate-service-center/index_calculator

---

---

---

Dependencies

Score: 5.14166355650266