# graylab/dl4proteins-notebooks architecture

> Architecture diagram of the GitHub repository graylab/dl4proteins-notebooks, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/graylab/dl4proteins-notebooks
- Repository: https://github.com/graylab/dl4proteins-notebooks

## Overview

##### Main System Components

a) Educational Framework Layer
- As a top-level container showing the Jupyter/Colab environment
- Integration with Google Colab (primary platform)
- GitHub repository connection for notebook distribution

b) Curriculum Flow Layer
Content into four main learning tracks:
##### Fundamentals Track (WS01-02)
- NumPy Implementation
- PyTorch Implementation
##### Advanced Neural Networks Track (WS03-04)
- CNN Architecture
- Language Models
##### Protein-Specific Track (WS05-07)
- Transfer Learning
- AlphaFold
- Graph Neural Networks
##### Advanced Applications Track (WS08-10)
- Diffusion Models
- Protein Design Pipeline
- RFDiffusion

##### Component Relationships
Following connections:

a) Dependencies Flow
- Technology progression (NumPy → PyTorch → Specialized Models)

b) Integration Points
- Connections to external tools (AlphaFold, RFDiffusion, ProteinMPNN)
- Data flow between components

##### Technical Details

For each notebook component, show:
- Primary technologies used (NumPy, PyTorch, etc.)
- Input/Output specifications
- Computational requirements
- External dependencies

**[Educational Platform Layer]**

- [Fundamentals]─→[Advanced Concepts]─→[Protein Applications]─→[Design Tools]

**[External Tools Integration]**

**[Computational Resources]**

##### Data flow between components

- Educational progression
- Technology stack integration
- Practical application flow
- Tool dependencies
- Learning pathways

Remember to:
- Keep the main flow clear and intuitive
- Version information for key tools
- Resource requirements
- Optional vs. required paths

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Platform
        JC[Jupyter/Colab Environment]
        GH[GitHub Repository]
        JC --- GH
    end

    subgraph "Learning Tracks"
        subgraph "Fundamentals Track"
            WS01["NumPy Implementation"]
            WS02["PyTorch Implementation"]
            WS01 --> WS02
        end

        subgraph "Advanced Neural Networks"
            WS03["CNN Architecture"]
            WS04["Language Models"]
            WS02 --> WS03
            WS03 --> WS04
        end

        subgraph "Protein-Specific"
            WS05["Transfer Learning"]
            WS06["AlphaFold"]
            WS07["Graph Neural Networks"]
            WS04 --> WS05
            WS05 --> WS06
            WS06 --> WS07
        end

        subgraph "Advanced Applications"
            WS08["Diffusion Models"]
            WS09["Protein Design Pipeline"]
            WS10["RFDiffusion"]
            WS07 --> WS08
            WS08 --> WS09
            WS09 --> WS10
        end
    end

    subgraph "External Tools"
        AF[AlphaFold]
        RF[RFDiffusion]
        PM[ProteinMPNN]
        GR[GNN Resources]
    end

    WS06 -.-> AF
    WS10 -.-> RF
    WS09 -.-> PM
    WS07 -.-> GR

    classDef platform fill:#f9f,stroke:#333
    classDef fundamentals fill:#aef,stroke:#333
    classDef advanced fill:#fda,stroke:#333
    classDef protein fill:#bfb,stroke:#333
    classDef external fill:#ddd,stroke:#333

    class JC,GH platform
    class WS01,WS02 fundamentals
    class WS03,WS04 advanced
    class WS05,WS06,WS07 protein
    class AF,RF,PM,GR external

    click WS01 "https://github.com/Graylab/DL4Proteins-notebooks/blob/main/notebooks/WS01_NeuralNetworksWithNumpy.ipynb"
    click WS02 "https://github.com/Graylab/DL4Proteins-notebooks/blob/main/notebooks/WS02_NeuralNetworksWithPyTorch.ipynb"
    click WS03 "https://github.com/Graylab/DL4Proteins-notebooks/blob/main/notebooks/WS03_ConvolutionalNeuralNetworks.ipynb"
    click WS04 "https://github.com/Graylab/DL4Proteins-notebooks/blob/main/notebooks/WS04_LMsForShakespeareAndProteins.ipynb"
    click WS05 "https://github.com/Graylab/DL4Proteins-notebooks/blob/main/notebooks/WS05_LanguageModelEmbeddingsTransferLearningForDownstreamTask.ipynb"
    click WS06 "https://github.com/Graylab/DL4Proteins-notebooks/blob/main/notebooks/WS06_IntroductionToAF.ipynb"
    click WS07 "https://github.com/Graylab/DL4Proteins-notebooks/blob/main/notebooks/WS07_GNNsForProteins.ipynb"
    click WS08 "https://github.com/Graylab/DL4Proteins-notebooks/blob/main/notebooks/WS08_DenoisingDiffusionProbabilisticModels.ipynb"
    click WS09 "https://github.com/Graylab/DL4Proteins-notebooks/blob/main/notebooks/WS09_PuttingItAllTogether_DesigningProteins.ipynb"
    click WS10 "https://github.com/Graylab/DL4Proteins-notebooks/blob/main/notebooks/WS10_RFDiffusion_AllAtom.ipynb"
    click GR "https://github.com/Graylab/DL4Proteins-notebooks/tree/main/images/GNN/"
```
