# yashpasar/brain-tumor-classification-and-detection-machine-learning architecture

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

- Interactive diagram: https://gitdiagram.com/yashpasar/brain-tumor-classification-and-detection-machine-learning
- Repository: https://github.com/yashpasar/brain-tumor-classification-and-detection-machine-learning

## Overview

##### Project Type and Purpose
- This is a MATLAB-based image processing and machine-learning application for detecting and classifying brain tumors in MRI scans.
- It provides a GUI front end to load MRI images, applies a sequence of processing stages (preprocessing, segmentation, feature extraction), and then runs classification algorithms (SVM, ANN, k-NN) to label tumors as benign or malignant.

##### File Structure Analysis
- Top level:
- Brain_Tumor_Code/ – MATLAB source directory
– BrainMRI_GUI.fig & .m: graphical user interface
– Image processing scripts: Brain_DWT_PCA.m, crossfun.m, crossfun_Parameters.m
– Dataset artifacts: Normalized_Features.mat, Trainset.mat
– Folders “Benign” and “Malignant” (image samples)
- README.md describes the five-stage pipeline and lists all algorithms.

##### Key Architectural Components
a. GUI Layer
- BrainMRI_GUI.m/.fig – user interface for selecting images, launching pipeline, viewing results.
b. Data Store
- Raw MRI images (Benign/, Malignant/)
- Precomputed feature set (Normalized_Features.mat)
- Training data (Trainset.mat)
c. Preprocessing Module
- Filters & noise removal (Canny, median filter)
- Enhancement routines
d. Segmentation Module
- Otsu thresholding
- Watershed segmentation
e. Feature Extraction Module
- DWT + PCA (Brain_DWT_PCA.m)
- Custom feature calculators (crossfun.m, crossfun_Parameters.m)
f. Classification Module
- SVM, ANN, k-NN algorithms (built-in MATLAB toolboxes)
g. Reporting / Evaluation
- Classification labels and accuracy metrics in GUI
- Save or export results

##### Relationships and Data Flow
- GUI → loads image → Preprocessing → Segmentation → Feature Extraction → Classifier → GUI (result display)
- Preprocessing outputs intermediate image to Segmentation
- Segmentation outputs region masks to Feature Extraction
- Feature Extraction writes feature vectors to memory or .mat → Classification consumes features → returns label & confidence
- Training data store (Trainset.mat) is loaded by Classification module for model fitting (if “retrain” option exists)

##### Architectural Patterns
- Pipeline (linear sequence of processing stages)
- Modular separation of concerns (GUI, processing modules, data storage)

##### Technologies and Frameworks
- MATLAB R2015a core environment
- MATLAB Image Processing Toolbox (Canny, Otsu, Watershed)
- MATLAB Statistics & Machine Learning Toolbox (SVM, ANN, k-NN)
- MATLAB .fig GUI design

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "External Systems"
        MRI["MRI Scanner"]:::external
    end

    MRI -->|"Raw MRI Images"| GUI_In[/GUI Layer/]:::ui
    click GUI_In "https://github.com/yashpasar/brain-tumor-classification-and-detection-machine-learning/blob/master/Brain_Tumor_Code/BrainMRI_GUI.fig"
    click GUI_In "https://github.com/yashpasar/brain-tumor-classification-and-detection-machine-learning/blob/master/Brain_Tumor_Code/BrainMRI_GUI.m"

    GUI_In -->|"Select Image, Launch Pipeline"| Preprocessing["Preprocessing\n(Canny, Median Filter,\nEnhancement)"]:::process

    Preprocessing -->|"Filtered Image"| Segmentation["Segmentation\n(Otsu Thresholding,\nWatershed)"]:::process

    Segmentation -->|"Region Masks"| FeatureExtraction["Feature Extraction\n(DWT + PCA, Custom Calculators)"]:::process
    click FeatureExtraction "https://github.com/yashpasar/brain-tumor-classification-and-detection-machine-learning/blob/master/Brain_Tumor_Code/Brain_DWT_PCA.m"
    click FeatureExtraction "https://github.com/yashpasar/brain-tumor-classification-and-detection-machine-learning/blob/master/Brain_Tumor_Code/crossfun.m"
    click FeatureExtraction "https://github.com/yashpasar/brain-tumor-classification-and-detection-machine-learning/blob/master/Brain_Tumor_Code/crossfun_Parameters.m"

    FeatureExtraction -->|"Feature Vectors"| NormalizedFeatures[(Normalized_Features.mat)]:::datastore
    click NormalizedFeatures "https://github.com/yashpasar/brain-tumor-classification-and-detection-machine-learning/blob/master/Brain_Tumor_Code/Normalized_Features.mat"

    subgraph "Data Stores"
        Benign[(Benign Samples Folder)]:::datastore
        Malignant[(Malignant Samples Folder)]:::datastore
        Trainset[(Trainset.mat)]:::datastore
        README[(README.md)]:::external
    end
    click Benign "https://github.com/yashpasar/brain-tumor-classification-and-detection-machine-learning/tree/master/Brain_Tumor_Code/Benign/"
    click Malignant "https://github.com/yashpasar/brain-tumor-classification-and-detection-machine-learning/tree/master/Brain_Tumor_Code/Malignant/"
    click Trainset "https://github.com/yashpasar/brain-tumor-classification-and-detection-machine-learning/blob/master/Brain_Tumor_Code/Trainset.mat"
    click README "https://github.com/yashpasar/brain-tumor-classification-and-detection-machine-learning/blob/master/README.md"

    Benign -->|"Training Images" | TrainingData
    Malignant -->|"Training Images"| TrainingData
    TrainingData[(Training Data)]:::datastore

    TrainingData -->|"Model Fitting"| Classification["Classification\n(SVM, ANN, k-NN)"]:::classification
    NormalizedFeatures -->|"Inference Features"| Classification

    Classification -->|"Label & Confidence"| GUI_Out[[ GUI Results ]]:::ui
    GUI_Out -->|"Save or Export Results"| README

    classDef ui fill:#cce5ff,stroke:#333,stroke-width:1px;
    classDef process fill:#d4edda,stroke:#333,stroke-width:1px;
    classDef datastore fill:#ffe5b4,stroke:#333,stroke-width:1px;
    classDef classification fill:#e2d6f7,stroke:#333,stroke-width:1px;
    classDef external fill:#f0f0f0,stroke:#333,stroke-width:1px;
```
