integrated tool-suite of essential processing and analysis of imaging+ experiments
Project description
Imaging+ ![a python -x- calcium spike](https://pypi-camo.freetls.fastly.net/2012a98034267901500e6aa71410fb3cc0edd7e5/646f63732f736f757263652f66696c65732f696d6167696e67706c75732d6c6f676f2e706e67)
imaging+ is a Python package and tool-suite for essential processing and analysis of 2photon imaging data. Especially, there is a fully implemented pipeline for data structuring, processing, analysis and plotting of 2photon Ca2+ imaging experiments, and experiments based around 2photon imaging such as all optical experiments (i.e. 2photon optogenetic stim or 1photon optogenetic stim, with combined 2photon Ca2+ imaging).
Overview
This package is designed for experiments that follow the general structure of an "imaging+" experiment shown below. We have additionally provided specific sub-modules to suit imaging experiments performed using PackIO, a Bruker 2pPlus microscope and using Suite2p for Ca2+ imaging data processing for ROI segmentation. It should be completely usable and understandable for anyone with the correct data in hand and basic knowledge of Python. There are tutorials to help along the way. Ultimately, the goal of this package is to jump-start your own analysis of your awesome experiment.
We hope that it provides a useful structure to organize your experimental data, and some functionality to interact and process your data in an efficient manner.
Getting started
Recommended tools:
- python >=3.9
- conda - environments for python package management
- Run
conda create -n <insert-name> python=3.9
to create a new conda environment with python 3.9 - Note:
imaging+
should install and function normally within existing conda environments as well.
- Run
- Jupyter - for creating python based notebooks
- VS Code or PyCharm - IDE for python code development
Installation instructions
Note: The package is installable as a stand-alone python package. You can install the package into an existing conda environment, or you may choose to skip using a conda environment all together (steps 2 and 3).
- Clone this github repository using
git clone https://github.com/Packer-Lab/imaging+.git
in the terminal. - Create the preset conda environment provided in this repository (
plitest.yml
) usingconda env create -f plitest.yml
from the terminal. - Activate the conda environment
conda activate plitest
. cd
to the parent directory of where this repo was downloaded to.- From this parent directly, run
pip install -e imaging+
from terminal to install this packageimaging+
.
Test imaging+
is successfully installed (import package in python):
- Ensure that the conda environment from which
imaging+
was installed is activated. - start python from command line using:
python
, or start python from the same conda environment in your preferred method (e.g. jupyter notebook or IDE). - Import the package:
import imaging+
orimport imaging+ as ip
.
Documentation
The documentation for imaging+
is available at https://imagingplus.readthedocs.io/en/latest/
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.