Skip to content

W5ALC/Colorado-Severe-Weather

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

139 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

β›ˆοΈ Colorado Severe Weather Network Toolkit

CSWN Interface

A comprehensive desktop application for severe weather monitoring and emergency communications in Colorado

GitHub release License Python Platform

πŸ“₯ Download Latest Release β€’ πŸ“– Documentation β€’ 🌐 Live Gallery


πŸ“‹ Table of Contents


πŸŒ€ Overview

The Colorado Severe Weather Network Toolkit is a specialized GUI application designed for meteorologists, storm spotters, emergency managers, and weather enthusiasts operating in Colorado and surrounding regions. It provides centralized access to critical weather resources, real-time data, and forecasting tools from the National Weather Service (NWS), Storm Prediction Center (SPC), and other authoritative sources.

Why CSWN Toolkit?

  • ⚑ Rapid Access - All critical weather resources in one unified interface
  • 🎯 Colorado-Focused - Tailored for CO's unique weather patterns and NWS offices
  • πŸ”„ Real-Time Updates - Live weather alerts, radar, and satellite imagery
  • πŸ“‘ Net Control Ready - Built-in script generator for amateur radio weather nets
  • πŸŒ™ Dark/Light Modes - Comfortable viewing in any environment
  • πŸ–₯️ Cross-Platform - Windows, macOS, and Linux support

✨ Key Features

πŸŽ™οΈ Net Control Script Generator

  • Automatically generates daily net control scripts
  • Includes AFD and HWO from all 5 partner NWS offices (BOU, PUB, GJT, CYS, GLD)
  • Customizable parameters to keep information relevant
  • Perfect for ARES/RACES operations

🌩️ Severe Weather Monitoring

  • Storm Prediction Center Integration

    • Convective Outlooks (Day 1-8)
    • Mesoscale Discussions
    • Watch/Warning Polygons
    • Storm Reports Archive
    • Mesoanalysis Tools
  • Real-Time Alerts

    • Colorado-specific weather alerts
    • County-level warnings
    • Interactive alert maps

πŸ›°οΈ Radar & Satellite

  • NEXRAD Radar (Multiple sources)
  • GOES-16/19 Satellite Imagery
  • RGB Cloud Detail Products
  • Zoom Earth Real-Time View
  • Ventusky Radar/Satellite
  • Tropical Tidbits Integration

πŸ“Š Forecast Tools

  • NWS Products

    • Area Forecast Discussions (AFD)
    • Hazardous Weather Outlooks (HWO)
    • Graphical Forecasts (NDFD)
    • Weather Prediction Center (WPC)
  • Model Data

    • HRRR (High-Resolution Rapid Refresh)
    • NAM NEST
    • College of DuPage Model Viewers
    • Tropical Tidbits Model Graphics

πŸ“‘ Observations

  • Mesowest Station Data
  • mPing Reports
  • NWS Enhanced Data Display (EDD)
  • Surface Observations

πŸŽ“ Educational Resources

  • Skywarn Spotter Training Materials
  • Field Guide Access
  • Spotter Checklist
  • COMET MetEd Training Links

πŸ“Έ Screenshots

Main Interface (Dark Mode)

Main Interface Dark

Main Interface (Light Mode)

Main Interface Light


Active Alerts

SPC Products

GOES Satellite

Toolkit Tab

πŸ–ΌοΈ View Full Gallery


πŸ’Ύ Installation

Option 1: Download Pre-Built Executable (Recommended)

Choose your platform from the latest release:

πŸͺŸ Windows

# Download and extract
CSWN-Toolkit-v3.1.0-windows.zip

# Run the executable
CSWN-toolkit.exe

🍎 macOS

# Download the DMG
CSWN-Toolkit-v3.1.0-macos.dmg

# Install and run

🐧 Linux

# Download and extract
tar -xzf CSWN-Toolkit-v3.1.0-linux.tar.gz

# Make executable
chmod +x CSWN-Toolkit-linux-x86_64

# Run
./CSWN-Toolkit-linux-x86_64

# Or use AppImage (if available)
chmod +x CSWN-Toolkit-*.AppImage
./CSWN-Toolkit-*.AppImage

Option 2: Run from Source

Prerequisites

  • Python 3.8 or higher
  • Internet connection

Installation Steps

# Clone the repository
git clone https://github.com/W5ALC/Colorado-Severe-Weather.git
cd Colorado-Severe-Weather

# Install dependencies
pip install -r requirements.txt

# Run the application
python3 Colorado-Severe-Weather.py

Required Python Packages

PyQt6
PyQt6-WebEngine
requests
beautifulsoup4
pillow

πŸš€ Usage

First Launch

  1. Launch the application using your preferred method
  2. Explore the tabs to familiarize yourself with available resources
  3. Check the alerts tab for any active Colorado weather alerts
  4. Generate a net script if conducting weather net operations

Quick Start Guide

For Storm Spotters

  1. Navigate to "SPC & Severe" tab for convective outlooks
  2. Check "Alerts" for active warnings in your area
  3. Use "Radar/Satellite" for real-time storm tracking
  4. Access "Skywarn Resources" for field guide and checklist

For Net Control Operators

  1. Open the "Toolkit" tab
  2. Click "Generate Net Script"
  3. Script includes current AFD and HWO from all CO NWS offices
  4. Customize parameters as needed for your net

For Forecasters

  1. Review "AFD" tab for detailed forecast discussions
  2. Check "HWO" for hazardous weather outlooks
  3. Analyze "Models" tab for HRRR and other model data
  4. Monitor "Observations" for current conditions

Keyboard Shortcuts

  • Ctrl+R - Refresh current view
  • Ctrl+D - Toggle dark/light mode
  • Ctrl+Q - Quit application
  • F11 - Toggle fullscreen

πŸ”§ Features in Detail

Net Control Script Generator

The script generator creates professional, organized net control scripts including:

  • Date and time automatically populated
  • Current weather alerts for Colorado
  • Area Forecast Discussions from:
    • Boulder (BOU)
    • Pueblo (PUB)
    • Grand Junction (GJT)
    • Cheyenne (CYS)
    • Goodland (GLD)
  • Hazardous Weather Outlooks from all offices
  • Customizable sections for your specific net requirements

Multi-Office Coverage

CSWN Toolkit covers all NWS offices serving Colorado:

Office Coverage Area Callsign
Boulder North Central CO BOU
Pueblo Southeast CO PUB
Grand Junction Western CO GJT
Cheyenne Northeast CO CYS
Goodland Eastern Plains GLD

Real-Time Data Sources

  • NWS API - Official weather alerts and forecasts
  • SPC - Severe weather outlooks and discussions
  • GOES-R - Latest satellite imagery
  • NEXRAD - Real-time radar data
  • Mesowest - Surface observations

🀝 Contributing

Contributions are welcome! Here's how you can help:

Reporting Issues

  1. Check if the issue already exists in Issues
  2. Create a new issue with:
    • Clear description of the problem
    • Steps to reproduce
    • Expected vs actual behavior
    • Screenshots if applicable
    • Your OS and Python version

Submitting Changes

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Development Setup

# Clone your fork
git clone https://github.com/YOUR_USERNAME/Colorado-Severe-Weather.git

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install development dependencies
pip install -r requirements.txt
pip install pytest pylint black

# Run tests
pytest tests/

# Format code
black *.py

πŸ™ Acknowledgments

This project wouldn't be possible without these excellent resources:

Data Providers

Tools & Libraries

  • PyQt6 - Cross-platform GUI framework
  • Beautiful Soup - HTML parsing
  • Requests - HTTP library

Organizations

  • Skywarn - Storm spotter program
  • ARES/RACES - Amateur radio emergency services
  • Colorado Amateur Radio Community - Testing and feedback

πŸ“„ License

This project is licensed under the "It's Not That Serious" v1 License.

In plain English: Feel free to use, modify, and distribute this software. No warranties provided. Don't blame me if something breaks. Attribution appreciated but not required.


πŸ“ž Contact & Support


πŸ—ΊοΈ Roadmap

Upcoming Features

  • Push notifications for severe weather alerts
  • Historical storm report database
  • Integration with ham radio logging software
  • Mobile companion app
  • Offline mode with cached data
  • Custom alert zones and filters
  • APRS integration for storm spotters

Version History

  • v3.1.0 (Current) - Enhanced UI, added GOES-19 support
  • v3.0.0 - Major rewrite with PyQt6, dark mode
  • v2.1.0 - Added net script generator
  • v2.0.0 - Multi-platform support
  • v1.0.0 - Initial release

See CHANGELOG.md for detailed version history.


⭐ Star History

If you find this project useful, please consider giving it a star! It helps others discover the tool.

Star History Chart


Made with ⚑ by W5ALC for the Colorado weather community

Report Bug β€’ Request Feature β€’ View Gallery

About

Files for the Colorado Severe Weather Network Toolkit

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors