PyCoSMoS: An advanced toolbox for simulating real-world hydroclimatic data

Simulation models are a fundamental tool for investigating hydrological processes and for water resource management. In this study, we introduce PyCoSMoS, a Python toolbox that enables researchers to simulate observed univariate time series mimicking hydroclimatic processes. This toolbox preserves arbitrary marginal distribution and autocorrelation functions, while significantly reducing computational burden. PyCoSMoS is built upon the mixed-Uniform CoSMoS method recently proposed by Papalexiou et al. (2023). The toolbox is designed to minimize the user’s input, requiring only observed time series, marginal distribution, correlation function, and the number of lags. The output provides both visual and quantitative comparisons between the observed and simulated time series. We evaluate the performance of the package using various synthetic case studies and the results demonstrate satisfactory accuracy. Furthermore, we apply the toolbox to three real case studies: precipitation, temperature, and relative humidity, for which the toolbox can successfully simulate the observed time series in each case.