/Air-Quality-Index-Analysis

Official Hacktoberfest 2024 project repository from Club Gamma. Start hacking!

Primary LanguagePython

Air Quality Index (AQI) Prediction Using Machine Learning

Hacktoberfest Badge Open Source PRs Welcome

Project Overview 🌍

Delhi’s severe air pollution, particularly in winter, necessitates accurate Air Quality Index (AQI) predictions. AQI ranges from 0 to 500, with higher values indicating greater health risks. This project uses machine learning to predict AQI levels, offering timely alerts and preventative actions.

Key Features:

  • Data Processing: Cleaning and normalizing AQI datasets from major Indian cities such as Delhi, Bangalore, Kolkata, and Hyderabad.
  • Predictive Modeling: Training machine learning models (Random Forest, Gradient Boosting, etc.) to forecast AQI levels.
  • Imbalance Handling: Using SMOTE to address class imbalances in AQI_Bucket values.
  • Evaluation: Evaluating models using accuracy, precision, recall, and confusion matrices.

The project aims to provide accurate AQI predictions to help authorities and communities take timely action to combat air pollution.

Project Structure 📁

.
├── data/                 # Datasets for AQI data
├── notebooks/            # Jupyter notebooks for data analysis and experimentation
├── src/                  # Source code for the project
│   ├── data_processing.py
│   ├── model_training.py
├── README.md             # Project documentation
└── CONTRIBUTING.md       # Contribution guidelines

Getting Started 🤗🚀

To contribute to the project, follow these steps:

Fork the Repository:

Click the fork button at the top right of the repository page.

Clone Your Fork:

Clone the forked repository to your local machine.

git clone https://github.com/your-username/hacktoberfest2024.git

Navigate to the Project Directory:

cd hacktoberfest2024

Create a New Branch:

git checkout -b my-new-branch

Make Your Changes:

Add your features or improvements to the project.

Commit Your Changes:

git add .
git commit -m "Add relevant message here"

Push to Your Branch:

git push origin my-new-branch

Create a Pull Request:

Go to your forked repository on GitHub and create a pull request to the main repository.

Contribution Guidelines 📚

We welcome your contributions! Please follow these guidelines:

  • Creativity Allowed: Submit pull requests even if they break the rules—we may merge them anyway!
  • Preserve Existing Content: Don’t remove existing content.
  • Code Style: Your code can be neat, messy, or complex—as long as it works!
  • Add Your Name: Remember to add your name to the contributorsList file.
  • Keep it Small: Small pull requests help prevent merge conflicts.

Avoiding Conflicts (Syncing Your Fork) 🔄

To keep your fork up to date with the main repository:

Add Upstream Remote:

git remote add upstream https://github.com/clubgamma/hacktoberfest2024.git

Verify the New Remote:

git remote -v

Sync Your Fork with Upstream:

git fetch upstream
git merge upstream/main

Add Your Name 🌟

Please add your name to the CONTRIBUTING.md file using the following format:

Name: [YOUR NAME](GitHub link)

  • Place: City, State, Country
  • Bio: Who are you?
  • GitHub: [GitHub account name](GitHub link)

Pull Request Labels

We have the following PR labels:

  • level 1 - Basic level contributions
  • level 2 - Intermediate level contributions
  • level 3 - Advanced level contributions
  • hacktoberfest-accepted - Contributions accepted for Hacktoberfest

We look forward to your contributions! 🎉