# com-480-data-visualization/pixelles architecture

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

- Interactive diagram: https://gitdiagram.com/com-480-data-visualization/pixelles
- Repository: https://github.com/com-480-data-visualization/pixelles

## Overview

PixElles is an interactive, museum-themed data story about natural disasters from 1975–2025. Its user-facing journey presents global disaster patterns through globe and country views, timelines, and narrative chapters, with the README describing analysis across disaster types, geography, and human impact. The tree also shows a prepared EM-DAT dataset and per-country context data. Only the cleaning script was excerpted; links between the browser modules and data assets are therefore not asserted as verified calls.

Main entry points: [`docs/index.html`](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/index.html) (Museum entry), [`docs/js/scene2_globe.js`](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/js/scene2_globe.js) (Globe scene), [`docs/js/scene4_story.js`](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/js/scene4_story.js) (Story scene), [`docs/js/data.js`](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/js/data.js) (Browser data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Museum experience"]
  node_site["Museum entry<br/>[index.html]"]
  node_curators["Curator information<br/>[curators.html]"]
  node_timelinepage["Timeline page"]
  node_overviewpage["Overview page"]
  node_earthpage["Earth story page<br/>[earth_story.html]"]
  node_globepage["Globe page<br/>[globe.html]"]
end

subgraph group_views["Interactive views"]
  node_ticket["Ticket scene<br/>[scene1_ticket.js]"]
  node_globe["Globe scene<br/>[scene2_globe.js]"]
  node_country["Country scene<br/>[scene3_country.js]"]
  node_timeline["Country timeline<br/>[scene3_timeline.js]"]
  node_story["Story scene<br/>[scene4_story.js]"]
  node_overview["Country overview<br/>[scene5_overview.js]"]
end

subgraph group_data["Data assets"]
  node_datajs["Browser data<br/>[data.js]"]
  node_contexts[("Country context")]
  node_chapters["Story chapters"]
  node_sourcefile["EM-DAT workbook"]
  node_cleaned[("Clean disaster data<br/>[emdat_clean.csv]")]
  node_geo["Country boundaries"]
end

subgraph group_prep["Data preparation"]
  node_cleaner["EM-DAT cleaning"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_site
node_site -.->|"begins experience"| node_ticket
node_site -.->|"guides through"| node_globe
node_site -.->|"guides through"| node_country
node_site -.->|"shows trends"| node_timeline
node_site -.->|"tells story"| node_story
node_site -.->|"shows overview"| node_overview
node_cleaner -->|"reads"| node_sourcefile
node_cleaner -->|"writes"| node_cleaned
node_visitor -.->|"opens"| node_curators
node_timelinepage -.->|"hosts"| node_timeline
node_overviewpage -.->|"hosts"| node_overview
node_earthpage -.->|"hosts"| node_story
node_globepage -.->|"hosts"| node_globe
node_datajs -.->|"uses data"| node_cleaned
node_datajs -.->|"uses context"| node_contexts
node_story -.->|"uses chapters"| node_chapters
node_globe -.->|"uses boundaries"| node_geo

click node_site "https://github.com/com-480-data-visualization/pixelles/blob/master/docs/index.html"
click node_ticket "https://github.com/com-480-data-visualization/pixelles/blob/master/docs/js/scene1_ticket.js"
click node_globe "https://github.com/com-480-data-visualization/pixelles/blob/master/docs/js/scene2_globe.js"
click node_country "https://github.com/com-480-data-visualization/pixelles/blob/master/docs/js/scene3_country.js"
click node_timeline "https://github.com/com-480-data-visualization/pixelles/blob/master/docs/js/scene3_timeline.js"
click node_story "https://github.com/com-480-data-visualization/pixelles/blob/master/docs/js/scene4_story.js"
click node_overview "https://github.com/com-480-data-visualization/pixelles/blob/master/docs/js/scene5_overview.js"
click node_curators "https://github.com/com-480-data-visualization/pixelles/blob/master/docs/curators.html"
click node_datajs "https://github.com/com-480-data-visualization/pixelles/blob/master/docs/js/data.js"
click node_contexts "https://github.com/com-480-data-visualization/pixelles/tree/master/docs/data/context"
click node_chapters "https://github.com/com-480-data-visualization/pixelles/blob/master/docs/data/story_chapters.json"
click node_cleaner "https://github.com/com-480-data-visualization/pixelles/blob/master/milestones/milestone-2/create_emdat_clean.py"
click node_sourcefile "https://github.com/com-480-data-visualization/pixelles/blob/master/docs/data/public_emdat_incl_hist_2026-03-17.xlsx"
click node_cleaned "https://github.com/com-480-data-visualization/pixelles/blob/master/docs/data/emdat_clean.csv"
click node_geo "https://github.com/com-480-data-visualization/pixelles/blob/master/docs/data/countries_110m.geojson"
click node_timelinepage "https://github.com/com-480-data-visualization/pixelles/blob/master/docs/country_timeline.html"
click node_overviewpage "https://github.com/com-480-data-visualization/pixelles/blob/master/docs/country_overview.html"
click node_earthpage "https://github.com/com-480-data-visualization/pixelles/blob/master/docs/earth_story.html"
click node_globepage "https://github.com/com-480-data-visualization/pixelles/blob/master/docs/globe.html"

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_site,node_curators,node_timelinepage,node_overviewpage,node_earthpage,node_globepage toneBlue
class node_ticket,node_globe,node_country,node_timeline,node_story,node_overview toneAmber
class node_datajs,node_contexts,node_chapters,node_sourcefile,node_cleaned,node_geo toneMint
class node_cleaner toneRose
class node_visitor toneIndigo
```

## Components

### Museum experience

- [Museum entry](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/index.html): `docs/index.html`
- [Curator information](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/curators.html): `docs/curators.html`
- [Timeline page](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/country_timeline.html): `docs/country_timeline.html`
- [Overview page](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/country_overview.html): `docs/country_overview.html`
- [Earth story page](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/earth_story.html): `docs/earth_story.html`
- [Globe page](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/globe.html): `docs/globe.html`

### Interactive views

- [Ticket scene](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/js/scene1_ticket.js): `docs/js/scene1_ticket.js`
- [Globe scene](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/js/scene2_globe.js): `docs/js/scene2_globe.js`
- [Country scene](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/js/scene3_country.js): `docs/js/scene3_country.js`
- [Country timeline](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/js/scene3_timeline.js): `docs/js/scene3_timeline.js`
- [Story scene](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/js/scene4_story.js): `docs/js/scene4_story.js`
- [Country overview](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/js/scene5_overview.js): `docs/js/scene5_overview.js`

### Data assets

- [Browser data](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/js/data.js): `docs/js/data.js`
- [Country context](https://github.com/com-480-data-visualization/pixelles/tree/master/docs/data/context): `docs/data/context`
- [Story chapters](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/data/story_chapters.json): `docs/data/story_chapters.json`
- [EM-DAT workbook](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/data/public_emdat_incl_hist_2026-03-17.xlsx): `docs/data/public_emdat_incl_hist_2026-03-17.xlsx`
- [Clean disaster data](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/data/emdat_clean.csv): `docs/data/emdat_clean.csv`
- [Country boundaries](https://github.com/com-480-data-visualization/pixelles/blob/master/docs/data/countries_110m.geojson): `docs/data/countries_110m.geojson`

### Data preparation

- [EM-DAT cleaning](https://github.com/com-480-data-visualization/pixelles/blob/master/milestones/milestone-2/create_emdat_clean.py): `milestones/milestone-2/create_emdat_clean.py`

### Other components

- **Visitor**

## Connections

- Visitor → Museum entry: opens (evidence: `README.md`)
- Museum entry → Ticket scene: begins experience
- Museum entry → Globe scene: guides through
- Museum entry → Country scene: guides through
- Museum entry → Country timeline: shows trends
- Museum entry → Story scene: tells story
- Museum entry → Country overview: shows overview
- EM-DAT cleaning → EM-DAT workbook: reads (evidence: `milestones/milestone-2/create_emdat_clean.py`)
- EM-DAT cleaning → Clean disaster data: writes (evidence: `milestones/milestone-2/create_emdat_clean.py`)
- Visitor → Curator information: opens
- Timeline page → Country timeline: hosts
- Overview page → Country overview: hosts
- Earth story page → Story scene: hosts
- Globe page → Globe scene: hosts
- Browser data → Clean disaster data: uses data
- Browser data → Country context: uses context
- Story scene → Story chapters: uses chapters
- Globe scene → Country boundaries: uses boundaries
