Metadata-Version: 2.4
Name: us-sewersheds
Version: 0.1.1
Summary: Process and analyze US sewershed data from CWNS
Author-email: Daly Wettermark <139182397+dalyw@users.noreply.github.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/dalyw/us-sewersheds
Project-URL: Repository, https://github.com/dalyw/us-sewersheds
Keywords: sewersheds,wastewater,CWNS,data
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: pandas>=2.2.3
Requires-Dist: networkx>=3.4.2
Requires-Dist: numpy>=2.2.2
Requires-Dist: streamlit>=1.42.0
Requires-Dist: plotly>=5.20.0
Requires-Dist: dash>=2.18.2
Requires-Dist: dash_cytoscape>=1.0.2
Requires-Dist: urllib3>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: bumpversion; extra == "dev"

# US Sewersheds

Process and analyze US sewershed data from the Clean Watersheds Needs Survey (CWNS).

## Overview

This repository includes code to visualize sewershed interconnections in the US based on the 2022 Clean Watershed Needs Survey. The us_sewersheds folder includes two scripts:

1. **merge_cwns_data.py**
   - Merges multiple sources for population served into the primary facilities list.
   - Functions:
     - `main(state=None)`: Main processing function that can process all states or a single state.
     - `merge_population_data(facilities_df, ww_df, sso_df)`: Merges population data from multiple sources.
     - `build_sewershed_map(facilities_df)`: Creates network connections between treatment facilities.
   - Required inputs:
     - data/2022CWNS_NATIONAL_APR2024: Clean Watersheds Needs Survey 2022 dataset
       - FACILITIES.csv: Main facilities data
       - FACILITY_PERMIT.csv: Facility permit information
       - AREAS_COUNTY.csv: County area information
       - FACILITY_TYPES.csv: Facility type information
       - FLOW.csv: Flow data
       - POPULATION_WASTEWATER.csv: Wastewater population data
       - POPULATION_WASTEWATER_CONFIRMED.csv: Confirmed wastewater population data
       - POPULATION_DECENTRALIZED.csv: Decentralized population data
       - DISCHARGES.csv: Discharge information
2. **sewersheds_app.py**
   - Deploys Streamlit application to visualize different sewersheds in the US, by state and county

## Installation
