# savvythelegend/mle architecture

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

- Interactive diagram: https://gitdiagram.com/savvythelegend/mle
- Repository: https://github.com/savvythelegend/mle

## Overview

##### Project type and purpose
- This is a hands-on, “from-scratch” Machine Learning Engineering (MLE) repository.
- Purpose: deep-dive implementations of ML algorithms (linear models, ensembles, dimensionality reduction, evaluation), plus data‐science resources, study notes, and end-to-end projects.

##### File structure
- Top‐level directories:
- data/         ← raw datasets
- docs/         ← conceptual deep dives, math notes
- implementations/ ← Jupyter notebooks of manual ML model implementations
- notes/        ← study notebooks and utility scripts (PyTorch/Scikit‐Learn)
- programming/  ← language-specific tutorials (Python, SQL)
- projects/     ← end-to-end pipelines and example applications
- tests/        ← placeholders for unit tests
- Configuration files: .gitignore, LICENSE, README.md
- Build/deployment: none (not a deployable service)

##### README for additional insights
- Confirms directory roles, core focus on “no shortcuts,” transparency.

##### Detail without over-splitting
- Of the seven top-level directories as its own component or subsystem.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Data Layer
    subgraph "Data Layer"
        DL["Data Layer"]:::data
        DF1["heart_failure_clinical_records_dataset.csv"]:::data
        DF2["movie_data.csv"]:::data
        DF3["sample_input.csv"]:::data
    end

    %% Documentation Layer
    subgraph "Documentation Layer"
        DOC["Documentation Layer"]:::docs
        D1["MachineLearningNotes.pdf"]:::docs
        D2["gradients.md"]:::docs
        D3["linear-nonlinear.md"]:::docs
        D4["prompt.md"]:::docs
    end

    %% Implementation Layer
    subgraph "Implementation Layer"
        IMPL["Implementation Layer"]:::impl
        I1["linear_regression.ipynb"]:::impl
        I2["logistic_regression.ipynb"]:::impl
        I3["Adaline.ipynb"]:::impl
        I4["perceptron.ipynb"]:::impl
        I5["sklearn_ensemble_RandomForest.ipynb"]:::impl
        I6["decision_trees_hands_on.ipynb"]:::impl
        I7["evaluation_ml.ipynb"]:::impl
        I8["principal_component_analysis_from_scratch.ipynb"]:::impl
        I9["svd_imgcompress.ipynb"]:::impl
    end

    %% Notes & Utilities Layer
    subgraph "Notes & Utilities Layer"
        NOTES["Notes & Utilities"]:::notes
        N1["Ch_02_Perceptron_GradientDescent_Adaline.ipynb"]:::notes
        N2["Ch_03_LogisticReg_SVM_DecisionTree_KNN.ipynb"]:::notes
        N3["Ch_04_DataPreprocessing_L1_L2_FeatureSelection.ipynb"]:::notes
        N4["Ch_05_DimensionalityReduction_PCA_LDA_tSNE.ipynb"]:::notes
        N5["Ch_06_ModelEvaluation_HyperparameterTuning.ipynb"]:::notes
        N6["Ch_07_EnsembleLearning_.ipynb"]:::notes
        N7["Ch_08_SentimentAnalysis_TopicModelling_LDA.ipynb"]:::notes
        N8["Ch_11_NeuralNetwork.ipynb"]:::notes
        N9["README.md"]:::notes
        N10["plot_decision_regions_script.py"]:::notes
    end

    %% Programming Resources Layer
    subgraph "Programming Resources Layer"
        PR["Programming Resources"]:::prog
        P1["intuition.md"]:::prog
        P2["numpeee.ipynb"]:::prog
        P3["pythonforml.ipynb"]:::prog
        P4["Data-Science-Skills_Linkedin.sql"]:::prog
        P5["Histogram-of-Tweets_Twitter.sql"]:::prog
    end

    %% End-to-End Projects Layer
    subgraph "End-to-End Projects Layer"
        PROJ["Projects Layer"]:::proj
        Pj1["Heart_Failure_Prediction_📚.ipynb"]:::proj
        Pj2["model.pkl"]:::proj
        Pj3["phishing_ml.ipynb"]:::proj
        Pj4["stock_price_prediction.ipynb"]:::proj
        Pj5["Readme.md (time_series)"]:::proj
        Pj6["hf_data_handling.ipynb"]:::proj
        Pj7["hf_data_pipeline.ipynb"]:::proj
    end

    %% Testing Layer
    subgraph "Testing Layer"
        TEST["Testing Layer"]:::test
        T1[".gitkeep"]:::test
    end

    %% Connections
    DL -->|feeds| IMPL
    DL -->|feeds| PROJ
    DOC -->|supports| IMPL
    DOC -->|supports| PROJ
    NOTES -->|enhances| IMPL
    NOTES -->|enhances| PROJ
    PR ---|reference| IMPL
    IMPL -->|validated by| TEST
    PROJ -->|validated by| TEST

    %% Click Events Data Layer
    click DL "https://github.com/savvythelegend/mle/tree/main/data/"
    click DF1 "https://github.com/savvythelegend/mle/blob/main/data/datasets/archive/heart_failure_clinical_records_dataset.csv"
    click DF2 "https://github.com/savvythelegend/mle/blob/main/data/movie_data.csv"
    click DF3 "https://github.com/savvythelegend/mle/blob/main/data/sample_input.csv"

    %% Click Events Documentation Layer
    click DOC "https://github.com/savvythelegend/mle/tree/main/docs/"
    click D1 "https://github.com/savvythelegend/mle/blob/main/docs/MachineLearningNotes.pdf"
    click D2 "https://github.com/savvythelegend/mle/blob/main/docs/gradients.md"
    click D3 "https://github.com/savvythelegend/mle/blob/main/docs/linear-nonlinear.md"
    click D4 "https://github.com/savvythelegend/mle/blob/main/docs/prompt.md"

    %% Click Events Implementation Layer
    click IMPL "https://github.com/savvythelegend/mle/tree/main/implementations/"
    click I1 "https://github.com/savvythelegend/mle/blob/main/implementations/regression/linear_regression.ipynb"
    click I2 "https://github.com/savvythelegend/mle/blob/main/implementations/regression/logistic_regression.ipynb"
    click I3 "https://github.com/savvythelegend/mle/blob/main/implementations/linear_models/Adaline.ipynb"
    click I4 "https://github.com/savvythelegend/mle/blob/main/implementations/linear_models/perceptron.ipynb"
    click I5 "https://github.com/savvythelegend/mle/blob/main/implementations/ensembles/sklearn_ensemble_RandomForest.ipynb"
    click I6 "https://github.com/savvythelegend/mle/blob/main/implementations/trees/decision_trees_hands_on.ipynb"
    click I7 "https://github.com/savvythelegend/mle/blob/main/implementations/evaluation/evaluation_ml.ipynb"
    click I8 "https://github.com/savvythelegend/mle/blob/main/implementations/dimensionality_reduction/principal_component_analysis_from_scratch.ipynb"
    click I9 "https://github.com/savvythelegend/mle/blob/main/implementations/dimensionality_reduction/svd_imgcompress.ipynb"

    %% Click Events Notes & Utilities Layer
    click NOTES "https://github.com/savvythelegend/mle/tree/main/notes/Machine-Learning-with-Pytorch-Scikit-Learn/"
    click N1 "https://github.com/savvythelegend/mle/blob/main/notes/Machine-Learning-with-Pytorch-Scikit-Learn/Ch_02_Perceptron_GradientDescent_Adaline.ipynb"
    click N2 "https://github.com/savvythelegend/mle/blob/main/notes/Machine-Learning-with-Pytorch-Scikit-Learn/Ch_03_LogisticReg_SVM_DecisionTree_KNN.ipynb"
    click N3 "https://github.com/savvythelegend/mle/blob/main/notes/Machine-Learning-with-Pytorch-Scikit-Learn/Ch_04_DataPreprocessing_L1_L2_FeatureSelection.ipynb"
    click N4 "https://github.com/savvythelegend/mle/blob/main/notes/Machine-Learning-with-Pytorch-Scikit-Learn/Ch_05_DimensionalityReduction_PCA_LDA_tSNE.ipynb"
    click N5 "https://github.com/savvythelegend/mle/blob/main/notes/Machine-Learning-with-Pytorch-Scikit-Learn/Ch_06_ModelEvaluation_HyperparameterTuning.ipynb"
    click N6 "https://github.com/savvythelegend/mle/blob/main/notes/Machine-Learning-with-Pytorch-Scikit-Learn/Ch_07_EnsembleLearning_.ipynb"
    click N7 "https://github.com/savvythelegend/mle/blob/main/notes/Machine-Learning-with-Pytorch-Scikit-Learn/Ch_08_SentimentAnalysis_TopicModelling_LDA.ipynb"
    click N8 "https://github.com/savvythelegend/mle/blob/main/notes/Machine-Learning-with-Pytorch-Scikit-Learn/Ch_11_NeuralNetwork.ipynb"
    click N9 "https://github.com/savvythelegend/mle/blob/main/notes/Machine-Learning-with-Pytorch-Scikit-Learn/README.md"
    click N10 "https://github.com/savvythelegend/mle/blob/main/notes/Machine-Learning-with-Pytorch-Scikit-Learn/utils/plot_decision_regions_script.py"

    %% Click Events Programming Resources Layer
    click PR "https://github.com/savvythelegend/mle/tree/main/programming/"
    click P1 "https://github.com/savvythelegend/mle/blob/main/programming/python/intuition.md"
    click P2 "https://github.com/savvythelegend/mle/blob/main/programming/python/numpeee.ipynb"
    click P3 "https://github.com/savvythelegend/mle/blob/main/programming/python/pythonforml.ipynb"
    click P4 "https://github.com/savvythelegend/mle/blob/main/programming/sql/easy/Data-Science-Skills_Linkedin.sql"
    click P5 "https://github.com/savvythelegend/mle/blob/main/programming/sql/easy/Histogram-of-Tweets_Twitter.sql"

    %% Click Events End-to-End Projects Layer
    click PROJ "https://github.com/savvythelegend/mle/tree/main/projects/"
    click Pj1 "https://github.com/savvythelegend/mle/blob/main/projects/Heart Failure Prediction System/Heart_Failure_Prediction_📚.ipynb"
    click Pj2 "https://github.com/savvythelegend/mle/blob/main/projects/Heart Failure Prediction System/model.pkl"
    click Pj3 "https://github.com/savvythelegend/mle/blob/main/projects/phishing_ml.ipynb"
    click Pj4 "https://github.com/savvythelegend/mle/blob/main/projects/stock_price_prediction.ipynb"
    click Pj5 "https://github.com/savvythelegend/mle/blob/main/projects/time_series/Readme.md"
    click Pj6 "https://github.com/savvythelegend/mle/blob/main/projects/time_series/hf_data_handling.ipynb"
    click Pj7 "https://github.com/savvythelegend/mle/blob/main/projects/time_series/hf_data_pipeline.ipynb"

    %% Click Events Testing Layer
    click TEST "https://github.com/savvythelegend/mle/tree/main/tests/"
    click T1 "https://github.com/savvythelegend/mle/blob/main/tests/.gitkeep"

    %% Styles
    classDef data fill:#E3F2FD,stroke:#1976D2,stroke-width:1px;
    classDef docs fill:#FFF3E0,stroke:#FB8C00,stroke-width:1px;
    classDef impl fill:#E8F5E9,stroke:#388E3C,stroke-width:1px;
    classDef notes fill:#FFE0B2,stroke:#F57C00,stroke-width:1px;
    classDef prog fill:#E1BEE7,stroke:#8E24AA,stroke-width:1px;
    classDef proj fill:#CE93D8,stroke:#6A1B9A,stroke-width:1px;
    classDef test fill:#FFEBEE,stroke:#D32F2F,stroke-width:1px;
```
