Skip to main content

Python module for extracting optical physiology ROIs and traces for various file types and formats

Project description

PyPI version Full Tests Auto-release codecov documentation License

ROIExtractors

Automatically read optical imaging/segmentation data into a common API

Explore our documentation »

Table of Contents

About

ROIExtractors provides a common API for various optical imaging and segmentation formats to streamline conversion and data analysis. ROI stands for Region Of Interest, which is the region in a set of acquired fluorescence images which the segmentation software has determined as a neuron.

Features:

  • Reads data from 10+ popular optical imaging and segmentation data formats into a common API.
  • Extracts relevant metadata from each format.
  • Provides a handy set of methods to analyze data such as get_roi_locations()

Installation

To install the latest stable release of roiextractors though PyPI, type:

pip install roiextractors

For more flexibility we recommend installing the latest version directly from GitHub. The following commands create an environment with all the required dependencies and the latest updates:

git clone https://github.com/catalystneuro/roiextractors
cd roiextractors
conda env create roiextractors_env
conda activate roiextractors_env
pip install -e .

Note that this will install the package in editable mode.

Finally, if you prefer to avoid conda altogether, the following commands provide a clean installation within the current environment:

pip install git+https://github.com/catalystneuro/roiextractors.git@main

Documentation

See our ReadTheDocs page for full documentation, including a gallery of all supported formats.

Funding

ROIExtractors is funded by

  • Stanford University as part of the Ripple U19 project (U19NS104590).
  • LBNL as part of the NWB U24 (U24NS120057).

License

ROIExtractors is distributed under the BSD3 License. See LICENSE for more information.

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

roiextractors-0.5.10.tar.gz (67.6 kB view details)

Uploaded Source

Built Distribution

roiextractors-0.5.10-py3-none-any.whl (88.4 kB view details)

Uploaded Python 3

File details

Details for the file roiextractors-0.5.10.tar.gz.

File metadata

  • Download URL: roiextractors-0.5.10.tar.gz
  • Upload date:
  • Size: 67.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.20

File hashes

Hashes for roiextractors-0.5.10.tar.gz
Algorithm Hash digest
SHA256 443619f8cf6a88bce3ffd5d0a631a5fb245520d298cb1496096637624fb3c720
MD5 9a278a10817886f82a6aa9a2f8feab26
BLAKE2b-256 07e4953b95a9d907342f5eee2c1562eab99000c6570f5bcea7bafd3c54b6906d

See more details on using hashes here.

File details

Details for the file roiextractors-0.5.10-py3-none-any.whl.

File metadata

File hashes

Hashes for roiextractors-0.5.10-py3-none-any.whl
Algorithm Hash digest
SHA256 d97e19716830c9569b0941e19582f21e650020276e6c4505ae6adfb8c1b5e24c
MD5 4cc17666ce237fb7fb44a3539d87ca55
BLAKE2b-256 e54615a07c9b86c73d8341ea878e1307f8e7796a56afe72fd4f60ec1bd40470b

See more details on using hashes here.

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