swmm_api: A Python Package for Automation, Customization, and Visualization in SWMM-Based Urban Drainage Modeling

The Python package swmm_api addresses a critical gap in urban drainage modeling by providing a flexible, script-based tool for managing SWMM models. Recognizing the limitations of existing solutions, this study developed a Python-based approach that seamlessly integrates SWMM model creation, editing, analysis, and visualization within Python’s extensive ecosystem. The package offers intuitive, dictionary-like interactions with model components, enabling manipulation of input files and extraction of results as structured data. It supports advanced GIS integration, sensitivity analysis, calibration, and uncertainty estimation through libraries like GeoPandas, SALib, and SPOTPY. Results demonstrate significant efficiency improvements in repetitive tasks, including batch simulations, sensitivity analyses, and automated GIS data processing, exemplified by practical applications such as model updates for municipal sewer systems. The package significantly enhances reproducibility and facilitates transparent sharing of scientific workflows. Overall, swmm_api provides researchers and practitioners with a robust, adaptable solution for streamlined urban drainage modeling.