Roseburg Receiver – Utility Outage Map

A real-time web application that visualizes power outages across multiple utilities in Southwest Oregon. Built with Flask, Leaflet.js, and Turf.js, this project aggregates outage data from:

• Pacific Power
• Douglas Electric Cooperative
• Central Lincoln PUD
• Coos-Curry Electric Cooperative

and renders them on an interactive county map, complete with per-utility customer outage counts and full ODOT traffic integration.

---

Table of Contents

• Features
• Demo
• Architecture
• Getting Started
  • Prerequisites
  • Installation
  • Configuration
  • Running the App Locally
  • Docker
• Project Structure
• API Endpoints
• Customization
• Contributing
• License

---

Features

• Live outage markers for each utility, color-coded by source
• County polygons with configurable styles and legend toggle
• Per-county outage summaries by utility, with localStorage state persistence
• Automated page refresh and data polling for near-real-time updates
• Responsive, mobile-friendly design and accessibility considerations
• Full ODOT integration:
  • Traffic Incidents (live from TripCheck API)
  • ODOT CCTV Camera layer (statewide)
  • ODOT DMS (Message Board) layer, with live sign messages

---

Demo

Access the live map at:
https://outages.roseburgscanner.com

---

Architecture

1. Frontend

   • Leaflet.js for map rendering
   • Turf.js for point-in-polygon detection
   • Vanilla JavaScript for UI, legend toggles, data polling, and all map logic

2. Backend

   • Flask application serving static assets and JSON REST endpoints
   • Requests to external outage and ODOT data sources, with polling and caching
   • Custom calibration functions to convert proprietary (x, y) coordinates to WGS84 lat/lon for DEC and CLPUD

---

Getting Started

Prerequisites

• Python 3.8+
• pip

Installation

git clone https://github.com/the-roseburg-community/utility-outages.git
cd utility-outages
pip install -r requirements.txt

Configuration

No secrets required for outage data.
Note: ODOT (TripCheck) endpoints require a free API key. Set this in your environment as ODOT_SUBSCRIPTION_KEY.

• PACIFIC_POWER_URL
• DEC_SUMMARY_URL
• CLPUD_SUMMARY_URL
• CCE_URL

Adjust coordinate calibration constants in app.py if utilities change their feed formats.

Running the App Locally

export FLASK_APP=app.py
export ODOT_SUBSCRIPTION_KEY=your-odot-key
flask run --host=0.0.0.0 --port=5001

Or:

python app.py

Open your browser at http://localhost:5001.

Docker

Build the Docker image:

docker build -t roseburg-outage-map .

Run the container:

docker run -d -p 5001:5001 --name outage-map -e ODOT_SUBSCRIPTION_KEY=your-odot-key roseburg-outage-map

---

Project Structure

├── app.py                        # Flask application & API integration
├── requirements.txt              # Python dependencies
├── Dockerfile                    # Container build instructions
├── static/
│   ├── favicon.ico
│   ├── styles.css
│   ├── trr-script.js             # Leaflet + all map/data logic
│   └── dc.geojson                # County boundaries (can swap in your own). This one is for all of Oregon
│   └──filtered_counties.geojson  # Custom County boundaries to make file much smaller for faster page load times
│   └── mileposts.geojson         # Oregon milepost boundaries
└── templates/
    ├── index.html                # Main web UI
    └── 404.html                  # Custom 404 page

---

API Endpoints

Route	Description
/	Renders the outage map UI
/outages	Pacific Power JSON feed
/dec-outages	Douglas Electric Cooperative outages (with x/y → lat/lon mapping)
/clpud-outages	Central Lincoln PUD outages (with x/y → lat/lon mapping)
/cce-outages	Coos-Curry Electric XML feed parsed into JSON
/odot-incidents	Live ODOT incident/closure feed
/odot-cctv	ODOT CCTV camera layer (statewide)
/odot-dms-inventory	ODOT message board (DMS) location and info
/odot-dms-status	ODOT message board live status/messages
/static/<path>	Serves CSS, JS, geoJSON, and other static assets

---

Customization

• Styling: update styles.css and adjust countyStyles in trr-script.js
• County GeoJSON: swap out dc.geojson for any other region
• Polling Interval: modify the setInterval duration in trr-script.js
• Legend/Layer UI: Add new toggles and layers as needed

---

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/YourFeature)
3. Commit your changes
4. Open a pull request

Please ensure all changes include appropriate tests and documentation updates.

---

License

Distributed under the GNU General Public License v3.0 (GPL-3.0).
See LICENSE for details.

---

Project Ownership

Community-driven by The Roseburg Receiver
Douglas County, Oregon – Not-for-profit, open to all.

Contact & Info: roseburgscanner.com/about/#contact-the-roseburg-receiver

---