STNSRPM 0.0.5

🌎 Scripts and information to synthetic generation of precipitation based on Point Processes.

Repository supporting the STNSRPM (Spatio-Temporal Newman Scott Rectangular Pulse Model) for synthetic rainfall generation.

This repository contains the utilities for calibrating the STNSRPM and simulate synthetic rainfall series which mimic the observed rainfall statistics (mean, variance, skewness, proportion of dry/wet days, wet/dry transitions probabilities, temporal autocorrelation and spatial correlation) at different temporal aggregations (hourly and daily). The functionality presented here might be very useful to disaggregate rainfall series (from daily to hourly) or for extreme event analysis, among others.

The description of the STNSRPM can be found at doc.

Overview of STNSRPM: Paper in Environmental Modelling and Software (not available yet)
Others papers which make use of the STNSRPM: Paper in Water

Contents

Directory	Contents
NSRP	Python code for calibrate the NSRPM (Newman Scott Rectangular Pulse Model) and simulate synthetic rainfall series.
STNSRP	Python code for calibrate the STNSRPM (Spatio-Temporal Newman Scott Rectangular Pulse Model) and simulate multisite rainfall series (in progress).
dist	Model versions available at pypi.org for supporting "pip" installation.
doc	Description of the model.
notebooks	Jupyter notebooks with specific examples to calibrate, simulate and validate the STNSRPM.

References

The formal reference of STNSRPM is:

Diez-Sierra, J., del Desus, M., Navas, S. (2021). Repository supporting the STNSRPM for synthetic rainfall generation. Zenodo, DOI: XX.XXXX/zenodo.XXXXXXX. Available from: https://github.com/navass11/STNSRPM

Requirements

Scripts and (jupyter) notebooks are provided in python language to ensure reproducibility and reusability of the results. The simplest way to match all these requirements is by using a dedicated conda environment, which can be easily installed by issuing:

conda create -n STNSRPM pip jupyter
conda activate STNSRPM
pip install STNSRPM

Example of use

Examples of use of the STNSRPM are available in form of jupyter notebooks. To run the examples follow the following steps:

1. download the folder notebooks from the github repository.
2. open jupyter notebook (type jupyter notebook in the terminal)
3. open one the test available in the folder notebooks with jupyter notebook (e.g. NSRP_test.ipynb)

Errata and problem reporting

To report an issue with the problem please:

1. Make sure that the problem has not been reported yet. Check here.
2. Follow this GitHub issue template.