MekdelawitGebre/ethiopia-fi-forecast

# Ethiopia Financial Inclusion Project ## Overview This project analyzes financial inclusion in Ethiopia, focusing on access, usage, affordability, and gender gaps. It utilizes structured datasets collected from surveys, operators, regulators, and other official sources to identify trends and support future impact modeling. The workflow is divided into two primary phases: * **Task 1:** Data Exploration & Enrichment * **Task 2:** Exploratory Data Analysis (EDA) --- ## File Structure ```text ethiopia-fi-forecast/ │ ├─ data/ │ ├─ raw/ # Original raw datasets │ └─ processed/ # Cleaned & enriched datasets │ ├─ plots/ # All plots generated in Task 2 EDA │ ├─ temporal_coverage.png │ ├─ confidence_distribution.png │ ├─ access_trends.png │ ├─ gender_gap.png │ ├─ usage_trends.png │ ├─ infrastructure_trends.png │ ├─ event_timeline.png │ ├─ access_with_events.png │ └─ indicator_correlation.png │ ├─ src/ │ ├─ task1_explore_and_enrich.py # Task 1: Data exploration and enrichment │ └─ task2_eda.py # Task 2: EDA and visualization logic │ ├─ requirements.txt ├─ .gitignore └─ README.md ``` --- ## Setup Instructions 1. **Clone the repository:** ```bash git clone github.com cd ethiopia-fi-forecast ``` 2. **Create and activate a virtual environment:** ```bash python3 -m venv .venv source .venv/bin/activate ``` 3. **Install dependencies:** ```bash pip install -r requirements.txt ``` 4. **Run Task 1 (Data Exploration & Enrichment):** ```bash python3 src/task1_explore_and_enrich.py ``` * Cleans and enriches raw data. * Validates schema and data quality. * Saves enriched data to `data/processed/`. 5. **Run Task 2 (Exploratory Data Analysis):** ```bash python3 src/task2_eda.py ``` * Generates visualizations for access, usage, infrastructure, and events. * Saves all plots to the `plots/` folder. --- ## Task 1 – Data Exploration & …