Skip to content

Vihangam (Vi-han-gam) is a drone software system designed for disaster management, focusing on search and rescue operations.

Notifications You must be signed in to change notification settings

AtulACleaver/Vihangam

Repository files navigation

๐Ÿš Vihangam - Drone Disaster Management System

Vihangam Logo

Advanced AI-Powered Disaster Response Platform

Low-altitude navigation, real-time detection, and intelligent pathfinding for emergency response operations


๐ŸŒŸ Features

  • ๐ŸŽฏ Real-time AI Object Detection - YOLO-based disaster detection with confidence scoring
  • ๐Ÿง  A Pathfinding Algorithm* - Low-altitude navigation with dynamic obstacle avoidance
  • ๐Ÿ“Š Interactive Dashboard - Comprehensive mission control and analytics
  • ๐Ÿ—บ๏ธ Terrain-Aware Navigation - Elevation mapping and clearance monitoring
  • โšก Real-time Updates - WebSocket-powered live data streaming
  • ๐Ÿ“ฑ Responsive Design - Dark theme with glassmorphism UI

๐Ÿ› ๏ธ Tech Stack

Backend Framework

Django Python
  • Django 5.2.6 - High-level Python web framework
  • Django Channels - WebSocket support for real-time communication
  • Python 3.x - Core programming language

Frontend Technologies

HTML5 CSS3 JavaScript Bootstrap
  • HTML5 - Semantic markup and structure
  • CSS3 - Advanced styling with glassmorphism effects
  • JavaScript ES6+ - Interactive functionality and A* algorithm implementation
  • Bootstrap 5.3 - Responsive grid system and components

UI/UX Libraries

Font Awesome Leaflet Chart.js
  • Font Awesome 6.0 - Comprehensive icon library
  • Leaflet 1.9.4 - Interactive mapping and geolocation
  • Chart.js 4.4 - Data visualization and analytics charts

AI & Computer Vision

YOLO OpenCV Pillow
  • YOLOv8 - Real-time object detection for disaster identification
  • Pillow (PIL) - Image processing and manipulation
  • Custom A Implementation* - Pathfinding algorithm for low-altitude navigation

Database & Storage

SQLite
  • SQLite - Lightweight database for development
  • Django ORM - Object-relational mapping

Development Tools

Git VS Code pip
  • Git - Version control system
  • pip - Package management
  • Virtual Environment - Isolated Python environment

๐Ÿ“ Project Architecture

vihangam_disaster_dashboard/
โ”œโ”€โ”€ ๐ŸŽฎ apps/
โ”‚   โ”œโ”€โ”€ ๐Ÿ“Š dashboard/          # Mission control and analytics
โ”‚   โ”œโ”€โ”€ ๐ŸŽฏ detection/          # AI object detection system
โ”‚   โ””โ”€โ”€ ๐Ÿง  pathfinding/        # A* navigation algorithms
โ”œโ”€โ”€ ๐ŸŽจ static/
โ”‚   โ”œโ”€โ”€ css/                   # Custom stylesheets
โ”‚   โ”œโ”€โ”€ js/                    # JavaScript modules
โ”‚   โ””โ”€โ”€ images/                # Assets and logos
โ”œโ”€โ”€ ๐Ÿ“„ templates/              # HTML templates
โ”œโ”€โ”€ ๐ŸŒ disaster_dashboard/     # Django project settings
โ””โ”€โ”€ ๐Ÿ”ง manage.py              # Django management script

๐Ÿš€ Quick Start Guide

Prerequisites

  • Python 3.8+
  • pip package manager
  • Virtual environment support

1. Environment Setup

# Clone the repository
git clone <repository-url>
cd disaster_dashboard

# Activate virtual environment
source venv/bin/activate  # macOS/Linux
# or
venv\Scripts\activate     # Windows

2. Install Dependencies

pip install -r requirements.txt

3. Database Migration

python manage.py migrate

4. Collect Static Files

python manage.py collectstatic --noinput

5. Run Development Server

python manage.py runserver

6. Access the Application


๐ŸŽฎ Application Modules

๐Ÿ“Š Dashboard Module

  • Real-time mission monitoring
  • Drone status tracking
  • Weather and environmental data
  • Mission statistics and analytics

๐ŸŽฏ Detection Module

  • YOLO-based object detection
  • Confidence threshold adjustment
  • Real-time bounding box visualization
  • Detection history and analytics
  • Export functionality

๐Ÿง  Pathfinding Module

  • A algorithm implementation*
  • Low-altitude navigation (10-100m)
  • Dynamic obstacle avoidance
  • Terrain awareness system
  • Real-time path recalculation

๐Ÿ”ง Development

Adding New Features

  1. Create new Django app: python manage.py startapp feature_name
  2. Add to INSTALLED_APPS in settings.py
  3. Create templates in templates/feature_name/
  4. Add CSS in static/css/feature_name.css
  5. Run migrations: python manage.py makemigrations && python manage.py migrate

CSS Architecture

  • base.css - Global styles and dark theme
  • dashboard.css - Dashboard-specific styling
  • detection.css - Detection module styling
  • pathfinding.css - A* pathfinding styling

JavaScript Modules

  • A* pathfinding algorithm implementation
  • Real-time data updates
  • Interactive UI components
  • Chart.js integrations

๐Ÿ“Š Performance Features

  • โšก Real-time Updates: WebSocket-powered live data
  • ๐ŸŽจ Glassmorphism UI: Modern dark theme with blur effects
  • ๐Ÿ“ฑ Responsive Design: Mobile-first approach
  • ๐Ÿš€ Optimized Assets: Minified CSS/JS and image optimization
  • ๐Ÿง  Efficient Algorithms: Optimized A* pathfinding implementation

About

Vihangam (Vi-han-gam) is a drone software system designed for disaster management, focusing on search and rescue operations.

Topics

Resources

Stars

Watchers

Forks

Contributors 5