Skip to main content

Calcium imaging analysis platform

Project description

banner

PyPi: PyPI version

License: License: GPL v3

Chat: Gitter

Downloads: Downloads

Code analysis: Maintainability

Mesmerize is a platform for the annotation and analysis of neuronal calcium imaging data. Mesmerize encompasses the entire process of calcium imaging analysis from raw data to interactive visualizations. Mesmerize allows you to create FAIR-functionally linked datasets that are easy to share. The analysis tools are applicable for a broad range of biological experiments and come with GUI interfaces that can be used without requiring a programming background.

Associated bioRxiv paper: https://doi.org/10.1101/840488

manuscript on biorxiv

Installation

If you're familiar with anaconda or virtual environments, and have the necessary build tools, installation is as simple as:

pip install tslearn~=0.2.2
pip install mesmerize

After installation simply call mesmerize from inside the virtual environment to launch it.

If you're unfamiliar with virtual environments, see the docs for more detailed instructions on all operating systems: http://mesmerizelab.org/user_guides/installation.html

In order to use CaImAn features you will need to have CaImAn installed into your environment. See the Mesmerize installation instructions linked above for more details.

Documentation

Documentation is available here: http://www.mesmerizelab.org/

Questions/Discussions

Feel free to ask questions or discuss things on gitter. For larger bugs/issues please use the issue tracker.

Gitter

Issue tracker: https://github.com/kushalkolar/MESmerize/issues

News

July 2020

Changes:

  • Mesmerize can now be installed via pip.
  • Much easier to import imaging meta data from other sources.
  • Create stimulus tuning curve plots.
  • ΔF/F must now be extracted at the Viewer stage for caiman data, or set through other methods. Spikes and ΔF/F can be visualized in the Viewer.

June 2020

Version 0.2 released.

Changes:

  • Windows is now supported!
  • The Viewer can handle 3D data and 3D ROIs.
  • For development, classes are provided for creating Volumetic ROI types, and a Volumetic ROI manager.
  • Caiman 3D CNMF is supported.
  • Updated CNMF(E) and motion correction modules to use the latest release of CaImAn. Parameter entry GUIs are much more flexible now.
  • CNMF(E) data can be imported directly from hdf5 files from Caiman. Therefore you can use your own scripts/notebooks and existing CNMF hdf5 files for downstream analysis in Mesmerize.
  • More customizable support for use of caiman modules within the Mesmerize viewer's script editor.
  • Suite2p importer added, allowing you to perform downstream analysis of Suite2p output data in Mesmerize.
  • Some cleanup with the batch manager
  • bug fixes

Please note that batches from v0.1 and v0.2 are not inter-compatible. Use the v0.1 branch if you need v0.1

Nov 2019:

See our recent biorxiv manuscript where we use Mesmerize to analyze a calcium imaging dataset from Ciona intestinalis as well as other model organisms!

https://doi.org/10.1101/840488

manuscript on biorxiv

Upcoming

Towards v0.3

  • Full support for recordings from Femtonics microscopes.
  • Export lite versions of projects for easier sharing

Acknowledgements

I'd like to thank the pyqtgraph developers for creating such an expansive library, which we built upon to create many of the interactive elements of Mesmerize. The CaImAn developers have created a very robust library for pre-processing and signal extraction of calcium imaging data, which Mesmerize is able to interface with. Simon Daste provided sample data and assistance which allowed for creation of the Suite2p importer module. Jordi Zwiggelaar created the Mesmerize logo & banner. pyqtgraph/pyqtgraph) developers for creating such an expansive library, which we built upon to create many of the interactive elements of Mesmerize. The CaImAn developers have created a very robust library for pre-processing and signal extraction of calcium imaging data, which Mesmerize is able to interface with. Simon Daste provided sample data and assistance which allowed for creation of the Suite2p importer module. Jordi Zwiggelaar created the Mesmerize logo & banner.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mesmerize-0.2.1.tar.gz (1.0 MB view hashes)

Uploaded Source

Built Distribution

mesmerize-0.2.1-py3-none-any.whl (1.2 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page