Sovereign 8s.is mirror of standardgalactic/austrian-climate-indicators
  • Python 99%
  • Shell 1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
slehner bd3c2bf44f
Some checks failed
Deploy GitHub Pages / build (push) Has been cancelled
Deploy GitHub Pages / deploy (push) Has been cancelled
DEV: improve colorrange for seasonal stampplots
2026-02-03 10:35:18 +00:00
.github/workflows DEP: remove csv from artifacts 2026-01-21 10:12:54 +01:00
doc DOC: update example plots with 2025 data 2026-02-02 09:17:17 +00:00
scripts DEV: setup fonts 2026-01-21 09:56:12 +01:00
src DEV: improve colorrange for seasonal stampplots 2026-02-03 10:35:18 +00:00
.gitignore initialise repo 2025-09-12 08:14:08 +00:00
config.toml Merge branch 'updates-for-final-release' of github.com:seblehner/austrian-climate-indicators into updates-for-final-release 2026-01-26 09:14:33 +00:00
pyproject.toml initialise repo 2025-09-12 08:14:08 +00:00
README.md STY: fancify badges 2026-01-26 16:16:17 +01:00
uv.lock initialise repo 2025-09-12 08:14:08 +00:00

High-resolution climate indicators for gridded climate data in Austria

GitHub Pages Zenodo data doi Python code style: black

This repository supplements the manuscript by Sebastian Lehner and Matthias Schlögl : Climate indicators for Austria since 1961 at 1 km resolution.

Note

In a nutshell:

  • A comprehensive toolkit to compute, aggregate, and visualize climate indicators for climate impact applications.
  • Built on xclim and xarray for index computation, with task automation via pytask.
  • Works out of the box with defaults for gridded climate data sets from Austria (SPARTACUS, WINFORE and SNOWGRID-CL), but can be configured for any dataset readable by xarray.

Input data sets

Default configs for the following meteorological variables and their corresponding data source are available:

Different datasets are untested and may require adaptations due to a different input data structure (e.g., variable naming, calendar, units, chunking).

Quick start

Important

This project leverages uv for package and project management.

  1. Clone the repository
  2. Install dependencies using uv (creates a local .venv):
    uv sync
    
  3. Adapt the configuration in config.toml.
  4. Run the workflow:
    uv run pytask
    
    or run individual steps manually.

Output validation

Tip

Run the validation task with uv run src/check_files.py

This performs the following checks:

  • Compare the actual output file counts in the output path versus the expected number depending on the years specified in the config.toml.
  • Test whether the minimum output file size exceeds a threshold of 100 KB.
  • Check for files that only contain NaN values.
  • Note: This does not validate data values in any other ways except for the blank NaN check.

Aggregation and evaluation

Tip

Run the aggregation and evaluation task: uv run src/climind_eval.py

This computes:

  1. Spatial averages;
  2. Climatological means for 1961–1990 and 1991–2020;
  3. Two-tailed Mann–Whitney U-tests for significant changes between the two climatological fields.

Outputs are stored in the directory specified in config.toml.

Automation

Important

This project leverages pytask for workflow management.

  • pytask is included in the environment and installed via uv.
  • Simply run uv run pytask to execute all automated tasks.
  • The pytask configuration can be adapted through the pyproject.toml file.
  • For parallel processing, either update the config file, or use uv run pytask -n NUM_WORKERS.
  • By default, pytask captures all stdout and stderr, which means that it will not properly be logged within the logfiles. To stream logs to console and log files (recommended), use the -s option, i.e. uv run pytask -s.

Configuration

Note

All configuration settings are controlled via config.toml.

Typical settings:

  • Input dataset location and variable names
  • Years or time range
  • Output directory
  • Specification of indicators to compute

To compute only selected indicators, use the abbreviations (as listed in the index column in doc/indices.csv) in the [CLIMATE_INDICES] section of config.toml. Default is IND_LIST = "all", which computes all indicators listed in doc/indices.csv.

Climate indicators

  • The list of all currently implemented indicators is available as doc/indices.csv
  • The list comprises Climdex, BIOCLIM and additional indices from xclim, as well as custom routines.

Visualisation

Visualizations use either the computed indicators or the aggregated/evaluated outputs. The following visualizations are implemented and can be explored in the showcase document:

  1. Time series of spatially averaged anomalies (annual/seasonal)
  2. Spatial maps of climatologies and their differences
  3. Stamp plots and anomaly stamp plots
  4. Grouped significant changes plots
  5. Grouped warming stripes
  6. Year-of-minimum/maximum per grid cell and histograms over time

Groupings for plots (4) and (5) are based on each indicator’s input parameters (details in the showcase).