Electroencephalography (EEG) Resources

 

Corpora: TUEG | TUAB | TUAR | TUEP | TUEV | TUSZ | TUSL
Software: EGAS | ERDR | EEGR | EVAL | PYPR | MEDF | EDFB | PYED
Documentation: ELEC | ANNO |
Instructions: BROW | RSYN | DISK
What's New: 2024 | 2023 | 2022 | 2021 | 2020 | 2019 | 2018 | 2017 | 2016 | 2015

To request access to the TUH EEG Corpus, please fill out this form and email a signed copy to help@nedcdata.org. Please include "Download The TUH EEG Corpus" in the subject line or click on this link.

Note this is an Adobe Acrobat form, and it is best filled out using Adobe Acrobat or a similarly compatible tool. We suggest you download a copy to your desktop and fill it out using a local app, rather than attempt to complete the form from within a browser.

The form must be filled out correctly or it will be returned to you. Please follow the instructions on the form very carefully, including completing the address information accurately. This is very important and we cannot accept forms with incorrect addresses.

Once your form is accepted, you will receive the username and password to our resources in a separate email, and be added to our listserv. This usually takes about 24 hours. The TUH EEG Corpus is freely available. The only reason we require registration is that we need to track who downloads the data. We also want to be able to inform you of any updates to the releases.

Once you have obtained the username and password, you can selectively download portions of the corpus using your browser. You can also use the rsync interface described below.


Corpora

  • The TUH EEG Corpus (TUEG): A rich archive of 26,846 clinical EEG recordings collected at Temple University Hospital (TUH) from 2002 - 2017. Read this journal paper for a more complete description of the corpus.

  • The TUH Abnormal EEG Corpus (TUAB): A corpus of EEGs that have been annotated as normal or abnormal. Read Silvia Lopez's MS thesis for a description of the corpus.

  • The TUH EEG Artifact Corpus (TUAR): This subset of TUEG that contains annotations of 5 different artifacts: (1) eye movement (EYEM), (2) chewing (CHEW), (3) shivering (SHIV), (4) electrode pop, electrode static, and lead artifacts (ELPP), and (5) muscle artifacts (MUSC).

  • The TUH EEG Epilepsy Corpus (TUEP): This is a subset of TUEG that contains 100 subjects epilepsy and 100 subjects without epilepsy, as determined by a certified neurologist. The data was developed in collaboration with a number of partners including NIH.

  • The TUH EEG Events Corpus (TUEV): This corpus is a subset of TUEG that contains annotations of EEG segments as one of six classes: (1) spike and sharp wave (SPSW), (2) generalized periodic epileptiform discharges (GPED), (3) periodic lateralized epileptiform discharges (PLED), (4) eye movement (EYEM), (5) artifact (ARTF) and (6) background (BCKG).

  • The TUH EEG Seizure Corpus (TUSZ): This corpus has EEG signals that have been manually annotated data for seizure events (start time, stop, channel and seizure type). For more information about this corpus, please refer to our book section. Our annotation guidelines are described here.

  • The TUH EEG Slowing Corpus (TUSL): This is another subset of TUEG that contains annotations of slowing events. This corpus has been used to study common error modalities in automated seizure detection.




Software

  • NEDC EEG Annotation System (EAS): A tool that allows rapid annotation of EEG signals. The tool includes spectrogram and energy plots, and is capable of transcribing data in real time. Learn more about this tool from our IEEE SPMB 2018 paper.

  • NEDC ResNet Decoder Real-Time (ERDR): A real-time EEG seizure detection system based on a ResNet-18 neural network and transfer learning. This package contains a real-time decoder that is described in this publication. This is also part of our real-time demonstration system.

  • https://isip.piconepress.com/projects/nedc/data/eeg/tuh_eeg_software/
  • NEDC ResNet Seizure Detection System (EEGR): A research version of our real-time seizure detection system that includes a trainer and a decoder. This package is used to develop and evaluate models. This package contains a decoder that is described in this publication.

  • NEDC Eval EEG (EVAL): A Python-based scoring package that implements a variety of standard evaluation metrics. A complete description of the software can be found here.

  • NEDC PyPrint EDF (PYPR): A Python-based tool that decodes the header and signal data in an Edf file. This is not as simple as it might seem because channels can be permuted and must be decoded using channel labels.

  • MATLAB EDF (MEDF): MATLAB code that loads EEG signal data from an EDF file.

  • EDF Browser (EDFB): An open-source program that can be used to view files such as EEG, EMG, ECG, etc., available for Windows and Linux.

  • Python-based EDF (PYED): A Python interface to EDFLib that lets you read and write EDF files (the distribution format for TUH EEG).



Documentation

  • Electrodes (ELEC): A document that describes how EEG signals are stored in a multichannel signal file format. This document also includes a description of the channel labels, which are required to properly decode the data.

  • Annotations: (ANNO): A document that describes how we annotate seizures and store the annotations in various file formats.



Instructions

All of our released corpora are now available these ways:

  1. From the web at:

          https://www.isip.piconepress.com/projects/tuh_eeg/downloads/

    You can directly browse the directories and explore the data. This is convenient if you want to sample the data and explore formats, content, etc.

    The username and password are the same as what you use to access the web-based version of these resources. If you do not have the username and password, register by filling out this form and we will contact you with registration information by email.

  2. Rsync, which is available on Linux and Mac platforms, is our preferred way of downloading data. It allows you to easily keep your copy of the data in sync with ours.

    Windows users can get access to rsync by installing MobaXterm. Some tips on how to install and use MobaXterm are here.

    Before you attempt to download an entire corpus, you should test your ability to download data by executing this command:

          rsync -auxvL --delete nedc-eeg@www.isip.piconepress.com:data/eeg/TEST .

    If for some reason this fails, change "-auxvL" to "-auxvvvL". This will generate a log file that your IT support team can use to diagnose the problems with your downloads.

    Once this command works correctly, then you should go here to select the corpus you want to download. A typical rsync command to download a specific release (e.g., vx.x.x) of a specific corpus (AAAA) is:

          rsync -auxvL --delete nedc-eeg@www.isip.piconepress.com:data/eeg/AAAA/vx.x.x/ .

    You can also download all versions of a corpus that are available on the server by dropping the version number:

          rsync -auxvL --delete nedc-eeg@www.isip.piconepress.com:data/eeg/AAAA/ .

    Note that the "." at the end of this command is very important since it denotes the destination directory. Without a destination directory specification, the command will not transfer any data.

    The username and password are the same as what you use to access the web-based version of these resources.

    Note that the "-L" option in rsync instructs it to follow links. All of our corpora are linked back to TUEG. It is best to always use the "-L" option.

  3. If Internet connectivity is a problem, you can send us a 8T USB drive. We will copy the data to this disk and send it to you. You must arrange for postage as described below. If you elect this option, you need to send us a 8T USB drive and provide a UPS or FedEx account number for return shipping.

    Please send us a conventional USB-mounted disk drive. We have had problems with other types of media such as thumb drives. Any standard USB-powered USB 2.0 compatible 8T drive, such as a Western Digital or Seagate, will work fine. Because of the time it takes to copy the data, we need a drive that can maintain a stable connection, and thumb drives have proven to be unreliable.

    Mail the drive to:

          Joseph Picone
          1610 Rhawn Street
          Philadelphia, PA 19111
          Tel: 708-848-2846

    Please email us for details before shipping the drive. If you ship us a drive directly from a reseller such as Amazon, please make sure that the shipment contains information that we can use to identify you. This information should include a point of contact (POC), the name of your institution, and contact information (name, surface mail address and telephone number for the POC).

    Please note that disk drives sent to international destinations will often get caught in Customs for weeks. Rsync is a much better option than going through your local governments.

If you are having trouble deciding what to do, email us and describe what specific resources in which you are interested. We will be happy to guide you through the process.




What's New

  • 2024:

    • (20240113) TUSZ (v2.0.2): We have removed two duplicate sessions and fixed one bug in the annotations. Performance on seizure detection should not change significantly.

  • 2023:

    • (20231004) TUSZ (v2.0.1): We have fixed a few small bugs with the annotations. A total of 35 files were corrected.

    • (20230916) NEDC EAS (v5.1.2): This version of our EEG annotation tool includes a more robust Windows installation process and several bug fixes for montage processing.

  • 2022:

    • (20221207) TUH EEG Resources: We have released updated versions of all our EEG corpora. Older versions of the corpora have been obsoleted.

    • (20220512) TUSZ (v1.5.3): This version uses our new csv file format for annotations. The data is the same as v1.5.2, which was used for the Neureka competition.

    • (20220501) NEDC EAS (v5.1.0): This version of our EEG annotation tool includes enhanced support for xml and csv files. It integrates the same new libraries that support manipulation of annotations.

    • (20220423) NEDC Eval EEG (v5.0.0): This version includes support for our relatively new csv and xml annotation file formats. It integrates the same new libraries used by our annotation tool - (nedc_eas).

    • (20220331) TUH EEG Seizure (v1.5.2): This is an update to our previous v1.5.2 release. This release includes the eval data and resampled versions of the edf files (sampled at 250 Hz).

    • (20220212) TUH EEG Artifact (v2.0.0): This version contains manually reviewed annotations based on substantial feedback from customers. See this publication for more details.

  • 2021:

    • (20210617) NEDC Annotator (v5.0.2): This version now adds support for csv and xml file formats for annotations.

    • (20210214) NEDC Annotator (v4.0.3): This version fully supports Python 3.7.x and integrates numerous bug fixes.

    • (20210107) TUH EEG Artifacts (v2.0.0): A new, significantly expanded, version of the artifact corpus in which the entire signal is annotated.

  • 2020:

    • (20201220) NEDC PyPrint Edf (v1.0.0): A simplified version or our software to read header and signal data from an EDF file.

    • (20200925) NEDC Annotator (v4.0.0): This version fully supports Python 3 and integrates numerous bug fixes. We expect to include XML and csv file format support in the next release of this tool.

    • (20200821) NEDC Eval EEG (v4.0.0): This version integrates the competition version of the scoring software with our regular distribution. The NIST software, which is used to implement the ATWV metric, is now optional.

    • (20200725) NEDC TUH EEG Artifact Corpus (v2.0.0): This release includes annotated artifact events in 310 EEG files. They have not yet been reviewed by our senior annotators, but we have released it in hopes of receiving feedback on the data.

    • (20200528) NEDC Eval EEG (v3.3.3): A new version of our software that checks for duplicate hypotheses and checks for overlap between hypotheses.

    • (20200527) NEDC TUH EEG Seizure (v1.5.2): We have released v1.5.2 of the TU Seizure Detection (TUSZ) Corpus. This version include new annotations for the entire training database.

    • (20200408) Annotation Standards: Our paper describing our for the Temple University Hospital EEG Seizure Corpus has been published and is now available.

    • (20200403) NEDC Eval EEG (v3.3.2): In this version of our scoring software, the hypothesis confidence and additional fields are optional.

    • (20200331) NEDC Python Streaming Software (v1.0.1): A new version that is compatible with Python v3. It is functionally the same as v1.0.0.

    • (20200328) NEDC Eval EEG (v3.3.1): A new version of our software that uses a simplified file format. This version was developed to support the Neureka™ 2020 Epilepsy Challenge. The software reads a list of seizure events to compare and score them off the reference annotations of our recent database release: TUH EEG Seizure Corpus (v1.5.1).

    • (20200320) NEDC TUH EEG Seizure (v1.5.1): We have released v1.5.1 of the TU Seizure Detection (TUSZ) Corpus. We have manually reviewed the annotations for the dev and eval sets in preparation for the Neureka™ 2020 Epilepsy Challenge.

  • 2019:

    • (20190323) NEDC TUH EEG Seizure (v1.5.0): This release includes the expansion of the training dataset from 1,984 files to 4,597. Calibration sequences of the new data have been manually annotated and added to the seizure spreadsheet. Annotation corrections were made to the files already existing in the training set.

    • (20190308) IBM TUSZ Pre-Processed Data (v1.0.0): This is our first release of IBMPPD which preprocesses the TUH Seizure Detection Corpus using two methods, both of which use an FFT sliding window approach (STFT) in the beginning.

  • 2018:

    • (20181206) NEDC TUH EEG Artifact Corpus (v1.0.0): This is our first release of the TUH EEG Artifact Corpus. This corpus was developed to aid in EEG event classification such as seizure detection algorithms. This corpus is a subset of the TUH EEG Corpus and contains files with 5 different types of artifacts: (1) eye movements (EYEM), (2) chewing (CHEW), (3) shivering (SHIV), (4) electrode pop, electrode static, and lead artifacts (ELPP), and (5) muscle artifacts (MUSC).

    • (20181102) NEDC Eval EEG (v1.3.0): In this release, the FPR definition of the TAES metric has been updated to the standard definition which is #FP / (#FP + #TN) or in other words (1 - TNR).

    • (20181022) NEDC TUH EEG Seizure (v1.4.0): This release includes improvements to the quality of annotations. Annotation corrections were made in the development test and training sets

    • (20180817) NEDC TUH EEG Seizure (v1.3.0): This release contains quality improvements of the annotations, as manually labeled calibration sequences. The main reason for this release is that we have created a blind evaluation set, often referred to as a held-out set. This is not being released, but will be used in an upcoming Kaggle-style challenge hosted by IBM. More details about this challenge will follow within the next few months.

    • (20180710) NEDC EEG AutoAnnotations (v1.1.0): This release includes the addition of automatically generated annotations using a six-way classification approach. In six-way classification, the first three events are of clinical interest: (1) spike and/or sharp waves (SPSW), (2) periodic lateralized epileptiform discharges (PLED), and (3) generalized periodic epileptiform discharges (GPED). The remaining three events are used to model background noise: (1) eye movement (EYEM), (2) artifacts (ARTF), and (3) background (BCKG).

    • (20180621) TUH EEG Events Corpus (v1.0.1): The EDF files in the previous release with corrupted headers have been fixed. All files should pass processing using standard open source tools.

    • (20180609) TUH EEG Corpus (v1.1.0): These annotations are only for EEG files that are under an hour in duration and contain 22 channels.

    • (20180501) NEDC Eval EEG (v1.2.0): This scoring software uses five different scoring methods: NIST, DP Align, Epoch Based, Any-Overlap, and TAES.

    • (20180417) TUH EEG Corpus (v1.1.0): This is the official version of the TUH EEG Corpus. This release organizes each session by the montage definition it fits. Filename conventions have been adjusted and files not containing any usable brain signal have been removed.

    • (20180416) TUH EEG Seizure Corpus (v1.2.1): This release includes small annotation fixes and an addition to the _SEIZURES spreadsheet of calibration start and end times, as well as other small cleanups.

    • (20180412) TUH Abnormal EEG Corpus (v2.0.0): This is a subset of the TUH EEG corpus that can be used for automatic detection of abnormal EEGs. This release contains patient numbers that have been re-mapped to be consistent with v1.1.0 of TUH EEG. Some cleanups including the removal of duplicate file s have been made.

    • (20180412) TUH EEG Slowing Corpus (v1.0.1): This is a small data set that can be used to study the difference between slowing and seizures in EEGs. This release contains patient numbers that have been re-mapped to be consistent with v1.1.0 of TUH EEG.

    • (20180327) TUH EEG Six-Way Event Classification Corpus (v1.0.0): This release contains the data used to develop our initial version of AutoEEG. Sections of EEG signals are annotated for one of 6 events: spike, gped, pled, eye movement, artifact and background.

  • 2017:

    • (20171207) TUH EEG Seizure Corpus (v1.2.0): This release contains patient numbers that match v1.0.0 of TUH EEG. Numerous other cleanups have been made to the data.

    • (20170923) TUH EEG Corpus (v1.0.0): This is the official version of the TUH EEG Corpus. This release contains sessions recorded between 2002 and 2015. There are 13,500 patients and 23,218 sessions with paired EEG reports.

    • (20170920) TUH EEG Slowing Corpus (v1.0.0): A small data set that can be used to study the difference between seizures and slowing in EEGs.

    • (20170913) TUH Abnormal EEG Corpus (v1.1.2): This release fixes a small bug in that the age information was not correct for 38 files. That has been corrected based on age information in the EEG reports.

    • (20170816) TUH Abnormal EEG Corpus (v1.1.1): This release fixes a small bug. One of the files was Left Ear (LE) references. All files are now Average Reference (AR) format for the EEG signals.

    • (20170805) TUH EEG Seizure Corpus (v1.1.1): In this release, each seizure event is classified by type. The signal data and start/stop times of the events hasn't changed. But now we provide event-based and term-based annotations as well as the type of seizure.

    • (20170701) TUH EEG Seizure Corpus (v1.1.0): This release contains the expanded training set, sub-one second resolution on the seizure boundaries, and an expanded classification of each EEG session in terms of types and subtypes. Corrupted EDF headers have also been corrected.

    • (20170617) TUH EEG Seizure Corpus (v1.0.4): A new release that contains bug fixes and much more information about the data. Each EEG session is classified by type and duration (e.g., routine or LTM).

    • (20170314) TUH Abnormal EEG Corpus (v1.0.1): This is a subset of the TUH EEG Corpus that can be used for automatic detection of abnormal EEGs. This is a bug fix release. The corpus now contains only one file per session. Also, we provide a suggested partitioning of the data into evaluation and training data.

    • (20170426) TUH EEG Seizure Corpus (v1.0.3): This is the first official release of a subset of the TUH EEG Corpus that has been manually annotated for seizure events.

    • (20170314) TUH Abnormal EEG Corpus (v1.0.0): This is a subset of the TUH EEG Corpus that can be used for automatic detection of abnormal EEGs.

  • 2016:

  • 2015:

    • (20150101) TUH EEG Corpus (v0.6.0): A beta release used to collect feedback from the community.

    • (20150401) TUH EEG Corpus (v0.2.0): This is our first public release of the TUH EEG Corpus. This is a beta release intended to allow users to give us feedback on the data. There are 247 sessions, 615 EDF files, and over 150 hours of EEG data. The uncompressed data occupies about 8.3G of disk space.