Package: napari-metroid
napari-metroidThis napari plugin is an adaptation ofmetroid. It creates several regions of interest of similar area over cells in a fluorescence video (2D+time). It then gets ROIs means over time and performs signal denoising: fixes photobleaching and separates signal from noise by means of blind source separation (with or without wavelet filtering).Thisnapariplugin was generated withCookiecutterusing@napari'scookiecutter-napari-plugintemplate.A Picture (to boil down a thousand words)Below is the graphical abstract of the Metroid software. This napari plugin works very similarly.Table of ContentsQuick WalktroughInstallationUsageOpen Sample DataOpen Plugin Main InterfaceAuto-generate Cell MaskSplit Mask into ROIsGet ROI Means over TimeRemove PhotobleachingFilter SignalsSave outputsContributingCiting napari-metroidLicenseIssuesQuick WalkthroughBelow is a full demonstration of using napari-metroid. It shows the following:Open sample data;Create cell mask;Split mask into ROIs of similar area;Get ROIs signals over time and plots two of them;Remove photobleaching;Remove noise:Use ICA to decompose ROIs signals into independent components;Plot 4 components;Manually select the component of interest (source);Perform inverse transformation with selected source;InstallationDownload and installAnacondaorMiniconda.Create a new conda environment:conda create -n metroid-env python=3.8Install napari, e.g. via pip:pip install "napari[all]"Installnapari-metroidviapip:pip install napari-metroidTo install latest development version :pip install git+https://github.com/zoccoler/napari-metroid.gitUsageOpen Sample DataThis plugin comes with two sample videos:Cell1 Video Action Potential: 2D + time fluorescence video of a rat isolated cardiomyocyte labeled with a membrane potential dye upon which an external electrical field pulse is applied.Cell1 Video Electroporation: Same cell, but submitted to a strong external electrical field pulse.You can open them under "File -> Open Sample -> napari-metroid", as shown below. Both videos are loaded from themetroid main repository. To know more about the experimental conditions, please refer to theoriginal publication.Open Plugin Main InterfaceAuto-generate Cell MaskMetroid can generate cell binary masks automatically by cumulative sum of images until any pixel saturation happens. It then applies Otsu thresholding and removes small objects.Split Mask into ROIsBy default, a cell mask is split into 32 regions of interest (ROIs) in a double-layer fashion: An outer layer of ROIs and an inner layer.
The method is solely based on the shape of the cell mask and the main criteria is that ROIs must have similar areas. The number of ROIs in each layer can be editted.Get ROI Means over TimeThe 'Get Signals' button serves to collect each ROI mean fluorescence over time and enable plotting. There, you can optionally provide the frame rate so that the time axis is properly displayed.
Double click over a ROI to have its signal plotted. Hold the 'ALT' key to plot multiple signals together.Remove PhotobleachingMetroid removes photobleaching by curve fitting over time periods that lack the cellular signal (which can be an action potential or an electroporation signal). That is why the 'Transitory' parameter is important. Action potentials are transitory signals whereas electroporation (at least for the duration of this experiment) are not, and the algorithm must be informed about that for proper trend removal.Filter SignalsCellular signals are filtered by separating signal components with either PCA or ICA (plus optional wavelet filtering). It then chooses one (or several) components and it applies the inverse transform using only the selected components. Metroid can do this component/source selection automatically based on estimations of signal power. Instead, we show below the manual selection procedure, where 4 components are plotted and the user selects one of them.Save OutputsRaw, corrected and filtered signals, as well as time and components, are arranged in a table with values for each time point. The table is displayed as a widget after each Run button click. Estimated signal-to-noise (SNR) in dB for each label/ROI are also provided (in this case, each line corresponds to a ROI, not a time point).
The user can save these data by clicking on the buttons "Copy to clipboard" or "Save as csv...".ContributingContributions are very welcome. Tests can be run withtox, please ensure
the coverage at least stays the same before you submit a pull request.Citing napari-metroidIf you use this plugin in your research, please be kind to cite the original paper below:Zoccoler, M., de Oliveira, P.X. METROID: an automated method for robust quantification of subcellular fluorescence events at low SNR. BMC Bioinformatics 21, 332 (2020).https://doi.org/10.1186/s12859-020-03661-9LicenseDistributed under the terms of theBSD-3license,
"napari-metroid" is free and open source softwareIssuesIf you encounter any problems, pleasefile an issuealong with a detailed description.