NM000124: eeg dataset, 24 subjects#
Han2024 – SSVEP fatigue dataset with two frequency paradigms
Citation: Yuheng Han, Yufeng Ke, Ruiyan Wang, Tao Wang, Dong Ming (2019). Han2024 – SSVEP fatigue dataset with two frequency paradigms. 10.82901/nemar.nm000124
24-participant EEG dataset — Han2024 – SSVEP fatigue dataset with two frequency paradigms.
Quickstart#
Install
pip install eegdash
Access the data
from eegdash.dataset import NM000124
dataset = NM000124(cache_dir="./data")
# Get the raw object of the first recording
raw = dataset.datasets[0].raw
print(raw.info)
Filter by subject
dataset = NM000124(cache_dir="./data", subject="01")
Advanced query
dataset = NM000124(
cache_dir="./data",
query={"subject": {"$in": ["01", "02"]}},
)
Iterate recordings
for rec in dataset:
print(rec.subject, rec.raw.info['sfreq'])
If you use this dataset in your research, please cite the original authors.
BibTeX
@dataset{nm000124,
title = {Han2024 – SSVEP fatigue dataset with two frequency paradigms},
author = {Yuheng Han and Yufeng Ke and Ruiyan Wang and Tao Wang and Dong Ming},
doi = {10.82901/nemar.nm000124},
url = {https://doi.org/10.82901/nemar.nm000124},
}
About This Dataset#
SSVEP fatigue dataset with two frequency paradigms.
Schema: HED 8.4.0 | Browse: https://www.hedtags.org/hed-schema-browser
SSVEP fatigue dataset with two frequency paradigms
8
View full README
SSVEP fatigue dataset with two frequency paradigms
8
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/8
8.5
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/8_5
9
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/9
9.5
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/9_5
10
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/10
10.5
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/10_5
11
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/11
11.5
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/11_5
12
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/12
12.5
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/12_5
13
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/13
13.5
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/13_5
14
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/14
14.5
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/14_5
15
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/15
15.5
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/15_5
25.5
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/25_5
26
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/26
26.5
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/26_5
27
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/27
27.5
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/27_5
28
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/28
28.5
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/28_5
29
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/29
29.5
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/29_5
30
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/30
30.5
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/30_5
31
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/31
31.5
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/31_5
32
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/32
32.5
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/32_5
33
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Label/33
Paradigm-Specific Parameters
Detected paradigm: ssvep
Stimulus frequencies: [8.0, 8.5, 9.0, 9.5, 10.0, 10.5, 11.0, 11.5, 12.0, 12.5, 13.0, 13.5, 14.0, 14.5, 15.0, 15.5, 25.5, 26.0, 26.5, 27.0, 27.5, 28.0, 28.5, 29.0, 29.5, 30.0, 30.5, 31.0, 31.5, 32.0, 32.5, 33.0] Hz
Frequency resolution: 0.5 Hz
Data Structure
Trials: 960 per frequency band (16 targets x 60 blocks)
Blocks per session: 60
Trials context: 6 training + 24 fatigue blocks per frequency condition
Preprocessing
Data state: epoched
Signal Processing
Classifiers: TRCA
Spatial filters: TRCA
BCI Application
Environment: lab
Online feedback: False
Tags
Pathology: healthy
Modality: visual
Type: perception
Documentation
DOI: 10.1109/TNSRE.2024.3380635
License: CC BY 4.0
Investigators: Yuheng Han, Yufeng Ke, Ruiyan Wang, Tao Wang, Dong Ming
Senior author: Dong Ming
Institution: Tianjin University
Department: Academy of Medical Engineering and Translational Medicine, Tianjin University
Country: CN
Repository: Zenodo
Data URL: https://zenodo.org/records/10507229
Publication year: 2024
Funding: National Key Research and Development Program of China (Grant 2021YFF1200603); National Natural Science Foundation of China (Grants 62276184, 61806141)
Ethics approval: Research Ethics Committee of Tianjin University
Keywords: SSVEP, BCI, fatigue, dynamic stopping, EEG
References
Y. Han, Y. Ke, R. Wang, T. Wang, and D. Ming, “Enhancing SSVEP-BCI Performance Under Fatigue State Using Dynamic Stopping Strategy,” IEEE Trans. Neural Syst. Rehab. Eng., vol. 32, pp. 1407-1415, 2024. DOI: 10.1109/TNSRE.2024.3380635 Appelhoff, S., Sanderson, M., Brooks, T., Vliet, M., Quentin, R., Holdgraf, C., Chaumon, M., Mikulan, E., Tavabi, K., Hochenberger, R., Welke, D., Brunner, C., Rockhill, A., Larson, E., Gramfort, A. and Jas, M. (2019). MNE-BIDS: Organizing electrophysiological data into the BIDS format and facilitating their analysis. Journal of Open Source Software 4: (1896). https://doi.org/10.21105/joss.01896 Pernet, C. R., Appelhoff, S., Gorgolewski, K. J., Flandin, G., Phillips, C., Delorme, A., Oostenveld, R. (2019). EEG-BIDS, an extension to the brain imaging data structure for electroencephalography. Scientific Data, 6, 103. https://doi.org/10.1038/s41597-019-0104-8 Generated by MOABB 1.4.3 (Mother of All BCI Benchmarks) NeuroTechX/moabb
Cohort#
Dataset Statistics#
Channel counts: 64 ch (n=48 recordings)
Sampling frequencies: 1000.0 Hz (n=48 recordings)
Total recording duration: 19 h 50 min
Signal · Electrodes & live trace#
Live trace viewer — sub-13 · ses-0 · task-ssvep · run-0
Showing one representative recording out of
24 subjects and 48 recordings in this dataset.
Browse the full set on OpenNeuro;
drop any other _eeg.{set,edf,bdf,vhdr} file onto the
viewer (or pass ?eeg=<url>) to inspect it.
Electrode layout — EEG · 62 sensors — 62 channels
NEMAR Processing Statistics#
The plots below are generated by NEMAR’s automated EEG pipeline. The histogram shows pipeline success for data cleaning and ICA decomposition, the percentage of data frames and EEG channels retained after artefact removal, line noise per channel (RMS, dB), and the age/gender distribution of participants.
HED event descriptors word cloud
Manifest#
File Explorer#
Browse the BIDS file structure of this dataset. Records are fetched on demand from the EEGDash catalog the first time you open the explorer.
Full dataset metadata table
Dataset ID |
|
Title |
Han2024 – SSVEP fatigue dataset with two frequency paradigms |
Author (year) |
|
Canonical |
— |
Importable as |
|
Year |
2019 |
Authors |
Yuheng Han, Yufeng Ke, Ruiyan Wang, Tao Wang, Dong Ming |
License |
CC BY 4.0 |
Citation / DOI |
|
Source links |
OpenNeuro | NeMAR | Source URL |
Copy-paste BibTeX
@dataset{nm000124,
title = {Han2024 – SSVEP fatigue dataset with two frequency paradigms},
author = {Yuheng Han and Yufeng Ke and Ruiyan Wang and Tao Wang and Dong Ming},
doi = {10.82901/nemar.nm000124},
url = {https://doi.org/10.82901/nemar.nm000124},
}
API Reference#
eegdash.datasetEEGDashDatasetNM000124 · Han2024eegdash/dataset/registry.py · [source ↗]- class eegdash.dataset.NM000124(cache_dir: str, query: dict | None = None, s3_bucket: str | None = None, **kwargs)[source]#
Han2024 – SSVEP fatigue dataset with two frequency paradigms
- Study:
nm000124(NeMAR)- Author (year):
Han2024- Canonical:
—
Also importable as:
NM000124,Han2024.Modality:
eeg; Experiment type:Perception; Subject type:Healthy. Subjects: 24; recordings: 48; tasks: 1.- Parameters:
cache_dir (str | Path) – Directory where data are cached locally.
query (dict | None) – Additional MongoDB-style filters to AND with the dataset selection. Must not contain the key
dataset.s3_bucket (str | None) – Base S3 bucket used to locate the data.
**kwargs (dict) – Additional keyword arguments forwarded to
EEGDashDataset.
- data_dir#
Local dataset cache directory (
cache_dir / dataset_id).- Type:
Path
Notes
Each item is a recording; recording-level metadata are available via
dataset.description.querysupports MongoDB-style filters on fields inALLOWED_QUERY_FIELDSand is combined with the dataset filter. Dataset-specific caveats are not provided in the summary metadata.References
OpenNeuro dataset: https://openneuro.org/datasets/nm000124 NeMAR dataset: https://nemar.org/dataexplorer/detail?dataset_id=nm000124 DOI: https://doi.org/10.82901/nemar.nm000124
Examples
>>> from eegdash.dataset import NM000124 >>> dataset = NM000124(cache_dir="./data") >>> recording = dataset[0] >>> raw = recording.load()
- __init__(cache_dir: str, query: dict | None = None, s3_bucket: str | None = None, **kwargs)[source]#
- save(path: str, overwrite: bool = False, offset: int = 0)[source]#
Save datasets to files by creating one subdirectory for each dataset:
path/ 0/ 0-raw.fif | 0-epo.fif description.json raw_preproc_kwargs.json (if raws were preprocessed) window_kwargs.json (if this is a windowed dataset) window_preproc_kwargs.json (if windows were preprocessed) target_name.json (if target_name is not None and dataset is raw) 1/ 1-raw.fif | 1-epo.fif description.json raw_preproc_kwargs.json (if raws were preprocessed) window_kwargs.json (if this is a windowed dataset) window_preproc_kwargs.json (if windows were preprocessed) target_name.json (if target_name is not None and dataset is raw)
- Parameters:
path (str) –
- Directory in which subdirectories are created to store
-raw.fif | -epo.fif and .json files to.
overwrite (bool) – Whether to delete old subdirectories that will be saved to in this call.
offset (int) – If provided, the integer is added to the id of the dataset in the concat. This is useful in the setting of very large datasets, where one dataset has to be processed and saved at a time to account for its original position.
BaseDataset from braindecode — windowed via create_windows_from_events.braindecodeDataLoader; supports parallel workers and on-the-fly augmentations.pytorchSwap any load_dataset(...) call for nm000124 to reproduce the tutorial on this dataset.
Citation
Yuheng Han, Yufeng Ke, Ruiyan Wang, Tao Wang, Dong Ming (2019). Han2024 – SSVEP fatigue dataset with two frequency paradigms. 10.82901/nemar.nm000124
Provenance
¹Contributed to nemar in BIDS format.
²Curated & ingested by the EEGDash catalog; see CITATION.cff for canonical reference.
³Persistent identifier: 10.82901/nemar.nm000124.
See Also#
eegdash.dataset.EEGDashDataseteegdash.dataset