# empathy87/storytelling-with-data architecture

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

- Interactive diagram: https://gitdiagram.com/empathy87/storytelling-with-data
- Repository: https://github.com/empathy87/storytelling-with-data

## Overview

This repository is a collection of Python/matplotlib Jupyter notebooks that recreate data-visualization examples from Storytelling with Data. The user workflow is to open a figure notebook and use its documented plot as an example; the README also presents a color palette through image assets. The tree and README do not establish calls between notebooks or a shared runtime, so the graph represents these as independent examples rather than an invented processing pipeline.

Main entry points: [`vertical-bar/figure-0-5.ipynb`](https://github.com/empathy87/storytelling-with-data/blob/master/vertical-bar/figure-0-5.ipynb) (Vertical bars), [`vertical-bar/figure-5-13.ipynb`](https://github.com/empathy87/storytelling-with-data/blob/master/vertical-bar/figure-5-13.ipynb) (Figure 5.13), [`vertical-bar/figure-6-4.ipynb`](https://github.com/empathy87/storytelling-with-data/blob/master/vertical-bar/figure-6-4.ipynb) (Figure 6.4), [`horizontal-bar/figure-3-14.ipynb`](https://github.com/empathy87/storytelling-with-data/blob/master/horizontal-bar/figure-3-14.ipynb) (Figure 3.34)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bar["Bar Charts"]
  node_vertical["Vertical bars<br/>[figure-0-5.ipynb]"]
  node_vertical513["Figure 5.13<br/>[figure-5-13.ipynb]"]
  node_vertical64["Figure 6.4<br/>[figure-6-4.ipynb]"]
  node_horizontal314["Figure 3.34<br/>[figure-3-14.ipynb]"]
  node_horizontal49["Figure 4.9<br/>[figure-4-9.ipynb]"]
end

subgraph group_other["Other Figures"]
  node_slope["Slopegraph<br/>[figure-9-32.ipynb]"]
  node_simple["Simple text<br/>[figure-9-29.ipynb]"]
  node_scatter["Scatterplot<br/>[figure-5-6.ipynb]"]
  node_line["Line chart<br/>[figure-5-10.ipynb]"]
  node_paper["Paper example"]
  node_talk["Talk presentation"]
end

subgraph group_palette["Color Palette"]
  node_colors["Palette assets"]
end

node_reader(("Reader"))

node_reader -->|"opens example"| node_vertical
node_reader -->|"opens example"| node_vertical513
node_reader -->|"opens example"| node_vertical64
node_reader -->|"opens example"| node_horizontal314
node_reader -->|"opens example"| node_horizontal49
node_reader -->|"opens example"| node_slope
node_reader -->|"opens example"| node_simple
node_reader -->|"opens example"| node_scatter
node_reader -->|"opens example"| node_line
node_reader -->|"views palette"| node_colors

click node_vertical "https://github.com/empathy87/storytelling-with-data/blob/master/vertical-bar/figure-0-5.ipynb"
click node_vertical513 "https://github.com/empathy87/storytelling-with-data/blob/master/vertical-bar/figure-5-13.ipynb"
click node_vertical64 "https://github.com/empathy87/storytelling-with-data/blob/master/vertical-bar/figure-6-4.ipynb"
click node_horizontal314 "https://github.com/empathy87/storytelling-with-data/blob/master/horizontal-bar/figure-3-14.ipynb"
click node_horizontal49 "https://github.com/empathy87/storytelling-with-data/blob/master/horizontal-bar/figure-4-9.ipynb"
click node_slope "https://github.com/empathy87/storytelling-with-data/blob/master/slopegraph/figure-9-32.ipynb"
click node_simple "https://github.com/empathy87/storytelling-with-data/blob/master/simple-text/figure-9-29.ipynb"
click node_scatter "https://github.com/empathy87/storytelling-with-data/blob/master/scatterplot/figure-5-6.ipynb"
click node_line "https://github.com/empathy87/storytelling-with-data/blob/master/line/figure-5-10.ipynb"
click node_paper "https://github.com/empathy87/storytelling-with-data/blob/master/slopegraph/HabrMailRuPaper.ipynb"
click node_talk "https://github.com/empathy87/storytelling-with-data/blob/master/talks/winter_school/presentation%20plots.ipynb"
click node_colors "https://github.com/empathy87/storytelling-with-data/tree/master/images/colors"

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_vertical,node_vertical513,node_vertical64,node_horizontal314,node_horizontal49 toneBlue
class node_slope,node_simple,node_scatter,node_line,node_paper,node_talk toneAmber
class node_colors toneMint
class node_reader toneIndigo
```

## Components

### Bar Charts

- [Vertical bars](https://github.com/empathy87/storytelling-with-data/blob/master/vertical-bar/figure-0-5.ipynb): `vertical-bar/figure-0-5.ipynb`
- [Figure 5.13](https://github.com/empathy87/storytelling-with-data/blob/master/vertical-bar/figure-5-13.ipynb): `vertical-bar/figure-5-13.ipynb`
- [Figure 6.4](https://github.com/empathy87/storytelling-with-data/blob/master/vertical-bar/figure-6-4.ipynb): `vertical-bar/figure-6-4.ipynb`
- [Figure 3.34](https://github.com/empathy87/storytelling-with-data/blob/master/horizontal-bar/figure-3-14.ipynb): `horizontal-bar/figure-3-14.ipynb`
- [Figure 4.9](https://github.com/empathy87/storytelling-with-data/blob/master/horizontal-bar/figure-4-9.ipynb): `horizontal-bar/figure-4-9.ipynb`

### Other Figures

- [Slopegraph](https://github.com/empathy87/storytelling-with-data/blob/master/slopegraph/figure-9-32.ipynb): `slopegraph/figure-9-32.ipynb`
- [Simple text](https://github.com/empathy87/storytelling-with-data/blob/master/simple-text/figure-9-29.ipynb): `simple-text/figure-9-29.ipynb`
- [Scatterplot](https://github.com/empathy87/storytelling-with-data/blob/master/scatterplot/figure-5-6.ipynb): `scatterplot/figure-5-6.ipynb`
- [Line chart](https://github.com/empathy87/storytelling-with-data/blob/master/line/figure-5-10.ipynb): `line/figure-5-10.ipynb`
- [Paper example](https://github.com/empathy87/storytelling-with-data/blob/master/slopegraph/HabrMailRuPaper.ipynb): `slopegraph/HabrMailRuPaper.ipynb`
- [Talk presentation](https://github.com/empathy87/storytelling-with-data/blob/master/talks/winter_school/presentation%20plots.ipynb): `talks/winter_school/presentation plots.ipynb`

### Color Palette

- [Palette assets](https://github.com/empathy87/storytelling-with-data/tree/master/images/colors): `images/colors`

### Other components

- **Reader**

## Connections

- Reader → Vertical bars: opens example (evidence: `README.md`)
- Reader → Figure 5.13: opens example (evidence: `README.md`)
- Reader → Figure 6.4: opens example (evidence: `README.md`)
- Reader → Figure 3.34: opens example (evidence: `README.md`)
- Reader → Figure 4.9: opens example (evidence: `README.md`)
- Reader → Slopegraph: opens example (evidence: `README.md`)
- Reader → Simple text: opens example (evidence: `README.md`)
- Reader → Scatterplot: opens example (evidence: `README.md`)
- Reader → Line chart: opens example (evidence: `README.md`)
- Reader → Palette assets: views palette (evidence: `README.md`)