# imperialchepi/healthgps-data architecture

> Architecture diagram of the GitHub repository imperialchepi/healthgps-data, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/imperialchepi/healthgps-data
- Repository: https://github.com/imperialchepi/healthgps-data

## Overview

This is a data repository supplying Health-GPS, with a companion script for converting downloaded source CSVs into the repository’s layout. The principal workflow is formatted input data becoming disease, risk, cost, and population datasets for the Health-GPS program. The tree shows additional disease-specific relative-risk and population-impact-factor collections. Source excerpts are limited, so links describe only capabilities explicit in the README or formatter documentation; the internal runtime wiring and many dataset details are not shown.

Main entry points: [`Scripts to format data/format_healthgps_disease_data.py`](https://github.com/imperialchepi/healthgps-data/blob/main/Scripts%20to%20format%20data/format_healthgps_disease_data.py) (CSV formatter), [`data/diseases`](https://github.com/imperialchepi/healthgps-data/tree/main/data/diseases) (Disease inputs), [`data/analysis/cost`](https://github.com/imperialchepi/healthgps-data/tree/main/data/analysis/cost) (Cost estimates), [`data/undb`](https://github.com/imperialchepi/healthgps-data/tree/main/data/undb) (UNDB datasets)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_formatting["Data formatting"]
  node_formatter["CSV formatter"]
end

subgraph group_disease_data["Disease data"]
  node_disease_inputs["Disease inputs"]
  node_pif_scenarios["PIF scenarios"]
  node_relative_risks["Relative risks"]
end

subgraph group_analysis_data["Analysis data"]
  node_analysis_cost["Cost estimates"]
  node_analysis_parameters["Analysis parameters"]
end

subgraph group_population_data["Population data"]
  node_country_metadata["Country metadata<br/>[countries.csv]"]
  node_undb_data["UNDB datasets"]
end

node_source_downloads(("Source downloads"))
node_healthgps(("Health-GPS"))

node_source_downloads -->|"provides CSVs"| node_formatter
node_formatter -->|"formats disease files"| node_disease_inputs
node_formatter -->|"copies cost files"| node_analysis_cost
node_formatter -->|"formats UNDB files"| node_undb_data
node_disease_inputs -->|"supplies input data"| node_healthgps
node_pif_scenarios -->|"supplies input data"| node_healthgps
node_relative_risks -->|"supplies input data"| node_healthgps
node_analysis_cost -->|"supplies input data"| node_healthgps
node_analysis_parameters -->|"supplies input data"| node_healthgps
node_country_metadata -->|"supplies input data"| node_healthgps
node_undb_data -->|"supplies input data"| node_healthgps

click node_formatter "https://github.com/imperialchepi/healthgps-data/blob/main/Scripts%20to%20format%20data/format_healthgps_disease_data.py"
click node_disease_inputs "https://github.com/imperialchepi/healthgps-data/tree/main/data/diseases"
click node_pif_scenarios "https://github.com/imperialchepi/healthgps-data/tree/main/data/diseases"
click node_relative_risks "https://github.com/imperialchepi/healthgps-data/tree/main/data/diseases"
click node_analysis_cost "https://github.com/imperialchepi/healthgps-data/tree/main/data/analysis/cost"
click node_analysis_parameters "https://github.com/imperialchepi/healthgps-data/tree/main/data/analysis"
click node_country_metadata "https://github.com/imperialchepi/healthgps-data/blob/main/data/countries.csv"
click node_undb_data "https://github.com/imperialchepi/healthgps-data/tree/main/data/undb"

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_formatter toneBlue
class node_disease_inputs,node_pif_scenarios,node_relative_risks toneAmber
class node_analysis_cost,node_analysis_parameters toneMint
class node_country_metadata,node_undb_data toneRose
class node_source_downloads,node_healthgps toneIndigo
```

## Components

### Data formatting

- [CSV formatter](https://github.com/imperialchepi/healthgps-data/blob/main/Scripts%20to%20format%20data/format_healthgps_disease_data.py): `Scripts to format data/format_healthgps_disease_data.py`

### Disease data

- [Disease inputs](https://github.com/imperialchepi/healthgps-data/tree/main/data/diseases): `data/diseases`
- [PIF scenarios](https://github.com/imperialchepi/healthgps-data/tree/main/data/diseases): `data/diseases`
- [Relative risks](https://github.com/imperialchepi/healthgps-data/tree/main/data/diseases): `data/diseases`

### Analysis data

- [Cost estimates](https://github.com/imperialchepi/healthgps-data/tree/main/data/analysis/cost): `data/analysis/cost`
- [Analysis parameters](https://github.com/imperialchepi/healthgps-data/tree/main/data/analysis): `data/analysis`

### Population data

- [Country metadata](https://github.com/imperialchepi/healthgps-data/blob/main/data/countries.csv): `data/countries.csv`
- [UNDB datasets](https://github.com/imperialchepi/healthgps-data/tree/main/data/undb): `data/undb`

### Other components

- **Source downloads**
- **Health-GPS**

## Connections

- Source downloads → CSV formatter: provides CSVs (evidence: `Scripts to format data/format_healthgps_disease_data.py`)
- CSV formatter → Disease inputs: formats disease files (evidence: `Scripts to format data/format_healthgps_disease_data.py`)
- CSV formatter → Cost estimates: copies cost files (evidence: `Scripts to format data/format_healthgps_disease_data.py`)
- CSV formatter → UNDB datasets: formats UNDB files (evidence: `Scripts to format data/format_healthgps_disease_data.py`)
- Disease inputs → Health-GPS: supplies input data (evidence: `README.md`)
- PIF scenarios → Health-GPS: supplies input data (evidence: `README.md`)
- Relative risks → Health-GPS: supplies input data (evidence: `README.md`)
- Cost estimates → Health-GPS: supplies input data (evidence: `README.md`)
- Analysis parameters → Health-GPS: supplies input data (evidence: `README.md`)
- Country metadata → Health-GPS: supplies input data (evidence: `README.md`)
- UNDB datasets → Health-GPS: supplies input data (evidence: `README.md`)