Abstract
Python has become an essential programming language for scientific computing and data analysis and processing. Various multiple-point statistics (MPS) algorithms are used to characterize complex heterogeneous structures and phenomena in earth sciences. However, there is currently no Python library that integrates mainstream MPS methods for simulation and computation in geosciences. Aiming to establish a stable MPS tool, we developed an open-source Python library of commonly used MPS methods, named pyMPSLib. pyMPSLib consists of ENESIM, SNESIM, and DS algorithms and provides a flexible and convenient API interface. To ensure the maintainability of pyMPSLib, the Python objects and toolkits of MPS algorithms are defined and implemented. To improve the compatibility and extensibility of the presented library, uniform coding standard is adopted in pyMPSLib. We performed the parameter sensitivity analysis under multiple configurations to validate the performance of the library. This open-source library also provides optional tools to quantitatively evaluate the realizations of the integrated MPS methods.
Similar content being viewed by others
Data and code availability
All data used in this study and the source code of pyMPSLib are available on GitHub at https://github.com/GS-3DMG/pyMPSLib.
References
Arpat GB (2005) Sequential simulation with patterns. Stanford University. https://doi.org/10.1016/j.chb.2015.02.010
Azamifard A, Ahmadi M, Rashidi F, Pourfard M, Dabir B (2020) Insights of new-generation reservoir property modeling (MPS methods) in assessing the reservoir performance for different recovery methods. Arab J Geosci 13(7):1–14. https://doi.org/10.1007/s12517-020-05293-y
Caers J, Journel AG (1998) Stochastic reservoir simulation using neural networks trained on outcrop data. SPE Annual Technical Conference and Exhibition. Soc Pet Eng. https://doi.org/10.2118/49026-MS
Caers J (2001) Geostatistical reservoir modelling using statistical pattern recognition. J Petrol Sci Eng 29(3–4):177–188. https://doi.org/10.1016/S0920-4105(01)00088-2
Chen Q, Mariethoz G, Liu G, Comunian A, Ma X (2018) Locality-based 3-D multiple-point statistics reconstruction using 2-D geological cross sections. Hydrol Earth Syst Sci 22(12):6547–6566. https://doi.org/10.5194/hess-22-6547-2018
Chen Q, Liu G, Ma X, Zhang J, Zhang X (2019) Conditional multiple-point geostatistical simulation for unevenly distributed sample data. Stoch Env Res Risk Assess 33(4):973–987. https://doi.org/10.1007/s00477-019-01671-5
Chen Q, Liu G, Ma X, Li X, He Z (2020) 3D stochastic modeling framework for quaternary sediments using multiple-point statistics: a case study in Minjiang Estuary area, southeast China. Comput Geosci 136:104404. https://doi.org/10.1016/j.cageo.2019.104404
Comunian A, Renard P, Straubhaar J (2012) 3D multiple-point statistics simulation using 2D training images. Comput Geosci 40:49–65. https://doi.org/10.1016/j.cageo.2011.07.009
Cui Z, Chen Q, Liu G, Ma X, Que X (2021a) Multiple-point geostatistical simulation based on conditional conduction probability. Stoch Env Res Risk Assess 35(7):1355–1368. https://doi.org/10.1007/s00477-020-01944-4
Cui Z, Chen Q, Liu G, Mariethoz G, Ma X (2021b) Hybrid parallel framework for multiple-point geostatistics on Tianhe-2: A robust solution for large-scale simulation. Comput Geosci 157:104923. https://doi.org/10.1016/j.cageo.2021.104923
Deutsch CV, Journel AG (1992) Geostatistical software library and user’s guide. N Y 119:147
De Vries LM, Carrera J, Falivene O, Gratacós O, Slooten LJ (2009) Application of multiple point geostatistics to non-stationary images. Math Geosci 41(1):29–42. https://doi.org/10.1007/s11004-008-9188-y
Gravey M, Mariethoz G (2020) QuickSampling v1.0: a robust and simplified pixel-based multiple-point simulation approach. Geosci Model Dev 13:2611–2630. https://doi.org/10.5194/gmd-13-2611-2020
Guardiano FB, Srivastava RM (1993) Multivariate geostatistics: beyond bivariate moments. In: Soares A (ed) Geostatistics Tróia ’92. Springer Netherlands, Dordrecht, pp 133–144. https://doi.org/10.1007/978-94-011-1739-5_12
Hansen TM, Vu LT, Bach T (2016) MPSLIB: A C++ class for sequential simulation of multiple-point statistical models. SoftwareX 5:127–133. https://doi.org/10.1016/j.softx.2016.07.001
Jha SK, Mariethoz G, Evans JP, McCabe MF (2013) Demonstration of a geostatistical approach to physically consistent downscaling of climate modeling simulations. Water Resour Res 49(1):245–259. https://doi.org/10.1029/2012WR012602
Journel AG (1993) Geostatistics: roadblocks and challenges. In: Soares A (ed), Geostatistics Tróia ’92. Springer Netherlands, Dordrecht, pp 213–224. https://doi.org/10.1007/978-94-011-1739-5_18
Kessler TC, Comunian A, Oriani F et al (2013) Modeling fine-scale geological heterogeneity-examples of sand lenses in tills. Ground Water 51(5):692–705. https://doi.org/10.1111/j.1745-6584.2012.01015.x
Lemenkova P (2020) Python libraries matplotlib, seaborn and pandas for visualization geo-spatial datasets generated by QGIS. Analele stiintifice ale Universitatii" Alexandru Ioan Cuza" din Iasi-seria Geografie 64(1):13–32.
Mariethoz G, Renard P, Straubhaar J (2010) The direct sampling method to perform multiple‐point geostatistical simulations. Water Resour Res 46(11). https://doi.org/10.1029/2008WR007621
Pirot G, Straubhaar J, Renard P (2015) A pseudo genetic model of coarse braided-river deposits. Water Resour Res 51(12):9595–9611. https://doi.org/10.1002/2015WR017078
Straubhaar J, Renard P, Mariethoz G, Froidevaux R, Besson O (2011) An improved parallel multiple-point algorithm using a list approach. Math Geosci 43(3):305–328. https://doi.org/10.1007/s11004-011-9328-7
Strebelle SB (2002) Conditional simulation of complex geological structures using multiple-point statistics. Math Geol 34(1):1–21. https://doi.org/10.1023/A:1014009426274
Strebelle SB, Journel AG (2011) Reservoir modeling using multiple-point statistics. SPE Annual Technical Conference and Exhibition. Soc Pet Eng. https://doi.org/10.2118/71324-MS
Strebelle SB (2015). SNESIM URL https://github.com/SCRFpublic/snesim-standalone
Tahmasebi P, Sahimi M (2012) Reconstruction of three-dimensional porous media using a single thin section. Physical Review E 85(6):066709. https://doi.org/10.1103/PhysRevE.85.066709
Wang L, Yin Y, Zhang C, Feng W, Li G, Chen Q, Chen M (2022) A MPS-based novel method of reconstructing 3D reservoir models from 2D images using seismic constraints. J Pet Sci Eng 209:109974. https://doi.org/10.1016/j.petrol.2021.109974
Zambelli P, Gebbert S, Ciolli M (2013) Pygrass: An object oriented python application programming interface (API) for geographic resources analysis support system (GRASS) geographic information system (GIS). ISPRS Int J Geo Inf 2(1):201–219. https://doi.org/10.3390/ijgi2010201
Zhang T, Switzer P, Journel A (2006) Filter-based classification of training image patterns for spatial simulation. Math Geol 38(1):63–80. https://doi.org/10.1007/s11004-005-9004-x
Zhou K, Zhang N (2018) Extraction of alteration mineral information from moderate remote sensing images using MPS method. J Ind Soc Remote Sensing 46(1):89–96. https://doi.org/10.1007/s12524-017-0668-8
Acknowledgements
The authors would like to thank the reviewers and the editor for the constructive feedback and the insightful comments on the manuscript which greatly improved the work.
Funding
This work is supported by the National Natural Science Foundation of China (42172333, 41902304, U1711267) and the Knowledge Innovation Program of Wuhan-Shuguang Project (2022010801020206).
Author information
Authors and Affiliations
Contributions
All authors contributed to the study conception and design. Material preparation, data collection and analysis were performed by Qiyu Chen, Ruihong Zhou, Cui Liu, Qianhong Huang. The first draft of the manuscript was written by Qiyu Chen. All authors read and approved the final manuscript.
Corresponding author
Ethics declarations
Competing interests
The authors declare no competing interests.
Additional information
Communicated by: Xiang Que
Publisher's note
Springer Nature remains neutral with regard to jurisdictional claims in published maps and institutional affiliations.
Rights and permissions
Springer Nature or its licensor (e.g. a society or other partner) holds exclusive rights to this article under a publishing agreement with the author(s) or other rightsholder(s); author self-archiving of the accepted manuscript version of this article is solely governed by the terms of such publishing agreement and applicable law.
About this article
Cite this article
Chen, Q., Zhou, R., Liu, C. et al. pyMPSLib: A robust and scalable open-source Python library for mutiple-point statistical simulation. Earth Sci Inform 16, 3179–3190 (2023). https://doi.org/10.1007/s12145-023-01086-5
Received:
Accepted:
Published:
Issue Date:
DOI: https://doi.org/10.1007/s12145-023-01086-5