# ipython-books/cookbook-2nd architecture

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

- Interactive diagram: https://gitdiagram.com/ipython-books/cookbook-2nd
- Repository: https://github.com/ipython-books/cookbook-2nd

## Overview

This repository is the Markdown source for the *IPython Interactive Computing and Visualization Cookbook, Second Edition*: a collection of hands-on recipes for interactive computing and data science. The principal workflow is that a reader selects a recipe from the book’s contents, follows it, and applies its techniques in a Jupyter Notebook. The README also points readers to a separate repository for notebook code. Chapter nodes represent content directories rather than runtime modules; the sampled source is primarily site and notebook generation tooling, which is not part of the book’s product architecture.

Main entry points: [`chapter01_basic`](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter01_basic) (Computing basics), [`chapter02_best_practices`](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter02_best_practices) (Best practices), [`chapter03_notebook`](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter03_notebook) (Notebook craft), [`chapter04_optimization`](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter04_optimization) (Profiling and optimization)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundations["Interactive Computing"]
  node_basics["Computing basics"]
  node_practice["Best practices"]
end

subgraph group_notebooks["Notebook and Performance"]
  node_notebook["Notebook craft"]
  node_optimization["Profiling and optimization"]
  node_hpc["High-performance computing"]
end

subgraph group_data["Data Science"]
  node_visualization["Data visualization"]
  node_statistics["Statistical analysis"]
  node_machinelearning["Machine learning"]
end

subgraph group_numerical["Numerical Methods"]
  node_numericaloptimization["Numerical optimization"]
  node_signal["Signal processing"]
  node_image["Image processing"]
end

subgraph group_scientific["Scientific Computing"]
  node_deterministic["Deterministic models"]
  node_stochastic["Stochastic models"]
  node_graphgeo["Graphs and geospatial"]
  node_symbolic["Symbolic computing"]
end

node_reader(("Book reader"))
node_notebookcode["Notebook code repository"]

node_reader -->|"reads recipes"| node_basics
node_reader -->|"reads recipes"| node_practice
node_reader -->|"reads recipes"| node_notebook
node_reader -->|"reads recipes"| node_optimization
node_reader -->|"reads recipes"| node_hpc
node_reader -->|"reads recipes"| node_visualization
node_reader -->|"reads recipes"| node_statistics
node_reader -->|"reads recipes"| node_machinelearning
node_reader -->|"reads recipes"| node_numericaloptimization
node_reader -->|"reads recipes"| node_signal
node_reader -->|"reads recipes"| node_image
node_reader -->|"reads recipes"| node_deterministic
node_reader -->|"reads recipes"| node_stochastic
node_reader -->|"reads recipes"| node_graphgeo
node_reader -->|"reads recipes"| node_symbolic
node_reader -->|"gets notebook code"| node_notebookcode

click node_basics "https://github.com/ipython-books/cookbook-2nd/tree/master/chapter01_basic"
click node_practice "https://github.com/ipython-books/cookbook-2nd/tree/master/chapter02_best_practices"
click node_notebook "https://github.com/ipython-books/cookbook-2nd/tree/master/chapter03_notebook"
click node_optimization "https://github.com/ipython-books/cookbook-2nd/tree/master/chapter04_optimization"
click node_hpc "https://github.com/ipython-books/cookbook-2nd/tree/master/chapter05_hpc"
click node_visualization "https://github.com/ipython-books/cookbook-2nd/tree/master/chapter06_viz"
click node_statistics "https://github.com/ipython-books/cookbook-2nd/tree/master/chapter07_stats"
click node_machinelearning "https://github.com/ipython-books/cookbook-2nd/tree/master/chapter08_ml"
click node_numericaloptimization "https://github.com/ipython-books/cookbook-2nd/tree/master/chapter09_numoptim"
click node_signal "https://github.com/ipython-books/cookbook-2nd/tree/master/chapter10_signal"
click node_image "https://github.com/ipython-books/cookbook-2nd/tree/master/chapter11_image"
click node_deterministic "https://github.com/ipython-books/cookbook-2nd/tree/master/chapter12_deterministic"
click node_stochastic "https://github.com/ipython-books/cookbook-2nd/tree/master/chapter13_stochastic"
click node_graphgeo "https://github.com/ipython-books/cookbook-2nd/tree/master/chapter14_graphgeo"
click node_symbolic "https://github.com/ipython-books/cookbook-2nd/tree/master/chapter15_symbolic"

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_basics,node_practice toneBlue
class node_notebook,node_optimization,node_hpc toneAmber
class node_visualization,node_statistics,node_machinelearning toneMint
class node_numericaloptimization,node_signal,node_image toneRose
class node_deterministic,node_stochastic,node_graphgeo,node_symbolic,node_reader,node_notebookcode toneIndigo
```

## Components

### Interactive Computing

- [Computing basics](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter01_basic): `chapter01_basic`
- [Best practices](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter02_best_practices): `chapter02_best_practices`

### Notebook and Performance

- [Notebook craft](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter03_notebook): `chapter03_notebook`
- [Profiling and optimization](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter04_optimization): `chapter04_optimization`
- [High-performance computing](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter05_hpc): `chapter05_hpc`

### Data Science

- [Data visualization](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter06_viz): `chapter06_viz`
- [Statistical analysis](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter07_stats): `chapter07_stats`
- [Machine learning](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter08_ml): `chapter08_ml`

### Numerical Methods

- [Numerical optimization](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter09_numoptim): `chapter09_numoptim`
- [Signal processing](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter10_signal): `chapter10_signal`
- [Image processing](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter11_image): `chapter11_image`

### Scientific Computing

- [Deterministic models](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter12_deterministic): `chapter12_deterministic`
- [Stochastic models](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter13_stochastic): `chapter13_stochastic`
- [Graphs and geospatial](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter14_graphgeo): `chapter14_graphgeo`
- [Symbolic computing](https://github.com/ipython-books/cookbook-2nd/tree/master/chapter15_symbolic): `chapter15_symbolic`

### Other components

- **Book reader**
- **Notebook code repository**

## Connections

- Book reader → Computing basics: reads recipes (evidence: `README.md`)
- Book reader → Best practices: reads recipes (evidence: `README.md`)
- Book reader → Notebook craft: reads recipes (evidence: `README.md`)
- Book reader → Profiling and optimization: reads recipes (evidence: `README.md`)
- Book reader → High-performance computing: reads recipes (evidence: `README.md`)
- Book reader → Data visualization: reads recipes (evidence: `README.md`)
- Book reader → Statistical analysis: reads recipes (evidence: `README.md`)
- Book reader → Machine learning: reads recipes (evidence: `README.md`)
- Book reader → Numerical optimization: reads recipes (evidence: `README.md`)
- Book reader → Signal processing: reads recipes (evidence: `README.md`)
- Book reader → Image processing: reads recipes (evidence: `README.md`)
- Book reader → Deterministic models: reads recipes (evidence: `README.md`)
- Book reader → Stochastic models: reads recipes (evidence: `README.md`)
- Book reader → Graphs and geospatial: reads recipes (evidence: `README.md`)
- Book reader → Symbolic computing: reads recipes (evidence: `README.md`)
- Book reader → Notebook code repository: gets notebook code (evidence: `README.md`)
