nanecha/Cross-Country-Solar-Farm-Analysis

This project performs end-to-end exploratory data analysis (EDA) on solar radiation measurement data across Benin, Sierra Leone, and Togo to identify high-potential regions for solar installation that align with MoonLight Energy Solutions' long-term sustainability goals. # Solar Investment Strategy Analysis **Analytics Engineer** ## Project Overview This project performs end-to-end exploratory data analysis (EDA) on solar radiation measurement data across **Benin**, **Sierra Leone**, and **Togo** to identify high-potential regions for solar installation that align with MoonLight Energy Solutions' long-term sustainability goals. --- ## Repository Structure ``` moonlight-solar/ ├── app/ │ ├── __init__.py │ ├── main.py # Streamlit dashboard entry point │ └── utils.py # Data processing & visualization utilities ├── scripts/ │ ├── __init__.py │ └── README.md ├── notebooks/ │ ├── benin_eda.ipynb │ ├── sierraleone_eda.ipynb │ ├── togo_eda.ipynb │ └── compare_countries.ipynb ├── data/ # ← gitignored, never committed │ ├── benin_clean.csv │ ├── sierraleone_clean.csv │ └── togo_clean.csv ├── reports/ │ └── strategy_report.md ├── requirements.txt ├── .gitignore └── README.md ``` --- ## Setup ```bash # 1. Clone the repo git clone github.com /moonlight-solar.git cd moonlight-solar # 2. Create and activate virtual environment python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate # 3. Install dependencies pip install -r requirements.txt # 4. Place raw CSVs in data/ (gitignored) # data/benin-malanville_qc.csv # data/sierraleone-bumbuna_qc.csv # data/togo-dapaong_qc.csv # 5. Run EDA notebooks jupyter notebook notebooks/ # 6. Launch Streamlit dashboard streamlit run app/main.py ``` --- ## Branches | Branch | Purpose | |---|---| | `main` | Stable, reviewed code | | `eda-benin` | EDA notebook for Benin | | `eda-sierraleone` | EDA notebook for Sierra Leone | | `eda-togo` | EDA notebook for Togo | | `compare-countries` | Cross-country comparison notebook | | `dashboard` | Streamlit app | --- ## Dataset Columns | Column | Unit | Description | |---|---|---| | Timestamp | yyyy-mm-dd hh:mm | Date and time of observation | | GHI | W/m …