# manal-0603/deep_learning architecture

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

- Interactive diagram: https://gitdiagram.com/manal-0603/deep_learning
- Repository: https://github.com/manal-0603/deep_learning

## Overview

##### Project type and purpose
- This is an educational/research-oriented Deep Learning project consisting of two Jupyter notebooks:
- Perceptron_Simple.ipynb
- perceptron multicouche.ipynb
- The README only states “Deep_Learning,” confirming that these notebooks demonstrate and compare a single-layer perceptron versus a multilayer perceptron implementation and visualization.

##### File structure
- There are no separate “src” or “lib” directories—everything lives in notebooks.
- No config files or deployment scripts; core work happens inside the two notebooks.
- Likely dependencies (NumPy, Matplotlib or similar) are implicit in the notebook environment.

##### Components
a. Data Layer
- Input datasets (e.g., synthetic linearly separable data or real datasets)
- Data preprocessing steps (normalization, train/test split)
b. Execution Environment
- Jupyter Notebook server (kernel executing Python code)
- Python interpreter with ML libraries (NumPy, Matplotlib, potentially scikit-learn)
c. Model Implementation
- Notebook “Perceptron_Simple”:
- Initialization of weights
- Forward pass / activation function
- Weight update rule (learning loop)
- Training → Evaluation → Visualization
- Notebook “perceptron multicouche”:
- Definition of multilayer architecture (input, hidden, output layers)
- Forward propagation through layers
- Backpropagation and gradient descent
- Training → Evaluation → Visualization
d. Visualization & Results
- Plots of decision boundary, loss vs. epochs, accuracy metrics
- Comparative analysis between simple and multilayer perceptron

##### Relationships & data flow
- Data → Preprocessing → Notebook kernel
- Kernel runs Simple Perceptron pipeline → Model artifacts / plots
- Kernel runs Multilayer Perceptron pipeline → Model artifacts / plots
- Visualization sub-component reads model outputs and renders graphs in notebook UI

##### Architectural patterns & design principles
- Pipeline pattern: sequential stages of data preparation, training, evaluation, and plotting
- Separation of concerns: treat each notebook as a self-contained experiment

##### Technologies & frameworks
- Jupyter Notebook environment
- Python 3.x
- Core libraries: NumPy (array ops), Matplotlib or Seaborn (visuals), optionally scikit-learn (for data)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Documentation
    Doc["Project Overview / README"]:::dependency
    click Doc "https://github.com/manal-0603/deep_learning/blob/main/README.md"

    %% Data Layer
    Data["Input Datasets"]:::data
    Preprocess["Data Preprocessing\n(normalization, train/test split)"]:::compute

    %% Execution Environment
    Kernel["Jupyter Notebook Kernel"]:::compute
    PythonEnv["Python Env\n(NumPy, Matplotlib, scikit-learn)"]:::dependency

    %% Model Implementations
    Simple["Perceptron_Simple Notebook"]:::compute
    click Simple "https://github.com/manal-0603/deep_learning/blob/main/Perceptron_Simple.ipynb"
    Multi["Multilayer Perceptron Notebook"]:::compute
    click Multi "https://github.com/manal-0603/deep_learning/blob/main/perceptron multicouche.ipynb"

    %% Visualization
    Visualization["Visualization & Results\n(decision boundary, loss, accuracy)"]:::output

    %% Flow
    Doc -.-> Data
    Data --> Preprocess
    Preprocess --> Kernel
    Kernel --> Simple
    Kernel --> Multi
    Simple --> Visualization
    Multi --> Visualization
    Kernel -.-> PythonEnv
    Simple -.-> PythonEnv
    Multi -.-> PythonEnv

    %% Styles
    classDef compute fill:#cce5ff,stroke:#66b2ff,stroke-width:1px;
    classDef data fill:#d4edda,stroke:#28a745,stroke-width:1px;
    classDef output fill:#fff3cd,stroke:#ffcd39,stroke-width:1px;
    classDef dependency stroke-dasharray: 5 5,fill:#f8f9fa,stroke:#6c757d,stroke-width:1px;
```
