calyxish/yango-accra-mobility-prediction

# Yango Accra Mobility Prediction A machine learning project to predict ride travel times in Accra, Ghana using trip data and weather conditions. ## Project Structure ``` yango-accra-mobility-prediction/ ├── data/ # Data files (not tracked in git) │ ├── Train.csv │ ├── Test.csv │ ├── Accra_weather.csv │ ├── SampleSubmission.csv │ └── VariableDefinitions.csv ├── notebooks/ # Jupyter notebooks │ ├── 01_eda_and_cleaning.ipynb │ ├── 02_train_model.ipynb │ └── StarterNotebook.ipynb # Start here! ├── scripts/ # Python scripts │ └── feature_engineering.py ├── outputs/ # Model outputs and submissions ├── config.py # Configuration and file paths ├── utils.py # Utility functions ├── setup_check.py # Environment verification ├── requirements.txt # Python dependencies ├── .gitignore # Git ignore file └── README.md # This file ``` ## Quick Start ### 1. Clone the Repository ```bash git clone github.com cd yango-accra-mobility-prediction ``` ### 2. Create Virtual Environment ```bash # Using conda (recommended) conda create -n yango-env python=3.9 conda activate yango-env # Or using venv python -m venv venv # Windows venv\Scripts\activate # Linux/Mac source venv/bin/activate ``` ### 3. Install Dependencies ```bash pip install -r requirements.txt ``` ### 4. Setup Data 1. Download competition data from Zindi 2. Place CSV files in the `data/` directory: - `Train.csv` - `Test.csv` - `Accra_weather.csv` - `SampleSubmission.csv` - `VariableDefinitions.csv` ### 5. Verify Setup ```bash python setup_check.py ``` ### 6. Start with Notebooks ```bash jupyter notebook ``` Open `StarterNotebook.ipynb` to begin! ## Usage Guide ### For Beginners 1. **Start with**: `StarterNotebook.ipynb` - Basic implementation w …