Skip to content

About

No description, website, or topics provided.

Resources

Stars

3 stars

Watchers

1 watching

Forks

Repository files navigation

🌌 AetherGuard-INDIA

AI-Powered Space Weather Prediction & Impact Assessment System Forecasting solar flares and geomagnetic storms to protect India's critical infrastructure

πŸš€ Live Demo β€’ πŸ“– Documentation β€’ πŸ”§ Installation β€’ 🀝 Contributing


🌟 Overview

AetherGuard-INDIA is a machine learning-powered platform that predicts space weather events β€” solar flares and geomagnetic storms β€” and assesses their potential impact on satellites, power grids, communication networks, and other infrastructure. The system combines historical space weather data with a trained prediction model to deliver early warnings through a simple, accessible web interface.

🎯 Mission

Give India's infrastructure operators, researchers, and the public an early-warning system for space weather disruptions, so that satellite operators, grid operators, and aviation/communication services can prepare before an event hits.


✨ Key Features

πŸ€– Predictive Modeling

  • Machine learning model trained on historical space weather data (space_weather_model.joblib)
  • Forecasts the likelihood and severity of solar flare / geomagnetic storm activity
  • Continuously retrainable pipeline via train_model.py

πŸ“Š Impact Assessment

  • Translates raw predictions into practical impact categories (impact.py) β€” e.g. effects on satellites, power grids, GPS, and radio communications
  • Helps non-technical users understand what a prediction means rather than just a raw probability

🌐 Web Dashboard

  • Lightweight Flask web app (app.py) for running predictions and viewing results
  • Simple interface designed for quick checks without needing to run scripts manually

πŸ“ Historical Tracking

  • Prediction history logged per session/user (history_Space.csv, history_default_username.csv, prediction_history.csv)
  • Enables trend review and comparison of past forecasts against outcomes

πŸ‘₯ User & Subscriber Management

  • Basic user accounts (users.txt) for tracking who ran which predictions
  • Subscriber list (subscribers.txt) to support alert/notification distribution

πŸ—οΈ System Architecture

Prediction Pipeline

Space Weather Data β†’ Feature Preparation β†’ Trained ML Model (predict.py) β†’
Risk/Impact Scoring (impact.py) β†’ Web Dashboard (app.py) β†’ History Log

Core Components

  • 🧠 Prediction Engine: predict.py β€” loads space_weather_model.joblib and generates forecasts
  • πŸ“‰ Impact Engine: impact.py β€” converts predictions into infrastructure impact assessments
  • πŸ‹οΈ Training Pipeline: train_model.py β€” trains/retrains the space weather model
  • 🌐 Web Interface: app.py β€” Flask-based dashboard for interacting with the system
  • πŸ’Ύ Data Store: CSV-based history logs for predictions and user activity

πŸš€ Quick Start

Prerequisites

  • Python 3.8+
  • pip package manager
  • Git for version control

1️⃣ Clone Repository

git clone https://github.com/hiralM001/Aetherlite-project.git
cd Aetherlite-project

2️⃣ Install Dependencies

pip install -r requirements.txt

3️⃣ Launch Application

python app.py

4️⃣ Access Dashboard

Open your browser and navigate to:


πŸ“‹ Usage Guide

Web Interface

  1. Open the dashboard in your browser after starting app.py
  2. Run a prediction using the current/latest space weather inputs
  3. Review results, including the predicted event likelihood and impact assessment
  4. Check history to compare against past predictions

Command Line

# Run a prediction directly
python predict.py

# Assess impact of a given prediction
python impact.py

# Retrain the model on updated data
python train_model.py

πŸ“ Project Structure

Aetherlite-project/
β”œβ”€β”€ πŸ“‚ .devcontainer/              # Dev container configuration
β”œβ”€β”€ 🌐 app.py                      # Flask web application (main entry point)
β”œβ”€β”€ πŸ—„οΈ app_backup.py               # Backup copy of the web application
β”œβ”€β”€ 🧠 predict.py                  # Prediction script using the trained model
β”œβ”€β”€ πŸ“‰ impact.py                   # Converts predictions into impact assessments
β”œβ”€β”€ πŸ‹οΈ train_model.py              # Model training / retraining script
β”œβ”€β”€ πŸ€– space_weather_model.joblib  # Trained ML model artifact
β”œβ”€β”€ πŸ“Š history_Space.csv           # Space weather prediction history
β”œβ”€β”€ πŸ“Š history_default_username.csv# Per-user prediction history
β”œβ”€β”€ πŸ“Š prediction_history.csv      # General prediction log
β”œβ”€β”€ πŸ‘€ users.txt                   # Registered users
β”œβ”€β”€ πŸ“§ subscribers.txt             # Alert subscriber list
β”œβ”€β”€ πŸ“‹ requirements.txt            # Python dependencies
└── πŸ“– README.md                   # This file

🎯 Use Cases

Satellite Operators

  • Anticipate solar activity that may affect satellite electronics or communications

Power Grid Operators

  • Early warning for geomagnetically induced currents that can stress transformers

Researchers & Students

  • Study space weather trends using logged historical prediction data
  • Experiment with retraining the model on new data

General Public / Enthusiasts

  • Check current space weather risk through a simple web dashboard

πŸ› οΈ Development

Setting Up a Development Environment

# Clone repository
git clone https://github.com/hiralM001/Aetherlite-project.git
cd Aetherlite-project

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Linux/Mac
# venv\Scripts\activate   # Windows

# Install dependencies
pip install -r requirements.txt

# Run the app
python app.py

Retraining the Model

python train_model.py

This regenerates space_weather_model.joblib using the latest training data.


🀝 Contributing

Contributions are welcome! Here's how to get involved:

Contribution Areas

  • 🧠 Model Improvements: Improve prediction accuracy or add new features
  • πŸ“‰ Impact Logic: Refine how predictions map to real-world impact categories
  • 🎨 UI/UX: Improve the Flask dashboard
  • πŸ“š Documentation: Help others understand and use the system

Development Workflow

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit changes: git commit -m 'Add amazing feature'
  4. Push to branch: git push origin feature/amazing-feature
  5. Submit a Pull Request with a detailed description

πŸ“œ License

No license has been specified for this project yet. Consider adding one (e.g. MIT) so others know how they can use and contribute to it.


πŸ“ž Support & Contact


🌌 Forecasting the Skies to Protect What's on the Ground

About

No description, website, or topics provided.

Resources

Stars

3 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages