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
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 10ccb876f345c81a756fc2785e667cec9f3381461f7792ef4d06b1755392654c |
|
MD5 | fb7e5fba73192f04a542482f49b7acf9 |
|
BLAKE2b-256 | 9e3ca3304f01bb20cde01c10f6732161d412a9747d2840300ac5b260b04dc460 |
File details
Details for the file SBCK-1.4.0-cp311-cp311-macosx_11_0_arm64.whl
.
File metadata
- Download URL: SBCK-1.4.0-cp311-cp311-macosx_11_0_arm64.whl
- Upload date:
- Size: 180.8 kB
- Tags: CPython 3.11, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 93b835dec44f65a1741562184e3f847d210fafa7a2c1d96192d1d119427f5fc6 |
|
MD5 | 3bdab98d065d159aac84610257143e0a |
|
BLAKE2b-256 | 79af70fc7968aa266c7e2d352c2cb3d908153cf59bee635c41ba5381b9d4ee92 |