A plugin to perform registration of regions-of-interests in time-lapse data.
A Napari plugin for the registration of regions of interests (ROI) in a time lapse acquistion and processing of the intensity of the registered data.
The ROI are defined using a Labels layer. Registration of multiple ROIs is supported.
Registration widget uses the user-defined labels, constructs a rectangular ROI around each of them and registers the ROIs in each time frame.
Processing widget measures the ROI displacements and extracts the average intensity of the ROI, calculated on the area of the labels.
Subtract background widget subtracts a background on each frame, calculated as the mean intensity on a Labels layer.
Tipically useful when ambient light affects the measurement.
You can install
napari-roi-registration via pip:
pip install napari-roi-registration
To install latest development version :
pip install git+https://github.com/GiorgiaTortora/napari-roi-registration.git
A detailed guide which shows how to use the widgets of the napari-roi-registration plugin and how to properly choose the parameters can be found here. A demo video is available at this link. Sample datasets are available.
- Create a new Labels layer and draw one or more labels where you want to select a ROI (Region Of Interest). Each color in the same Labels layer represents a different label which will correspond to a different ROI.
- Push the
Register ROIsbutton: registration of the entire stack will be performed. When the registration is finished two new layers will appear in the viewer. One layer contains the centroids of the drawn labels while the other contains the bounding boxes enclosing the ROIs. The registration starts from the currently selected frame. If
register entire stackis selected, the registration will create a new layer for each label, with the registered ROI stacks.
Process registered ROIs button, the registered ROIs will be analyzed. The intensity of the registered ROIs (measured on the area of the selected label) and the displacement of the ROIs will be calculated.
plot results is selected the plot of displacement vs time index and mean intensity vs time index will appear in the Console.
save results option, an excel file containing ROIs positions, displacements and intensities, will be saved.
- Create a new Labels layer and draw a label on the area where you want to calculate the background.
- Push the
Subtract backgroundbutton. A new image layer will appear in the viewer. This layer contains the image to which the background was subtracted.
Contributions are very welcome. Tests can be run with tox, please ensure the coverage at least stays the same before you submit a pull request.
Distributed under the terms of the BSD-3 license, "napari-roi-registration" is free and open source software
If you encounter any problems, please file an issue along with a detailed description.
- 13 December 2023
- 04 May 2022
- Information not submitted
- Stars: 5
- Forks: 0
- Issues + PRs: 2