# abhiraj-sardar/ml-projects architecture

> Architecture diagram of the GitHub repository abhiraj-sardar/ml-projects, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abhiraj-sardar/ml-projects
- Repository: https://github.com/abhiraj-sardar/ml-projects

## Overview

##### Project type and purpose
- This is a collection of machine-learning experiments implemented as Jupyter notebooks.
- It provides examples for Exploratory Data Analysis (EDA), Data Visualization, and supervised model training (Logistic Regression on a breast cancer dataset and a Neural Network on MNIST).
- Purpose: demonstrate end-to-end ML workflows—from raw data through analysis, visualization, training, and evaluation.

##### File structure
- Top-level directories and files:
- DataSet/ (contains data.csv as the raw data source)
- Two standalone notebooks for general-purpose analysis:
– Exploratory_Data_Analysis_(EDA)_use_case (1).ipynb
– Data_Visualization_in_Python_use_case.ipynb
- Two subfolders representing specific model pipelines:
– “Logistic Regression” / Breast_Cancer_Detection.ipynb
– “Neural Network” / MNIST_Digit_classification.ipynb
- README.md (contains only the title “ML-Projects”)
- No separate source code or service components—everything runs interactively in Jupyter.

##### README for additional insights
- README is minimal; no explicit architecture description or dependencies listed.
- We’ll infer common ML libraries (pandas, NumPy, matplotlib/seaborn, scikit-learn, TensorFlow/Keras).

a. Main components
- Data Source (DataSet/data.csv)
- Data Ingestion & Preprocessing layer (shared Python code inside notebooks)
- Analysis Notebooks
– EDA Notebook
– Visualization Notebook
- Model Training Pipelines
– Logistic Regression pipeline
– Neural Network pipeline
- Outputs (plots, metrics, trained model artifacts)
- Execution Environment (Jupyter Server, Python environment with ML libs)
b. Relationships & interactions
- Data Source → Preprocessing steps → EDA & Visualization notebooks
- Preprocessed data → Model Training notebooks → Evaluation results
- Notebooks may share common code (extract into a reusable module if needed)
c. Architectural patterns & design principles
- Pipeline pattern: data flows through sequential stages (ingest → analyze → train → evaluate)
- Modular separation by use-case (group notebooks by function)
- Environment encapsulation: single Jupyter kernel with all dependencies installed
d. Key technologies/frameworks
- Jupyter Notebook / IPython kernel
- Python libraries: pandas, NumPy, matplotlib or seaborn, scikit-learn (Logistic Regression), TensorFlow/Keras (Neural Network)

##### Additional recommendations
- Similar notebooks under a “Analysis” section and model flows under a “Training” section.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Data Source
    DS["Raw Data\n(data.csv)"]:::data

    %% Preprocessing
    Preprocess["Data Ingestion &\nPreprocessing"]:::process

    %% Analysis Section
    subgraph "Analysis"
        EDA["EDA Notebook"]:::notebook
        Viz["Visualization Notebook"]:::notebook
    end

    %% Training Section
    subgraph "Training"
        LR["Logistic Regression\nPipeline"]:::pipeline
        NN["Neural Network\nPipeline"]:::pipeline
    end

    %% Execution Environment
    Exec["Jupyter Environment\n(pandas, NumPy,\nmatplotlib, scikit-learn,\nTensorFlow/Keras)"]:::env

    %% Data Flow
    DS -->|"load data"| Preprocess
    Preprocess -->|"clean & feature-engineer"| EDA
    Preprocess -->|"clean & feature-engineer"| Viz
    Preprocess -->|"train/test split"| LR
    Preprocess -->|"train/test split"| NN
    EDA -->|"analysis plots"| Exec
    Viz -->|"visualizations"| Exec
    LR -->|"trained model & metrics"| Exec
    NN -->|"trained model & metrics"| Exec

    %% Click Events
    click DS "https://github.com/abhiraj-sardar/ml-projects/blob/master/DataSet/data.csv"
    click EDA "https://github.com/abhiraj-sardar/ml-projects/blob/master/Exploratory_Data_Analysis_(EDA)_use_case (1).ipynb"
    click Viz "https://github.com/abhiraj-sardar/ml-projects/blob/master/Data_Visualization_in_Python_use_case.ipynb"
    click LR "https://github.com/abhiraj-sardar/ml-projects/blob/master/Logistic Regression/Breast_Cancer_Detection.ipynb"
    click NN "https://github.com/abhiraj-sardar/ml-projects/blob/master/Neural Network/MNIST_Digit_classification.ipynb"

    %% Styles
    classDef data fill:#a2d5a2,stroke:#333,stroke-width:1px
    classDef process fill:#f4e04d,stroke:#333,stroke-width:1px
    classDef notebook fill:#89CFF0,stroke:#333,stroke-width:1px
    classDef pipeline fill:#FFA500,stroke:#333,stroke-width:1px
    classDef env fill:#B19CD9,stroke:#333,stroke-width:1px
```
