# marcotallone/deep-learning-project architecture

> Architecture diagram of the GitHub repository marcotallone/deep-learning-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/marcotallone/deep-learning-project
- Repository: https://github.com/marcotallone/deep-learning-project

## Overview

This repository develops and compares MRI brain-tumor classifiers and segmenters: dataset loading feeds task-specific training, whose models produce predictions assessed with metrics and analysis tools. The README documents classification and segmentation datasets, four classification architectures, and three U-Net variants. A separate `presentation/` subtree contains the Reveal.js engine used for the project presentation, including slide navigation and optional presentation features. Training-to-module links are supported by the SOURCE INDEX; the presentation controller links reflect imports shown there. Several presentation plugins and some runtime details were not sampled, so their wiring is not asserted.

Main entry points: [`presentation/js/reveal.js`](https://github.com/marcotallone/deep-learning-project/blob/master/presentation/js/reveal.js) (Reveal.js Engine), [`training/cnn_training.py`](https://github.com/marcotallone/deep-learning-project/blob/master/training/cnn_training.py) (CNN Training), [`training/unet_training.py`](https://github.com/marcotallone/deep-learning-project/blob/master/training/unet_training.py) (U-Net Training), [`training/vit_training.py`](https://github.com/marcotallone/deep-learning-project/blob/master/training/vit_training.py) (ViT Training)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["MRI Data"]
  node_dataset_download["Dataset Download<br/>[download.py]"]
  node_dataset_loaders["Dataset Loaders<br/>[datasets.py]"]
end

subgraph group_models["Model Architectures"]
  node_custom_cnn["Custom CNN<br/>[custom_cnn.py]"]
  node_alexnet["AlexNet<br/>[alexnet.py]"]
  node_vgg16["VGG-16<br/>[vgg16.py]"]
  node_vit["Vision Transformer<br/>[vit.py]"]
  node_classic_unet["Classic U-Net<br/>[classic_unet.py]"]
  node_improved_unet["Improved U-Net<br/>[improved_unet.py]"]
  node_attention_unet["Attention U-Net<br/>[attention_unet.py]"]
end

subgraph group_training["Training And Evaluation"]
  node_cnn_train["CNN Training<br/>[cnn_training.py]"]
  node_unet_train["U-Net Training<br/>[unet_training.py]"]
  node_vit_train["ViT Training<br/>[vit_training.py]"]
  node_train_utils["Training Utilities<br/>[train.py]"]
  node_metrics["Metrics<br/>[metrics.py]"]
  node_analysis["Analysis And Plots<br/>[analysis.py]"]
end

subgraph group_presentation["Presentation Runtime"]
  node_reveal["Reveal.js Engine<br/>[reveal.js]"]
  node_slide_controls["Slide Controllers<br/>[controls.js]"]
  node_slide_content["Slide Content<br/>[slidecontent.js]"]
  node_fragments["Slide Fragments<br/>[fragments.js]"]
  node_scroll_view["Scroll View<br/>[scrollview.js]"]
  node_auto_animate["Auto Animation<br/>[autoanimate.js]"]
  node_playback["Auto-Slide Playback<br/>[playback.js]"]
end

subgraph group_plugins["Presentation Plugins"]
  node_highlight_plugin["Code Highlighting<br/>[plugin.js]"]
  node_markdown_plugin["Markdown Slides<br/>[plugin.js]"]
  node_math_plugin["Math Rendering<br/>[plugin.js]"]
  node_notes_plugin["Speaker Notes<br/>[plugin.js]"]
  node_search_plugin["Slide Search<br/>[plugin.js]"]
  node_zoom_plugin["Slide Zoom<br/>[plugin.js]"]
end

node_researcher(("Project User"))
node_presentation_user(("Presentation Viewer"))

node_researcher -->|"obtains data"| node_dataset_download
node_researcher -->|"trains models"| node_cnn_train
node_researcher -->|"trains models"| node_unet_train
node_researcher -->|"trains models"| node_vit_train
node_cnn_train -->|"loads data"| node_dataset_loaders
node_unet_train -->|"loads data"| node_dataset_loaders
node_vit_train -->|"loads data"| node_dataset_loaders
node_cnn_train -->|"selects model"| node_custom_cnn
node_cnn_train -->|"imports model"| node_alexnet
node_cnn_train -->|"imports model"| node_vgg16
node_vit_train -->|"builds model"| node_vit
node_unet_train -->|"imports model"| node_classic_unet
node_unet_train -->|"imports model"| node_improved_unet
node_unet_train -->|"imports model"| node_attention_unet
node_cnn_train -->|"uses training"| node_train_utils
node_unet_train -->|"uses training"| node_train_utils
node_vit_train -->|"uses training"| node_train_utils
node_train_utils -->|"computes metrics"| node_metrics
node_cnn_train -->|"uses analysis"| node_analysis
node_unet_train -->|"uses analysis"| node_analysis
node_vit_train -->|"uses analysis"| node_analysis
node_presentation_user -->|"views slides"| node_reveal
node_reveal -->|"imports controller"| node_slide_controls
node_reveal -->|"imports controller"| node_slide_content
node_reveal -->|"imports controller"| node_fragments
node_reveal -->|"imports controller"| node_scroll_view
node_reveal -->|"imports controller"| node_auto_animate
node_reveal -->|"creates playback"| node_playback
node_reveal -.-> node_highlight_plugin
node_reveal -.-> node_markdown_plugin
node_reveal -.-> node_math_plugin
node_reveal -.-> node_notes_plugin
node_reveal -.-> node_search_plugin
node_reveal -.-> node_zoom_plugin

click node_dataset_download "https://github.com/marcotallone/deep-learning-project/blob/master/datasets/download.py"
click node_dataset_loaders "https://github.com/marcotallone/deep-learning-project/blob/master/utils/datasets.py"
click node_cnn_train "https://github.com/marcotallone/deep-learning-project/blob/master/training/cnn_training.py"
click node_unet_train "https://github.com/marcotallone/deep-learning-project/blob/master/training/unet_training.py"
click node_vit_train "https://github.com/marcotallone/deep-learning-project/blob/master/training/vit_training.py"
click node_train_utils "https://github.com/marcotallone/deep-learning-project/blob/master/utils/train.py"
click node_metrics "https://github.com/marcotallone/deep-learning-project/blob/master/utils/metrics.py"
click node_analysis "https://github.com/marcotallone/deep-learning-project/blob/master/utils/analysis.py"
click node_custom_cnn "https://github.com/marcotallone/deep-learning-project/blob/master/models/custom_cnn.py"
click node_alexnet "https://github.com/marcotallone/deep-learning-project/blob/master/models/alexnet.py"
click node_vgg16 "https://github.com/marcotallone/deep-learning-project/blob/master/models/vgg16.py"
click node_vit "https://github.com/marcotallone/deep-learning-project/blob/master/models/vit.py"
click node_classic_unet "https://github.com/marcotallone/deep-learning-project/blob/master/models/classic_unet.py"
click node_improved_unet "https://github.com/marcotallone/deep-learning-project/blob/master/models/improved_unet.py"
click node_attention_unet "https://github.com/marcotallone/deep-learning-project/blob/master/models/attention_unet.py"
click node_reveal "https://github.com/marcotallone/deep-learning-project/blob/master/presentation/js/reveal.js"
click node_slide_controls "https://github.com/marcotallone/deep-learning-project/blob/master/presentation/js/controllers/controls.js"
click node_slide_content "https://github.com/marcotallone/deep-learning-project/blob/master/presentation/js/controllers/slidecontent.js"
click node_fragments "https://github.com/marcotallone/deep-learning-project/blob/master/presentation/js/controllers/fragments.js"
click node_scroll_view "https://github.com/marcotallone/deep-learning-project/blob/master/presentation/js/controllers/scrollview.js"
click node_auto_animate "https://github.com/marcotallone/deep-learning-project/blob/master/presentation/js/controllers/autoanimate.js"
click node_playback "https://github.com/marcotallone/deep-learning-project/blob/master/presentation/js/components/playback.js"
click node_highlight_plugin "https://github.com/marcotallone/deep-learning-project/blob/master/presentation/plugin/highlight/plugin.js"
click node_markdown_plugin "https://github.com/marcotallone/deep-learning-project/blob/master/presentation/plugin/markdown/plugin.js"
click node_math_plugin "https://github.com/marcotallone/deep-learning-project/blob/master/presentation/plugin/math/plugin.js"
click node_notes_plugin "https://github.com/marcotallone/deep-learning-project/blob/master/presentation/plugin/notes/plugin.js"
click node_search_plugin "https://github.com/marcotallone/deep-learning-project/blob/master/presentation/plugin/search/plugin.js"
click node_zoom_plugin "https://github.com/marcotallone/deep-learning-project/blob/master/presentation/plugin/zoom/plugin.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dataset_download,node_dataset_loaders,node_researcher,node_presentation_user toneBlue
class node_custom_cnn,node_alexnet,node_vgg16,node_vit,node_classic_unet,node_improved_unet,node_attention_unet toneAmber
class node_cnn_train,node_unet_train,node_vit_train,node_train_utils,node_metrics,node_analysis toneMint
class node_reveal,node_slide_controls,node_slide_content,node_fragments,node_scroll_view,node_auto_animate,node_playback toneRose
class node_highlight_plugin,node_markdown_plugin,node_math_plugin,node_notes_plugin,node_search_plugin,node_zoom_plugin toneIndigo
```

## Components

### MRI Data

- [Dataset Download](https://github.com/marcotallone/deep-learning-project/blob/master/datasets/download.py): `datasets/download.py`
- [Dataset Loaders](https://github.com/marcotallone/deep-learning-project/blob/master/utils/datasets.py): `utils/datasets.py`

### Model Architectures

- [Custom CNN](https://github.com/marcotallone/deep-learning-project/blob/master/models/custom_cnn.py): `models/custom_cnn.py`
- [AlexNet](https://github.com/marcotallone/deep-learning-project/blob/master/models/alexnet.py): `models/alexnet.py`
- [VGG-16](https://github.com/marcotallone/deep-learning-project/blob/master/models/vgg16.py): `models/vgg16.py`
- [Vision Transformer](https://github.com/marcotallone/deep-learning-project/blob/master/models/vit.py): `models/vit.py`
- [Classic U-Net](https://github.com/marcotallone/deep-learning-project/blob/master/models/classic_unet.py): `models/classic_unet.py`
- [Improved U-Net](https://github.com/marcotallone/deep-learning-project/blob/master/models/improved_unet.py): `models/improved_unet.py`
- [Attention U-Net](https://github.com/marcotallone/deep-learning-project/blob/master/models/attention_unet.py): `models/attention_unet.py`

### Training And Evaluation

- [CNN Training](https://github.com/marcotallone/deep-learning-project/blob/master/training/cnn_training.py): `training/cnn_training.py`
- [U-Net Training](https://github.com/marcotallone/deep-learning-project/blob/master/training/unet_training.py): `training/unet_training.py`
- [ViT Training](https://github.com/marcotallone/deep-learning-project/blob/master/training/vit_training.py): `training/vit_training.py`
- [Training Utilities](https://github.com/marcotallone/deep-learning-project/blob/master/utils/train.py): `utils/train.py`
- [Metrics](https://github.com/marcotallone/deep-learning-project/blob/master/utils/metrics.py): `utils/metrics.py`
- [Analysis And Plots](https://github.com/marcotallone/deep-learning-project/blob/master/utils/analysis.py): `utils/analysis.py`

### Presentation Runtime

- [Reveal.js Engine](https://github.com/marcotallone/deep-learning-project/blob/master/presentation/js/reveal.js): `presentation/js/reveal.js`
- [Slide Controllers](https://github.com/marcotallone/deep-learning-project/blob/master/presentation/js/controllers/controls.js): `presentation/js/controllers/controls.js`
- [Slide Content](https://github.com/marcotallone/deep-learning-project/blob/master/presentation/js/controllers/slidecontent.js): `presentation/js/controllers/slidecontent.js`
- [Slide Fragments](https://github.com/marcotallone/deep-learning-project/blob/master/presentation/js/controllers/fragments.js): `presentation/js/controllers/fragments.js`
- [Scroll View](https://github.com/marcotallone/deep-learning-project/blob/master/presentation/js/controllers/scrollview.js): `presentation/js/controllers/scrollview.js`
- [Auto Animation](https://github.com/marcotallone/deep-learning-project/blob/master/presentation/js/controllers/autoanimate.js): `presentation/js/controllers/autoanimate.js`
- [Auto-Slide Playback](https://github.com/marcotallone/deep-learning-project/blob/master/presentation/js/components/playback.js): `presentation/js/components/playback.js`

### Presentation Plugins

- [Code Highlighting](https://github.com/marcotallone/deep-learning-project/blob/master/presentation/plugin/highlight/plugin.js): `presentation/plugin/highlight/plugin.js`
- [Markdown Slides](https://github.com/marcotallone/deep-learning-project/blob/master/presentation/plugin/markdown/plugin.js): `presentation/plugin/markdown/plugin.js`
- [Math Rendering](https://github.com/marcotallone/deep-learning-project/blob/master/presentation/plugin/math/plugin.js): `presentation/plugin/math/plugin.js`
- [Speaker Notes](https://github.com/marcotallone/deep-learning-project/blob/master/presentation/plugin/notes/plugin.js): `presentation/plugin/notes/plugin.js`
- [Slide Search](https://github.com/marcotallone/deep-learning-project/blob/master/presentation/plugin/search/plugin.js): `presentation/plugin/search/plugin.js`
- [Slide Zoom](https://github.com/marcotallone/deep-learning-project/blob/master/presentation/plugin/zoom/plugin.js): `presentation/plugin/zoom/plugin.js`

### Other components

- **Project User**
- **Presentation Viewer**

## Connections

- Project User → Dataset Download: obtains data (evidence: `README.md`)
- Project User → CNN Training: trains models (evidence: `README.md`)
- Project User → U-Net Training: trains models (evidence: `README.md`)
- Project User → ViT Training: trains models (evidence: `README.md`)
- CNN Training → Dataset Loaders: loads data (evidence: `training/cnn_training.py`)
- U-Net Training → Dataset Loaders: loads data (evidence: `training/unet_training.py`)
- ViT Training → Dataset Loaders: loads data (evidence: `training/vit_training.py`)
- CNN Training → Custom CNN: selects model (evidence: `training/cnn_training.py`)
- CNN Training → AlexNet: imports model (evidence: `training/cnn_training.py`)
- CNN Training → VGG-16: imports model (evidence: `training/cnn_training.py`)
- ViT Training → Vision Transformer: builds model (evidence: `training/vit_training.py`)
- U-Net Training → Classic U-Net: imports model (evidence: `training/unet_training.py`)
- U-Net Training → Improved U-Net: imports model (evidence: `training/unet_training.py`)
- U-Net Training → Attention U-Net: imports model (evidence: `training/unet_training.py`)
- CNN Training → Training Utilities: uses training (evidence: `training/cnn_training.py`)
- U-Net Training → Training Utilities: uses training (evidence: `training/unet_training.py`)
- ViT Training → Training Utilities: uses training (evidence: `training/vit_training.py`)
- Training Utilities → Metrics: computes metrics (evidence: `utils/train.py`)
- CNN Training → Analysis And Plots: uses analysis (evidence: `training/cnn_training.py`)
- U-Net Training → Analysis And Plots: uses analysis (evidence: `training/unet_training.py`)
- ViT Training → Analysis And Plots: uses analysis (evidence: `training/vit_training.py`)
- Presentation Viewer → Reveal.js Engine: views slides (evidence: `README.md`)
- Reveal.js Engine → Slide Controllers: imports controller (evidence: `presentation/js/reveal.js`)
- Reveal.js Engine → Slide Content: imports controller (evidence: `presentation/js/reveal.js`)
- Reveal.js Engine → Slide Fragments: imports controller (evidence: `presentation/js/reveal.js`)
- Reveal.js Engine → Scroll View: imports controller (evidence: `presentation/js/reveal.js`)
- Reveal.js Engine → Auto Animation: imports controller (evidence: `presentation/js/reveal.js`)
- Reveal.js Engine → Auto-Slide Playback: creates playback (evidence: `presentation/js/reveal.js`)
- Reveal.js Engine → Code Highlighting
- Reveal.js Engine → Markdown Slides
- Reveal.js Engine → Math Rendering
- Reveal.js Engine → Speaker Notes
- Reveal.js Engine → Slide Search
- Reveal.js Engine → Slide Zoom
