swmmio

v0.8.2 (2025/06/11)

Programmatic pre and post processing for EPA Stormwater Management Model (SWMM)

Introduction

swmmio is a Python tool for engineers and hydrologists who need to supercharge their ability to modify and analyze EPA SWMM models and results. Using a familiar Pandas interface, users can replace manual procesess that used to live in spreadsheets with scripts and automation.

The core swmmio.Model object provides accessors to related elements in the INP and RPT. For example, swmmio.Model.subcatchments provides a DataFrame (or GeoDataFrame) joining data from the [SUBCATCHMENTS] and [SUBAREAS] tables in the model.inp file and, if available, the Subcatchment Runoff Summary from the model.rpt file.

Additionally, swmmio provides a lower-level API for reading and writing (almost) all of the sections of the model.inp file which is useful for programmatically modifying EPA SWMM models.

Installation

pip install swmmio

For documentation and tutorials, see our documentation.