# jakevdp/pythondatasciencehandbook architecture

> Architecture diagram of the GitHub repository jakevdp/pythondatasciencehandbook, 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/jakevdp/pythondatasciencehandbook
- Repository: https://github.com/jakevdp/pythondatasciencehandbook

## Overview

This repository is a Jupyter-notebook version of the Python Data Science Handbook. A reader studies the material online or runs notebooks, progressing from IPython and core data tools through visualization and machine learning. The graph preserves the documented chapter areas and execution options. Notebook contents were not sampled, so chapter-to-chapter dependencies are not inferred; workflow edges are based on the README.

Main entry points: [`website/content`](https://github.com/jakevdp/pythondatasciencehandbook/tree/master/website/content) (Online Book), [`notebooks`](https://github.com/jakevdp/pythondatasciencehandbook/tree/master/notebooks) (Executable Notebooks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundations["Python Foundations"]
  node_ipython["IPython"]
end

subgraph group_data["Data Analysis"]
  node_numpy["NumPy"]
  node_pandas["Pandas"]
  node_datasets["Sample Data"]
end

subgraph group_visualization["Visualization"]
  node_matplotlib["Matplotlib"]
  node_seaborn["Seaborn"]
end

subgraph group_learning["Machine Learning"]
  node_scikit_learn["Scikit-learn"]
  node_validation["Model Validation"]
  node_features["Feature Engineering"]
  node_naive_bayes["Naive Bayes"]
  node_regression["Linear Regression"]
  node_svm["Support Vector Machines"]
  node_forests["Random Forests"]
  node_pca["Principal Components"]
  node_manifold["Manifold Learning"]
  node_kmeans["K-Means"]
  node_mixtures["Gaussian Mixtures"]
  node_density["Kernel Density"]
  node_image_features["Image Features"]
end

node_reader(("Reader"))
node_online_book["Online Book"]
node_notebooks["Executable Notebooks"]
node_binder["Binder"]
node_colab["Google Colab"]

node_reader -->|"reads online"| node_online_book
node_reader -->|"runs"| node_notebooks
node_reader -->|"launches notebooks"| node_binder
node_reader -->|"launches notebooks"| node_colab

click node_online_book "https://github.com/jakevdp/pythondatasciencehandbook/tree/master/website/content"
click node_notebooks "https://github.com/jakevdp/pythondatasciencehandbook/tree/master/notebooks"
click node_ipython "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/01.00-IPython-Beyond-Normal-Python.ipynb"
click node_numpy "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/02.00-Introduction-to-NumPy.ipynb"
click node_pandas "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/03.00-Introduction-to-Pandas.ipynb"
click node_matplotlib "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/04.00-Introduction-To-Matplotlib.ipynb"
click node_seaborn "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/04.14-Visualization-With-Seaborn.ipynb"
click node_scikit_learn "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.02-Introducing-Scikit-Learn.ipynb"
click node_validation "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.03-Hyperparameters-and-Model-Validation.ipynb"
click node_features "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.04-Feature-Engineering.ipynb"
click node_naive_bayes "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.05-Naive-Bayes.ipynb"
click node_regression "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.06-Linear-Regression.ipynb"
click node_svm "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.07-Support-Vector-Machines.ipynb"
click node_forests "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.08-Random-Forests.ipynb"
click node_pca "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.09-Principal-Component-Analysis.ipynb"
click node_manifold "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.10-Manifold-Learning.ipynb"
click node_kmeans "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.11-K-Means.ipynb"
click node_mixtures "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.12-Gaussian-Mixtures.ipynb"
click node_density "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.13-Kernel-Density-Estimation.ipynb"
click node_image_features "https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.14-Image-Features.ipynb"
click node_datasets "https://github.com/jakevdp/pythondatasciencehandbook/tree/master/notebooks/data"

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_ipython toneBlue
class node_numpy,node_pandas,node_datasets toneAmber
class node_matplotlib,node_seaborn toneMint
class node_scikit_learn,node_validation,node_features,node_naive_bayes,node_regression,node_svm,node_forests,node_pca,node_manifold,node_kmeans,node_mixtures,node_density,node_image_features toneRose
class node_reader,node_binder,node_colab toneIndigo
class node_online_book,node_notebooks toneTeal
```

## Components

### Python Foundations

- [IPython](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/01.00-IPython-Beyond-Normal-Python.ipynb): `notebooks/01.00-IPython-Beyond-Normal-Python.ipynb`

### Data Analysis

- [NumPy](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/02.00-Introduction-to-NumPy.ipynb): `notebooks/02.00-Introduction-to-NumPy.ipynb`
- [Pandas](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/03.00-Introduction-to-Pandas.ipynb): `notebooks/03.00-Introduction-to-Pandas.ipynb`
- [Sample Data](https://github.com/jakevdp/pythondatasciencehandbook/tree/master/notebooks/data): `notebooks/data`

### Visualization

- [Matplotlib](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/04.00-Introduction-To-Matplotlib.ipynb): `notebooks/04.00-Introduction-To-Matplotlib.ipynb`
- [Seaborn](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/04.14-Visualization-With-Seaborn.ipynb): `notebooks/04.14-Visualization-With-Seaborn.ipynb`

### Machine Learning

- [Scikit-learn](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.02-Introducing-Scikit-Learn.ipynb): `notebooks/05.02-Introducing-Scikit-Learn.ipynb`
- [Model Validation](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.03-Hyperparameters-and-Model-Validation.ipynb): `notebooks/05.03-Hyperparameters-and-Model-Validation.ipynb`
- [Feature Engineering](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.04-Feature-Engineering.ipynb): `notebooks/05.04-Feature-Engineering.ipynb`
- [Naive Bayes](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.05-Naive-Bayes.ipynb): `notebooks/05.05-Naive-Bayes.ipynb`
- [Linear Regression](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.06-Linear-Regression.ipynb): `notebooks/05.06-Linear-Regression.ipynb`
- [Support Vector Machines](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.07-Support-Vector-Machines.ipynb): `notebooks/05.07-Support-Vector-Machines.ipynb`
- [Random Forests](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.08-Random-Forests.ipynb): `notebooks/05.08-Random-Forests.ipynb`
- [Principal Components](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.09-Principal-Component-Analysis.ipynb): `notebooks/05.09-Principal-Component-Analysis.ipynb`
- [Manifold Learning](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.10-Manifold-Learning.ipynb): `notebooks/05.10-Manifold-Learning.ipynb`
- [K-Means](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.11-K-Means.ipynb): `notebooks/05.11-K-Means.ipynb`
- [Gaussian Mixtures](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.12-Gaussian-Mixtures.ipynb): `notebooks/05.12-Gaussian-Mixtures.ipynb`
- [Kernel Density](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.13-Kernel-Density-Estimation.ipynb): `notebooks/05.13-Kernel-Density-Estimation.ipynb`
- [Image Features](https://github.com/jakevdp/pythondatasciencehandbook/blob/master/notebooks/05.14-Image-Features.ipynb): `notebooks/05.14-Image-Features.ipynb`

### Other components

- **Reader**
- [Online Book](https://github.com/jakevdp/pythondatasciencehandbook/tree/master/website/content): `website/content`
- [Executable Notebooks](https://github.com/jakevdp/pythondatasciencehandbook/tree/master/notebooks): `notebooks`
- **Binder**
- **Google Colab**

## Connections

- Reader → Online Book: reads online (evidence: `README.md`)
- Reader → Executable Notebooks: runs (evidence: `README.md`)
- Reader → Binder: launches notebooks (evidence: `README.md`)
- Reader → Google Colab: launches notebooks (evidence: `README.md`)
