# mukundth/learndatascience architecture

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

- Interactive diagram: https://gitdiagram.com/mukundth/learndatascience
- Repository: https://github.com/mukundth/learndatascience

## Overview

Learn Data Science is a collection of interactive notebooks and datasets for teaching four techniques. The documented learning path moves from an overview through data exploration to analysis; worksheets provide code-focused practice. The README identifies loans data for regression, human-activity sensor data for random forests, and UN economic data. Supporting Python helpers implement plotting, clustering, and related utilities, but the available excerpts do not show which notebooks invoke them, so those links are omitted.

Main entry points: [`notebooks/A2. Linear Regression - Data Exploration - Lending Club.ipynb`](https://github.com/mukundth/learndatascience/blob/master/notebooks/A2.%20Linear%20Regression%20-%20Data%20Exploration%20-%20Lending%20Club.ipynb) (Linear exploration), [`notebooks/B2. Logistic Regression - Data Exploration.ipynb`](https://github.com/mukundth/learndatascience/blob/master/notebooks/B2.%20Logistic%20Regression%20-%20Data%20Exploration.ipynb) (Logistic exploration), [`notebooks/C2. Random Forests - Data Exploration.ipynb`](https://github.com/mukundth/learndatascience/blob/master/notebooks/C2.%20Random%20Forests%20-%20Data%20Exploration.ipynb) (Forest exploration), [`notebooks/D2. K-Means Clustering - Data Exploration.ipynb`](https://github.com/mukundth/learndatascience/blob/master/notebooks/D2.%20K-Means%20Clustering%20-%20Data%20Exploration.ipynb) (K-means exploration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_curriculum["Learning materials"]
  node_worksheets["Code worksheets"]
end

subgraph group_regression["Regression lessons"]
  node_lin_overview["Linear overview"]
  node_lin_explore["Linear exploration"]
  node_lin_analysis["Linear analysis"]
  node_log_overview["Logistic overview"]
  node_log_supplement["Odds and logit"]
  node_log_explore["Logistic exploration"]
  node_log_analysis["Logistic analysis"]
end

subgraph group_forest["Random forests"]
  node_forest_overview["Forest overview"]
  node_forest_explore["Forest exploration"]
  node_forest_analysis["Forest analysis"]
end

subgraph group_clustering["K-means clustering"]
  node_kmeans_overview["K-means overview"]
  node_kmeans_explore["K-means exploration"]
  node_kmeans_analysis["K-means analysis"]
end

subgraph group_resources["Data and helpers"]
  node_loan_data[("Loan datasets")]
  node_har_data[("Activity data")]
  node_un_data[("UN data")]
  node_lin_helpers["Linear helpers<br/>[linreg.py]"]
  node_log_helpers["Logistic helpers<br/>[logreg.py]"]
  node_forest_helpers["Forest helpers<br/>[randomforests.py]"]
  node_kmeans_helpers["Clustering helpers<br/>[kmeans.py]"]
end

node_learner(("Learner"))

node_learner -->|"studies"| node_lin_overview
node_learner -->|"studies"| node_log_overview
node_learner -->|"studies"| node_forest_overview
node_learner -->|"studies"| node_kmeans_overview
node_lin_overview -->|"continues to"| node_lin_explore
node_lin_explore -->|"continues to"| node_lin_analysis
node_log_overview -->|"continues to"| node_log_explore
node_log_explore -->|"continues to"| node_log_analysis
node_forest_overview -->|"continues to"| node_forest_explore
node_forest_explore -->|"continues to"| node_forest_analysis
node_kmeans_overview -->|"continues to"| node_kmeans_explore
node_kmeans_explore -->|"continues to"| node_kmeans_analysis
node_lin_explore -->|"uses"| node_loan_data
node_log_explore -->|"uses"| node_loan_data
node_forest_explore -->|"uses"| node_har_data
node_kmeans_explore -->|"uses"| node_un_data

click node_worksheets "https://github.com/mukundth/learndatascience/tree/master/notebooks"
click node_lin_overview "https://github.com/mukundth/learndatascience/blob/master/notebooks/A1.%20Linear%20Regression%20-%20Overview.ipynb"
click node_lin_explore "https://github.com/mukundth/learndatascience/blob/master/notebooks/A2.%20Linear%20Regression%20-%20Data%20Exploration%20-%20Lending%20Club.ipynb"
click node_lin_analysis "https://github.com/mukundth/learndatascience/blob/master/notebooks/A3.%20Linear%20Regression%20-%20Analysis.ipynb"
click node_log_overview "https://github.com/mukundth/learndatascience/blob/master/notebooks/B1.%20Logistic%20Regression%20-%20Overview.ipynb"
click node_log_supplement "https://github.com/mukundth/learndatascience/blob/master/notebooks/B1a.%20Odds%2C%20LogOdds%20and%20Logit%20Function%20.ipynb"
click node_log_explore "https://github.com/mukundth/learndatascience/blob/master/notebooks/B2.%20Logistic%20Regression%20-%20Data%20Exploration.ipynb"
click node_log_analysis "https://github.com/mukundth/learndatascience/blob/master/notebooks/B3.%20Logistic%20Regression%20-%20Analysis.ipynb"
click node_forest_overview "https://github.com/mukundth/learndatascience/blob/master/notebooks/C1.%20Random%20Forests%20-%20Overview.ipynb"
click node_forest_explore "https://github.com/mukundth/learndatascience/blob/master/notebooks/C2.%20Random%20Forests%20-%20Data%20Exploration.ipynb"
click node_forest_analysis "https://github.com/mukundth/learndatascience/blob/master/notebooks/C3.%20Random%20Forests%20-%20Analysis.ipynb"
click node_kmeans_overview "https://github.com/mukundth/learndatascience/blob/master/notebooks/D1.%20K-Means%20Clustering%20-%20Overview.ipynb"
click node_kmeans_explore "https://github.com/mukundth/learndatascience/blob/master/notebooks/D2.%20K-Means%20Clustering%20-%20Data%20Exploration.ipynb"
click node_kmeans_analysis "https://github.com/mukundth/learndatascience/blob/master/notebooks/D3.%20K-Means%20Clustering%20Analysis.ipynb"
click node_loan_data "https://github.com/mukundth/learndatascience/tree/master/datasets"
click node_har_data "https://github.com/mukundth/learndatascience/tree/master/datasets/ucihar"
click node_un_data "https://github.com/mukundth/learndatascience/tree/master/datasets"
click node_lin_helpers "https://github.com/mukundth/learndatascience/blob/master/notebooks/linreg.py"
click node_log_helpers "https://github.com/mukundth/learndatascience/blob/master/notebooks/logreg.py"
click node_forest_helpers "https://github.com/mukundth/learndatascience/blob/master/notebooks/randomforests.py"
click node_kmeans_helpers "https://github.com/mukundth/learndatascience/blob/master/notebooks/kmeans.py"

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_worksheets toneBlue
class node_lin_overview,node_lin_explore,node_lin_analysis,node_log_overview,node_log_supplement,node_log_explore,node_log_analysis toneAmber
class node_forest_overview,node_forest_explore,node_forest_analysis toneMint
class node_kmeans_overview,node_kmeans_explore,node_kmeans_analysis toneRose
class node_loan_data,node_har_data,node_un_data,node_lin_helpers,node_log_helpers,node_forest_helpers,node_kmeans_helpers,node_learner toneIndigo
```

## Components

### Learning materials

- [Code worksheets](https://github.com/mukundth/learndatascience/tree/master/notebooks): `notebooks`

### Regression lessons

- [Linear overview](https://github.com/mukundth/learndatascience/blob/master/notebooks/A1.%20Linear%20Regression%20-%20Overview.ipynb): `notebooks/A1. Linear Regression - Overview.ipynb`
- [Linear exploration](https://github.com/mukundth/learndatascience/blob/master/notebooks/A2.%20Linear%20Regression%20-%20Data%20Exploration%20-%20Lending%20Club.ipynb): `notebooks/A2. Linear Regression - Data Exploration - Lending Club.ipynb`
- [Linear analysis](https://github.com/mukundth/learndatascience/blob/master/notebooks/A3.%20Linear%20Regression%20-%20Analysis.ipynb): `notebooks/A3. Linear Regression - Analysis.ipynb`
- [Logistic overview](https://github.com/mukundth/learndatascience/blob/master/notebooks/B1.%20Logistic%20Regression%20-%20Overview.ipynb): `notebooks/B1. Logistic Regression - Overview.ipynb`
- [Odds and logit](https://github.com/mukundth/learndatascience/blob/master/notebooks/B1a.%20Odds%2C%20LogOdds%20and%20Logit%20Function%20.ipynb): `notebooks/B1a. Odds, LogOdds and Logit Function .ipynb`
- [Logistic exploration](https://github.com/mukundth/learndatascience/blob/master/notebooks/B2.%20Logistic%20Regression%20-%20Data%20Exploration.ipynb): `notebooks/B2. Logistic Regression - Data Exploration.ipynb`
- [Logistic analysis](https://github.com/mukundth/learndatascience/blob/master/notebooks/B3.%20Logistic%20Regression%20-%20Analysis.ipynb): `notebooks/B3. Logistic Regression - Analysis.ipynb`

### Random forests

- [Forest overview](https://github.com/mukundth/learndatascience/blob/master/notebooks/C1.%20Random%20Forests%20-%20Overview.ipynb): `notebooks/C1. Random Forests - Overview.ipynb`
- [Forest exploration](https://github.com/mukundth/learndatascience/blob/master/notebooks/C2.%20Random%20Forests%20-%20Data%20Exploration.ipynb): `notebooks/C2. Random Forests - Data Exploration.ipynb`
- [Forest analysis](https://github.com/mukundth/learndatascience/blob/master/notebooks/C3.%20Random%20Forests%20-%20Analysis.ipynb): `notebooks/C3. Random Forests - Analysis.ipynb`

### K-means clustering

- [K-means overview](https://github.com/mukundth/learndatascience/blob/master/notebooks/D1.%20K-Means%20Clustering%20-%20Overview.ipynb): `notebooks/D1. K-Means Clustering - Overview.ipynb`
- [K-means exploration](https://github.com/mukundth/learndatascience/blob/master/notebooks/D2.%20K-Means%20Clustering%20-%20Data%20Exploration.ipynb): `notebooks/D2. K-Means Clustering - Data Exploration.ipynb`
- [K-means analysis](https://github.com/mukundth/learndatascience/blob/master/notebooks/D3.%20K-Means%20Clustering%20Analysis.ipynb): `notebooks/D3. K-Means Clustering Analysis.ipynb`

### Data and helpers

- [Loan datasets](https://github.com/mukundth/learndatascience/tree/master/datasets): `datasets`
- [Activity data](https://github.com/mukundth/learndatascience/tree/master/datasets/ucihar): `datasets/ucihar`
- [UN data](https://github.com/mukundth/learndatascience/tree/master/datasets): `datasets`
- [Linear helpers](https://github.com/mukundth/learndatascience/blob/master/notebooks/linreg.py): `notebooks/linreg.py`
- [Logistic helpers](https://github.com/mukundth/learndatascience/blob/master/notebooks/logreg.py): `notebooks/logreg.py`
- [Forest helpers](https://github.com/mukundth/learndatascience/blob/master/notebooks/randomforests.py): `notebooks/randomforests.py`
- [Clustering helpers](https://github.com/mukundth/learndatascience/blob/master/notebooks/kmeans.py): `notebooks/kmeans.py`

### Other components

- **Learner**

## Connections

- Learner → Linear overview: studies (evidence: `README.md`)
- Learner → Logistic overview: studies (evidence: `README.md`)
- Learner → Forest overview: studies (evidence: `README.md`)
- Learner → K-means overview: studies (evidence: `README.md`)
- Linear overview → Linear exploration: continues to (evidence: `README.md`)
- Linear exploration → Linear analysis: continues to (evidence: `README.md`)
- Logistic overview → Logistic exploration: continues to (evidence: `README.md`)
- Logistic exploration → Logistic analysis: continues to (evidence: `README.md`)
- Forest overview → Forest exploration: continues to (evidence: `README.md`)
- Forest exploration → Forest analysis: continues to (evidence: `README.md`)
- K-means overview → K-means exploration: continues to (evidence: `README.md`)
- K-means exploration → K-means analysis: continues to (evidence: `README.md`)
- Linear exploration → Loan datasets: uses (evidence: `README.md`)
- Logistic exploration → Loan datasets: uses (evidence: `README.md`)
- Forest exploration → Activity data: uses (evidence: `README.md`)
- K-means exploration → UN data: uses (evidence: `README.md`)
