# wesm/pydata-book architecture

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

- Interactive diagram: https://gitdiagram.com/wesm/pydata-book
- Repository: https://github.com/wesm/pydata-book

## Overview

This repository is an educational book companion: readers work through Jupyter notebooks covering Python, NumPy, pandas, data workflows, visualization, time series, modeling, and applied analysis. The README acts as the documented chapter index; datasets and examples are supporting materials, but the sampled files do not establish which notebooks load them. Notebook internals were not sampled, so the graph shows documented access rather than inferred calls or a chapter-to-chapter execution pipeline.

Main entry points: [`README.md`](https://github.com/wesm/pydata-book/blob/3rd-edition/README.md) (Book Index), [`ch02.ipynb`](https://github.com/wesm/pydata-book/blob/3rd-edition/ch02.ipynb) (Python Basics), [`ch03.ipynb`](https://github.com/wesm/pydata-book/blob/3rd-edition/ch03.ipynb) (Structures and Files), [`ch04.ipynb`](https://github.com/wesm/pydata-book/blob/3rd-edition/ch04.ipynb) (NumPy Arrays)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundations["Python Foundations"]
  node_ch02["Python Basics<br/>[ch02.ipynb]"]
  node_ch03["Structures and Files<br/>[ch03.ipynb]"]
  node_ch04["NumPy Arrays<br/>[ch04.ipynb]"]
  node_appa["Advanced NumPy<br/>[appa.ipynb]"]
end

subgraph group_data["Data Analysis"]
  node_ch05["pandas Basics<br/>[ch05.ipynb]"]
  node_ch06["Loading and Storage<br/>[ch06.ipynb]"]
  node_ch07["Data Cleaning<br/>[ch07.ipynb]"]
  node_ch08["Data Wrangling<br/>[ch08.ipynb]"]
end

subgraph group_methods["Analysis Methods"]
  node_ch09["Visualization<br/>[ch09.ipynb]"]
  node_ch10["Aggregation<br/>[ch10.ipynb]"]
  node_ch11["Time Series<br/>[ch11.ipynb]"]
  node_ch12["Modeling Libraries<br/>[ch12.ipynb]"]
  node_ch13["Analysis Examples<br/>[ch13.ipynb]"]
end

subgraph group_materials["Learning Materials"]
  node_readme["Book Index<br/>[README.md]"]
  node_appb["Appendix Notebook<br/>[appb.ipynb]"]
  node_datasets[("Sample Datasets")]
  node_examples[("Example Files")]
end

node_reader(("Reader"))

node_reader -->|"finds materials"| node_readme
node_readme -->|"lists notebook"| node_ch02
node_readme -->|"lists notebook"| node_ch03
node_readme -->|"lists notebook"| node_ch04
node_readme -->|"lists notebook"| node_ch05
node_readme -->|"lists notebook"| node_ch06
node_readme -->|"lists notebook"| node_ch07
node_readme -->|"lists notebook"| node_ch08
node_readme -->|"lists notebook"| node_ch09
node_readme -->|"lists notebook"| node_ch10
node_readme -->|"lists notebook"| node_ch11
node_readme -->|"lists notebook"| node_ch12
node_readme -->|"lists notebook"| node_ch13
node_readme -->|"lists appendix"| node_appa

click node_readme "https://github.com/wesm/pydata-book/blob/3rd-edition/README.md"
click node_ch02 "https://github.com/wesm/pydata-book/blob/3rd-edition/ch02.ipynb"
click node_ch03 "https://github.com/wesm/pydata-book/blob/3rd-edition/ch03.ipynb"
click node_ch04 "https://github.com/wesm/pydata-book/blob/3rd-edition/ch04.ipynb"
click node_appa "https://github.com/wesm/pydata-book/blob/3rd-edition/appa.ipynb"
click node_ch05 "https://github.com/wesm/pydata-book/blob/3rd-edition/ch05.ipynb"
click node_ch06 "https://github.com/wesm/pydata-book/blob/3rd-edition/ch06.ipynb"
click node_ch07 "https://github.com/wesm/pydata-book/blob/3rd-edition/ch07.ipynb"
click node_ch08 "https://github.com/wesm/pydata-book/blob/3rd-edition/ch08.ipynb"
click node_ch09 "https://github.com/wesm/pydata-book/blob/3rd-edition/ch09.ipynb"
click node_ch10 "https://github.com/wesm/pydata-book/blob/3rd-edition/ch10.ipynb"
click node_ch11 "https://github.com/wesm/pydata-book/blob/3rd-edition/ch11.ipynb"
click node_ch12 "https://github.com/wesm/pydata-book/blob/3rd-edition/ch12.ipynb"
click node_ch13 "https://github.com/wesm/pydata-book/blob/3rd-edition/ch13.ipynb"
click node_appb "https://github.com/wesm/pydata-book/blob/3rd-edition/appb.ipynb"
click node_datasets "https://github.com/wesm/pydata-book/tree/3rd-edition/datasets"
click node_examples "https://github.com/wesm/pydata-book/tree/3rd-edition/examples"

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_ch02,node_ch03,node_ch04,node_appa toneBlue
class node_ch05,node_ch06,node_ch07,node_ch08 toneAmber
class node_ch09,node_ch10,node_ch11,node_ch12,node_ch13 toneMint
class node_readme,node_appb,node_datasets,node_examples toneRose
class node_reader toneIndigo
```

## Components

### Python Foundations

- [Python Basics](https://github.com/wesm/pydata-book/blob/3rd-edition/ch02.ipynb): `ch02.ipynb`
- [Structures and Files](https://github.com/wesm/pydata-book/blob/3rd-edition/ch03.ipynb): `ch03.ipynb`
- [NumPy Arrays](https://github.com/wesm/pydata-book/blob/3rd-edition/ch04.ipynb): `ch04.ipynb`
- [Advanced NumPy](https://github.com/wesm/pydata-book/blob/3rd-edition/appa.ipynb): `appa.ipynb`

### Data Analysis

- [pandas Basics](https://github.com/wesm/pydata-book/blob/3rd-edition/ch05.ipynb): `ch05.ipynb`
- [Loading and Storage](https://github.com/wesm/pydata-book/blob/3rd-edition/ch06.ipynb): `ch06.ipynb`
- [Data Cleaning](https://github.com/wesm/pydata-book/blob/3rd-edition/ch07.ipynb): `ch07.ipynb`
- [Data Wrangling](https://github.com/wesm/pydata-book/blob/3rd-edition/ch08.ipynb): `ch08.ipynb`

### Analysis Methods

- [Visualization](https://github.com/wesm/pydata-book/blob/3rd-edition/ch09.ipynb): `ch09.ipynb`
- [Aggregation](https://github.com/wesm/pydata-book/blob/3rd-edition/ch10.ipynb): `ch10.ipynb`
- [Time Series](https://github.com/wesm/pydata-book/blob/3rd-edition/ch11.ipynb): `ch11.ipynb`
- [Modeling Libraries](https://github.com/wesm/pydata-book/blob/3rd-edition/ch12.ipynb): `ch12.ipynb`
- [Analysis Examples](https://github.com/wesm/pydata-book/blob/3rd-edition/ch13.ipynb): `ch13.ipynb`

### Learning Materials

- [Book Index](https://github.com/wesm/pydata-book/blob/3rd-edition/README.md): `README.md`
- [Appendix Notebook](https://github.com/wesm/pydata-book/blob/3rd-edition/appb.ipynb): `appb.ipynb`
- [Sample Datasets](https://github.com/wesm/pydata-book/tree/3rd-edition/datasets): `datasets`
- [Example Files](https://github.com/wesm/pydata-book/tree/3rd-edition/examples): `examples`

### Other components

- **Reader**

## Connections

- Reader → Book Index: finds materials (evidence: `README.md`)
- Book Index → Python Basics: lists notebook (evidence: `README.md`)
- Book Index → Structures and Files: lists notebook (evidence: `README.md`)
- Book Index → NumPy Arrays: lists notebook (evidence: `README.md`)
- Book Index → pandas Basics: lists notebook (evidence: `README.md`)
- Book Index → Loading and Storage: lists notebook (evidence: `README.md`)
- Book Index → Data Cleaning: lists notebook (evidence: `README.md`)
- Book Index → Data Wrangling: lists notebook (evidence: `README.md`)
- Book Index → Visualization: lists notebook (evidence: `README.md`)
- Book Index → Aggregation: lists notebook (evidence: `README.md`)
- Book Index → Time Series: lists notebook (evidence: `README.md`)
- Book Index → Modeling Libraries: lists notebook (evidence: `README.md`)
- Book Index → Analysis Examples: lists notebook (evidence: `README.md`)
- Book Index → Advanced NumPy: lists appendix (evidence: `README.md`)
