xscen

A climate change scenario-building analysis framework, built with Intake-esm catalogs and xarray-based packages such as xclim and xESMF.
https://github.com/Ouranosinc/xscen

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

Keywords from Contributors

archiving climate-science anuclim climate-analysis icclim netcdf4 xclim hydrology earth-system-model climate

Last synced: about 12 hours ago
JSON representation

Repository metadata

A climate change scenario-building analysis framework.

README.rst

          ============
xscen |logo|
============

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

A climate change scenario-building analysis framework, built with `intake-esm` catalogs and `xarray`-based packages such as `xclim` and `xESMF`.

For documentation concerning `xscen`, see: https://xscen.readthedocs.io/en/latest/

Features
--------
* Supports workflows with YAML configuration files for better transparency, reproducibility, and long-term backups.
* `intake-esm`_-based catalog to find and manage climate data.
* Climate dataset extraction, subsetting, and temporal aggregation.
* Calculate missing variables through `intake-esm`'s `DerivedVariableRegistry`_.
* Regridding powered by `xESMF`_.
* Bias adjustment tools provided by `xsdba`_.

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

Please refer to the `installation docs`_.

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

.. _Cookiecutter: https://github.com/cookiecutter/cookiecutter
.. _DerivedVariableRegistry: https://intake-esm.readthedocs.io/en/latest/how-to/define-and-use-derived-variable-registry.html
.. _Ouranosinc/cookiecutter-pypackage: https://github.com/Ouranosinc/cookiecutter-pypackage
.. _installation docs: https://xscen.readthedocs.io/en/latest/installation.html
.. _intake-esm: https://intake-esm.readthedocs.io/
.. _xESMF: https://xesmf.readthedocs.io/
.. _xclim: https://xclim.readthedocs.io/
.. _xsdba: https://xsdba.readthedocs.io/

.. |build| image:: https://github.com/Ouranosinc/xscen/actions/workflows/main.yml/badge.svg
        :target: https://github.com/Ouranosinc/xscen/actions/workflows/main.yml
        :alt: Build Status

.. |conda| image:: https://img.shields.io/conda/vn/conda-forge/xscen.svg
        :target: https://anaconda.org/conda-forge/xscen
        :alt: Conda Build

.. |coveralls| image:: https://coveralls.io/repos/github/Ouranosinc/xscen/badge.svg
        :target: https://coveralls.io/github/Ouranosinc/xscen
        :alt: Coveralls

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

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

.. |license| image:: https://img.shields.io/pypi/l/figanos
        :target: https://github.com/Ouranosinc/figanos/blob/main/LICENSE
        :alt: License

.. |logo| image:: https://raw.githubusercontent.com/Ouranosinc/xscen/main/docs/_static/_images/xscen-logo-small.png
        :target: https://github.com/Ouranosinc/xscen
        :alt: xscen Logo

.. |ossf-bp| image:: https://bestpractices.coreinfrastructure.org/projects/9945/badge
        :target: https://bestpractices.coreinfrastructure.org/projects/9945
        :alt: Open Source Security Foundation Best Practices

.. |ossf-score| image:: https://api.securityscorecards.dev/projects/github.com/Ouranosinc/xscen/badge
        :target: https://securityscorecards.dev/viewer/?uri=github.com/Ouranosinc/xscen
        :alt: Open Source Security Foundation Scorecard

.. |pre-commit| image:: https://results.pre-commit.ci/badge/github/Ouranosinc/xscen/main.svg
        :target: https://results.pre-commit.ci/latest/github/Ouranosinc/xscen/main
        :alt: pre-commit.ci status

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

.. |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

.. |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.

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

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

        

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit and templated with cookiecutter.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: "1.2.0"
title: "xscen"
message: >-
  If you use this software, please cite it using the
  metadata from this file.
type: "software"
authors:
  - given-names: "Gabriel"
    family-names: "Rondeau-Genesse"
    affiliation: "Ouranos"
    city: "Montreal"
    country: "CA"
    email: 'rondeau-genesse.gabriel@ouranos.ca'
    orcid: "https://orcid.org/0000-0003-3389-9406"
  - given-names: "Pascal"
    family-names: "Bourgault"
    affiliation: "Ouranos"
    city: "Montreal"
    country: "CA"
    email: 'bourgault.pascal@ouranos.ca'
    orcid: "https://orcid.org/0000-0003-1192-0403"
  - given-names: "Juliette"
    family-names: "Lavoie"
    affiliation: "Ouranos"
    city: "Montreal"
    country: "CA"
    orcid: "https://orcid.org/0000-0002-4708-5182"
  - given-names: "Trevor James"
    family-names: "Smith"
    affiliation: "Ouranos"
    city: "Montreal"
    country: "CA"
    email: 'smith.trevorj@ouranos.ca'
    orcid: "https://orcid.org/0000-0001-5393-8359"
  - given-names: "Sarah"
    family-names: "Gammon"
    affiliation: "Ouranos"
    city: "Montreal"
    country: "CA"
    email: 'gammon.sarah@ouranos.ca'
    orcid: "https://orcid.org/0009-0007-6082-9063"
  - given-names: "Travis"
    family-names: "Logan"
    affiliation: "Ouranos"
    city: "Montreal"
    country: "CA"
    email: 'logan.travis@ouranos.ca'
    orcid: "https://orcid.org/0000-0002-2212-9580"
  - given-names: "Louis-Philippe"
    family-names: "Caron"
    affiliation: "Ouranos"
    city: "Montreal"
    country: "CA"
    email: 'caron.louis-philippe@ouranos.ca'
    orcid: "https://orcid.org/0000-0001-5221-0147"
  - given-names: "Marco"
    family-names: "Braun"
    affiliation: "Ouranos"
    city: "Montreal"
    country: "CA"
    email: 'braun.marco@ouranos.ca'
    orcid: "https://orcid.org/0000-0001-5061-3217"
  - given-names: "Sarah-Claude"
    family-names: "Bourdeau-Goulet"
    affiliation: "Ouranos"
    city: "Montreal"
    country: "CA"
    email: 'bourdeau-goulet.sarah-claude@ouranos.ca'
    orcid: "https://orcid.org/0000-0002-6125-2557"
  - given-names: "Blaise"
    family-names: "Gauvin St-Denis"
    affiliation: "Ouranos"
    city: "Montreal"
    country: "CA"
    email: 'gauvin-st-denis.blaise@ouranos.ca'
    orcid: "https://orcid.org/0009-0004-9049-2092"
  - given-names: "Éric"
    family-names: "Dupuis"
    affiliation: "Ouranos"
    city: "Montreal"
    country: "CA"
    email: 'dupuis.eric@ouranos.ca'
    orcid: "https://orcid.org/0000-0001-7976-4596"
  - given-names: "Artem"
    family-names: "Buyalo"
    affiliation: "Ouranos"
    city: "Montreal"
    country: "CA"
    orcid: "https://orcid.org/0009-0006-3403-6636"
contact:
  - given-names: "Gabriel"
    family-names: "Rondeau-Genesse"
    affiliation: "Ouranos"
    city: "Montreal"
    country: "CA"
    email: 'rondeau-genesse.gabriel@ouranos.ca'
    orcid: "https://orcid.org/0000-0003-3389-9406"
repository-code: "https://github.com/Ouranosinc/xscen"
abstract: "A climate change scenario-building analysis framework, built with xclim/xarray."
license: "Apache-2.0"
version: "0.13.1"

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 5 days ago

Total Commits: 2,616
Total Committers: 16
Avg Commits per committer: 163.5
Development Distribution Score (DDS): 0.753

Commits in past year: 541
Committers in past year: 11
Avg Commits per committer in past year: 49.182
Development Distribution Score (DDS) in past year: 0.701

Name Email Commits
RondeauG r****l@o****a 645
Zeitsperre 1****e 525
juliettelavoie j****e@h****a 501
Pascal Bourgault b****l@o****a 359
bumpversion[bot] b****]@o****a 160
pre-commit-ci[bot] 6****] 113
dependabot[bot] 4****] 100
Éric Dupuis e****1@u****a 76
Marco Braun B****o@o****a 71
Sarah-Claude Bourdeau 8****e 23
SarahG-579462 g****h@o****a 19
Pascal Bourgault b****l@o****a 9
Rondeau-Genesse g****1@o****a 6
Eric Dupuis e****s@d****a 4
ArtemBuyalo a****o@m****a 3
Blaise Gauvin St-Denis s****e@o****a 2

Committer domains:


Issue and Pull Request metadata

Last synced: 13 days ago

Total issues: 106
Total pull requests: 670
Average time to close issues: 3 months
Average time to close pull requests: 5 days
Total issue authors: 14
Total pull request authors: 13
Average comments per issue: 1.74
Average comments per pull request: 0.93
Merged pull request: 538
Bot issues: 6
Bot pull requests: 276

Past year issues: 18
Past year pull requests: 258
Past year average time to close issues: 6 days
Past year average time to close pull requests: 5 days
Past year issue authors: 6
Past year pull request authors: 9
Past year average comments per issue: 1.72
Past year average comments per pull request: 0.92
Past year merged pull request: 168
Past year bot issues: 1
Past year bot pull requests: 112

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/Ouranosinc/xscen

Top Issue Authors

  • RondeauG (37)
  • juliettelavoie (24)
  • aulemahal (17)
  • Zeitsperre (6)
  • SarahG-579462 (6)
  • github-actions[bot] (5)
  • coxipi (2)
  • mccrayc (2)
  • sarahclaude (2)
  • vindelico (1)
  • sg2475962 (1)
  • dependabot[bot] (1)
  • lou-a (1)
  • bstdenis (1)

Top Pull Request Authors

  • dependabot[bot] (230)
  • RondeauG (110)
  • Zeitsperre (106)
  • aulemahal (85)
  • juliettelavoie (61)
  • pre-commit-ci[bot] (46)
  • coxipi (17)
  • vindelico (5)
  • SarahG-579462 (5)
  • bstdenis (2)
  • ArtemBuyalo (1)
  • sarahclaude (1)
  • sg2475962 (1)

Top Issue Labels

  • enhancement (43)
  • bug (31)
  • documentation (8)
  • CI (5)
  • help wanted (3)
  • wontfix (2)
  • good first issue (1)
  • dependencies (1)
  • github_actions (1)

Top Pull Request Labels

  • dependencies (240)
  • CI (130)
  • python (115)
  • github_actions (114)
  • docs (35)
  • documentation (18)
  • bug (11)
  • enhancement (11)
  • xclim (1)

Package metadata

proxy.golang.org: github.com/Ouranosinc/xscen

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/Ouranosinc/xscen#section-documentation
  • Licenses: apache-2.0
  • Latest release: v0.13.1 (published 13 days ago)
  • Last Synced: 2025-10-29T20:52:36.831Z (5 days ago)
  • Versions: 22
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.395%
    • Average: 5.576%
    • Dependent repos count: 5.758%
proxy.golang.org: github.com/ouranosinc/xscen

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/ouranosinc/xscen#section-documentation
  • Licenses: apache-2.0
  • Latest release: v0.13.1 (published 13 days ago)
  • Last Synced: 2025-10-29T20:52:42.976Z (5 days ago)
  • Versions: 22
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.395%
    • Average: 5.576%
    • Dependent repos count: 5.758%
pypi.org: xscen

A climate change scenario-building analysis framework, built with xclim/xarray.

  • Homepage: https://xscen.readthedocs.io/
  • Documentation: https://xscen.readthedocs.io/
  • Licenses: apache-2.0
  • Latest release: 0.13.1 (published 13 days ago)
  • Last Synced: 2025-10-29T20:52:41.136Z (5 days ago)
  • Versions: 18
  • Dependent Packages: 1
  • Dependent Repositories: 1
  • Downloads: 2,476 Last month
  • Rankings:
    • Dependent packages count: 4.798%
    • Stargazers count: 16.055%
    • Average: 19.464%
    • Dependent repos count: 21.526%
    • Forks count: 22.633%
    • Downloads: 32.31%
  • Maintainers (3)

Dependencies

.github/workflows/bump-version.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • ad-m/github-push-action master composite
.github/workflows/codeql-analysis.yml actions
  • actions/checkout v3 composite
  • github/codeql-action/analyze v1 composite
  • github/codeql-action/autobuild v1 composite
  • github/codeql-action/init v1 composite
.github/workflows/conda-build.yml actions
  • actions/checkout v3 composite
  • haya14busa/action-cond v1 composite
  • mamba-org/provision-with-micromamba main composite
  • uibcdf/action-build-and-upload-conda-packages v1.2.0 composite
.github/workflows/first_pull_request.yml actions
  • actions/github-script v6 composite
.github/workflows/label.yml actions
  • actions/labeler v4 composite
.github/workflows/main.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • mamba-org/setup-micromamba v1 composite
  • styfle/cancel-workflow-action 0.11.0 composite
.github/workflows/publish-pypi.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • pypa/gh-action-pypi-publish release/v1 composite
.github/workflows/remove-obsolete-cache.yml actions
  • actions/checkout v3 composite
.github/workflows/tag-testpypi.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • pypa/gh-action-pypi-publish release/v1 composite
setup.py pypi
.github/workflows/actions-versions-updater.yml actions
  • actions/checkout v4.1.1 composite
  • saadmk11/github-actions-version-updater v0.8.1 composite
pyproject.toml pypi
  • babel *
  • cartopy *
  • cf_xarray >=0.7.6
  • cftime *
  • clisops >=0.10
  • dask *
  • flox *
  • fsspec <2023.10.0
  • geopandas *
  • h5netcdf *
  • h5py *
  • intake-esm >=2023.07.07
  • matplotlib *
  • netCDF4 *
  • numpy *
  • pandas >=2.0
  • parse *
  • pyarrow *
  • pyyaml *
  • rechunker *
  • shapely >=2.0
  • sparse *
  • toolz *
  • xarray <2023.11.0
  • xclim >=0.46.0
  • xesmf >=0.7
  • zarr *
environment.yml conda
  • babel
  • cartopy
  • cf_xarray >=0.7.6
  • cftime
  • clisops >=0.10
  • dask
  • flox
  • fsspec <2023.10.0
  • geopandas
  • h5netcdf
  • h5py
  • intake-esm >=2023.07.07
  • matplotlib
  • nc-time-axis >=1.3.1
  • netcdf4
  • numpy
  • pandas >=2.0
  • parse
  • pip
  • pyarrow >=1.0.0
  • python >=3.9
  • pyyaml
  • rechunker
  • shapely >=2.0
  • sparse
  • toolz
  • xarray <2023.11.0
  • xclim >=0.46.0
  • xesmf >=0.7
  • zarr

Score: 14.747888789291254