MINI2P freely-moving calcium imaging and spatial tuning analysis
MINI2P_toolbox includes the codes, softwares, 3D models, protocols, and etc. for buidling and using MINI2P to do freely-moving recording. MINI2P is an open-source miniature 2-photon microsocpe for fast high-resolution calcium imaging in freely-moving mice, published in Zong, et al.,"Large-scale two-photon calcium imaging in freely moving mice (2022)". With the materials provided in this toolbox, people can assemble, test the MINI2P system, set up the animal tracking system, process the MINI2P imaging data, extract neuronal activity from single cells, and combine the neuronal activity data and the tracking data together for user-depedent downsteam analysis. The multi-FOV stitching software is also included. The codes for most of the anaylsis (grid cells, place cells, etc) in the paper "Large-scale two-photon calcium imaging in freely moving mice (2022)" are also provided.
-
3D models (and 2D drawings for custom components) of all components for bulding a complete MINI2P system.
-
a) P1–Shopping and Machining list. This document lists each essential component with the supplier, the product name, the model (or item reference) and its approximate price in Euro. 2D Drawings and 3D models of most components are available here .
b) P2-System building protocol. This protocol includes all steps to assemble a MINI2P system. Each Protocol starts with a short-list of main reagents and tools needed, followed by an overview schematic of the module, and a table with the main products. HC-920 assembly building and laser coupling video tutorial can be found on the link.
c) P3–Miniscope assembly protocol. How to assemble a MINI2P microscope is described in this protocol.
-
a) One scanimage Machine Data File (MDF) for 2000Hz MEMS-L scanner. A second file for 5600Hz MEMS-F scanner
b) An example Suite2P settings.
c) Two DLC model configuration files:
More details in Documents.
d) AnimalTracker.vi: a Labview program for recording animal behaviors and synchronizing the tracking camera recording with the MINI2P imaging. More details in Documents
e) MINI2P SI device: Briefly, this device enables users to measure MINI2P distortion in different planes, do fast data correction, and register MINI2P system information in ScanImage software. And all this information is saved in Tiff header now. Video tutorial can be found on the link. More details in Readme
-
a) Pipelines for spatial tuning analysis included in the paper (grid cells, place cells,etc).
b) NATEX.mlapp: Nat Explorer, an application to load, process and preview the neuronal activity data (from the Suite2P output) and the tracking data (from the DLC output). It also combines the neuronal activity data and tracking data into the NAT.mat (Neuron Activity aligned with Tracking Matrix) and put all necessasy information into ExperimentInformation.mat for the user-specific downsteam analysis. More details in Documents
c) StitchingChecker.mlapp: an application to stitch multiple FOV recorded from different positions of the cortext. It can load in wide-field image as a reference for FOV alignment and can also take the retinotopic mapping result in for identifying different visual cortices. The precise alginment of FOVs is confirmed by
-
overlapping of the landmarks between FOVs and the wide-field image, or between neighbouring FOVS;
-
peak cross-correlation between FOVs and the wide-field image, or between neighbouring FOVs;
-
overlapping of the repeated cells in neighbouring FOVS. We also found this application can be used to register imagings recorded in multiple days.
More details in Documents
d) DistortionCleaner.mlapp： an application to eliminate the scanning distortion of MINI2P imaging, calibrate FOV and pixel size, and generate transform matrix. This program works similar to the ScanImage plugin “MINI2P distortion detecotion", but can work without installing Scanimage. Note that since the release of MINI2P SI Device in March, 2022, this function is not in use or maintenance any more. Users can still install and try it but we will not provide any support or bug-fix. More details in Documents
-
-
a) Requirements: A list of the non-optical components necessary to build and use a MINI2P system, including licensed software requirements.
b) How-to: A set of more detailed how-to documentation about how some components of the system work.
Applications NATEX, StitchingChecker and DistortionCleaner were written with Matlab app designer. In order to use these software, please press "open” in the home toolstrip of Matlab, select the software, wait until the app designer interface pops out, and then press "run". Some details in how to use each application is provided under Documents
This repository was created by Weijian Zong and maintained by the Moser group at Kavli Institute for Systems Neuroscience. It has benefitted from the inputs of all authors of the paper Zong, et al.,"Large-scale two-photon calcium imaging in freely moving mice," Cell(2022). Sections of the analysis code are based on the Behavioural Neurology Toolbox, (c) Vadim Frolov 2018.
MINI2P is a complete open-source project, we encourage people to use, test, modify and further develop this toolbox. If you have any questions or suggestions, or find any bugs in the codes, please contact us or submit an issue. If you use the code or data, please cite us!