Skip to content

🔬 This is an ImageJ or Fiji plugin to identify, characterize, quantify and classify cells according to user-defined conditions.

License

Notifications You must be signed in to change notification settings

acayuelalopez/CellTypeAnalyzer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Table of Contents

Cell-TypeAnalyzer

General

A flexible Fiji/ImageJ plugin to classify cells according to user-defined criteria.

Note: This plugin (currently) only supports 2D images from microscope three-channel acquisition in RGB form with each channel with same dimension and magnification: 24-bit RGB (24-bit with 8-bits per channel red, green and blue) or Color Composite (each channel can be kept as 16-bit and more than 3 channels can be merged and kept separate). This plugin may work with RGB images while it does not work with RGB stack.

Overview of Procedure

Cell-TypeAnalyzer can work with images with up to three color channels. One of the channels, called Marker I, defines what a cell is and what is not. This channel can be a marker of cytoplasm, nuclei, or any other cellular structure of interest. Once we have identified cells with Marker I, Markers II and III will define the cell types.

A high-level overview of the Cell-TypeAnalyzer procedure involved is shown. The processing actions consists of six major stages:

(Step I). After loading the raw RGB images, we need to establish the correspondence between the color channels and the marker names and roles. At this point, we may perform a spatial calibration (give the pixel size in physical units) to get measurements in real length units or pixels otherwise. We may also restrict the analysis to a Region-of-interest (ROI) that must be a closed shape. The plugin shows a histogram of the pixel values in each one of the channels as visual feedback.

(Step II). The next step is the identification of the cells based on Marker I. To isolate cells from their background, we offer multiple possibilities. All of them respond to an auto-thresholding with different methods to binarize the image, then a watershed filtering may be applied to separate connected cells. Then single-cell contours are detected and boundaries traced. Once done, geometrical and image features are extracted from each cell, and each cell obtains a unique ID number. The plugin shows at this point a summary of the detected features through some descriptive statistics (mean, median, variance, standard deviation, minimum, maximum, quantiles, and inter-quantile range, etc.). The user may now apply filters based on these features to keep only the relevant cells for their study.

(Step III). Morphological operators (erosion or dilation) may be applied to the cell contours to alter their original size. These operations allow the measurements on Marker II to be performed in a region that coincides with the area detected by Marker I (no operation), a smaller region (erosion), or a larger region (dilation). We may also perform a ''Bright Spots'' analysis to count small bright dots within each cell. Then we will compute geometrical and image features from Marker II in the selected regions. Finally, we may create cell types and, to each one, add as many constraints based on the Marker II features as needed.

###### **Scriptable Pre-Processing Actions.** Additionally, by clicking on `Script Button`, a dialog window will be displayed in which users are provided by a script editor to write their own code in any of ImageJ's macro supported language without saving or even, likewise, copying it to the clipboard `(crtl-a, ctrl-c)` and paste `(ctrl-v)` on script editor area, then run it. Either way, whether running is successful, pre-processing actions under the code will be applied to objects belonging DAPI channel.

(Step IV). We repeat the same actions as in Step III, but now on Marker III. Then, we can add the constraints on Marker III to the definition of each cell type. Cells are assigned to each one of the types if they meet all the conditions on Markers II and III. Note that cell types can also involve conditions solely on Marker II or Marker III.

(Step V). The last interactive step allows us to configure a dynamic scatter plot to display any cell feature as a function of any other. Data points will represent relevant cells (those passing the criteria of a valid cell according to Marker I) being colored depending on their cell type or in gray if they do not fulfill the criteria of any defined cell type. Finally, we may save an XML configuration file that will allow us to run this analysis in batch mode for many images (Step VI).

(Step VI). In this step, we apply the image analysis steps defined above (cell segmentation, region operations, etc.) and classify the detected cells into the user-defined cell types to a large number of images that have been acquired with similar characteristics as the one that served to set up the analysis. This execution is performed in batch mode and produces text or Excel files with the results for each image and a summary for the whole set.

Installation

The CellTypeAnalyzer plugin may be installed in Fiji or ImageJ by following these steps:

  1. In the event of not having ImageJ or Fiji already installed, please navigate through https://imagej.nih.gov/ij/download.html, download it and then, install it on a computer with Java pre-installed in either Windows, Mac OS or Linux systems.
  2. Once done, download the plugin JAR file named as CellTypeAnalyzer_.jar from repository.
  3. Move this file into the ImageJ/Fiji "plugins" subfolder, or differently, by dragging and dropping into the ImageJ/Fiji main window or optionally, running through menu bar "Plugins" "Install" ‘Path to File’. Then restart either ImageJ or Fiji and it is about time to start using "CellTypeAnalyzer".

Video Tutorials

Running Cell-TypeAnalyzer in batch-mode

batch_analysis.1.mp4

Running Cell-TypeAnalyzer for single-image

single_analysis.1.mp4

References

[1] Cayuela López, A., Gómez-Pedrero, J., Blanco, A., & Sorzano, C. (2022).
Cell-TypeAnalyzer: A flexible Fiji/ImageJ plugin to classify cells according to user-defined criteria. Biological Imaging, 2,E5. DOI:10.1017/S2633903X22000058

About

🔬 This is an ImageJ or Fiji plugin to identify, characterize, quantify and classify cells according to user-defined conditions.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages