NM000208: eeg dataset, 14 subjects#
Door lock control experiment (15 subjects, 4 classes, 31 EEG ch)
Citation: Jongmin Lee, Minju Kim, Dojin Heo, Jongsu Kim, Min-Ki Kim, Taejun Lee, Jongwoo Park, HyunYoung Kim, Minho Hwang, Laehyun Kim, Sung-Phil Kim (2019). Door lock control experiment (15 subjects, 4 classes, 31 EEG ch).
14-participant EEG dataset — Door lock control experiment (15 subjects, 4 classes, 31 EEG ch).
Quickstart#
Install
pip install eegdash
Access the data
from eegdash.dataset import NM000208
dataset = NM000208(cache_dir="./data")
# Get the raw object of the first recording
raw = dataset.datasets[0].raw
print(raw.info)
Filter by subject
dataset = NM000208(cache_dir="./data", subject="01")
Advanced query
dataset = NM000208(
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{nm000208,
title = {Door lock control experiment (15 subjects, 4 classes, 31 EEG ch)},
author = {Jongmin Lee and Minju Kim and Dojin Heo and Jongsu Kim and Min-Ki Kim and Taejun Lee and Jongwoo Park and HyunYoung Kim and Minho Hwang and Laehyun Kim and Sung-Phil Kim},
}
About This Dataset#
Door lock control experiment (15 subjects, 4 classes, 31 EEG ch).
Schema: HED 8.4.0 | Browse: https://www.hedtags.org/hed-schema-browser
Door lock control experiment (15 subjects, 4 classes, 31 EEG ch)
Target
├─ Sensory-event
├─ Experimental-stimulus
View full README
Door lock control experiment (15 subjects, 4 classes, 31 EEG ch)
Target
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Target
NonTarget
├─ Sensory-event
├─ Experimental-stimulus
├─ Visual-presentation
└─ Non-target
Paradigm-Specific Parameters
Detected paradigm: p300
Stimulus onset asynchrony: 750.0 ms
Data Structure
Trials: 50 training + 30 testing blocks per subject
Trials context: per_subject
BCI Application
Applications: home_appliance_control
Environment: laboratory
Online feedback: True
Tags
Pathology: Healthy
Modality: ERP
Type: P300
Documentation
DOI: 10.3389/fnhum.2024.1320457
License: CC-BY-4.0
Investigators: Jongmin Lee, Minju Kim, Dojin Heo, Jongsu Kim, Min-Ki Kim, Taejun Lee, Jongwoo Park, HyunYoung Kim, Minho Hwang, Laehyun Kim, Sung-Phil Kim
Institution: Ulsan National Institute of Science and Technology
Country: KR
Data URL: jml226/Home-Appliance-Control-Dataset
Publication year: 2024
References
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.5.0 (Mother of All BCI Benchmarks) NeuroTechX/moabb
Cohort#
Dataset Statistics#
Age distribution by gender (n=14, range 23–23 yr, mean 22.0 yr)
Channel counts: 31 ch (n=434 recordings)
Sampling frequencies: 500.0 Hz (n=434 recordings)
Total recording duration: 3 h 40 min
Signal · Electrodes & live trace#
Live trace viewer — sub-5 · ses-0 · task-p300 · run-20
Showing one representative recording out of
14 subjects and 434 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 · 31 sensors — 31 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 |
Door lock control experiment (15 subjects, 4 classes, 31 EEG ch) |
Author (year) |
|
Canonical |
— |
Importable as |
|
Year |
2019 |
Authors |
Jongmin Lee, Minju Kim, Dojin Heo, Jongsu Kim, Min-Ki Kim, Taejun Lee, Jongwoo Park, HyunYoung Kim, Minho Hwang, Laehyun Kim, Sung-Phil Kim |
License |
CC-BY-4.0 |
Citation / DOI |
Unknown |
Source links |
OpenNeuro | NeMAR | Source URL |
API Reference#
eegdash.datasetEEGDashDatasetNM000208 · Lee2024_Door_lock_controleegdash/dataset/registry.py · [source ↗]- class eegdash.dataset.NM000208(cache_dir: str, query: dict | None = None, s3_bucket: str | None = None, **kwargs)[source]#
Door lock control experiment (15 subjects, 4 classes, 31 EEG ch)
- Study:
nm000208(NeMAR)- Author (year):
Lee2024_Door_lock_control- Canonical:
—
Also importable as:
NM000208,Lee2024_Door_lock_control.Modality:
eeg; Experiment type:Attention; Subject type:Healthy. Subjects: 14; recordings: 434; 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/nm000208 NeMAR dataset: https://nemar.org/dataexplorer/detail?dataset_id=nm000208
Examples
>>> from eegdash.dataset import NM000208 >>> dataset = NM000208(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 nm000208 to reproduce the tutorial on this dataset.
Citation
Jongmin Lee, Minju Kim, Dojin Heo, Jongsu Kim, Min-Ki Kim, … (2019). Door lock control experiment (15 subjects, 4 classes, 31 EEG ch).
Provenance
¹Contributed to nemar in BIDS format.
²Curated & ingested by the EEGDash catalog; see CITATION.cff for canonical reference.
Related & sibling datasets
+ 1 more — see See Also below →
See Also#
eegdash.dataset.EEGDashDataseteegdash.dataset