# j-nkumbatir/ihs5-poverty-analysis architecture

> Architecture diagram of the GitHub repository j-nkumbatir/ihs5-poverty-analysis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/j-nkumbatir/ihs5-poverty-analysis
- Repository: https://github.com/j-nkumbatir/ihs5-poverty-analysis

## Overview

This repository is an IHS5 research analysis of socioeconomic determinants of poverty in Malawi. Its documented workflow runs from obtaining raw survey data through Stata preparation and cleaning, exploratory analysis, and logistic/OLS modeling, with Python used for EDA, diagnostics, and visualizations. The graph follows the README’s ordered Stata workflow and documented tool roles; source excerpts were unavailable, so implementation-level calls and data transfers cannot be verified.

Main entry points: [`Scripts/Stata/02_data_cleaning.do`](https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Stata/02_data_cleaning.do) (Data cleaning), [`Scripts/Python/03_exploratory_data_analysis.ipynb`](https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Python/03_exploratory_data_analysis.ipynb) (Python EDA), [`Scripts/Stata/01_preperation_wrangleling.do`](https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Stata/01_preperation_wrangleling.do) (Data preparation), [`Scripts/Stata/03_exploratory_data_analysis.do`](https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Stata/03_exploratory_data_analysis.do) (Stata EDA)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Survey data"]
  node_raw[("Raw IHS5 survey")]
  node_processed[("Processed datasets")]
end

subgraph group_stata["Stata workflow"]
  node_prepare["Data preparation"]
  node_clean["Data cleaning"]
  node_stata_eda["Stata EDA"]
  node_model["Regression modeling"]
end

subgraph group_python["Python analysis"]
  node_py_clean["Python cleaning"]
  node_py_eda["Python EDA"]
  node_py_model["Python regression analysis"]
end

subgraph group_results["Research outputs"]
  node_tables["Analysis tables"]
  node_figures["Analysis figures"]
end

node_nso(("Malawi NSO"))

node_nso -->|"provides data"| node_raw
node_raw -->|"input for"| node_prepare
node_prepare -->|"followed by"| node_clean
node_clean -->|"followed by"| node_stata_eda
node_stata_eda -->|"followed by"| node_model
node_clean -.->|"cleaning also in"| node_py_clean
node_py_clean -.->|"analysis continues"| node_py_eda
node_py_eda -.->|"modeling analysis"| node_py_model
node_clean -->|"produces cleaned data"| node_processed
node_model -.->|"reports results"| node_tables
node_py_eda -.->|"creates visualizations"| node_figures

click node_prepare "https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Stata/01_preperation_wrangleling.do"
click node_clean "https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Stata/02_data_cleaning.do"
click node_stata_eda "https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Stata/03_exploratory_data_analysis.do"
click node_model "https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Stata/04_regression_modeling_and_analysis.do"
click node_py_clean "https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Python/02_data_cleaning.ipynb"
click node_py_eda "https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Python/03_exploratory_data_analysis.ipynb"
click node_py_model "https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Python/04_regression_modelling_and_analysis.ipynb"
click node_processed "https://github.com/j-nkumbatir/ihs5-poverty-analysis/tree/main/Data/Processed"
click node_tables "https://github.com/j-nkumbatir/ihs5-poverty-analysis/tree/main/Output/Tables"
click node_figures "https://github.com/j-nkumbatir/ihs5-poverty-analysis/tree/main/Output/Figures"

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_raw,node_processed toneBlue
class node_prepare,node_clean,node_stata_eda,node_model toneAmber
class node_py_clean,node_py_eda,node_py_model toneMint
class node_tables,node_figures toneRose
class node_nso toneIndigo
```

## Components

### Survey data

- **Raw IHS5 survey**
- [Processed datasets](https://github.com/j-nkumbatir/ihs5-poverty-analysis/tree/main/Data/Processed): `Data/Processed`

### Stata workflow

- [Data preparation](https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Stata/01_preperation_wrangleling.do): `Scripts/Stata/01_preperation_wrangleling.do`
- [Data cleaning](https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Stata/02_data_cleaning.do): `Scripts/Stata/02_data_cleaning.do`
- [Stata EDA](https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Stata/03_exploratory_data_analysis.do): `Scripts/Stata/03_exploratory_data_analysis.do`
- [Regression modeling](https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Stata/04_regression_modeling_and_analysis.do): `Scripts/Stata/04_regression_modeling_and_analysis.do`

### Python analysis

- [Python cleaning](https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Python/02_data_cleaning.ipynb): `Scripts/Python/02_data_cleaning.ipynb`
- [Python EDA](https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Python/03_exploratory_data_analysis.ipynb): `Scripts/Python/03_exploratory_data_analysis.ipynb`
- [Python regression analysis](https://github.com/j-nkumbatir/ihs5-poverty-analysis/blob/main/Scripts/Python/04_regression_modelling_and_analysis.ipynb): `Scripts/Python/04_regression_modelling_and_analysis.ipynb`

### Research outputs

- [Analysis tables](https://github.com/j-nkumbatir/ihs5-poverty-analysis/tree/main/Output/Tables): `Output/Tables`
- [Analysis figures](https://github.com/j-nkumbatir/ihs5-poverty-analysis/tree/main/Output/Figures): `Output/Figures`

### Other components

- **Malawi NSO**

## Connections

- Malawi NSO → Raw IHS5 survey: provides data (evidence: `README.md`)
- Raw IHS5 survey → Data preparation: input for (evidence: `README.md`)
- Data preparation → Data cleaning: followed by (evidence: `README.md`)
- Data cleaning → Stata EDA: followed by (evidence: `README.md`)
- Stata EDA → Regression modeling: followed by (evidence: `README.md`)
- Data cleaning → Python cleaning: cleaning also in (evidence: `README.md`)
- Python cleaning → Python EDA: analysis continues (evidence: `README.md`)
- Python EDA → Python regression analysis: modeling analysis (evidence: `README.md`)
- Data cleaning → Processed datasets: produces cleaned data (evidence: `README.md`)
- Regression modeling → Analysis tables: reports results (evidence: `README.md`)
- Python EDA → Analysis figures: creates visualizations (evidence: `README.md`)
