Metadata-Version: 2.4
Name: xsdba
Version: 0.6.1
Summary: Statistical correction and bias adjustment tools for xarray.
Keywords: xsdba,bias adjustment,statistics,statistical downscaling,xarray,xclim
Author-email: Éric Dupuis <dupuis.eric@ouranos.ca>, Pascal Bourgault <bourgault.pascal@ouranos.ca>
Maintainer-email: Éric Dupuis <dupuis.eric@ouranos.ca>, Trevor James Smith <smith.trevorj@ouranos.ca>
Requires-Python: >=3.10.0
Description-Content-Type: text/x-rst
License-Expression: Apache-2.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Scientific/Engineering :: Mathematics
Classifier: Typing :: Typed
License-File: LICENSE
Requires-Dist: boltons >=20.1
Requires-Dist: bottleneck >=1.3.1
Requires-Dist: cf_xarray>=0.10.0
Requires-Dist: cftime >=1.4.1
Requires-Dist: dask[array] >=2024.8.1
Requires-Dist: filelock >=3.14.0
Requires-Dist: jsonpickle >=3.1.0
Requires-Dist: numba >=0.58.1
Requires-Dist: numpy >=1.26.0
Requires-Dist: packaging
Requires-Dist: pandas >=2.2.0
Requires-Dist: pint>=0.24.4
Requires-Dist: rich >=13.7.0
Requires-Dist: scipy >=1.11.0
Requires-Dist: statsmodels >=0.14.2
Requires-Dist: typer >=0.16.0
Requires-Dist: xarray >=2023.11.0
Requires-Dist: xsdba[dev] ; extra == "all"
Requires-Dist: xsdba[docs] ; extra == "all"
Requires-Dist: xsdba[extras] ; extra == "all"
Requires-Dist: xsdba[sbck] ; extra == "all"
Requires-Dist: bump-my-version >=1.2.3 ; extra == "dev"
Requires-Dist: codespell >=2.4.1 ; extra == "dev"
Requires-Dist: coverage >=7.5.0 ; extra == "dev"
Requires-Dist: deptry >=0.23.1 ; extra == "dev"
Requires-Dist: flake8 >=7.3.0 ; extra == "dev"
Requires-Dist: flake8-rst-docstrings >=0.4.0 ; extra == "dev"
Requires-Dist: flit >=3.11.0,<4.0 ; extra == "dev"
Requires-Dist: h5netcdf >=1.3.0 ; extra == "dev"
Requires-Dist: h5py >=3.12.1 ; extra == "dev"
Requires-Dist: mypy >=1.18.2 ; extra == "dev"
Requires-Dist: matplotlib >=3.6.0 ; extra == "dev"
Requires-Dist: numpydoc >=1.9.0 ; extra == "dev"
Requires-Dist: pip >=25.2 ; extra == "dev"
Requires-Dist: pooch >=1.8.0 ; extra == "dev"
Requires-Dist: pre-commit >=3.5.0 ; extra == "dev"
Requires-Dist: pytest >=9.0.0 ; extra == "dev"
Requires-Dist: pytest-cov >=5.0.0 ; extra == "dev"
Requires-Dist: pytest-xdist >=3.2.0 ; extra == "dev"
Requires-Dist: ruff >=0.15.4 ; extra == "dev"
Requires-Dist: tox >=4.30.3 ; extra == "dev"
Requires-Dist: vulture >=2.14 ; extra == "dev"
Requires-Dist: watchdog >=4.0.0 ; extra == "dev"
Requires-Dist: xdoctest >=1.1.5 ; extra == "dev"
Requires-Dist: yamllint >=1.35.1 ; extra == "dev"
Requires-Dist: furo >=2023.9.10 ; extra == "docs"
Requires-Dist: h5netcdf >=1.5.0 ; extra == "docs"
Requires-Dist: h5py >=3.12.1 ; extra == "docs"
Requires-Dist: ipykernel ; extra == "docs"
Requires-Dist: ipython >=8.5.0 ; extra == "docs"
Requires-Dist: jupyter_client ; extra == "docs"
Requires-Dist: matplotlib >=3.8.0 ; extra == "docs"
Requires-Dist: nbsphinx >=0.9.8 ; extra == "docs"
Requires-Dist: nc-time-axis >=1.4.1 ; extra == "docs"
Requires-Dist: pooch >=1.8.0 ; extra == "docs"
Requires-Dist: pygments ; extra == "docs"
Requires-Dist: sphinx >=8.2.2 ; extra == "docs"
Requires-Dist: sphinx-autobuild >=2024.4.16 ; extra == "docs"
Requires-Dist: sphinx-autodoc-typehints >=3.1.0 ; extra == "docs"
Requires-Dist: sphinx-codeautolink>=0.16.2 ; extra == "docs"
Requires-Dist: sphinx-copybutton ; extra == "docs"
Requires-Dist: sphinx-intl ; extra == "docs"
Requires-Dist: sphinx-mdinclude ; extra == "docs"
Requires-Dist: sphinxcontrib-bibtex ; extra == "docs"
Requires-Dist: fastnanquantile >=0.0.2 ; extra == "extras"
Requires-Dist: POT >=0.9.4 ; extra == "extras"
Requires-Dist: xclim >=0.56.0 ; extra == "extras"
Requires-Dist: sbck >=1.4.2 ; extra == "sbck"
Project-URL: About Ouranos, https://ouranos.ca/en/
Project-URL: Changelog, https://xsdba.readthedocs.io/en/stable/changelog.html
Project-URL: Homepage, https://xsdba.readthedocs.io/
Project-URL: Issue tracker, https://github.com/Ouranosinc/xsdba/issues
Project-URL: Source, https://github.com/Ouranosinc/xsdba
Provides-Extra: all
Provides-Extra: dev
Provides-Extra: docs
Provides-Extra: extras
Provides-Extra: sbck

===========================================================
xsdba: Statistical Downscaling and Bias Adjustment library
===========================================================

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

Statistical correction and bias adjustment tools for xarray.

* Free software: Apache Software License 2.0
* Documentation: https://xsdba.readthedocs.io.

Features
--------

* The `xsdba` submodule provides a collection of bias-adjustment methods meant to correct for systematic biases found in climate model simulations relative to observations.
  Almost all adjustment algorithms conform to the `train` - `adjust` scheme, meaning that adjustment factors are first estimated on training data sets, then applied in a distinct step to the data to be adjusted.
  Given a reference time series (`ref`), historical simulations (`hist`) and simulations to be adjusted (`sim`), any bias-adjustment method would be applied by first estimating the adjustment factors between the historical simulation and the observation series, and then applying these factors to `sim``, which could be a future simulation:

* Time grouping (months, day of year, season) can be done within bias adjustment methods.

* Properties and measures utilities can be used to assess the quality of adjustments.

Quick Install
-------------
`xsdba` can be installed from PyPI:

.. code-block:: shell

    $ pip install xsdba

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

How to make the most of `xsdba`: `Basic Usage Examples`_ and `In-Depth Examples`_.

`xsdba` was first developed as the submodule `sdba` of `xclim`_. A `migration guide`_  is available for users of `sdba`.

.. _Basic Usage Examples: https://xsdba.readthedocs.io/en/latest/notebooks/example.html
.. _In-Depth Examples: https://xsdba.readthedocs.io/en/latest/notebooks/advanced_example.html
.. _xclim: https://xclim.readthedocs.io/
.. _migration guide: https://xsdba.readthedocs.io/en/stable/xclim_migration_guide.html

Credits
-------

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

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

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

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

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

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

.. |license| image:: https://img.shields.io/github/license/Ouranosinc/xsdba.svg
        :target: https://github.com/Ouranosinc/xsdba/blob/main/LICENSE
        :alt: License

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

.. |ossf-score| image:: https://api.securityscorecards.dev/projects/github.com/Ouranosinc/xsdba/badge
        :target: https://securityscorecards.dev/viewer/?uri=github.com/Ouranosinc/xsdba
        :alt: OpenSSF Scorecard

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

.. |pypi| image:: https://img.shields.io/pypi/v/xsdba.svg
        :target: https://pypi.python.org/pypi/xsdba
        :alt: PyPI

.. |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/xsdba.svg
        :target: https://pypi.python.org/pypi/xsdba
        :alt: Supported Python Versions

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

.. |logo| image:: https://raw.githubusercontent.com/Ouranosinc/xsdba/main/docs/logos/xsdba-logo-small-light.png
        :target: https://github.com/Ouranosinc/xsdba
        :alt: Xsdba
        :class: xsdba-logo-small no-theme

.. |logo-light| image:: https://raw.githubusercontent.com/Ouranosinc/xsdba/main/docs/logos/xsdba-logo-small-light.png
        :target: https://github.com/Ouranosinc/xsdba
        :alt:
        :class: xclim-logo-small only-light-inline

.. |logo-dark| image:: https://raw.githubusercontent.com/Ouranosinc/xsdba/main/docs/logos/xsdba-logo-small-dark.png
        :target: https://github.com/Ouranosinc/xsdba
        :alt:
        :class: xclim-logo-small only-dark-inline

