Abstract

ABSTRACTThe stormwater management model SWMM of the US EPA is widely used to analyse, design or optimise urban drainage systems. To perform advanced analysis and visualisations of model data this technical note introduces the R package swmmr. It contains functions to read and write SWMM files, initiate simulations from the R console and to convert SWMM model files to and from GIS data. Additionally, model data can be transformed to produce high quality visualisations. In accordance with SWMM’s open source policy the package can be obtained through github.com or the Comprehensive R Archive Network (CRAN).

Highlights

  • Modelling urban drainage systems has become essential to develop and assess resilient urban stormwater management strategies

  • While the open source software facilitates basic analysis and visualisations of model data, advanced features such as time series data management, parameter uncertainty analysis or extended statistics are reserved to commercialised versions of SWMM, only

  • This becomes especially useful when dealing with large SWMM data using functions such as read_inp(), read_rpt() and read_lid_rpt() (Table 1) as the console output remains readable in case large data have been printed

Read more

Summary

Introduction

Modelling urban drainage systems has become essential to develop and assess resilient urban stormwater management strategies. While the open source software facilitates basic analysis and visualisations of model data, advanced features such as time series data management, parameter uncertainty analysis or extended statistics are reserved to commercialised versions of SWMM, only. In this respect, the free software environment for statistical computing and graphics R (R Core Team 2017) is frequently used by both scientists and engineers. Core functions of the package comprise fast reading and writing of SWMM files, conversion between GIS data and the SWMM input file format as well as model data transformation to produce expressive visualisation This technical note describes design principles of the swmmr package and exemplifies its usage. This includes a demonstration of how to produce high quality figures of model results and model structures enabled by further R packages

What is the package useful for?
Package design and core functions
Example usage
Setup and model execution
Analysis of model data
Visualisation with ggplot2 and mapview
Model calibration using DEoptim
Conclusions
Disclosure statement
Full Text
Published version (Free)

Talk to us

Join us for a 30 min session where you can share your feedback and ask us any queries you have

Schedule a call