Skip to main content

Statistical Bias Correction Kit

Project description

SBCK (Statistical Bias Correction Kit)

Features

  • python3 and R version
  • c++ independent files for Sparse Histogram
  • Implement classic methods of bias correction (see [8,9] for the definition of bias correction)
  • Quantile Mapping [5,7,14], parametric and non parametric version
  • CDFt methods [6]
  • OTC and dOTC methods [9]
  • R2D2 method [11]
  • MBCn method [4]
  • QDM method [3]
  • MRec method [1]
  • ECBC method [12]
  • TSMBC method [15], for autocorrelations.

How to select a bias correction method ?

This summary of ability of each method to perform a bias correction is proposed by François, (2020). Please refer to this article for further interpretation.

Characteristics CDF-t R2D2 dOTC MBCn MRec
Correction of univariate dist. prop. Yes Yes Yes Yes Yes
Modification of correlations of the model No Yes Yes Yes Yes
Capacity to correct inter-var. prop. No Yes Yes Yes Yes
Capacity to correct spatial prop. No Yes Yes ~ ~
Capacity to correct temporal prop. No No No No No
Preserve the rank structure of the model Yes ~ ~ ~ ~
Capacity to correct small geographical area n.a. Yes Yes Yes Yes
Capacity to correct large geographical area n.a. ~ ~ ~ No
Allow for change of the multi-dim. prop. Yes No Yes ~ Yes

Python instruction

Requires:

  • python3
  • Eigen
  • numpy
  • scipy
  • pybind11

You can install from pypi:

pip3 install SBCK

Or from sources:

git clone https://github.com/yrobink/SBCK-python.git
cd SBCK
pip3 install .

If the Eigen library is not found, use:

pip3 install . eigen="path-to-eigen"

Acknowledgements

Thanks to [Trevor James Smith] for his help with the publication on pypi.

License

Copyright(c) 2021 / 2023 Yoann Robin

This file is part of SBCK.

SBCK is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

SBCK is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with SBCK. If not, see https://www.gnu.org/licenses/.

References

  • [1] Bárdossy, A. and Pegram, G.: Multiscale spatial recorrelation of RCM precipitation to produce unbiased climate change scenarios over large areas and small, Water Resources Research, 48, 9502–, https://doi.org/10.1029/2011WR011524, 2012.
  • [2] Bazaraa, M. S., Jarvis, J. J., and Sherali, H. D.: Linear Programming and Network Flows, 4th edn., John Wiley & Sons, 2009.
  • [3] Cannon, A. J., Sobie, S. R., and Murdock, T. Q.: Bias correction of simulated precipitation by quantile mapping: how well do methods preserve relative changes in quantiles and extremes?, J. Climate, 28, 6938–6959, https://doi.org/10.1175/JCLI-D-14-00754.1, 2015.
  • [4] Cannon, Alex J.: Multivariate quantile mapping bias correction: an N-dimensional probability density function transform for climate model simulations of multiple variables, Climate Dynamics, nb. 1, vol. 50, p. 31-49, 10.1007/s00382-017-3580-6, 2018.
  • [5] Déqué, M.: Frequency of precipitation and temperature extremes over France in an anthropogenic scenario: Model results and statistical correction according to observed values, Global Planet. Change, 57, 16–26, https://doi.org/10.1016/j.gloplacha.2006.11.030, 2007.
  • [6] Michelangeli, P.-A., Vrac, M., and Loukos, H.: Probabilistic downscaling approaches: Application to wind cumulative distribution functions, Geophys. Res. Lett., 36, L11708, https://doi.org/10.1029/2009GL038401, 2009.
  • [7] Panofsky, H. A. and Brier, G. W.: Some applications of statistics to meteorology, Mineral Industries Extension Services, College of Mineral Industries, Pennsylvania State University, 103 pp., 1958.
  • [8] Piani, C., Weedon, G., Best, M., Gomes, S., Viterbo, P., Hagemann, S., and Haerter, J.: Statistical bias correction of global simulated daily precipitation and temperature for the application of hydrological models, J. Hydrol., 395, 199–215, https://doi.org/10.1016/j.jhydrol.2010.10.024, 2010.
  • [9] Robin, Y., Vrac, M., Naveau, P., Yiou, P.: Multivariate stochastic bias corrections with optimal transport, Hydrol. Earth Syst. Sci., 23, 773–786, 2019, https://doi.org/10.5194/hess-23-773-2019
  • [10] Sinkhorn Distances: Lightspeed Computation of Optimal Transportation Distances. arXiv, https://arxiv.org/abs/1306.0895
  • [11] Vrac, M.: Multivariate bias adjustment of high-dimensional climate simulations: the Rank Resampling for Distributions and Dependences (R2 D2 ) bias correction, Hydrol. Earth Syst. Sci., 22, 3175–3196, https://doi.org/10.5194/hess-22-3175-2018, 2018.
  • [12] Vrac, M. and P. Friederichs, 2015: Multivariate—Intervariable, Spatial, and Temporal—Bias Correction. J. Climate, 28, 218–237, https://doi.org/10.1175/JCLI-D-14-00059.1
  • [13] Wasserstein, L. N. (1969). Markov processes over denumerable products of spaces describing large systems of automata. Problems of Information Transmission, 5(3), 47-52.
  • [14] Wood, A. W., Leung, L. R., Sridhar, V., and Lettenmaier, D. P.: Hydrologic Implications of Dynamical and Statistical Approaches to Downscaling Climate Model Outputs, Clim. Change, 62, 189–216, https://doi.org/10.1023/B:CLIM.0000013685.99609.9e, 2004.
  • [15] Robin, Y. and Vrac, M.: Is time a variable like the others in multivariate statistical downscaling and bias correction?, Earth Syst. Dynam. Discuss. [preprint], https://doi.org/10.5194/esd-2021-12, in review, 2021.
  • François, B., Vrac, M., Cannon, A., Robin, Y., and Allard, D.: Multivariate bias corrections of climate simulations: Which benefits for which losses?, Earth Syst. Dyn., 11, 537–562, https://doi.org/10.5194/esd-11-537-2020, https://esd.copernicus.org/articles/11/537/2020/, 2020.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

SBCK-1.4.0.tar.gz (58.9 kB view details)

Uploaded Source

Built Distribution

SBCK-1.4.0-cp311-cp311-macosx_11_0_arm64.whl (180.8 kB view details)

Uploaded CPython 3.11 macOS 11.0+ ARM64

File details

Details for the file SBCK-1.4.0.tar.gz.

File metadata

  • Download URL: SBCK-1.4.0.tar.gz
  • Upload date:
  • Size: 58.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for SBCK-1.4.0.tar.gz
Algorithm Hash digest
SHA256 10ccb876f345c81a756fc2785e667cec9f3381461f7792ef4d06b1755392654c
MD5 fb7e5fba73192f04a542482f49b7acf9
BLAKE2b-256 9e3ca3304f01bb20cde01c10f6732161d412a9747d2840300ac5b260b04dc460

See more details on using hashes here.

File details

Details for the file SBCK-1.4.0-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for SBCK-1.4.0-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 93b835dec44f65a1741562184e3f847d210fafa7a2c1d96192d1d119427f5fc6
MD5 3bdab98d065d159aac84610257143e0a
BLAKE2b-256 79af70fc7968aa266c7e2d352c2cb3d908153cf59bee635c41ba5381b9d4ee92

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page