SuperSCADA — North River WRRF

Real-time SCADA dashboard for anaerobic digestion monitoring and control. Built with Python + Streamlit. Deployable to Streamlit Cloud in 3 steps.

Quick Start — Local

python -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate
pip install -r requirements.txt
streamlit run app.py

Open http://localhost:8501

Deploy to Streamlit Cloud

Step 1 — Push to GitHub

git init
git add .
git commit -m "SuperSCADA initial commit"
git branch -M main
git remote add origin https://github.com/YOUR_USERNAME/supersca-da.git
git push -u origin main

Step 2 — Connect Streamlit Cloud

1. Go to https://share.streamlit.io
2. Sign in with GitHub
3. Click New app
4. Repository: YOUR_USERNAME/supersca-da
5. Branch: main
6. Main file: app.py
7. Click Deploy

That's it. No secrets, no environment variables needed.

Project Structure

supersca_da/
├── app.py                      # Overview dashboard (entry point)
├── requirements.txt
├── .streamlit/config.toml      # Dark theme
├── pages/
│   ├── 1_Microbial_Health.py   # VFA, F/M, COD, Biomass
│   ├── 2_Inhibitors.py         # NH3, H2S, heavy metals, toxic organics
│   ├── 3_Nutrients.py          # C:N:P ratio management
│   ├── 4_Retention_AI_Control.py  # SRT, HRT, AI predictions
│   └── 5_Historian.py          # Time-series table + CSV download
└── utils/
    ├── process_model.py        # Pure Python physics simulation
    ├── session.py              # Streamlit session state manager
    └── charts.py               # Plotly helpers + dark CSS

Plant Basis

North River WRRF (NYSDEC Permit NY0026247):

• 8 × 200,000 ft³ circular cast-in-place concrete digesters
• Two-stage mesophilic | 170 MGD | Riverbank State Park platform
• HRT 15–20 d | SRT 15–35 d | Temp 35–37°C
• Gas yield: 15 ft³/lb VS = 0.936 m³/kgVS
• Wiggins Gas Holder: 135,000 ft³ (3,822 m³)
• Cogeneration: 5 × 3.37 MW engines (13.5 MW max)