index-calculator 0.6.3

Python index-calculator is an xclim wrapperto calculate climate indices from CMORized netCDF files.

index_calculator

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

• Free software: MIT license

• Documentation: 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.

Installation

You can install the package directly with pip:

pip install index_calculator

If you want to contribute, I recommend cloning the repository and installing the package in development mode, e.g.

git clone https://github.com/ludwiglierhammer/index_calculator
cd index_calculator
pip install -e .

This will install the package but you can still edit it and you don’t need the package in your PYTHONPATH

Requirements

• python3.6 or higher

• numpy

• pandas

• xarray

• xclim

Contact

In cases of any problems, needs or wishes do not hesitate to contact:

[e-mail]

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

0.1.0 (2022-03-08)

• First release on PyPI.

0.2.0 (2022-07-07)

• documentation on readthedocs

• tests

• new cli arguments added

0.2.1 (2022-07-12)

• install data and tables via pip

0.3.0 (2022-07-19)

• new indices implemented

  • CD: number of cold and dry days

  • CHDYYx: Maximum number of consecutive heat days

  • CSDI: Cold spell duration index

  • CW: Number of cold and wet days

  • DTR: Mean of daily temperature range

  • GD: Number of growing degree days

  • GDYYx: Number of consecutive growing degree days

  • HD17: Number of heating degree days

  • PRCPTOT: Total precipitation amount

  • RDYYp: Number of wet days with precip over percentile

  • RYYpTOT: Precipitation fraction with precip over percentile

  • TG10p: Fraction of days with mean temperature under 10th percentile

  • TG90p: Fraction of days with mean temperature under 90th percentile

  • TX10p: Fraction of days with maximum temperature under 10th percentile

  • TX90p: Fraction of days with maximum temperature under 90th percentile

  • TN10p: Fraction of days with minimum temperature under 10th percentile

  • TN90p: Fraction of days with minimum temperature under 90th percentile

  • WD: Number of warm and dry days

  • WSDI: Warm spell duration index

  • WW: Number of warm and wet days

0.3.1 (2022-07-20)

• adjustments fro automatically project-specific outfile name generation

0.3.2 (2022-07-21)

• project-specific directory structure for cordex, cmip5 and cmip6

0.3.3 (2022-08-10)

• more documentation

• properties to classes

• classes automatically call functions

0.4.0 (2022-11-25)

• split output files into several files

• restructuring time encoding

• properties removed

0.5.0 (2023-01-04)

• new indices: * CSf (Number of cold spells) * HSf (Number of hot spells) * HSx (Maximum length of hot spells) * SD (Number od snow days) * SCD (Snow cover duration) * Sint (Snowfall intensity) * Sfreq (Snowfall freqeuncy) * UTCI (Universal Thermal Climate Index)

• add time bounds

• index-calculator version in DRS

0.5.1 (2023-01-23)

• add grid mapping if necessary

0.5.2 (2023-02-07)

• add input format and component information to index_calculation.pjson

0.5.3 (2023-02-13)

• new projects E-OBS and ERA5 included

0.5.4 (2023-02-15)

• new project HYRAS

• ignore time-dependent data variables other than input variable

0.5.5 (2023-02-16)

• new index (WI): number of winter days (tas<-10°C)

• use pyhomogenize>=0.2.9

• write time and time_bnds to float

0.5.6 (2023-02-22)

• time controlling to pyhomogenize

0.6.0 (2023-03-03)

• new indices: * HW: maximum length of heat waves * GSS: start of growing season * GSE: end of growing season * FFS: start of frost-free season * FFE: end of frost-free season * RRm: mean daily precipitation * RRYYp: precipitation percentile value

• rename RYYp to RYYpABS and RDYYP to RYYp according to ICCLIM

• optional argument perc woth percentile indicators

0.6.1 (2023-03-09)

• some metadata corrections

0.6.2 (2023-03-10)

• component name adjusments with HYRAS

0.6.3 (2023-03-13)

• take coordinate attributes from input dataset