Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/clubgamma/air-quality-index-analysis
Official Hacktoberfest 2024 project repository from Club Gamma. Start hacking!
https://github.com/clubgamma/air-quality-index-analysis
aiml hacktoberfest hacktoberfest2024
Last synced: 1 day ago
JSON representation
Official Hacktoberfest 2024 project repository from Club Gamma. Start hacking!
- Host: GitHub
- URL: https://github.com/clubgamma/air-quality-index-analysis
- Owner: clubgamma
- Created: 2024-10-09T12:50:50.000Z (29 days ago)
- Default Branch: main
- Last Pushed: 2024-10-21T13:03:33.000Z (17 days ago)
- Last Synced: 2024-10-21T14:41:38.108Z (17 days ago)
- Topics: aiml, hacktoberfest, hacktoberfest2024
- Language: Jupyter Notebook
- Homepage:
- Size: 7.48 MB
- Stars: 1
- Watchers: 0
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
## Air Quality Index (AQI) Prediction Using Machine Learning
## 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 📁
```bash
.
├── 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.
```bash
git clone https://github.com/your-username/hacktoberfest2024.git
```
### Navigate to the Project Directory:
```bash
cd hacktoberfest2024
```
### Create a New Branch:
```bash
git checkout -b my-new-branch
```
### Make Your Changes:
Add your features or improvements to the project.
### Commit Your Changes:
```bash
git add .
git commit -m "Add relevant message here"
```
### Push to Your Branch:
```bash
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:
```bash
git remote add upstream https://github.com/clubgamma/hacktoberfest2024.git
```
### Verify the New Remote:
```bash
git remote -v
```
### Sync Your Fork with Upstream:
```bash
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! 🎉