# aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024 architecture

> Architecture diagram of the GitHub repository aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024
- Repository: https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024

## Overview

This project turns World Bank Price Level Index data into cost-of-living analysis, visualizations, and country-category predictions. The user-facing workflow is the Gradio dashboard: users explore PLI by year and country or submit PLI and year for a classification. The README also documents preprocessing, feature engineering, EDA, and a Power BI dashboard. Notebook roles and the exact wiring between artifacts are not shown in the excerpts, so those relationships are limited to README-documented workflow links.

Main entry points: [`ML_Pipeline.ipynb`](https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/ML_Pipeline.ipynb) (PLI Features), [`app.py`](https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/app.py) (Random Forest), [`cleaned_data.csv`](https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/cleaned_data.csv) (Cleaned Data), [`raw_data/raw_data_of_world_bank_PLI.csv`](https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/raw_data/raw_data_of_world_bank_PLI.csv) (Raw PLI Data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data Preparation"]
  node_worldbank["World Bank PLI"]
  node_rawdata["Raw PLI Data"]
  node_cleaned["Cleaned Data<br/>[cleaned_data.csv]"]
  node_filtered["Filtered Data<br/>[filtered_data.csv]"]
  node_prep["Data Workflow<br/>[main.ipynb]"]
end

subgraph group_analysis["Economic Analysis"]
  node_eda["Exploratory Analysis<br/>[ML_Pipeline.ipynb]"]
  node_feature["PLI Features<br/>[ML_Pipeline.ipynb]"]
end

subgraph group_prediction["Classification"]
  node_classifier["Random Forest<br/>[app.py]"]
  node_model["Saved Model<br/>[model.pkl]"]
  node_rfmodel["RF Model Artifact<br/>[rf_model.pkl]"]
  node_nn["Neural Network Work"]
end

subgraph group_products["User Products"]
  node_dashboard["Gradio Dashboard<br/>[app.py]"]
  node_powerbi["Power BI Dashboard<br/>[dashboard.pbix]"]
end

node_user(("Analyst"))

node_worldbank -->|"supplies"| node_rawdata
node_rawdata -->|"preprocesses"| node_prep
node_prep -->|"produces"| node_cleaned
node_cleaned -.->|"filters"| node_filtered
node_cleaned -->|"engineers"| node_feature
node_feature -->|"analyzes"| node_eda
node_user -->|"explores"| node_dashboard
node_dashboard -->|"invokes"| node_classifier
node_classifier -.->|"uses"| node_model
node_feature -->|"trains"| node_classifier
node_user -->|"explores"| node_powerbi
node_feature -.->|"experiments"| node_nn
node_eda -.->|"informs"| node_powerbi
node_rfmodel -.->|"persists"| node_classifier

click node_worldbank "https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/raw_data/raw_data_of_world_bank_PLI.csv"
click node_rawdata "https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/raw_data/raw_data_of_world_bank_PLI.csv"
click node_cleaned "https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/cleaned_data.csv"
click node_filtered "https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/filtered_data.csv"
click node_prep "https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/main.ipynb"
click node_eda "https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/ML_Pipeline.ipynb"
click node_feature "https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/ML_Pipeline.ipynb"
click node_dashboard "https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/app.py"
click node_powerbi "https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/dashboard.pbix"
click node_classifier "https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/app.py"
click node_model "https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/model.pkl"
click node_rfmodel "https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/rf_model.pkl"
click node_nn "https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/neural_network.ipynb"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_worldbank,node_rawdata,node_cleaned,node_filtered,node_prep toneBlue
class node_eda,node_feature toneAmber
class node_classifier,node_model,node_rfmodel,node_nn toneMint
class node_dashboard,node_powerbi toneRose
class node_user toneIndigo
```

## Components

### Data Preparation

- [World Bank PLI](https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/raw_data/raw_data_of_world_bank_PLI.csv): `raw_data/raw_data_of_world_bank_PLI.csv`
- [Raw PLI Data](https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/raw_data/raw_data_of_world_bank_PLI.csv): `raw_data/raw_data_of_world_bank_PLI.csv`
- [Cleaned Data](https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/cleaned_data.csv): `cleaned_data.csv`
- [Filtered Data](https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/filtered_data.csv): `filtered_data.csv`
- [Data Workflow](https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/main.ipynb): `main.ipynb`

### Economic Analysis

- [Exploratory Analysis](https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/ML_Pipeline.ipynb): `ML_Pipeline.ipynb`
- [PLI Features](https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/ML_Pipeline.ipynb): `ML_Pipeline.ipynb`

### Classification

- [Random Forest](https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/app.py): `app.py`
- [Saved Model](https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/model.pkl): `model.pkl`
- [RF Model Artifact](https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/rf_model.pkl): `rf_model.pkl`
- [Neural Network Work](https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/neural_network.ipynb): `neural_network.ipynb`

### User Products

- [Gradio Dashboard](https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/app.py): `app.py`
- [Power BI Dashboard](https://github.com/aswina1636/global_cost_of_living_analysis-using-world_bank-pli_data-1990-2024/blob/main/dashboard.pbix): `dashboard.pbix`

### Other components

- **Analyst**

## Connections

- World Bank PLI → Raw PLI Data: supplies (evidence: `README.md`)
- Raw PLI Data → Data Workflow: preprocesses (evidence: `README.md`)
- Data Workflow → Cleaned Data: produces (evidence: `README.md`)
- Cleaned Data → Filtered Data: filters
- Cleaned Data → PLI Features: engineers (evidence: `README.md`)
- PLI Features → Exploratory Analysis: analyzes (evidence: `README.md`)
- Analyst → Gradio Dashboard: explores (evidence: `README.md`)
- Gradio Dashboard → Random Forest: invokes (evidence: `app.py`)
- Random Forest → Saved Model: uses
- PLI Features → Random Forest: trains (evidence: `README.md`)
- Analyst → Power BI Dashboard: explores (evidence: `README.md`)
- PLI Features → Neural Network Work: experiments
- Exploratory Analysis → Power BI Dashboard: informs
- RF Model Artifact → Random Forest: persists
