# anusharajs/zenith-tc architecture

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

- Interactive diagram: https://gitdiagram.com/anusharajs/zenith-tc
- Repository: https://github.com/anusharajs/zenith-tc

## Overview

##### Project type and purpose
- This is an educational “Zenith” repository containing Jupyter notebooks, MATLAB scripts, datasets, and PDF/PPTX notes covering Machine Learning (K-NN, Linear/Logistic Regression, Ridge/Lasso Regression, SVM) and Signal Processing topics.
- Purpose: to deliver hands-on code examples, data, and slides for training sessions.

##### File structure
- Top-level:
- Getting started with Colab.pdf (setup guide)
- Five ML algorithm folders (K-Nearest Neighbors, Linear Regression, Logistic Regression, Ridge and Lasso Regression, Support Vector Machines)
- Signal Processing folder with sub-folder “MATLAB codes” and PDFs
- README.md (project overview)
- Each ML folder contains:
- A README.md describing the exercise
- A Jupyter notebook (.ipynb) implementing the algorithm
- Relevant dataset files (.csv) or presentation (.pptx)
- Signal Processing folder:
- DIT-FFT.pdf, DTFT and DFT.pdf (theory notes)
- MATLAB codes (.m) under “MATLAB codes” with its own readme

##### Extract additional insights from README.md
- Confirms this is a “codes and notes for my Zenith sessions on Machine Learning and Signal Processing.”

a. Main components
1. User Interface Layer – Jupyter Lab/Google Colab environment (user runs notebooks)
2. Data Layer – CSV datasets (TSLA.csv, Titanic, Iris), PDFs/PPTX (theory slides)
3. Computation Layer –
- Python ML notebooks (scikit-learn, pandas, matplotlib)
- MATLAB scripts for signal processing
4. Output Layer – Visualizations, model metrics, generated plots, saved notebooks
b. Relationships & Data Flow
- User → (launch) → Notebook
- Notebook → (reads) → Data Layer
- Notebook → (executes) → ML/Signal Processing computation
- Computation → (writes/displays) → Outputs (plots, metrics, model artifacts)
- Theoretical PDFs/PPTX can be referenced by user → influence notebook parameters
c. Architectural patterns & design principles
- Modular separation by topic/algorithm for maintainability
- Clear data separation: each module has its own dataset folder
- Reusability: common environment setup (e.g., a shared conda/pip requirements file could be added)
- Extensibility: new algorithm modules can follow the same directory structure
d. Key technologies/frameworks
- Python 3.x, Jupyter Notebooks, scikit-learn, pandas, matplotlib
- MATLAB R202x for signal processing scripts
- Google Colab compatibility (via Getting started with Colab.pdf)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% User Interface Layer
    subgraph "User Interface Layer"
        User["User"]:::external
        ColabGuide["Getting started with Colab.pdf"]:::theory
        ProjectOverview["README.md"]:::theory
    end

    %% Machine Learning Modules
    subgraph "Machine Learning Modules"
        subgraph "K-Nearest Neighbors"
            KNN_Readme["README.md"]:::theory
            KNN_Notebook["KNN_Zenith.ipynb"]:::notebook
            KNN_Data["Classified Data"]:::dataset
            KNN_Output["KNN Outputs (Plots/Metrics)"]:::output
        end
        subgraph "Linear Regression"
            LR_Readme["README.md"]:::theory
            LR_Notebook["LinearRegression.ipynb"]:::notebook
            LR_Data["TSLA.csv"]:::dataset
            LR_Output["Linear Regression Outputs"]:::output
        end
        subgraph "Logistic Regression"
            Log_Readme["README.md"]:::theory
            Log_Notebook["LogisticRegression.ipynb"]:::notebook
            Log_Data["titanic_dataset.csv"]:::dataset
            Log_Output["Logistic Regression Outputs"]:::output
        end
        subgraph "Ridge and Lasso Regression"
            RiLa_Readme["README.md"]:::theory
            RiLa_Notebook["Ridge_and_Lasso_Regression.ipynb"]:::notebook
            RiLa_Data["TSLA.csv"]:::dataset
            RiLa_Output["Ridge & Lasso Outputs"]:::output
        end
        subgraph "Support Vector Machines"
            SVM_Readme["README.md"]:::theory
            SVM_Notebook["SVM_Zenith.ipynb"]:::notebook
            SVM_Data["Iris.csv"]:::dataset
            SVM_PPTX["SVM.pptx"]:::theory
            SVM_Output["SVM Outputs"]:::output
        end
    end

    %% Signal Processing Module
    subgraph "Signal Processing Module"
        SP_Readme["README.md"]:::theory
        subgraph "Theory Slides"
            DITFFT["DIT-FFT.pdf"]:::theory
            DTFT_DFT["DTFT and DFT.pdf"]:::theory
        end
        subgraph "MATLAB Codes"
            Code_Readme["readme.md"]:::theory
            dtft_dft["dtft_dft.m"]:::script
            ft_intro["ft_intro.m"]:::script
            single_comp["single_composite.m"]:::script
            spectrogram["spectrogram.m"]:::script
            spectrum["spectrum.m"]:::script
        end
        SP_Output["MATLAB Outputs"]:::output
    end

    %% Data Flow Connections
    User --> ColabGuide
    User --> ProjectOverview
    User --> KNN_Notebook
    KNN_Notebook --> KNN_Data
    KNN_Notebook --> KNN_Output

    User --> LR_Notebook
    LR_Notebook --> LR_Data
    LR_Notebook --> LR_Output

    User --> Log_Notebook
    Log_Notebook --> Log_Data
    Log_Notebook --> Log_Output

    User --> RiLa_Notebook
    RiLa_Notebook --> RiLa_Data
    RiLa_Notebook --> RiLa_Output

    User --> SVM_Notebook
    SVM_Notebook --> SVM_Data
    SVM_Notebook --> SVM_Output
    ProjectOverview --> SVM_PPTX

    User --> SP_Readme
    SP_Readme --> dtft_dft
    DITFFT --> dtft_dft
    DTFT_DFT --> dtft_dft
    dtft_dft --> SP_Output
    ft_intro --> SP_Output
    single_comp --> SP_Output
    spectrogram --> SP_Output
    spectrum --> SP_Output

    %% Click Events
    click ColabGuide "https://github.com/anusharajs/zenith-tc/blob/main/Getting started with Colab.pdf"
    click ProjectOverview "https://github.com/anusharajs/zenith-tc/blob/main/README.md"

    click KNN_Data "https://github.com/anusharajs/zenith-tc/tree/main/K-Nearest Neighbors/Classified Data"
    click KNN_Notebook "https://github.com/anusharajs/zenith-tc/blob/main/K-Nearest Neighbors/KNN_Zenith.ipynb"
    click KNN_Readme "https://github.com/anusharajs/zenith-tc/blob/main/K-Nearest Neighbors/README.md"

    click LR_Data "https://github.com/anusharajs/zenith-tc/blob/main/Linear Regression/TSLA.csv"
    click LR_Notebook "https://github.com/anusharajs/zenith-tc/blob/main/Linear Regression/LinearRegression.ipynb"
    click LR_Readme "https://github.com/anusharajs/zenith-tc/blob/main/Linear Regression/README.md"

    click Log_Data "https://github.com/anusharajs/zenith-tc/blob/main/Logistic Regression/titanic_dataset.csv"
    click Log_Notebook "https://github.com/anusharajs/zenith-tc/blob/main/Logistic Regression/LogisticRegression.ipynb"
    click Log_Readme "https://github.com/anusharajs/zenith-tc/blob/main/Logistic Regression/README.md"

    click RiLa_Data "https://github.com/anusharajs/zenith-tc/blob/main/Ridge and Lasso Regression/TSLA.csv"
    click RiLa_Notebook "https://github.com/anusharajs/zenith-tc/blob/main/Ridge and Lasso Regression/Ridge_and_Lasso_Regression.ipynb"
    click RiLa_Readme "https://github.com/anusharajs/zenith-tc/blob/main/Ridge and Lasso Regression/README.md"

    click SVM_Data "https://github.com/anusharajs/zenith-tc/blob/main/Suppor Vector Machines/Iris.csv"
    click SVM_Notebook "https://github.com/anusharajs/zenith-tc/blob/main/Suppor Vector Machines/SVM_Zenith.ipynb"
    click SVM_Readme "https://github.com/anusharajs/zenith-tc/blob/main/Suppor Vector Machines/README.md"
    click SVM_PPTX "https://github.com/anusharajs/zenith-tc/blob/main/Suppor Vector Machines/SVM.pptx"

    click DITFFT "https://github.com/anusharajs/zenith-tc/blob/main/Signal Processing/DIT-FFT.pdf"
    click DTFT_DFT "https://github.com/anusharajs/zenith-tc/blob/main/Signal Processing/DTFT and DFT.pdf"
    click SP_Readme "https://github.com/anusharajs/zenith-tc/blob/main/Signal Processing/README.md"
    click Code_Readme "https://github.com/anusharajs/zenith-tc/blob/main/Signal Processing/MATLAB codes/readme.md"
    click dtft_dft "https://github.com/anusharajs/zenith-tc/blob/main/Signal Processing/MATLAB codes/dtft_dft.m"
    click ft_intro "https://github.com/anusharajs/zenith-tc/blob/main/Signal Processing/MATLAB codes/ft_intro.m"
    click single_comp "https://github.com/anusharajs/zenith-tc/blob/main/Signal Processing/MATLAB codes/single_composite.m"
    click spectrogram "https://github.com/anusharajs/zenith-tc/blob/main/Signal Processing/MATLAB codes/spectrogram.m"
    click spectrum "https://github.com/anusharajs/zenith-tc/blob/main/Signal Processing/MATLAB codes/spectrum.m"

    %% Styles
    classDef notebook fill:#AEDFF7,stroke:#333,stroke-width:1px
    classDef dataset fill:#C2F0C2,stroke:#333,stroke-width:1px
    classDef theory fill:#FFF2A8,stroke:#333,stroke-width:1px
    classDef output fill:#FFD2A6,stroke:#333,stroke-width:1px
    classDef script fill:#AEDFF7,stroke:#333,stroke-width:1px
    classDef external fill:#FFFFFF,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5
```
