# sai14karthik/parkinson-detection-using-deepnets architecture

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

- Interactive diagram: https://gitdiagram.com/sai14karthik/parkinson-detection-using-deepnets
- Repository: https://github.com/sai14karthik/parkinson-detection-using-deepnets

## Overview

##### Project Type and Purpose
- This project is a deep learning research/experiment focused on detecting Parkinson’s Disease using MRI data.
- The repository uses Jupyter Notebook implementations for multiple CNN architectures (e.g., DenseNet121, EfficientNet variants, ResNet50, etc.) to train and evaluate models on a medical imaging dataset.
- The main goal is to experiment with different deep architectures and report performance metrics (accuracy, precision, recall, F1-score) for Parkinson’s detection.

##### Analyzing the File Structure
- The project contains a dataset folder (“parkinsons_dataset”) with two key subdirectories: “normal” and “parkinson” – representing the two classes for the classification task.
- There are several .ipynb files at the repository’s root, each corresponding to a specific deep learning model implementation.
- Notice the lack of additional back-end or deployment folders. This indicates the project is primarily a research pipeline and experimentation setup running in the Jupyter Notebook environment.

##### Core Components
a. Data Source & Ingestion:
- “parkinsons_dataset/” representing raw MRI images.
- Within this component, highlight the two categories: “normal” and “parkinson”.
b. Data Preprocessing Stage:
- This is implicitly included within the notebooks. Include elements for image reading, normalization, and augmentation if applicable.
c. Model Training & Evaluation:
- A central “Deep Learning Framework” node that indicates the use of TensorFlow/Keras alongside libraries like NumPy, Pandas, and scikit-learn.
d. Result Analysis:
- An evaluation component that captures the generation of metrics and visualizations for performance comparison between experiments.

##### Relationships and Data Flow
- From Preprocessing, branch out to multiple model training nodes (each notebook implementation can be a distinct node).
- Then, all model outputs feed into a “Results & Metrics” module (which might also be visualized within the notebooks).

##### Architectural Patterns & Design Principles
- Even though the implementation is notebook-based, conceptually treat it as a modular pipeline. This follows a common machine learning architecture pattern:
- Separation of concerns: Data handling, model training, and evaluation.
- Experimentation: Multiple nodes (notebooks) implementing variants of the same pipeline.
- Clearly denote that the project leverages transfer learning architectures (many of the CNN models are pre-trained networks adapted for Parkinson detection).

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Jupyter Notebook Environment"
        ds["Raw MRI Dataset"]:::datasrc
        subgraph "Dataset Classes"
            n["normal"]:::datasrc
            p["parkinson"]:::datasrc
        end
        ds --> n
        ds --> p

        pp["Data Preprocessing"]:::preprocess
        ds --> pp

        subgraph "Model Training"
            df["Deep Learning Framework\n(TensorFlow/Keras, NumPy, Pandas,scikit-learn)"]:::framework
            df --> d1["DenseNet121"]:::model
            df --> d2["EfficientNetB0"]:::model
            df --> d3["EfficientNetB7"]:::model
            df --> d4["InceptionV3"]:::model
            df --> d5["MobileNet"]:::model
            df --> d6["NASNetMobile"]:::model
            df --> d7["ResNet50"]:::model
            df --> d8["VGG16"]:::model
            df --> d9["VGG19"]:::model
            df --> d10["Xception"]:::model
        end
        pp --> df

        res["Results & Metrics"]:::result
        d1 --> res
        d2 --> res
        d3 --> res
        d4 --> res
        d5 --> res
        d6 --> res
        d7 --> res
        d8 --> res
        d9 --> res
        d10 --> res

        res -->|"feedback"| pp
    end

    click ds "https://github.com/sai14karthik/parkinson-detection-using-deepnets/tree/main/parkinsons_dataset"
    click n "https://github.com/sai14karthik/parkinson-detection-using-deepnets/tree/main/parkinsons_dataset/normal"
    click p "https://github.com/sai14karthik/parkinson-detection-using-deepnets/tree/main/parkinsons_dataset/parkinson"
    click d1 "https://github.com/sai14karthik/parkinson-detection-using-deepnets/blob/main/parkinson-mri_desnet121.ipynb"
    click d2 "https://github.com/sai14karthik/parkinson-detection-using-deepnets/blob/main/parkinson-mri_efficientnetb0.ipynb"
    click d3 "https://github.com/sai14karthik/parkinson-detection-using-deepnets/blob/main/parkinson-mri_efficientnetb7.ipynb"
    click d4 "https://github.com/sai14karthik/parkinson-detection-using-deepnets/blob/main/parkinson-mri_inceptionv3.ipynb"
    click d5 "https://github.com/sai14karthik/parkinson-detection-using-deepnets/blob/main/parkinson-mri_mobilenet.ipynb"
    click d6 "https://github.com/sai14karthik/parkinson-detection-using-deepnets/blob/main/parkinson-mri_nasnetmobile.ipynb"
    click d7 "https://github.com/sai14karthik/parkinson-detection-using-deepnets/blob/main/parkinson-mri_resnet50.ipynb"
    click d8 "https://github.com/sai14karthik/parkinson-detection-using-deepnets/blob/main/parkinson-mri_vgg16.ipynb"
    click d9 "https://github.com/sai14karthik/parkinson-detection-using-deepnets/blob/main/parkinson-mri_vgg19.ipynb"
    click d10 "https://github.com/sai14karthik/parkinson-detection-using-deepnets/blob/main/parkinson-mri_xception.ipynb"

    class ds,n,p datasrc
    class pp preprocess
    class d1,d2,d3,d4,d5,d6,d7,d8,d9,d10 model
    class res result
    class df framework

    classDef datasrc fill:#AED6F1,stroke:#1A5276,stroke-width:2px;
    classDef preprocess fill:#A9DFBF,stroke:#145A32,stroke-width:2px;
    classDef model fill:#F9E79F,stroke:#B7950B,stroke-width:2px;
    classDef result fill:#F5CBA7,stroke:#943126,stroke-width:2px;
    classDef framework fill:#D2B4DE,stroke:#6C3483,stroke-width:2px;
```
