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
- Host: GitHub
- URL: https://github.com/pyswmm/swmmio
- Owner: pyswmm
- License: mit
- Created: 2016-04-25T14:23:05.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2026-02-12T15:06:43.000Z (about 1 month ago)
- Last Synced: 2026-02-16T16:29:30.454Z (about 1 month ago)
- Topics: civil-engineering, hydraulic-modeling, hydroinformatics, python, swmm5, watershed
- Language: Python
- Homepage: https://swmmio.readthedocs.io
- Size: 15.3 MB
- Stars: 143
- Watchers: 11
- Forks: 45
- Open Issues: 37
- Releases: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Authors: AUTHORS
README.md
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.
Owner metadata
- Name: pyswmm
- Login: pyswmm
- Email:
- Kind: organization
- Description:
- Website: http://www.pyswmm.org
- Location: United States of America
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/132501370?v=4
- Repositories: 1
- Last ynced at: 2023-05-04T14:11:37.601Z
- Profile URL: https://github.com/pyswmm
GitHub Events
Total
- Delete event: 6
- Pull request event: 23
- Fork event: 5
- Issues event: 14
- Watch event: 14
- Issue comment event: 53
- Push event: 56
- Pull request review comment event: 1
- Pull request review event: 10
- Create event: 14
Last Year
- Pull request event: 5
- Fork event: 1
- Watch event: 4
- Issue comment event: 8
- Push event: 6
- Create event: 4
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 | 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:
- umich.edu: 2
- ic.ac.uk: 1
- stormharvester.com: 1
- fluves.com: 1
- pathirana.net: 1
- emnet.net: 1
- sandia.gov: 1
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
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
- 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
- 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 *
- 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
- actions/checkout v3 composite
- actions/checkout master composite
- actions/setup-python v3 composite
- pypa/gh-action-pypi-publish release/v1 composite
Score: 7.965545573129992