Skip to main content

A benchmark for evaluating intracranial brain responses to naturalistic stimuli

Project description

Neuroprobe

Neuroprobe Logo

Python PyTorch License

Neuroprobe: Evaluating Intracranial Brain Responses to Naturalistic Stimuli

🌐 Website | 📄 Paper | 🚀 Example Usage | 📤 Submit


By Andrii Zahorodnii¹²*, Christopher Wang¹*, Bennett Stankovits¹*, Charikleia Moraitaki¹, Geeling Chau³, Andrei Barbu¹, Boris Katz¹, Ila R Fiete¹²,

¹MIT CSAIL, CBMM | ²MIT McGovern Institute | ³Caltech | *Equal contribution

Overview

Neuroprobe is a benchmark for evaluating EEG/iEEG/sEEG/ECoG foundation models and understanding how the brain processes information across multiple tasks. It analyzes intracranial recordings during naturalistic stimuli using techniques from modern natural language processing. By probing neural responses across many tasks simultaneously, Neuroprobe aims to reveal the functional organization of the brain and relationships between different cognitive processes. The benchmark includes tools for decoding neural signals using both simple linear models and advanced neural networks, enabling researchers to better understand how the brain processes information across vision, language, and audio domains.

Please see the full technical paper for more details.

Getting Started

Prerequisites

  1. Install the package:
pip install neuroprobe
  1. If you haven't yet, download the BrainTreebank dataset from the official release webpage, or using the following script:
python braintreebank_download_extract.py --lite

(lite is an optional flag; if only using Neuroprobe as a benchmark, this flag will reduce the number of downloaded files by >50% by removing unnecessary files.)

  1. Start experimenting with quickstart.ipynb to create datasets and evaluate models.

Evaluation

Run the linear regression model evaluation:

python single_electrode.py --subject SUBJECT_ID --trial TRIAL_ID --verbose --lite --eval_name onset --split_type CrossSession

Results will be saved in the eval_results directory according to leaderboard_schema.json.

Citation

If you use Neuroprobe in your work, please cite our paper:

[Citation TBD]

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

neuroprobe-0.1.0.tar.gz (26.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

neuroprobe-0.1.0-py3-none-any.whl (26.9 MB view details)

Uploaded Python 3

File details

Details for the file neuroprobe-0.1.0.tar.gz.

File metadata

  • Download URL: neuroprobe-0.1.0.tar.gz
  • Upload date:
  • Size: 26.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.8

File hashes

Hashes for neuroprobe-0.1.0.tar.gz
Algorithm Hash digest
SHA256 7f966aea5b159b6cb5e196cdb5e75577c584fc9c203075797a53bd40ee49fe4a
MD5 3d8b9b880ab4a38cfbc9db87df19e52d
BLAKE2b-256 5484bdf449c5b60a2c458b698d287caad203b134022491c1fcb44650a90a6160

See more details on using hashes here.

File details

Details for the file neuroprobe-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: neuroprobe-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 26.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.8

File hashes

Hashes for neuroprobe-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 87e417899c91fd9314e68e3af948c93369bd58b181a1a1b84990c9fd4af8769f
MD5 3042825375af6dff7ab4a4df3686d73c
BLAKE2b-256 583ff6be8b9e45350ca14d814537a219665fdebaa57f120cdeb78c5a2ea8b246

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page