Registration of 3D movies applied to all channels
Project description
napari-3dtimereg
Temporal registration of 2D/3D movies on one channel based on itk-elastix, and transpose alignement to the other channels.
Adaptated from multireg for temporal movies.
For a tutorial on using elastix
for registration, see this tutorial.
Installation
-
You can install the plugin directly in
Napari
by going toPlugins>Install/Uninstall plugins
and search fornapari-3dtimereg
-
Or you can install
napari-3dtimereg
via pip:pip install napari-3dtimereg
Usage
You can launch 3dtimereg
in napari by going to Plugins>Do 3D movie registration (napari-3dtimereg)
.
Choose movie and reference chanel
First, choose select the movie that you want to register. The plugin will create a folder aligned
in the folder of your selected movie where the results will be saved.
Choose the color chanel on which to calculate the registration (reference chanel
). Color chanels are numbered from 0 to nchanels, and you can see their respective number in the layer list on the left panel of Napari. Click on Update
when the correct chanel is selected to go to the registration calculation step.
Calculate temporal alignement
The registration is calculated iteratively from one frame to another. Thus the first frame is not moved and all the other frames are aligned to it. You can tune several parameters in this plugin:
The other parameters are parameters to use itk-elastix to calculate the registration.
show log
: to see the log of Elastix calculationdo rigid
: performs a rigid (affine) transformation step, that allowed to correct for translations/rotations.do bspline
: performs a b-spline based transformation step, that allowed for local deformations in the image.show advanced parameters
: to control the parameters used in the rigid and/or bspline transformations. These parameters control the size of the local registrations calculated, the resolutions at which the transformations are calculated, and can thus greatly impact the results.final order
: is the final order of the B-Splines used for the registration.resolution
: is the number of consecutives resolutions at which the registration will be made. First the registration is made at the lowest level of resolution, correcting global deformations/motions, then at each step, the registration is done on higher resolution, allowing to correct for more local deformations.final spacing
: is the physical spacing of the smallest resolution.iterations
: are the maximum number of iterations allowed to minimize the distance between the two images for each resolution and type of registration.
If both rigid and bspline transformations, the program first applies the rigid transformation to allow for a global registration of the images. Then it will performs the second step of b-spline transformation that can includes local deformations.
For each frame, after calculating the registration on the reference chanel, the plugin will apply the calculated transformation to all the other color chanels of the initial movie. All results are saved as separated images in the aligned
folder during the computation.
Create the final aligned movie
When all frames have been processed, each color chanel and each frame have been saved in the aligned
folder as separated images. This is usefull to calculate the registration on large movies without having to keep all the intermediates and calculated images in memory. You can directly use these separated images, or reconstruct a single composite movie of the result.
If you click on Concatenate aligned images
on the plugin interface, the plugin will create a single composite movie from the aligned images, save it and delete the separated images in the aligned
folder.
License
Distributed under the terms of the BSD-3 license, "napari-3dtimereg" is free and open source software
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
Built Distribution
Hashes for napari_3dtimereg-0.0.6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3b97f315734b383ca8b8b8fd697e2a94c76a54eb65b96c659fe559bd52653879 |
|
MD5 | 409d072cb4b9d1dd73df4428bdca1018 |
|
BLAKE2b-256 | ba6a67b4f366e2725491feea61f3886990a2476599d15a88b8cca9b1966121d4 |