Skip to content

An ImageJ/FIJI plugin for multi-channel Hyperstack alignment (registration)

License

Notifications You must be signed in to change notification settings

ved-sharma/HyperStackReg

Repository files navigation

HyperStackReg ImageJ plugin

Example movie

Movie: A 16-bit multi-channel (blue, green and red) hyperstack movie before and after HyperStackReg registration. The intravital multiphoton movie shows green and red labeled cells moving in vivo in living mice. Extracellular matrix collagen fibers are shown in blue.

Rationale

A single channel time-lapse, Z-stack (C=1, Z>=1, T>1) can be aligned using StackReg plugin. HyperStackReg plugin builds on the functionalities of StackReg to align images in a multi-channel hyperstack (C>1, Z>=1, T>1). The main idea of the HyperStackReg plugin is to apply the same transformation matrix to each channel of a hyperstack, so that all the channels of a hyperstack are registered with respect to each other.

Installation

Put HyperStackReg_.class in the plugins folder and restart ImageJ. "HyperStackReg_" command should be visible under Plugins menu.

NOTE: In this version 5.7, the limit on the maximum number of channels a hyperstack can have was removed.
To download version 5.6 (where the limit was a maximum of 5 channels in the hyperstack), please check the previous release HyperStackReg v5.6

Requires

Just like StackReg, HyperStackReg requires that another plugin called TurboReg should be installed. Please follow directions described on the StackReg page.

How the plugin works

Step 1: User opens a multi-channel hyperstack (C>1, Z>=1, T>1) and runs the HyperStackReg_ plugin. In a pop-up dialog window, user then selects the transformation type (Translation, Rigid body, Scaled rotation, Affine) and the channels to be used for transformation matrix computation. All the channels are selected, by default. Behind-the-scene processing details are printed in the Log window.

Step 2: The plugin duplicates the user-selected channels (and the corresponding Z and T frames) into a hyperstack and merges those channels into an RGB hyperstack (C=1, Z>=1, T>1). No RGB flattening is done, if user selects a single channel for transformation matrix computation (Step 1).

Step 3: The resulting hyperstack is then aligned for each Z and T; and transformation matrices are stored in a text file. The duplicated hyperstack is closed.

Step 4: Transformation matrices are read from the text file and applied to the first channel (C=1) of the original hyperstack. This process is repeated for all the channels (2nd, 3rd, 4th...so on) of the original hyperstack.

Step 5: All the registered channels are combined into a hyperstack.

Batch processing

Plugin is macro recordable, so a folder full of files can be processed in batch mode. Check the HyperStackReg_processFolder.ijm macro for example.

Acknowledgements

This plugin builts on the functionalities of other plugins: StackReg and MultiStackReg

Author

HyperStackReg plugin was written by Ved Sharma during 2015-16, while in John Condeelis's laboratory at the Albert Einstein College of Medicine.

How to cite

DOI

License

See license file

Questions

Image.sc is the best place to ask questions about this plugin. Please post your question with the @vedsharma tag so I get the notification.

About

An ImageJ/FIJI plugin for multi-channel Hyperstack alignment (registration)

Resources

License

Stars

Watchers

Forks

Packages

No packages published