# EEG-Speech Brain Decoding Dataset

## Overview
This dataset contains EEG recordings and audio data.

## Sessions
Sessions are labeled by recording date in YYYYMMDD format.
- Example: `ses-20240401` = recorded on April 1, 2024

Multiple recordings on the same day are distinguished by run numbers:
- `run-N`: Nth recording of the day

## Tasks
- **speechopen**: Overt speech production task
  - Participants vocalize visually presented text
- **listening**: Auditory listening task
  - Participants listen to prerecorded speech stimuli

## File Format Notes

### EEG Data
Raw EEG data is stored:
- **Path**: `sub-*/ses-*/eeg/*_eeg.edf`
- **Note**: EDF format is not officially part of BIDS-EEG specification
- Files are excluded in `.bidsignore` but documented here for reference
- Future releases may include EDF conversions for full BIDS compliance

### Behavioral Data (Audio)
Task audio files are stored in `beh/` directories:
- **Speech production**: `sub-*/ses-*/beh/*_recording-vocal_beh.wav`
- **Listening**: `sub-*/ses-*/beh/*_recording-audio_beh.wav`
- **Note**: Not officially part of BIDS-EEG spec, but included for analysis convenience
- Excluded in `.bidsignore`

## Directory Structure
```
dataset_root/
├── README                          (this file)
├── CHANGES                         (version history)
├── dataset_description.json        (dataset metadata)
├── participants.tsv                (participant information)
├── participants.json               (participant column descriptions)
├── task-speechopen_acq-pangolin_eeg.json               (speech production EEG metadata)
├── task-listening_acq-pangolin_eeg.json                (listening EEG metadata)
├── task-speechopen_acq-pangolin_events.json            (speech production events column descriptions)
├── task-speechopen_acq-pangolin_recording-vocal_beh.json
├── task-listening_acq-pangolin_recording-audio_beh.json
├── .bidsignore                     (files to ignore in validation)
│
├── code/                           (analysis and preprocessing code)
│   ├── preprocessing/              (EEG and audio preprocessing)
│   ├── training/                   (model training scripts)
│   ├── evaluation/                 (evaluation metrics)
│   └── bids/                       (BIDS conversion scripts)
│
├── sub-01/                         (participant data)
│   └── ses-YYYYMMDD/              (session by date)
│       ├── eeg/                    (EEG recordings)
│       └── beh/                    (behavioral/audio data)
│
└── derivatives/                    (processed data)
    └── pipeline-standard/          (standard preprocessing)
```