README.md

FlyCaImAn - Fly Calcium Imaging Analysis Pipeline

Matlab code for analysis of calcium imaging data from the Drosophila brain, including motion correction, ROI segmentation, and detection of stimulus-modulated ROIs.

Organization of data

Pipeline

To process either 3DxT or 2DxT datasets:

• 1. Convert tiffs to mat files (generate image data variable 'Data', and image metadata variable 'iDat').
• 2. Pull extra information from metadata files ('.bin', '_vDat.mat', or '.mat' (LEDcontroler)).
• 3. Do motion correction (using NoRMCorre).
• 4. Do spatial and/or temporal resampling
  • this includes re-slicing for volumetric datasets and aligment relative to stimuli delivery.
  • generates main metadata variable used for ROI segmentation (wDat).
• 5. select brain pixels (generate a binary mask).
• 6. i) format stacks for ROI segmentation.
• 6. ii) stitch (along z axis) and format stacks for ROI segmentation.
• 7. ROI segmentation (in progress)
• 8. Detect stimulus-modulated ROIs (in progress)

To register image segments to local whole brain and to in vivo atlas

• (in progress)

Dependencies

For processing of imaging data this pipeline requires the following packages:

• CaImAn, see link for dependencies.
• NoRMCorre, see link for dependencies.
• CMTK_matlab_wrapper, this requires the Computational Morphometry Toolkit CMTK

For processing of behavior videos with fictrac this pipeline requires the following packages:

• Fictrac, see link for installation & dependencies (for windows see fic-trac-win).
• generate calibration-transform.dat, and update that file in /toolbox/fictrac_offline/fictrac_settings

For saving figures install:

• export_fig

For stitching Z-stacks:

• fiji, make sure you have the bio format plugin, Imagescience plugin, stitching plugin (confirm you have Plugins/Stitching/Pairwise Stitching) and NIfTI plugin

For interfacing with a cluster and ROI-related functions:

• download pu_cluster_interface (it requires the user defined temporary folder to save job parameters)

Usage

To use this package

1. Copy and edit fiji_fullpathedit.m (see that file for details), and save as fiji_fullpath.m.

For examples see all the demos: FlyCaImAn_demo.m FlyCaImAn_behavior_only_demo.m FlyCaImAn_behavior_plus_stimuli_demo.m FlyCaImAn_behavior_plus_stimuli_plus_imaging_demo.m FlyCaImAn_imaging_only_demo.m FlyCaImAn_Zstack_demo.m

Acknowledgements

Special thanks to:

• Eftychios Pnevmatikakis and Andrea A. Giovannuci for help with CaImAn-MATLAB and NoRMCorre toolboxes
• Gregory Jefferis and Torsten Rohlfing for help with CMTK toolbox

Citation

If you use this code please cite the following paper: Pacheco, D.A., Thiberge, S.Y., Pnevmatikakis, E. et al. Auditory activity is diverse and widespread throughout the central brain of Drosophila. Nat Neurosci (2020). https://doi.org/10.1038/s41593-020-00743-y