版本 0.9.2 (2.9 MB) 作者: Ethan Meyers
A MATLAB toolbox for interacting with the Allen Brain Observatory

77.0 次下载

更新时间 2022/9/2

来自 GitHub

在 GitHub 上查看许可证

View Brain-Observatory-Toolbox on File Exchange

Brain Observatory Toolbox

A MATLAB toolbox for accessing and using the neural recording public datasets from the Allen Brain Observatory1.

🚀 Get started with the EphysQuickstart & OphysQuickstart guides.

🔬 See the Brain Observatory Toolbox applied to neuroscience data analysis in the EphysDemo & the OphysDemo.

👩‍🏫 Learn how to use the Brain Observatory Toolbox with the EphysTutorial, OphysTutorial, & BehaviorTutorial.

🚧 The Brain Observatory Toolbox is at an early stage; the interface is not guaranteed stable across the v0.9.x releases.

Questions, suggestions, and other feedback are highly welcomed (in the Discussion forum).

About the Allen Brain Observatory datasets

Data releases from the Allen Brain Observatory include two datasets of neural activity recordings:

Dataset Recording Type Nickname Details
Visual Coding Neuropixels 2 Large-scale neural probe recordings "ephys" (electrophysiology) details
Visual Coding 2P 3 Two-photon calcium imaging "ophys" (optical physiology) details

The Visual Coding datasets are both collected from the living mouse brain during presentation of varying visual stimuli. Technical white papers (see Details for each dataset) provide detailed information about the experimental technicalities and computational pipelines.

About the Brain Observatory Toolbox (BOT)

The Brain Observatory Toolbox (BOT) provides a uniform interface to access and use the Visual Coding neural datasets.

The BOT interface provides tabular representations of available dataset items and object representations of specific dataset items:

Schematic of BOT data items & workflow

Key Concepts

  • Item tables support all tabular operations, including tabular indexing which enables specific dataset item selection for inspection and analysis as item objects
  • Item objects consist of numerous properties which each return direct, derived, or file-linked values about a specific item
    • Some item objects also have methods to compute values requiring additional user-specified arguments

The basic workflow is illustrated by three lines of code:

>> sessions = bot.fetchSessions('ephys')  % Obtain/view table showing available ephys session items
>> session = bot.session(sessions(1,:)) % Obtain/view object representing first available session item
>> methods(session) % Display methods (functions) available to access additional session item values

👉Try typing these three lines directly into the MATLAB command window

Technical Details

  • Local caching (of retrieved item information, object representation, and file contents) is implemented, to provide the fastest possible initial and repeat performance within and across MATLAB sessions.


The easiest way to install the Brain Observatory Toolbox is to use the Add-on Explorer:

  1. Launch the Add-on Explorer image
  2. Search for "Brain Observatory Toolbox"
  3. Press the "Add" button. image

Required products

  • MATLAB (R2021a)
  • Image Processing Toolbox (if running the Visual Coding 2P demonstration OphysDemo.mlx)


Initial engineering work was supported by the Foundation of Psychocultural Research and Sherman Fairchild Award at Hampshire College and hosted by the Center for Brains, Minds, and Machines at the Massachusetts Institute of Technology.


  1. Copyright 2016 Allen Institute for Brain Science. Allen Brain Observatory. Available from:

  2. Copyright 2019 Allen Institute for Brain Science. Visual Coding Neuropixels Dataset. Available from:

  3. Copyright 2016 Allen Institute for Brain Science. Visual Coding 2P Dataset. Available from:


Ethan Meyers (2023). Brain-Observatory-Toolbox (, GitHub. 检索来源 .

MATLAB 版本兼容性
创建方式 R2021a
兼容 R2021a 到 R2022b 的版本
Windows macOS Linux
标签 添加标签

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!
版本 已发布 发行说明

See release notes for this release on GitHub:


See release notes for this release on GitHub:


要查看或报告此来自 GitHub 的附加功能中的问题,请访问其 GitHub 仓库
要查看或报告此来自 GitHub 的附加功能中的问题,请访问其 GitHub 仓库