# divya-eng21/eeg-drowsiness-detection architecture

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

- Interactive diagram: https://gitdiagram.com/divya-eng21/eeg-drowsiness-detection
- Repository: https://github.com/divya-eng21/eeg-drowsiness-detection

## Overview

This repository is a small EEG drowsiness-classification project. Its documented workflow uses a dataset of pre-extracted EEG frequency-band features to compare machine-learning and neural-network approaches, then reports model accuracy; Random Forest performs best in the README. The tree identifies separate MLP and 1D-CNN notebooks and a general ML-pipeline notebook, but no notebook contents were provided, so internal execution details and notebook-to-notebook calls cannot be verified.

Main entry points: [`acquiredDataset.csv`](https://github.com/divya-eng21/eeg-drowsiness-detection/blob/main/acquiredDataset.csv) (EEG dataset), [`README.md`](https://github.com/divya-eng21/eeg-drowsiness-detection/blob/main/README.md) (Model results), [`eeg_drowsiness_detection_ML_pipeline.ipynb`](https://github.com/divya-eng21/eeg-drowsiness-detection/blob/main/eeg_drowsiness_detection_ML_pipeline.ipynb) (ML pipeline), [`eeg_drowsiness_DeepLearning_MLP.ipynb`](https://github.com/divya-eng21/eeg-drowsiness-detection/blob/main/eeg_drowsiness_DeepLearning_MLP.ipynb) (MLP experiment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["EEG data"]
  node_dataset["EEG dataset"]
end

subgraph group_experiments["Model experiments"]
  node_pipeline["ML pipeline"]
  node_mlp["MLP experiment"]
  node_cnn["1D-CNN experiment"]
  node_results["Model results<br/>[README.md]"]
end

node_dataset -->|"classifies from"| node_pipeline
node_dataset -.->|"classifies from"| node_mlp
node_dataset -.->|"classifies from"| node_cnn
node_pipeline -->|"reports comparison"| node_results
node_mlp -->|"reports accuracy"| node_results
node_cnn -->|"reports accuracy"| node_results

click node_dataset "https://github.com/divya-eng21/eeg-drowsiness-detection/blob/main/acquiredDataset.csv"
click node_pipeline "https://github.com/divya-eng21/eeg-drowsiness-detection/blob/main/eeg_drowsiness_detection_ML_pipeline.ipynb"
click node_mlp "https://github.com/divya-eng21/eeg-drowsiness-detection/blob/main/eeg_drowsiness_DeepLearning_MLP.ipynb"
click node_cnn "https://github.com/divya-eng21/eeg-drowsiness-detection/blob/main/eeg_drowsiness_DeepLearning_1DCNN.ipynb"
click node_results "https://github.com/divya-eng21/eeg-drowsiness-detection/blob/main/README.md"

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 toneBlue
class node_pipeline,node_mlp,node_cnn,node_results toneAmber
```

## Components

### EEG data

- [EEG dataset](https://github.com/divya-eng21/eeg-drowsiness-detection/blob/main/acquiredDataset.csv): `acquiredDataset.csv`

### Model experiments

- [ML pipeline](https://github.com/divya-eng21/eeg-drowsiness-detection/blob/main/eeg_drowsiness_detection_ML_pipeline.ipynb): `eeg_drowsiness_detection_ML_pipeline.ipynb`
- [MLP experiment](https://github.com/divya-eng21/eeg-drowsiness-detection/blob/main/eeg_drowsiness_DeepLearning_MLP.ipynb): `eeg_drowsiness_DeepLearning_MLP.ipynb`
- [1D-CNN experiment](https://github.com/divya-eng21/eeg-drowsiness-detection/blob/main/eeg_drowsiness_DeepLearning_1DCNN.ipynb): `eeg_drowsiness_DeepLearning_1DCNN.ipynb`
- [Model results](https://github.com/divya-eng21/eeg-drowsiness-detection/blob/main/README.md): `README.md`

## Connections

- EEG dataset → ML pipeline: classifies from (evidence: `README.md`)
- EEG dataset → MLP experiment: classifies from
- EEG dataset → 1D-CNN experiment: classifies from
- ML pipeline → Model results: reports comparison (evidence: `README.md`)
- MLP experiment → Model results: reports accuracy (evidence: `README.md`)
- 1D-CNN experiment → Model results: reports accuracy (evidence: `README.md`)
