swmmio

Python tools for interacting with, editing, and visualizing EPA SWMM5 models.
https://github.com/pyswmm/swmmio

Category: Natural Resources
Sub Category: Water Supply and Quality

Keywords

civil-engineering hydraulic-modeling hydroinformatics python swmm5 watershed

Keywords from Contributors

stormwater hydrology hydrology-stormwater-analysis swmm hydraulics

Last synced: about 9 hours ago
JSON representation

Repository metadata

Python tools for interacting with, editing, and visualizing EPA SWMM5 models

README.md

swmmio

v0.8.2 (2025/06/11)

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

workflow status
Documentation Status

image

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.


Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 2 days ago

Total Commits: 621
Total Committers: 16
Avg Commits per committer: 38.813
Development Distribution Score (DDS): 0.121

Commits in past year: 6
Committers in past year: 2
Avg Commits per committer in past year: 3.0
Development Distribution Score (DDS) in past year: 0.167

Name Email Commits
Adam Erispaha a****a@g****m 546
Bryant E. McDonnell b****l@g****m 15
kaklise k****e@s****v 11
Jackie Fortin-Flefil j****f@u****u 8
Jenn Wu j****u@e****t 7
Abhiram Mullapudi a****m@u****u 7
BuczynskiRafal b****2@g****m 6
Bruce Rindahl b****l@g****m 5
everett e****r@g****m 3
dependabot[bot] 4****] 3
chuwenhao123 5****3 3
Assela Pathirana a****a@p****t 3
algchyhao 3****o 1
Stijn Van Hoey s****n@f****m 1
David Irwin d****n@s****m 1
Dobson b****n@i****k 1

Committer domains:


Issue and Pull Request metadata

Last synced: about 1 month ago

Total issues: 70
Total pull requests: 85
Average time to close issues: 6 months
Average time to close pull requests: about 1 month
Total issue authors: 26
Total pull request authors: 14
Average comments per issue: 1.46
Average comments per pull request: 0.98
Merged pull request: 70
Bot issues: 0
Bot pull requests: 7

Past year issues: 1
Past year pull requests: 9
Past year average time to close issues: N/A
Past year average time to close pull requests: about 9 hours
Past year issue authors: 1
Past year pull request authors: 4
Past year average comments per issue: 9.0
Past year average comments per pull request: 0.11
Past year merged pull request: 7
Past year bot issues: 0
Past year bot pull requests: 2

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/pyswmm/swmmio

Top Issue Authors

  • aerispaha (37)
  • bemcdonnell (5)
  • MortenGrum (3)
  • rhc123123 (3)
  • timebridge (1)
  • gcoyle83 (1)
  • xiang3874264 (1)
  • jackieff (1)
  • tyjchen (1)
  • dirwin5 (1)
  • BuczynskiRafal (1)
  • chuwenhao123 (1)
  • bowguy (1)
  • wraseman (1)
  • jennwuu (1)

Top Pull Request Authors

  • aerispaha (44)
  • bowguy (8)
  • dependabot[bot] (7)
  • jackieff (7)
  • bemcdonnell (4)
  • BuczynskiRafal (3)
  • barneydobson (2)
  • dirwin5 (2)
  • everettsp (2)
  • wraseman (2)
  • simancas-es (1)
  • algchyhao (1)
  • stijnvanhoey (1)
  • kaklise (1)

Top Issue Labels

  • enhancement (20)
  • bug (17)
  • complete (3)
  • documentation (3)

Top Pull Request Labels

  • dependencies (7)
  • enhancement (6)
  • bug (2)
  • python (2)
  • complete (1)

Dependencies

docs/requirements.txt pypi
  • Sphinx ==3.2.1
  • commonmark ==0.9.1
  • recommonmark ==0.6.0
  • sphinx-rtd-theme ==0.5.0
  • sphinxcontrib-applehelp ==1.0.2
  • sphinxcontrib-devhelp ==1.0.2
  • sphinxcontrib-htmlhelp ==1.0.3
  • sphinxcontrib-jsmath ==1.0.1
  • sphinxcontrib-qthelp ==1.0.3
  • sphinxcontrib-serializinghtml ==1.1.4
requirements.txt pypi
  • geojson ==2.5.0
  • m2r *
  • mistune ==0.8.4
  • networkx >=2.4
  • numpy >=1.16.4
  • pandas >=0.24.2
  • pillow >=6.2.0
  • pyproj >=3.0.0
  • pyshp ==2.1.0
  • pytest *
  • pyyaml >=3.12
  • recommonmark *
setup.py pypi
  • Pillow >=6.2.0
  • geojson >=2.4.1
  • networkx >=2.4
  • numpy >=1.16.4
  • pandas >=0.24.2
  • pyshp ==2.1.0
  • pyyaml >=3.12
.github/workflows/python-app.yml actions
  • actions/checkout v3 composite
  • actions/checkout master composite
  • actions/setup-python v3 composite
  • pypa/gh-action-pypi-publish release/v1 composite

Score: 7.965545573129992