# nishkarshv/deep_learning_nd_projects architecture

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

- Interactive diagram: https://gitdiagram.com/nishkarshv/deep_learning_nd_projects
- Repository: https://github.com/nishkarshv/deep_learning_nd_projects

## Overview

This repository is a collection of Deep Learning Nanodegree projects and demonstrations, not one integrated application. Its clearest end-to-end runtime is deep_jazz: a MIDI corpus is preprocessed into musical grammar, an LSTM learns sequences, and generation produces a MIDI result. The image-classification and first-neural-network notebooks document separate model-building workflows; other notebooks cover script generation, translation, and GAN-based face generation. TensorBoard examples train MNIST models and emit summaries for visualization. Connections reflect sampled source or README statements; notebook internals and some project wiring were not sampled.

Main entry points: [`deep_jazz/generator.py`](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/deep_jazz/generator.py) (Jazz Generation), [`language_translator/translate.py`](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/language_translator/translate.py) (Translation Runner), [`tensorboard/tensorboard_visualizer/complex.py`](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/tensorboard/tensorboard_visualizer/complex.py) (Complex Visualizer Demo), [`deep_jazz/preprocess.py`](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/deep_jazz/preprocess.py) (MIDI Preprocessing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning_projects["Learning Projects"]
  node_bike_nn["Bike Usage NN"]
  node_cifar_model["CIFAR-10 CNN"]
  node_cifar_helpers["CIFAR Data Helpers<br/>[helper.py]"]
  node_tv_script["TV Script Generation"]
  node_notebook_translation["Translation Exercise"]
  node_face_gan["Face Generation GAN"]
end

subgraph group_jazz_generation["Jazz Generation"]
  node_midi_corpus["MIDI Input"]
  node_midi_processing["MIDI Preprocessing<br/>[preprocess.py]"]
  node_music_grammar["Music Grammar<br/>[grammar.py]"]
  node_lstm_model["LSTM Training<br/>[lstm.py]"]
  node_jazz_generator["Jazz Generation<br/>[generator.py]"]
  node_note_cleanup["Note Cleanup<br/>[qa.py]"]
  node_midi_output["Generated MIDI<br/>[generator.py]"]
end

subgraph group_translation["Translation"]
  node_translation_runner["Translation Runner<br/>[translate.py]"]
  node_text_data["Parallel Text Data<br/>[data_utils.py]"]
  node_seq2seq["Seq2Seq Model<br/>[seq2seq_model.py]"]
end

subgraph group_tensorboard_demos["TensorBoard Demos"]
  node_mnist_demo["MNIST Training Demo<br/>[tensorboard.py]"]
  node_named_demo["Named Summaries"]
  node_search_demo["Parameter Search"]
  node_complex_demo["Complex Visualizer Demo<br/>[complex.py]"]
  node_simple_demo["Simple Visualizer Demo<br/>[simple.py]"]
  node_visualizer_data["Visualizer Input Data<br/>[input_data.py]"]
end

node_learner(("Project User"))
node_translation_user(("Translation User"))
node_tensor_user(("Demo User"))
node_dashboard["TensorBoard Dashboard"]

node_learner -->|"runs notebook"| node_bike_nn
node_learner -->|"runs notebook"| node_cifar_model
node_cifar_model -.->|"uses helpers"| node_cifar_helpers
node_learner -.->|"runs notebook"| node_tv_script
node_learner -.->|"runs notebook"| node_notebook_translation
node_learner -.->|"runs notebook"| node_face_gan
node_midi_corpus -.->|"parses MIDI"| node_midi_processing
node_midi_processing -->|"imports grammar"| node_music_grammar
node_learner -->|"starts generation"| node_jazz_generator
node_jazz_generator -->|"uses preprocessing"| node_midi_processing
node_jazz_generator -->|"uses grammar"| node_music_grammar
node_jazz_generator -->|"builds model"| node_lstm_model
node_jazz_generator -->|"cleans notes"| node_note_cleanup
node_jazz_generator -->|"writes MIDI"| node_midi_output
node_translation_user -.->|"runs translation"| node_translation_runner
node_translation_runner -->|"loads token data"| node_text_data
node_translation_runner -->|"runs model"| node_seq2seq
node_seq2seq -->|"uses data utilities"| node_text_data
node_tensor_user -->|"runs demo"| node_mnist_demo
node_tensor_user -->|"runs demo"| node_named_demo
node_tensor_user -->|"runs demo"| node_search_demo
node_tensor_user -->|"runs demo"| node_complex_demo
node_tensor_user -.->|"runs demo"| node_simple_demo
node_complex_demo -->|"imports input data"| node_visualizer_data
node_mnist_demo -->|"writes summaries"| node_dashboard
node_named_demo -->|"writes summaries"| node_dashboard
node_search_demo -->|"writes summaries"| node_dashboard
node_complex_demo -->|"writes summaries"| node_dashboard
node_simple_demo -.->|"visualizes logs"| node_dashboard

click node_bike_nn "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/01_first_neural_network/DLND%20Your%20first%20neural%20network.ipynb"
click node_cifar_model "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/02_image_classification/dlnd_image_classification.ipynb"
click node_cifar_helpers "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/02_image_classification/helper.py"
click node_tv_script "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/03_tv_script_generation/dlnd_tv_script_generation.ipynb"
click node_notebook_translation "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/04_language_translation/language_translation.ipynb"
click node_face_gan "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/05_face_generation_gans/dlnd_face_generation_wip.ipynb"
click node_midi_corpus "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/deep_jazz/midi/original_metheny.mid"
click node_midi_processing "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/deep_jazz/preprocess.py"
click node_music_grammar "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/deep_jazz/grammar.py"
click node_lstm_model "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/deep_jazz/lstm.py"
click node_jazz_generator "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/deep_jazz/generator.py"
click node_note_cleanup "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/deep_jazz/qa.py"
click node_midi_output "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/deep_jazz/generator.py"
click node_translation_runner "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/language_translator/translate.py"
click node_text_data "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/language_translator/data_utils.py"
click node_seq2seq "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/language_translator/seq2seq_model.py"
click node_mnist_demo "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/tensorboard/tensorboard.py"
click node_named_demo "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/tensorboard/tensorboard_names.py"
click node_search_demo "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/tensorboard/tensorboard_param_search.py"
click node_complex_demo "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/tensorboard/tensorboard_visualizer/complex.py"
click node_simple_demo "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/tensorboard/tensorboard_visualizer/simple.py"
click node_visualizer_data "https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/tensorboard/tensorboard_visualizer/input_data.py"

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_bike_nn,node_cifar_model,node_cifar_helpers,node_tv_script,node_notebook_translation,node_face_gan,node_learner,node_translation_user,node_tensor_user toneBlue
class node_midi_corpus,node_midi_processing,node_music_grammar,node_lstm_model,node_jazz_generator,node_note_cleanup,node_midi_output toneAmber
class node_translation_runner,node_text_data,node_seq2seq toneMint
class node_mnist_demo,node_named_demo,node_search_demo,node_complex_demo,node_simple_demo,node_visualizer_data toneRose
class node_dashboard toneIndigo
```

## Components

### Learning Projects

- [Bike Usage NN](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/01_first_neural_network/DLND%20Your%20first%20neural%20network.ipynb): `01_first_neural_network/DLND Your first neural network.ipynb`
- [CIFAR-10 CNN](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/02_image_classification/dlnd_image_classification.ipynb): `02_image_classification/dlnd_image_classification.ipynb`
- [CIFAR Data Helpers](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/02_image_classification/helper.py): `02_image_classification/helper.py`
- [TV Script Generation](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/03_tv_script_generation/dlnd_tv_script_generation.ipynb): `03_tv_script_generation/dlnd_tv_script_generation.ipynb`
- [Translation Exercise](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/04_language_translation/language_translation.ipynb): `04_language_translation/language_translation.ipynb`
- [Face Generation GAN](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/05_face_generation_gans/dlnd_face_generation_wip.ipynb): `05_face_generation_gans/dlnd_face_generation_wip.ipynb`

### Jazz Generation

- [MIDI Input](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/deep_jazz/midi/original_metheny.mid): `deep_jazz/midi/original_metheny.mid`
- [MIDI Preprocessing](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/deep_jazz/preprocess.py): `deep_jazz/preprocess.py`
- [Music Grammar](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/deep_jazz/grammar.py): `deep_jazz/grammar.py`
- [LSTM Training](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/deep_jazz/lstm.py): `deep_jazz/lstm.py`
- [Jazz Generation](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/deep_jazz/generator.py): `deep_jazz/generator.py`
- [Note Cleanup](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/deep_jazz/qa.py): `deep_jazz/qa.py`
- [Generated MIDI](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/deep_jazz/generator.py): `deep_jazz/generator.py`

### Translation

- [Translation Runner](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/language_translator/translate.py): `language_translator/translate.py`
- [Parallel Text Data](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/language_translator/data_utils.py): `language_translator/data_utils.py`
- [Seq2Seq Model](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/language_translator/seq2seq_model.py): `language_translator/seq2seq_model.py`

### TensorBoard Demos

- [MNIST Training Demo](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/tensorboard/tensorboard.py): `tensorboard/tensorboard.py`
- [Named Summaries](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/tensorboard/tensorboard_names.py): `tensorboard/tensorboard_names.py`
- [Parameter Search](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/tensorboard/tensorboard_param_search.py): `tensorboard/tensorboard_param_search.py`
- [Complex Visualizer Demo](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/tensorboard/tensorboard_visualizer/complex.py): `tensorboard/tensorboard_visualizer/complex.py`
- [Simple Visualizer Demo](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/tensorboard/tensorboard_visualizer/simple.py): `tensorboard/tensorboard_visualizer/simple.py`
- [Visualizer Input Data](https://github.com/nishkarshv/deep_learning_nd_projects/blob/master/tensorboard/tensorboard_visualizer/input_data.py): `tensorboard/tensorboard_visualizer/input_data.py`

### Other components

- **Project User**
- **Translation User**
- **Demo User**
- **TensorBoard Dashboard**

## Connections

- Project User → Bike Usage NN: runs notebook (evidence: `README.md`)
- Project User → CIFAR-10 CNN: runs notebook (evidence: `README.md`)
- CIFAR-10 CNN → CIFAR Data Helpers: uses helpers
- Project User → TV Script Generation: runs notebook
- Project User → Translation Exercise: runs notebook
- Project User → Face Generation GAN: runs notebook
- MIDI Input → MIDI Preprocessing: parses MIDI
- MIDI Preprocessing → Music Grammar: imports grammar (evidence: `deep_jazz/preprocess.py`)
- Project User → Jazz Generation: starts generation (evidence: `README.md`)
- Jazz Generation → MIDI Preprocessing: uses preprocessing (evidence: `deep_jazz/generator.py`)
- Jazz Generation → Music Grammar: uses grammar (evidence: `deep_jazz/generator.py`)
- Jazz Generation → LSTM Training: builds model (evidence: `deep_jazz/generator.py`)
- Jazz Generation → Note Cleanup: cleans notes (evidence: `deep_jazz/generator.py`)
- Jazz Generation → Generated MIDI: writes MIDI (evidence: `deep_jazz/generator.py`)
- Translation User → Translation Runner: runs translation
- Translation Runner → Parallel Text Data: loads token data (evidence: `language_translator/translate.py`)
- Translation Runner → Seq2Seq Model: runs model (evidence: `language_translator/translate.py`)
- Seq2Seq Model → Parallel Text Data: uses data utilities (evidence: `language_translator/seq2seq_model.py`)
- Demo User → MNIST Training Demo: runs demo (evidence: `README.md`)
- Demo User → Named Summaries: runs demo (evidence: `README.md`)
- Demo User → Parameter Search: runs demo (evidence: `README.md`)
- Demo User → Complex Visualizer Demo: runs demo (evidence: `README.md`)
- Demo User → Simple Visualizer Demo: runs demo
- Complex Visualizer Demo → Visualizer Input Data: imports input data (evidence: `tensorboard/tensorboard_visualizer/complex.py`)
- MNIST Training Demo → TensorBoard Dashboard: writes summaries (evidence: `README.md`)
- Named Summaries → TensorBoard Dashboard: writes summaries (evidence: `README.md`)
- Parameter Search → TensorBoard Dashboard: writes summaries (evidence: `README.md`)
- Complex Visualizer Demo → TensorBoard Dashboard: writes summaries (evidence: `README.md`)
- Simple Visualizer Demo → TensorBoard Dashboard: visualizes logs
