The data required to run these notebooks are not yet available. We will update this page as soon as they are.

This repository contains scripts showcasing how to download iEEG data from the data base, perform preprocessing and preliminary analyses. It accompanies the scientific data we have recently submitted. In addition, we have packaged various utilities that were created during the cogitate as a python package named cog_ieeg.

Setup guide:

First, you should install all the dependencies and setup the cog_ieeg package, which is all done with a single line (make sure to create a separate environment where would like to have it installed first):

pip install git+https://github.com/Cogitate-consortium/iEEG-data-release.git@main#egg=cog_ieeg

This will take a bit of time, but then everything will be ready to go.

By default, the data will be downloaded in your home directory, under COGITATE/bids. If you wish to change this default parameter, you can adjust it with python:

from cog_ieeg.utils import set_bids_root
set_bids_root("YOUR/LOCAL/PATH")

This step is optional, everything else is ready to go. You also don't need to download any data manually, has we have automated download implemented. You should only register to our database here to get your credentials. You will simply need to specify the name of the subject you would like to download, input your credentials and the data will get downloaded on your machine.

How to use this repository:

This repository contains jupyter notebooks, analysis pipelines and many different functions. Depending on your interest, here are the different places to go to first:

• If you are interested in iEEG data analysis and you would like to see what are the different steps involved OR if you are interested in the COGITATE data and would like to get a sense of how to work with them, go check this notebook
• If you have decided you would like to do something with the cogitate data, you should go check this notebook. It can be run on each subject to get an idea of channels localization, responses observed... You can also used this script to specify a set of subjects to generate reports for each of them as HTML
• If you are a curious about the implementation of different functions we are using, you can go have a look at this file. It contains the cog_ieeg python package, in which the various custom functions we have created are organized.
• If you have your own data and would like to use pipelines that are similar to ours, go check the various scripts here. The preprocessing pipelines relies heavily on the bids format, which means if your data also are in bids, you should be able to use our pipelines without much tweaking.

My personal recommendation is to always start with this notebook as it gives a really good overview of how things work in general.

How to cite us:

If you use the scripts found in this repository, you can use the DOI provided by Zenodo to cite us. And here is a bibtex:

@article{LepauvreEtAl2024,
  title = {COGITATE-iEEG-DATA-RELEASE},
  author = {Lepauvre, Alex and Henin, Simon and Bendtz, Katarina and Sripad, Praveen and Bonacchi, Niccolò and Kreiman, Gabriel and Melloni, Lucia},
  year = {2024},
  doi = {TO_BE_UPDATED},
}

If you use any the data for other purpose, you should cite the scientific data paper directly:

@article{SeedatEtAl2024,
  author = {Alia Seedat and Alex Lepauvre and Jay Jeschke and Urszula Gorska-Klimowska and Marcelo Armendariz and Katarina Bendtz and Simon Henin and Rony Hirschhorn and Tanya Brown and Erika Jensen and David Mazumder and Stephanie Montenegro and Leyao Yu and Niccol\`{o} Bonacchi and Praveen Sripad and Fatemeh Taheriyan and Orrin Devinsky and Patricia Dugan and Werner Doyle and Adeen Flinker and Daniel Friedman and Wendell Lake and Michael Pitts and Liad Mudrik and Melanie Boly and Sasha Devore and Gabriel Kreiman and Lucia Melloni},
  title = {Open multi-center iEEG dataset with task probing conscious visual perception},
  journal = {TO_BE_UPDATED},
  year = {TO_BE_UPDATED},
  volume = {TO_BE_UPDATED},
  number = {TO_BE_UPDATED},
  pages = {TO_BE_UPDATED},
  doi = {TO_BE_UPDATED},
}

Contributors

Alex Lepauvre 💻

Praveen Sripad 💻

Simon Henin 💻

Katarina Bendtz 💻

Qian Chu 💬

Contributing to iEEG-data-release

Thank you for considering contributing to our project! Here are a few guidelines to help you get started:

Pull Requests

1. File an issue: Before making any changes, please open an issue to discuss the proposed changes. This helps us keep track of what needs to be done and ensures that your efforts align with the project's goals.
2. Fork the repository and create your branch from main.
3. Commit your changes and push your branch to your fork.
4. Submit a pull request and request a review.

Branch Protection

Our main branch is protected. All changes must be made via pull requests and require approval before being merged. This helps us maintain the quality and stability of the codebase.

Code Reviews

All pull requests will be reviewed by a maintainer. Please be patient if we take a bit longer than expected.

Questions?

If you have any questions, feel free to open an issue or contact the maintainers (alex.lepauvre@).

Additional notes

The folder WU_coregistration contains scripts that were used on subjects from Wisconsin university to co-register the trigger signal with the recorded iEEG signals (as both were recorded on different systems). This procedure was applied locally on the site before sharing the raw data, and is available here only for reference purposes. It should not be applied on the data at any points.

Acknowledgments

This notebook is brought to you by the intracranial team of the COGITATE consortium.

We would like to thank all the COGITATE consortium members:

This research was supported by Templeton World Charity Foundation (TWCF0389) and the Max Planck Society. The opinions expressed in this publication are those of the authors and do not necessarily reflect the views of TWCF.