# EzColocalization
EzColocalization is an open source ImageJ plugin developed to assist in colocalization studies. To allow for its use with as many data types as possible, the program takes a variety of inputs. Details of the possible inputs are available in the EzColocalization publication, but briefly, monochromatic images can be used as reporters, and ROI manager lists, binary masks, and light microscopy images can be used as to identify areas for analysis. This allows images or hand drawn regions for identification of areas to be analyzed. Outputs include everything necessary to visualize data, to decide upon appropriate analysis, to analyze data, and to analyze populations within experiments. EzColocalization is meant to simplify colocalization analysis for experimentalists, however EzColocalization can also be simply be used to identify cells with particular characteristics, align images, analyze colocalization in whole images, and analyze average signal of cells.
ImageJ (or Fiji) must be installed to use the plugin.
On the ImageJ menu bar select "Plugins">"Install..." and select the EzColocalization plugin file (.jar format). The EzColocalization plugin will now be selectable in the "Plugins" menu. Alternatively, the .jar file version of the plugin can be moved to the "plugins" folder found in the ImageJ folder, and ImageJ must be reopened. Finally, the source code and .jar file of EzColocalization plugin can also be downloaded from GitHub.
To use the EzColocalization plugin, select it from the "Plugins" menu on ImageJ. The plugin has tabs dedicated to the multitude of functions included. The function of each tab can be performed individually with “Preview” buttons, or all selected functions can be ran together with the “Analyze” button at the bottom of the plugin window. Test images of bacteria are included within the plugin to allow users to tryout the plugin. To open these images, within the EzColocalization window, select “File”>”Test images”.
In the interest of making the code interpretable and thus modifiable, the code within EzColocalization is organized as modularly as possible. The code is organized into packages of classes with related functions. A more detailed description of these classes and their functions is proved in the supplementary material of the EzColocalization publication.
We use SemVer for versioning. For the versions available, see the tags on this repository.
<EzColocalization, An ImageJ plugin for visualizing and measuring colocalization in cells and organisms.> Copyright (C) <2018> <Weston Stauffer, Huanjie Sheng, and Han N. Lim> This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License. This program is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.
A quick guide (No audio)
A comprehensive guide (With audio)
Stauffer, Weston, Huanjie Sheng, and Han N. Lim. "EzColocalization: An ImageJ plugin for visualizing and measuring colocalization in cells and organisms." Scientific reports 8.1 (2018): 15764.
@article{stauffer2018ezcolocalization, title={EzColocalization: An ImageJ plugin for visualizing and measuring colocalization in cells and organisms}, author={Stauffer, Weston and Sheng, Huanjie and Lim, Han N}, journal={Scientific Reports}, volume={8}, number={1}, pages={15764}, year={2018}, publisher={Nature Publishing Group} }