# kayabasak/data-cleaning-fundamentals architecture

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

- Interactive diagram: https://gitdiagram.com/kayabasak/data-cleaning-fundamentals
- Repository: https://github.com/kayabasak/data-cleaning-fundamentals

## Overview

This repository is a learning resource whose executable product is an end-to-end Pandas notebook for cleaning the Global Layoffs dataset. A learner runs the notebook, which loads the raw CSV, performs the documented inspection and cleaning stages, validates the result, and exports a cleaned CSV. The README lists these stages and the input/output datasets, but no notebook source excerpt was provided, so the graph reflects documented workflow rather than verified implementation details.

Main entry points: [`data_cleaning_pipeline.ipynb`](https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/data_cleaning_pipeline.ipynb) (Cleaning Notebook), [`layoffs.csv`](https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/layoffs.csv) (Raw Layoffs CSV), [`layoffs_clean.csv`](https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/layoffs_clean.csv) (Cleaned Layoffs CSV)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Cleaning Workflow"]
  node_notebook["Cleaning Notebook"]
  node_inspect["Inspect Data"]
  node_missing["Handle Missing"]
  node_duplicates["Remove Duplicates"]
  node_types["Fix Data Types"]
  node_outliers["Investigate Outliers"]
  node_validate["Validate Data"]
end

subgraph group_data["Dataset Files"]
  node_raw["Raw Layoffs CSV<br/>[layoffs.csv]"]
  node_clean["Cleaned Layoffs CSV<br/>[layoffs_clean.csv]"]
end

node_learner(("Learner"))

node_learner -->|"runs"| node_notebook
node_notebook -->|"loads"| node_raw
node_notebook -->|"performs"| node_inspect
node_notebook -->|"handles"| node_missing
node_notebook -->|"removes"| node_duplicates
node_notebook -->|"converts"| node_types
node_notebook -->|"investigates"| node_outliers
node_notebook -->|"validates"| node_validate
node_notebook -->|"exports"| node_clean

click node_notebook "https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/data_cleaning_pipeline.ipynb"
click node_inspect "https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/data_cleaning_pipeline.ipynb"
click node_missing "https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/data_cleaning_pipeline.ipynb"
click node_duplicates "https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/data_cleaning_pipeline.ipynb"
click node_types "https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/data_cleaning_pipeline.ipynb"
click node_outliers "https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/data_cleaning_pipeline.ipynb"
click node_validate "https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/data_cleaning_pipeline.ipynb"
click node_raw "https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/layoffs.csv"
click node_clean "https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/layoffs_clean.csv"

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_notebook,node_inspect,node_missing,node_duplicates,node_types,node_outliers,node_validate toneBlue
class node_raw,node_clean toneAmber
class node_learner toneIndigo
```

## Components

### Cleaning Workflow

- [Cleaning Notebook](https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/data_cleaning_pipeline.ipynb): `data_cleaning_pipeline.ipynb`
- [Inspect Data](https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/data_cleaning_pipeline.ipynb): `data_cleaning_pipeline.ipynb`
- [Handle Missing](https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/data_cleaning_pipeline.ipynb): `data_cleaning_pipeline.ipynb`
- [Remove Duplicates](https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/data_cleaning_pipeline.ipynb): `data_cleaning_pipeline.ipynb`
- [Fix Data Types](https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/data_cleaning_pipeline.ipynb): `data_cleaning_pipeline.ipynb`
- [Investigate Outliers](https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/data_cleaning_pipeline.ipynb): `data_cleaning_pipeline.ipynb`
- [Validate Data](https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/data_cleaning_pipeline.ipynb): `data_cleaning_pipeline.ipynb`

### Dataset Files

- [Raw Layoffs CSV](https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/layoffs.csv): `layoffs.csv`
- [Cleaned Layoffs CSV](https://github.com/kayabasak/data-cleaning-fundamentals/blob/main/layoffs_clean.csv): `layoffs_clean.csv`

### Other components

- **Learner**

## Connections

- Learner → Cleaning Notebook: runs (evidence: `README.md`)
- Cleaning Notebook → Raw Layoffs CSV: loads (evidence: `README.md`)
- Cleaning Notebook → Inspect Data: performs (evidence: `README.md`)
- Cleaning Notebook → Handle Missing: handles (evidence: `README.md`)
- Cleaning Notebook → Remove Duplicates: removes (evidence: `README.md`)
- Cleaning Notebook → Fix Data Types: converts (evidence: `README.md`)
- Cleaning Notebook → Investigate Outliers: investigates (evidence: `README.md`)
- Cleaning Notebook → Validate Data: validates (evidence: `README.md`)
- Cleaning Notebook → Cleaned Layoffs CSV: exports (evidence: `README.md`)
