PYSIMDEUM

pysimdeum is a Python package for modelling and simulating residential stochastic water demand and discharge at the end-use level.

Main functionalities:

• Build and populate houses with users and water end-use devices according to region (e.g. country, city, state) specific statistics
• Simulate water usage and demand stochastically based on the statistics
• The results are stored as xarray.DataArray, so all the simulation information can be accessed and aggregated afterwards (e.g., specific end-uses, sums over water usage of users, rolling means over time, ...)
• Serialisation: pysimdeum supports different output formats (e.g., csv, excel, netcdf, ...)
• Plotting results using matplotlib

A summary of the consumption and discharge patterns for all possible enduses in pysimdeum are shown below:

Default output is based on statistics about household sizes and water use of the Netherlands. These can be changed either within the code or by creating the correct toml files. An overview of worldwide differences is available in:

Mazzoni, F., Alvisi, S., Blokker, E. J. M., Buchberger, S. G., Castelletti, A., Cominola, A., Gross, M. P., Jacobs, H. E., Mayer, P., Steffelbauer, D. B., Stewart, R. A., Stillwell, A. S., Tzatchkov, V., Yamanaka, V. H. A. and Franchini, M. (2022). "Investigating the characteristics of residential end uses of water: a worldwide review." Water Research, art. no. 119500, doi:https://www.sciencedirect.com/science/article/abs/pii/S0043135422014452