# krxgu/eeg_research-work architecture

> Architecture diagram of the GitHub repository krxgu/eeg_research-work, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-03-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/krxgu/eeg_research-work
- Repository: https://github.com/krxgu/eeg_research-work

## Overview

##### Main Components
- Data Sources: Include components such as the BCI Competition IV dataset and possibly custom EEG datasets. Label these as “EEG Data/BCI Competition Dataset” or similar.
- Preprocessing/Exploration: Although not explicitly broken out in separate directories, note that each notebook probably contains its own data preprocessing steps. Indicate that raw EEG data is fed into each experiment module.
- Experiment Modules/Models:
– BCI_Competition_IV: A module that directly uses the BCI Competition IV data.
– ChronoNet: Split this into two sub-components:
▪ ChronoNet Implementation - Keras
▪ ChronoNet Implementation - PyTorch
As two technical implementations of the same model, highlighting the dual framework approach.
– DL_Classification: A deep learning based approach dedicated to EEG classification.
– Epilepsy_Classification: Specialized module focused on classifying epilepsy from EEG signals.
– ML_classification: Where classical machine learning techniques are applied to EEG data.
– ResNet-Classification: An experimental module using (likely) a variant of the ResNet architecture applied to EEG.

##### Relationships and Data Flow
- If there are any common pre-/post-processing elements (e.g., data normalization or feature extraction steps mentioned within the notebooks), denote those as shared components or as part of the flow before the data splits into the experimental pipelines.
- Finally, indicate that the outputs (model predictions, performance metrics, visualizations) from each module converge into an “Evaluation/Results” component.

##### Architectural Patterns and Design Principles
- Modular structure: each experiment is decoupled and can be developed or run independently.
- That there is a separation by framework – for instance, ChronoNet has clear splits between Keras and PyTorch implementations. Indicate these branches distinctly.

## Diagram (Mermaid)

```mermaid
flowchart TD
    EEGData["EEG Data Source\n(BCI Competition Dataset)"]:::data

    subgraph "Experimental Modules"
        direction TB
        BCI["BCI Competition IV Analysis"]:::deep
        ChronoKeras["ChronoNet (Keras)"]:::deep
        ChronoPyTorch["ChronoNet (PyTorch)"]:::deep
        DLClass["DL Classification"]:::deep
        Epilepsy["Epilepsy Classification"]:::deep
        MLClass["ML Classification"]:::ml
        ResNet["ResNet Classification"]:::deep
    end

    Eval["Evaluation / Results"]:::eval

    EEGData --> BCI
    EEGData --> ChronoKeras
    EEGData --> ChronoPyTorch
    EEGData --> DLClass
    EEGData --> Epilepsy
    EEGData --> MLClass
    EEGData --> ResNet

    BCI --> Eval
    ChronoKeras --> Eval
    ChronoPyTorch --> Eval
    DLClass --> Eval
    Epilepsy --> Eval
    MLClass --> Eval
    ResNet --> Eval

    click EEGData "https://github.com/krxgu/eeg_research-work/tree/main/BCI_Competition_IV"
    click BCI "https://github.com/krxgu/eeg_research-work/blob/main/BCI_Competition_IV/BCI_Competition_IV_2a.ipynb"
    click ChronoKeras "https://github.com/krxgu/eeg_research-work/blob/main/ChronoNet/Implementation-Keras/chrononet_keras.ipynb"
    click ChronoPyTorch "https://github.com/krxgu/eeg_research-work/blob/main/ChronoNet/Implementation-PyTorch/chrononet_pytorch.ipynb"
    click DLClass "https://github.com/krxgu/eeg_research-work/blob/main/DL_Classification/EEG DL Classification.ipynb"
    click Epilepsy "https://github.com/krxgu/eeg_research-work/blob/main/Epilepsy_Classification/EEG_epilepsy.ipynb"
    click MLClass "https://github.com/krxgu/eeg_research-work/blob/main/ML_classification/EEG ML classification .ipynb"
    click ResNet "https://github.com/krxgu/eeg_research-work/blob/main/ResNet-Classification/eeg-conv2d.ipynb"

    classDef data fill:#aee1ff,stroke:#333,stroke-width:2px;
    classDef deep fill:#ffcc99,stroke:#333,stroke-width:2px;
    classDef ml fill:#dab3ff,stroke:#333,stroke-width:2px;
    classDef eval fill:#ff9999,stroke:#333,stroke-width:2px;
```
