# jakevdp/sklearn_pycon2015 architecture

> Architecture diagram of the GitHub repository jakevdp/sklearn_pycon2015, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jakevdp/sklearn_pycon2015
- Repository: https://github.com/jakevdp/sklearn_pycon2015

## Overview

##### Project type and purpose
- This repository is not a traditional web or service-based application but an open-source tutorial package for teaching machine-learning with scikit-learn via Jupyter notebooks.

##### File structure
- Top-level:
- README.md, LICENSE, .gitignore – metadata and setup guidance
- notebooks/ – all the tutorial content
- Inside notebooks/:
- .ipynb files – sequential tutorial chapters
- fig_code/ – a Python package with helper modules (`data.py`, `figures.py`, etc.) that generate the tutorial plots and utilities
- images/ – static assets used by notebooks
- No separate “frontend” vs. “backend” directories, no deployment scripts. All code runs locally inside Jupyter.

##### README for additional insights
- The README spells out required Python versions, dependencies (numpy, scipy, matplotlib, scikit-learn, seaborn), and how to install via conda.
- It emphasizes that users will run `ipython notebook` locally to launch and interact with the material.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI Layer
    Browser["User Browser/UI"]:::ui
    Browser -->|"HTTP/WebSocket"| NotebookServer

    %% Server Layer
    NotebookServer["Jupyter Notebook Server"]:::server
    NotebookServer -->|"ZMQ execute_request"| Kernel
    Kernel["Python Kernel"]:::execution
    Kernel -->|"execute_result/display_data"| NotebookServer
    NotebookServer -->|"JSON over WebSocket"| Browser

    %% Environment
    Conda["Conda Environment"]:::env

    %% Code Assets
    subgraph "Tutorial Content" 
        direction TB
        NotebooksDir["Notebooks Directory"]:::code
        subgraph "Notebooks" 
            direction TB
            NB1["01-Preliminaries.ipynb"]:::code
            NB2["02.1-Machine-Learning-Intro.ipynb"]:::code
            NB3["02.2-Basic-Principles.ipynb"]:::code
            NB4["03.1-Classification-SVMs.ipynb"]:::code
            NB5["03.2-Regression-Forests.ipynb"]:::code
            NB6["04.1-Dimensionality-PCA.ipynb"]:::code
            NB7["04.2-Clustering-KMeans.ipynb"]:::code
            NB8["04.3-Density-GMM.ipynb"]:::code
            NB9["05-Validation.ipynb"]:::code
            NB10["Index.ipynb"]:::code
            NB11["URL.ipynb"]:::code
        end
        NotebooksDir --> NotebooksDir
        NotebooksDir --> NB1
        NotebooksDir --> NB2
        NotebooksDir --> NB3
        NotebooksDir --> NB4
        NotebooksDir --> NB5
        NotebooksDir --> NB6
        NotebooksDir --> NB7
        NotebooksDir --> NB8
        NotebooksDir --> NB9
        NotebooksDir --> NB10
        NotebooksDir --> NB11

        subgraph "fig_code Package" 
            direction TB
            FCpkg["fig_code"]:::code
            FC1["ML_flow_chart.py"]:::code
            FC2["data.py"]:::code
            FC3["figures.py"]:::code
            FC4["helpers.py"]:::code
            FC5["linear_regression.py"]:::code
            FC6["sgd_separator.py"]:::code
            FC7["svm_gui.py"]:::code
        end
        NotebooksDir --> FCpkg
        FCpkg --> FC1
        FCpkg --> FC2
        FCpkg --> FC3
        FCpkg --> FC4
        FCpkg --> FC5
        FCpkg --> FC6
        FCpkg --> FC7

        Images["images Folder"]:::assets
        NotebooksDir --> Images
    end

    %% Dependencies
    subgraph "External Dependencies"
        direction TB
        Numpy["numpy"]:::deps
        SciPy["scipy"]:::deps
        Matplotlib["matplotlib"]:::deps
        Sklearn["scikit-learn"]:::deps
        Seaborn["seaborn"]:::deps
    end

    Kernel -->|"import & function calls"| FCpkg
    Kernel -->|"import & function calls"| Numpy
    Kernel -->|"import & function calls"| SciPy
    Kernel -->|"import & function calls"| Matplotlib
    Kernel -->|"import & function calls"| Sklearn
    Kernel -->|"import & function calls"| Seaborn

    NotebookServer -->|"loads notebooks & assets"| NotebooksDir
    NotebookServer -->|"serves images"| Images

    Conda -->|"manages"| Kernel
    Conda -->|"provides"| Numpy
    Conda -->|"provides"| SciPy
    Conda -->|"provides"| Matplotlib
    Conda -->|"provides"| Sklearn
    Conda -->|"provides"| Seaborn

    %% Click Events
    click NotebooksDir "https://github.com/jakevdp/sklearn_pycon2015/tree/master/notebooks/"
    click NB1 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/01-Preliminaries.ipynb"
    click NB2 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/02.1-Machine-Learning-Intro.ipynb"
    click NB3 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/02.2-Basic-Principles.ipynb"
    click NB4 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/03.1-Classification-SVMs.ipynb"
    click NB5 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/03.2-Regression-Forests.ipynb"
    click NB6 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/04.1-Dimensionality-PCA.ipynb"
    click NB7 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/04.2-Clustering-KMeans.ipynb"
    click NB8 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/04.3-Density-GMM.ipynb"
    click NB9 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/05-Validation.ipynb"
    click NB10 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/Index.ipynb"
    click NB11 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/URL.ipynb"
    click FCpkg "https://github.com/jakevdp/sklearn_pycon2015/tree/master/notebooks/fig_code/"
    click FC1 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/fig_code/ML_flow_chart.py"
    click FC2 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/fig_code/data.py"
    click FC3 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/fig_code/figures.py"
    click FC4 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/fig_code/helpers.py"
    click FC5 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/fig_code/linear_regression.py"
    click FC6 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/fig_code/sgd_separator.py"
    click FC7 "https://github.com/jakevdp/sklearn_pycon2015/blob/master/notebooks/fig_code/svm_gui.py"
    click Images "https://github.com/jakevdp/sklearn_pycon2015/tree/master/notebooks/images/"

    %% Styles
    classDef ui fill:#AEDFF7,stroke:#333,stroke-width:1px
    classDef server fill:#F7D6AE,stroke:#333,stroke-width:1px
    classDef execution fill:#D5F7AE,stroke:#333,stroke-width:1px
    classDef code fill:#EAEAEA,stroke:#333,stroke-width:1px
    classDef assets fill:#FFD1DC,stroke:#333,stroke-width:1px
    classDef deps fill:#F0E68C,stroke:#333,stroke-width:1px
    classDef env fill:#D3D3D3,stroke:#333,stroke-width:1px
```
