DS006695#

Validation of Sleep Staging with Forehead EEG Patch

Access recordings and metadata through EEGDash.

Citation: Julie Onton, Sarah Mednick (2025). Validation of Sleep Staging with Forehead EEG Patch. 10.18112/openneuro.ds006695.v1.0.2

Modality: eeg Subjects: 19 Recordings: 81 License: CC0 Source: openneuro

Metadata: Complete (100%)

Quickstart#

Install

pip install eegdash

Access the data

from eegdash.dataset import DS006695

dataset = DS006695(cache_dir="./data")
# Get the raw object of the first recording
raw = dataset.datasets[0].raw
print(raw.info)

Filter by subject

dataset = DS006695(cache_dir="./data", subject="01")

Advanced query

dataset = DS006695(
    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{ds006695,
  title = {Validation of Sleep Staging with Forehead EEG Patch},
  author = {Julie Onton and Sarah Mednick},
  doi = {10.18112/openneuro.ds006695.v1.0.2},
  url = {https://doi.org/10.18112/openneuro.ds006695.v1.0.2},
}

About This Dataset#

UCSD Forehead Patch Sleep Validation Dataset

Curated EEG recordings for validating sleep staging from a three-electrode forehead patch against standard 33-channel polysomnography.

What is included

  • CGX patch .set files that contain EEG.VisualHypnogram and EEG.SpectralScoring. The 33-channel data is not included in this release – this release only includes the three-electrode data. The 33-channel data will be released separately.

View full README

UCSD Forehead Patch Sleep Validation Dataset

Curated EEG recordings for validating sleep staging from a three-electrode forehead patch against standard 33-channel polysomnography.

What is included

  • CGX patch .set files that contain EEG.VisualHypnogram and EEG.SpectralScoring. The 33-channel data is not included in this release – this release only includes the three-electrode data. The 33-channel data will be released separately.

Sleep stage labels

EEG.VisualHypnogram is manual scoring in 30-second epochs using the following integers

1 equals Wake 2 equals REM 3 equals N1 4 equals N2 5 equals N3 0 equals unknown or movement

EEG.SpectralScoring is spectral staging from the forehead patch. One row per patch channel. One column per 30-second epoch (see publication).

Alignment policy

The 33-channel cap data used to score polysomnography and the 3-channel patch EEG data do not always start and stop at the same clock times. CGX patch data were aligned to the cap start time based on a spreadsheet completed by the data collector, so the start may be off by a few seconds. The 3-channel EEG data were segmented into 30-second windows, and the number of these windows should approximately match the number of values in the EEG.VisualHypnogram for the same dataset. If the patch data ended up shorter than the visual hypnogram, the hypnogram was trimmed at the end to match the patch length. If the hypnogram was longer, it was left untrimmed. In general, the mismatch at the end of the recording is less than one 30-second window.

Subject exclusions

113 and 121 are excluded. The CGX patch was inadequate or unavailable.

Citation

Onton JA, Simon KC, Morehouse AB, Shuster AE, Zhang J, Peña AA, Mednick SC. Validation of spectral sleep scoring with polysomnography using forehead EEG device. Frontiers in Sleep. 2024. doi 10.3389/frsle.2024.1349537. American Academy of Sleep Medicine. The AASM manual for the scoring of sleep and associated events. 2007 and later.

Dataset Information#

Dataset ID

DS006695

Title

Validation of Sleep Staging with Forehead EEG Patch

Year

2025

Authors

Julie Onton, Sarah Mednick

License

CC0

Citation / DOI

doi:10.18112/openneuro.ds006695.v1.0.2

Source links

OpenNeuro | NeMAR | Source URL

Copy-paste BibTeX
@dataset{ds006695,
  title = {Validation of Sleep Staging with Forehead EEG Patch},
  author = {Julie Onton and Sarah Mednick},
  doi = {10.18112/openneuro.ds006695.v1.0.2},
  url = {https://doi.org/10.18112/openneuro.ds006695.v1.0.2},
}

Found an issue with this dataset?

If you encounter any problems with this dataset (missing files, incorrect metadata, loading errors, etc.), please let us know!

Report an Issue on GitHub

Technical Details#

Subjects & recordings
  • Subjects: 19

  • Recordings: 81

  • Tasks: 1

Channels & sampling rate
  • Channels: 3

  • Sampling rate (Hz): 500.0

  • Duration (hours): 0.0

Tags
  • Pathology: Not specified

  • Modality: Sleep

  • Type: Sleep

Files & format
  • Size on disk: 9.4 GB

  • File count: 81

  • Format: BIDS

License & citation
  • License: CC0

  • DOI: doi:10.18112/openneuro.ds006695.v1.0.2

Provenance

API Reference#

Use the DS006695 class to access this dataset programmatically.

class eegdash.dataset.DS006695(cache_dir: str, query: dict | None = None, s3_bucket: str | None = None, **kwargs)[source]#

Bases: EEGDashDataset

OpenNeuro dataset ds006695. Modality: eeg; Experiment type: Sleep; Subject type: Unknown. Subjects: 19; recordings: 19; 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

query#

Merged query with the dataset filter applied.

Type:

dict

records#

Metadata records used to build the dataset, if pre-fetched.

Type:

list[dict] | None

Notes

Each item is a recording; recording-level metadata are available via dataset.description. query supports MongoDB-style filters on fields in ALLOWED_QUERY_FIELDS and is combined with the dataset filter. Dataset-specific caveats are not provided in the summary metadata.

References

OpenNeuro dataset: https://openneuro.org/datasets/ds006695 NeMAR dataset: https://nemar.org/dataexplorer/detail?dataset_id=ds006695

Examples

>>> from eegdash.dataset import DS006695
>>> dataset = DS006695(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, overwrite=False)[source]#

Save the dataset to disk.

Parameters:
  • path (str or Path) – Destination file path.

  • overwrite (bool, default False) – If True, overwrite existing file.

Return type:

None

See Also#