# shubham996633/machine-learning-college-task architecture

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

- Interactive diagram: https://gitdiagram.com/shubham996633/machine-learning-college-task
- Repository: https://github.com/shubham996633/machine-learning-college-task

## Overview

##### Project type and purpose
- This repository is a collection of three standalone machine-learning experiments (notebooks) targeting different prediction tasks: house-price regression, student performance classification, and diabetes prediction.
- It’s primarily an open-source data-science toolkit rather than a deployed web service or microservices ecosystem.

##### File structure
- Top-level directories:
- data/kaggle/ – raw CSV datasets for each task
- notebooks/ – three Jupyter notebooks, one per ML task
- Configuration:
- requirements.txt – lists Python libraries (pandas, numpy, scikit-learn, etc.)
- There are no subfolders for production code, APIs, or deployment scripts—everything lives in notebooks.

##### README for additional insights
- It describes each ML task, the algorithm used (Linear Regression, SVM, KNN), and how to run the notebooks.

a. Main components
- Data Sources (House Price.csv, diabetes.csv, student-mat.csv)
- Data-Ingestion & Preprocessing (shared EDA/prep code in each notebook)
- Model Training components (Linear Regression, SVM, KNN modules)
- Evaluation & Visualization (plots generated by matplotlib/seaborn)
- Environment & Dependencies (Python interpreter, Jupyter, scikit-learn, imblearn, etc.)
b. Relationships & interactions
- Preprocessing → Model Training (one branch per algorithm)
- Model Training → Evaluation/Visualization
- Notebook UI layer sits on top, invoking each step
- Runtime container (your local machine or cloud notebook server) wraps all components
c. Architectural patterns or design principles
- Modular separation: treat each notebook as an independent pipeline
d. Key technologies
- Python + Jupyter Notebook
- pandas, numpy for data handling
- scikit-learn for modeling (LinearRegression, SVC, KNeighborsClassifier)
- matplotlib/seaborn for charts
- imblearn for handling class imbalance (if any)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Data Sources
    HP_data[(House Price Dataset\ndata/kaggle/House Price.csv)]:::datastore
    D_data[(Diabetes Dataset\ndata/kaggle/diabetes.csv)]:::datastore
    S_data[(Student Performance Dataset\ndata/kaggle/student-mat.csv)]:::datastore

    %% Jupyter Runtime Container
    subgraph "Jupyter Runtime"
        direction TB
        env["Environment & Dependencies\n(requirements.txt)"]:::environment
        docs["Project Overview & Run Instructions"]:::documentation

        subgraph "House Price Regression Pipeline"
            direction TB
            HP_notebook["House Price Regression Notebook\n(Linear Regression)"]:::pipeline
            HP_eval["Evaluation & Visualization"]:::evaluation
        end

        subgraph "Diabetes Prediction Pipeline"
            direction TB
            DP_notebook["Diabetes Prediction Notebook\n(SVM)"]:::pipeline
            DP_eval["Evaluation & Visualization"]:::evaluation
        end

        subgraph "Student Performance Pipeline"
            direction TB
            SP_notebook["Student Performance Notebook\n(KNN)"]:::pipeline
            SP_eval["Evaluation & Visualization"]:::evaluation
        end
    end

    %% Data Flow
    HP_data -->|loads| HP_notebook
    HP_notebook -->|trains| HP_eval

    D_data -->|loads| DP_notebook
    DP_notebook -->|trains| DP_eval

    S_data -->|loads| SP_notebook
    SP_notebook -->|trains| SP_eval

    %% Click Events
    click HP_data "https://github.com/shubham996633/machine-learning-college-task/blob/master/data/kaggle/House Price.csv"
    click D_data "https://github.com/shubham996633/machine-learning-college-task/blob/master/data/kaggle/diabetes.csv"
    click S_data "https://github.com/shubham996633/machine-learning-college-task/blob/master/data/kaggle/student-mat.csv"
    click HP_notebook "https://github.com/shubham996633/machine-learning-college-task/blob/master/notebooks/house-prediction..ipynb"
    click DP_notebook "https://github.com/shubham996633/machine-learning-college-task/blob/master/notebooks/diabetics.ipynb"
    click SP_notebook "https://github.com/shubham996633/machine-learning-college-task/blob/master/notebooks/student-performanc.ipynb"
    click env "https://github.com/shubham996633/machine-learning-college-task/blob/master/requirements.txt"
    click docs "https://github.com/shubham996633/machine-learning-college-task/blob/master/Readme.md"

    %% Styles
    classDef datastore fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef pipeline fill:#90EE90,stroke:#333,stroke-width:1px
    classDef evaluation fill:#FFFF99,stroke:#333,stroke-width:1px
    classDef environment fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef documentation fill:#D3D3D3,stroke:#333,stroke-width:1px
```
