NM000410: ieeg dataset, 79 subjects#
Vanderbilt BIEN Lab SOZ Resting State SEEG Classification (processed resting-state SEEG)
Access recordings and metadata through EEGDash.
Citation: Kate Wang, Sameer Sundrani, Dario Englot (2025). Vanderbilt BIEN Lab SOZ Resting State SEEG Classification (processed resting-state SEEG). 10.82901/nemar.nm000410
Modality: ieeg Subjects: 79 Recordings: 79 License: CC-BY-NC-SA-4.0 Source: nemar
Metadata: Complete (100%)
79-participant iEEG dataset — Vanderbilt BIEN Lab SOZ Resting State SEEG Classification (processed resting-state SEEG).
Quickstart#
Install
pip install eegdash
Access the data
from eegdash.dataset import NM000410
dataset = NM000410(cache_dir="./data")
# Get the raw object of the first recording
raw = dataset.datasets[0].raw
print(raw.info)
Filter by subject
dataset = NM000410(cache_dir="./data", subject="01")
Advanced query
dataset = NM000410(
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{nm000410,
title = {Vanderbilt BIEN Lab SOZ Resting State SEEG Classification (processed resting-state SEEG)},
author = {Kate Wang and Sameer Sundrani and Dario Englot},
doi = {10.82901/nemar.nm000410},
url = {https://doi.org/10.82901/nemar.nm000410},
}
About This Dataset#
NEMAR redistribution of Pennsieve Discover dataset 492, version 1 (doi:10.26275/wtaz-dbst; “Vanderbilt BIEN Lab SOZ Resting
State SEEG Classification”; licence on the record: “Creative Commons Attribution - NonCommercial-ShareAlike”, written here as CC-BY-NC-SA-4.0). It accompanies Sundrani et al. (2025), “Deep learning on brief interictal intracranial recordings can accurately characterize seizure onset zones”, Epilepsia 66(9):3180-3192, doi:10.1111/epi.18478. This is a processed-data (derivative) dataset: the signals are the authors’ filtered bipolar SEEG; raw recordings are not part of the release.
Release description (verbatim): This repository contains a de-identified codebase for training and analyzing deep neural networks that classify seizure onset zones (SOZ) vs. non-SOZ brain regions using resting-state stereoelectroencephalography (SEEG) recordings.
The citation for the associated manuscript is listed below:
Vanderbilt resting-state SEEG for seizure-onset-zone classification (derivative dataset)
Overview
Sundrani, S., Johnson, G. W., Doss, D. J., Makhoul, G. S., Hidalgo Monroy Lerma, B., Reda, A., Cavender, A. C., Liao, E., Rogers, B. P., Williams Roberson, S., Bick, S. K., Morgan, V. L., & Englot, D. J. (2025). Deep learning on brief interictal intracranial recordings can accurately characterize seizure onset zones. Epilepsia, 66(9), 3180–3192. Portico. https://doi.org/10.1111/epi.18478
Contents
View full README
Vanderbilt resting-state SEEG for seizure-onset-zone classification (derivative dataset)
Overview
Sundrani, S., Johnson, G. W., Doss, D. J., Makhoul, G. S., Hidalgo Monroy Lerma, B., Reda, A., Cavender, A. C., Liao, E., Rogers, B. P., Williams Roberson, S., Bick, S. K., Morgan, V. L., & Englot, D. J. (2025). Deep learning on brief interictal intracranial recordings can accurately characterize seizure onset zones. Epilepsia, 66(9), 3180–3192. Portico. https://doi.org/10.1111/epi.18478
Contents
79 participants, one 5-minute recording each (
sub-<code>/ieeg/sub-<code>_task-rest_ieeg.vhdr), BrainVision, float32, microvolts, 500-2048 Hz as released. Participant codes are the release codes (Epat##,Spat##,pat##; the release does not explain the prefixes). The paper reports 78 patients; the release has 79 files. Codes not in any cross-validation test fold of the authors’ results: [‘Epat09’]._channels.tsv: bipolar channel, region (releasebip_montage_region), andsoz_region_label: the region-level SOZ ground truth used by the authors (‘true_label’ in the results JSON). See channels.json._electrodes.tsv+_coordsystem.json: one row per bipolar channel with its region; the release gives no coordinates (x/y/z n/a).participants.tsv: release code and the authors’ test fold.Unreadable samples in the release: Epat09: rows 46875-46999 (93.750-94.000 s), channels 0-64 (one corrupt gzip chunk in the HDF5 file; the file matches the Pennsieve SHA-256, so the release itself carries it; the samples are NaN here and marked in that recording’s _events.tsv)
sourcedata/pennsieve-492-v1/: the complete release byte-identical (MAT files, code, model weights, results JSON, location_accuracy.csv, README.md, Pennsieve readme/manifest/changelog/banner), except macOS.DS_Storefiles and a compiled.pyc(1 files skipped: [‘files/models/__pycache__/multi_scale_ori.cpython-39.pyc’]); the Pennsieve listing with checksums;roundtrip_float32.tsv(max relative float32 error over all files: 5.77e-08).
Recording and processing (from the paper)
Five minutes of resting-state (interictal, non-SPES) SEEG from patients with drug-resistant epilepsy evaluated at Vanderbilt University Medical Center; patients awake, eyes closed, told to try not to fall asleep; recordings at least 4 h apart from electroclinical activity. Filtering: MATLAB filtfilt Butterworth passbands 1-59, 61-119 and 121-150 Hz.
Contacts were assigned to Desikan-Killiany regions; SOZs were defined on a region basis as regions containing any contact involved in the ictal onset of one or more seizures. Cohort (paper Table 1, n = 78): 45 female, 33 male; per-patient age and sex are not in the release.
Changes made for NEMAR
filt_data (float64, volts) written as float32 microvolts (BrainVision); channel names without spaces; unreadable source samples written as NaN (see Contents). Nothing else changed.
Privacy
The release contains only signals, channel/region labels, model outputs and code. No names, dates or hospital numbers were found in the MAT strings, JSON or text files. The code README lists the corresponding author’s institutional e-mail.
Ethics approval
Sundrani et al. 2025, Methods (Participants and Resting State SEEG): “This study was approved by the Vanderbilt Institutional Review Board, and informed subject consent was obtained.”
Funding
Sundrani et al. 2025, Acknowledgements (verbatim in dataset_description.json).
Licence
CC-BY-NC-SA-4.0 (Pennsieve licence field: “Creative Commons Attribution - NonCommercial-ShareAlike”). Non-commercial use only.
Additional metadata and localisation (added 2026-10-08)
Compiled after the upload from the article, its supplement and the source deposit (each statement names its source). Text and sidecar metadata only; no data file was changed.
Recording system. Amplifier not stated (n/a). sampling_freq in the .mat files: 512 Hz (40), 500 Hz (20), 1024 Hz (14), 2048 Hz (5); filt_data holds 150000-153600 samples per channel (deposit, Voyager Job). The deposit README states inputs at 500-512 Hz (data are resampled to 500 Hz by the code, resample_to_500hz). Filtering: MATLAB filtfilt Butterworth passbands 1-59, 61-119 and 121-150 Hz (paper Methods “Data Preprocessing”) - the stored filt_data are the filtered signals (variable name; deposit code).
Reference scheme. Bipolar montage of adjacent contacts (bip_montage_label e.g. “LAC1 - LAC2”; deposit .mat). Original recording reference not stated.
Electrode types. SEEG depth electrodes; manufacturer not stated.
Localisation method. Contacts localised on post-implantation CT with CRAnial Vault Explorer (CRAVE) and each contact assigned to a Desikan-Killiany (DK) region; verified by a staff engineer, attending neurosurgeon and attending epileptologist. SOZ defined per DK region containing any contact involved in ictal onset of >=1 seizure (paper Methods). Coordinates are not in the deposit; only DK labels per bipolar channel.
Cohort (paper Table 1). n=78; female 45 (57.7%); age mean 34.6 (SD 12.4); outcome at one year: Engel I 23, II 5, III 7, IV 3, neuromodulation responder 15, non-responder 10, none 15.
Each electrodes.tsv now has a soz_region_label column (yes/no/n/a): whether the channel’s DK region is one of the patient’s SOZ regions in the deposit results JSON.
NEMAR Metadata#
[](https://doi.org/10.82901/nemar.nm000410) # Vanderbilt resting-state SEEG for seizure-onset-zone classification (derivative dataset) ## Overview NEMAR redistribution of Pennsieve Discover dataset 492, version 1 (doi:10.26275/wtaz-dbst; “Vanderbilt BIEN Lab SOZ Resting State SEEG Classification”; licence on the record: “Creative Commons Attribution - NonCommercial-ShareAlike”, written here as CC-BY-NC-SA-4.0). It accompanies Sundrani et al. (2025), “Deep learning on brief interictal intracranial recordings can accurately characterize seizure onset zones”, Epilepsia 66(9):3180-3192, doi:10.1111/epi.18478. This is a processed-data (derivative) dataset: the signals are the authors’ filtered bipolar SEEG; raw recordings are not part of the release. Release description (verbatim): This repository contains a de-identified codebase for training and analyzing deep neural networks that classify seizure onset zones (SOZ) vs. non-SOZ brain regions using resting-state stereoelectroencephalography (SEEG) recordings. The citation for the associated manuscript is listed below: Sundrani, S., Johnson, G. W., Doss, D. J., Makhoul, G. S., Hidalgo Monroy Lerma, B., Reda, A., Cavender, A. C., Liao, E., Rogers, B. P., Williams Roberson, S., Bick, S. K., Morgan, V. L., & Englot, D. J. (2025). Deep learning on brief interictal intracranial recordings can accurately characterize seizure onset zones. Epilepsia, 66(9), 3180–3192. Portico. https://doi.org/10.1111/epi.18478 ## Contents - 79 participants, one 5-minute recording each (sub-<code>/ieeg/sub-<code>_task-rest_ieeg.vhdr), BrainVision,
float32, microvolts, 500-2048 Hz as released. Participant codes are the release codes (Epat##, Spat##, pat##; the release does not explain the prefixes). The paper reports 78 patients; the release has 79 files. Codes not in any cross-validation test fold of the authors’ results: [‘Epat09’].
_channels.tsv: bipolar channel, region (release bip_montage_region), and soz_region_label: the region-level SOZ ground truth used by the authors (‘true_label’ in the results JSON). See channels.json.
_electrodes.tsv + _coordsystem.json: one row per bipolar channel with its region; the release gives no coordinates (x/y/z n/a).
participants.tsv: release code and the authors’ test fold.
Unreadable samples in the release: Epat09: rows 46875-46999 (93.750-94.000 s), channels 0-64 (one corrupt gzip chunk in the HDF5 file; the file matches the Pennsieve SHA-256, so the release itself carries it; the samples are NaN here and marked in that recording’s _events.tsv)
sourcedata/pennsieve-492-v1/: the complete release byte-identical (MAT files, code, model weights, results JSON, location_accuracy.csv, README.md, Pennsieve readme/manifest/changelog/banner), except macOS .DS_Store files and a compiled .pyc (1 files skipped: [‘files/models/__pycache__/multi_scale_ori.cpython-39.pyc’]); the Pennsieve listing with checksums; roundtrip_float32.tsv (max relative float32 error over all files: 5.77e-08).
## Recording and processing (from the paper) Five minutes of resting-state (interictal, non-SPES) SEEG from patients with drug-resistant epilepsy evaluated at Vanderbilt University Medical Center; patients awake, eyes closed, told to try not to fall asleep; recordings at least 4 h apart from electroclinical activity. Filtering: MATLAB filtfilt Butterworth passbands 1-59, 61-119 and 121-150 Hz. Contacts were assigned to Desikan-Killiany regions; SOZs were defined on a region basis as regions containing any contact involved in the ictal onset of one or more seizures. Cohort (paper Table 1, n = 78): 45 female, 33 male; per-patient age and sex are not in the release. ## Changes made for NEMAR filt_data (float64, volts) written as float32 microvolts (BrainVision); channel names without spaces; unreadable source samples written as NaN (see Contents). Nothing else changed. ## Privacy The release contains only signals, channel/region labels, model outputs and code. No names, dates or hospital numbers were found in the MAT strings, JSON or text files. The code README lists the corresponding author’s institutional e-mail. ## Ethics approval Sundrani et al. 2025, Methods (Participants and Resting State SEEG): “This study was approved by the Vanderbilt Institutional Review Board, and informed subject consent was obtained.” ## Funding Sundrani et al. 2025, Acknowledgements (verbatim in dataset_description.json). ## Licence CC-BY-NC-SA-4.0 (Pennsieve licence field: “Creative Commons Attribution - NonCommercial-ShareAlike”). Non-commercial use only. ## Additional metadata and localisation (added 2026-10-08) Compiled after the upload from the article, its supplement and the source deposit (each statement names its source). Text and sidecar metadata only; no data file was changed. Recording system. Amplifier not stated (n/a). sampling_freq in the .mat files: 512 Hz (40), 500 Hz (20), 1024 Hz (14), 2048 Hz (5); filt_data holds 150000-153600 samples per channel (deposit, Voyager Job). The deposit README states inputs at 500-512 Hz (data are resampled to 500 Hz by the code, resample_to_500hz). Filtering: MATLAB filtfilt Butterworth passbands 1-59, 61-119 and 121-150 Hz (paper Methods “Data Preprocessing”) - the stored filt_data are the filtered signals (variable name; deposit code). Reference scheme. Bipolar montage of adjacent contacts (bip_montage_label e.g. “LAC1 - LAC2”; deposit .mat). Original recording reference not stated. Electrode types. SEEG depth electrodes; manufacturer not stated. Localisation method. Contacts localised on post-implantation CT with CRAnial Vault Explorer (CRAVE) and each contact assigned to a Desikan-Killiany (DK) region; verified by a staff engineer, attending neurosurgeon and attending epileptologist. SOZ defined per DK region containing any contact involved in ictal onset of >=1 seizure (paper Methods). Coordinates are not in the deposit; only DK labels per bipolar channel. Cohort (paper Table 1). n=78; female 45 (57.7%); age mean 34.6 (SD 12.4); outcome at one year: Engel I 23, II 5, III 7, IV 3, neuromodulation responder 15, non-responder 10, none 15. Each electrodes.tsv now has a soz_region_label column (yes/no/n/a): whether the channel’s DK region is one of the patient’s SOZ regions in the deposit results JSON.
License: CC-BY-NC-SA-4.0
Authors:
Kate Wang
Sameer Sundrani
Dario Englot
Versions:
Version |
DOI |
Released |
|---|---|---|
|
Cohort#
Dataset Statistics#
Channel counts (ch)
Sampling frequencies (Hz)
Total recording duration: 6 h 35 min
Signal · Electrodes & live trace#
Live trace viewer — sub-Epat02 · task-rest
Showing one representative recording out of
79 subjects and 79 recordings in this dataset.
Browse the full set on OpenNeuro;
drop any other _ieeg.{set,edf,bdf,vhdr} file onto the
viewer (or pass ?ieeg=<url>) to inspect it.
No scalp electrode layout is currently indexed for this dataset. Once the eegdash montage registry ingests it, the interactive viewer will appear here automatically.
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 |
Vanderbilt BIEN Lab SOZ Resting State SEEG Classification (processed resting-state SEEG) |
Author (year) |
— |
Canonical |
— |
Importable as |
|
Year |
2025 |
Authors |
Kate Wang, Sameer Sundrani, Dario Englot |
License |
CC-BY-NC-SA-4.0 |
Citation / DOI |
|
Source links |
OpenNeuro | NeMAR | Source URL |
Copy-paste BibTeX
@dataset{nm000410,
title = {Vanderbilt BIEN Lab SOZ Resting State SEEG Classification (processed resting-state SEEG)},
author = {Kate Wang and Sameer Sundrani and Dario Englot},
doi = {10.82901/nemar.nm000410},
url = {https://doi.org/10.82901/nemar.nm000410},
}
API Reference#
eegdash.datasetEEGDashDataset- class eegdash.dataset.NM000410(cache_dir: str, query: dict | None = None, s3_bucket: str | None = None, **kwargs)[source]#
Vanderbilt BIEN Lab SOZ Resting State SEEG Classification (processed resting-state SEEG)
- Study:
nm000410(NeMAR)- Author (year):
—
- Canonical:
—
Also importable as:
NM000410.Modality:
ieeg; Subject type:Unknown. Subjects: 79; recordings: 79; 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/nm000410 NeMAR dataset: https://nemar.org/dataexplorer/detail?dataset_id=nm000410 DOI: https://doi.org/10.82901/nemar.nm000410
Examples
>>> from eegdash.dataset import NM000410 >>> dataset = NM000410(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 nm000410 to reproduce the tutorial on this dataset.
Citation
Kate Wang, Sameer Sundrani, Dario Englot (2025). Vanderbilt BIEN Lab SOZ Resting State SEEG Classification (processed resting-state SEEG). 10.82901/nemar.nm000410
Provenance
¹Contributed to nemar in BIDS format.
²Curated & ingested by the EEGDash catalog; see CITATION.cff for canonical reference.
³Persistent identifier: 10.82901/nemar.nm000410.
See Also#
eegdash.dataset.EEGDashDataseteegdash.dataset