schnitzer-lab / EXTRACT-public

EXTRACT is a tractable and robust automated cell extraction tool for calcium imaging, which extracts the activities of cells as time series from both one-photon and two-photon calcium imaging movies.
MIT License
65 stars 18 forks source link

Open in MATLAB Online View EXTRACT-public on File Exchange

EXTRACT

Introduction

Example_movie

EXTRACT is a tractable and robust automated cell extraction tool for calcium imaging, which extracts the activities of cells as time series from both one-photon and two-photon Ca2+ imaging movies. EXTRACT makes minimal assumptions about the data, which is the main reason behind its high robustness and superior performance.

We show an example output of EXTRACT on a low SNR movie, in the figure on the right donated by Dr. Peng Yuan. Please note that this is the raw output, with no post-processing and/or manual annotation/selection by users. This run is a result of a batch processing of >30 sessions, optimized only once at the beginning of the study, with no extra parameter tweaking particular to this session. EXTRACT needs to be optimized per surgery/imaging modality type (practically once in the life-time of a study). For a trained person (feel free to schedule a tutorial for your lab!), this process usually takes around few minutes.

Installation

Use the Add-on Explorer and search for EXTRACT (recommended), or install files from this GitHub repo.

Getting Started

Browse the tutorial examples to quickly gain expertise with EXTRACT. You can view the tutorials :eyes: or run:arrow_forward: most of the tutorials on MATLAB Online. Or work any of the tutorials on your own computer.

Tutorial View Run
1 - Starting Code File Exchange Open in MATLAB Online
2 - Parallelization File Exchange Open in MATLAB Online
3 - Preprocessing File Exchange Open in MATLAB Online
4 - Cellfinding File Exchange Open in MATLAB Online
5 - Cell refinement File Exchange Open in MATLAB Online
6 - Final robust regression File Exchange Open in MATLAB Online

Links for the sample movies: Google Drive

The user manual

Please see the user manual inside the "Learning materials" folder. The user manual has a quick start guide, accompanied with several tutorials. The user manual also has several key insights for increasing the quality of cell extraction.

Instructional video

You can watch our 10-minute video about EXTRACT: Instructional video

Schedule a tutorial session!

Thank you for your interest in EXTRACT, a cell extraction routine with native GPU implementation. To receive occasional updates about new releases, to ask questions about EXTRACT usage, or schedule a tutorial session for your lab, please send an email to extractneurons@gmail.com along with your name and institution. (Please be sure to add this email to your contact list so that replies and announcements do not go to your spam folder). Thank you!

Questions

EXTRACT code is primarily written by Dr. Hakan Inan and Fatih Dinc in collaboration with many researchers in Schnitzerlab. The database is maintained by the current members of Schnitzerlab. If you have any questions or comments, please open an issue or contact via email extractneurons@gmail.com.

Citations

EXTRACT is described in two accompanying papers: Dinc & Inan et al., 2024 and Inan et al., 2017. Please cite these papers if you use EXTRACT in your own work.