# Auto Threshold

Auto Threshold | |
---|---|

Project | Fiji |

URL | http://imagej.net/Auto_Threshold |

Source | on GitHub |

License | GPLv3 |

Release | 1.16.5 |

Date | Sat Apr 29 22:30:45 CDT 2017 |

Development status | Stable |

Support status | Active |

Team | |

Founders | Gabriel Landini |

Leads | Gabriel Landini |

Developers | - |

Debuggers | Gabriel Landini |

Reviewers | Gabriel Landini |

Support | Gabriel Landini |

Maintainers | Gabriel Landini, Curtis Rueden |

Contributors | Johannes Schindelin, Mark Hiner, Stefan Helfrich |

This plugin binarises 8 and 16-bit images using various **global** (histogram-derived) thresholding methods. The segmented phase is always shown as white (255).

For **local** thresholding rather than global, see the Auto Local Threshold plugin.

## Contents

## Installation

**ImageJ**: requires v1.42m or newer. Download Auto_Threshold-X.Y.Z.jar and copy it into the ImageJ/plugins folder and either restart ImageJ or run the '* Help ▶ Update Menus*' command. After this a new command should appear in '* Image ▶ Adjust ▶ Auto Threshold*'.

**Fiji**: this plugin is part of the Fiji distribution, there is no need to download it.

## Use

**Method** selects the algorithm to be applied (detailed below).

The **Ignore black** and **Ignore white** options set the image histogram bins for [0] and [255] greylevels to 0 respectively. This may be useful if the digitised image has under- or over- exposed pixels.

**White object on black background** sets to white the pixels with values above the threshold value (otherwise, it sets to white the values less or equal to the threshold).

**Set Threshold instead of Threshold (single images)** sets the thresholding LUT, without changing the pixel data. This works only for single images.

It you are processing a stack, two additional options are available: **Stack** can be used to process all the slices (the threshold of each slice will be computed separately). If this option is left unchecked, only the current slice will be processed. **Use stack histogram** first computes the histogram of the whole stack, then computes the threshold based on that histogram and finally binarises all the slices with that single value. Selecting this option also selects the **Stack** option above automatically.

**Important notes:**

**1.** This plugin is accessed through the * Image ▶ Auto Threshold* menu entry, however the thresholding methods were also partially implemented in ImageJ's thresholder applet accessible through the * Image ▶ Adjust ▶ Threshold...* menu entry.
While the Auto Threshold plugin can use or ignore the extremes of the image histogram (Ignore black, Ignore white) the applet cannot: the 'default' method ignores the histogram extremes but the others methods do not. This means that applying the two commands to the same image can produce apparently different results. In essence, the Auto Threshold plugin, with the correct settings, can reproduce the results of the applet, but not the way round.

**2.** From version 1.12 the plugin supports thresholding of 16-bit images. Since the Auto Threshold plugin processes the full greyscale space, it can be slow when dealing with 16-bit images.
Note that the ImageJ thresholder applet also processes 16-bit images, but in reality ImageJ first computes a histogram with 256 bins. Therefore, there might be differences in the results obtained on 16-bit images when using the applet and the true 16-bit results obtained with this plugin.
Note that for speeding up, the histogram is bracketed to include only the range of bins that contain data (and avoid processing empty histogram bins at both extremes).

**3.** The result of 16 bit images and stacks (when processing all slices) is an 8 bit container showing the result in white [255] to comply with the concept of "binary image" (i.e. 8 bits with 0 and 255 values).
However, for stacks where only 1 slice is thresholded, the result is still a 16 bit container with the thresholded phase shown as white [65535]. This is to keep the data untouched in the remaining slices.
The "Try all" option retains the 16 bit format to still show the images with methods that might fail to obtain a threshold.
Images and stacks that are impossible to threshold remain unchanged.

**4.** The same image in 8 and 16 bits (without *scaling*) returns the same threshold value, however Li's method originally would return different values when the image data was *offset* (e.g. when adding a fixed value to all pixels). The current implementation avoids this offset-dependent problem.

**5.** The same image *scaled* by a fixed value (e.g. when multiplying all pixels by a fixed value) returns a similar threshold result (within 2 greyscale levels of the original unscaled image) for all methods except Huang, Li and Triangle due to the way these algorithms work.
E.g. the Triangle method applied to an 8 bit image and to the same image converted to 16 bits *with scaling* can result in different threshold values. This is because the scaling from 8 to 16 bits creates empty bins in between the scaled grey values. The Triangle method (based on a geometric approach) finds those artefactual gaps in the new 16 bit histogram which satisfy the method constraints, but which would not exist in the original 8 bit image. This cannot be prevented (for example by detecting empty histogram bins) as it would interfere with the analysis when real empty bins (as oppose to artefactual ones) exist in the image.

## Available methods

### Try all

Which method segments your data best? One can attempt to answer this question using the **Try all** option.
This produces a montage with results from all the methods, allowing to explore how the different algorithms perform on a particular image or stack.
When using stacks, in some cases it might not be a good idea to segment each slice individually rather than with a single threshold for all slices (try the mri-stack.tif from the sample images to better understand this issue).

Original image

Try all methods.

When processing stacks with many slices, the montages can become very large (~16 times the original stack size) and one risks running out of RAM. A popup window will appear (when stacks have more than 25 slices) to confirm whether the procedure should display the montaged results. Select **No** to compute the threshold values and display them in the log window.

### Default

This is the original method of auto thresholding available in ImageJ, which is a variation of the IsoData algorithm (described below). The **Default** option should return the same values as the '* Image ▶ Adjust ▶ Threshold ▶ Auto*', when selecting **Ignore black** and **Ignore white**.
To indicate segmentation of the desired phase, use the **White objects on black background** option.
The IsoData method is also known as *iterative intermeans*.

### Huang

Implements Huang's fuzzy thresholding method. This uses Shannon's entropy function (one can also use Yager's entropy function).

- Huang, L-K & Wang, M-J J (1995), "Image thresholding by minimizing the measure of fuzziness",
*Pattern Recognition***28(1)**: 41-51, <http://www.ktl.elf.stuba.sk/study/vacso/Zadania-Cvicenia/Cvicenie_3/TimA2/Huang_E016529624.pdf>

Ported from ME Celebi's fourier_0.8 routines [1] and [2].

### Huang2

This is an alternative implementation of Huang's method by J. Schindelin with an impressive speed advantage on 16 bit images. On some images, however the method gives returns different values than the original Huang method above.

### Intermodes

This assumes a bimodal histogram. The histogram is iteratively smoothed using a running average of size 3, until there are only two local maxima: j and k. The threshold t is then computed as (j+k)/2. Images with histograms having extremely unequal peaks or a broad and ﬂat valley are unsuitable for this method. method

- Prewitt, JMS & Mendelsohn, ML (1966), "The analysis of cell images",
*Annals of the New York Academy of Sciences***128**: 1035-1053, <http://www3.interscience.wiley.com/journal/119758871/abstract?CRETRY=1&SRETRY=0>

Ported from Antti Niemistö's MATLAB code. See here for an excellent slide presentation and his original MATLAB code.

### IsoData

Iterative procedure based on the isodata algorithm of:

- Ridler, TW & Calvard, S (1978), "Picture thresholding using an iterative selection method",
*IEEE Transactions on Systems, Man and Cybernetics***8**: 630-632, <http://ieeexplore.ieee.org/xpls/abs_all.jsp?arnumber=4310039>

The procedure divides the image into object and background by taking an initial threshold, then the averages of the pixels at or below the threshold and pixels above are computed. The averages of those two values are computed, the threshold is incremented and the process is repeated until the threshold is larger than the composite average. That is,

threshold = (average background + average objects)/2.

Several implementations of this method exist. See the source code for further comments.

### Li

Implements Li's Minimum Cross Entropy thresholding method based on the iterative version (2nd reference below) of the algorithm.

- Li, CH & Lee, CK (1993), "Minimum Cross Entropy Thresholding",
*Pattern Recognition***26(4)**: 617-625

- Li, CH & Tam, PKS (1998), "An Iterative Algorithm for Minimum Cross Entropy Thresholding",
*Pattern Recognition Letters***18(8)**: 771-776

- Sezgin, M & Sankur, B (2004), "Survey over Image Thresholding Techniques and Quantitative Performance Evaluation",
*Journal of Electronic Imaging***13(1)**: 146-165, <http://citeseer.ist.psu.edu/sezgin04survey.html>

Ported from ME Celebi's fourier_0.8 routines [3] and [4].

### MaxEntropy

Implements Kapur-Sahoo-Wong (Maximum Entropy) thresholding method:

- Kapur, JN; Sahoo, PK & Wong, ACK (1985), "A New Method for Gray-Level Picture Thresholding Using the Entropy of the Histogram",
*Graphical Models and Image Processing***29(3)**: 273-285

Ported from ME Celebi's fourier_0.8 routines [5] and [6].

### Mean

Uses the mean of grey levels as the threshold. It is used by some other methods as a first guess threshold.

- Glasbey, CA (1993), "An analysis of histogram-based thresholding algorithms",
*CVGIP: Graphical Models and Image Processing***55**: 532-537

### MinError(I)

An iterative implementation of Kittler and Illingworth's Minimum Error thresholding.

This implementation seems to converge more often than the original. Nevertheless, sometimes the algorithm does not converge to a solution. In that case a warning is reported to the log window and the result defaults to the initial estimate of the threshold which is computed using the Mean method.
The **Ignore black** or **Ignore white** options might help to avoid this problem.

- Kittler, J & Illingworth, J (1986), "Minimum error thresholding",
*Pattern Recognition***19**: 41-47

Ported from Antti Niemistö's MATLAB code. See here for an excellent slide presentation and the original MATLAB code.

### Minimum

Similarly to the Intermodes method, this assumes a bimodal histogram. The histogram is iteratively smoothed using a running average of size 3, until there are only two local maxima. The threshold t is such that yt−1 > yt <= yt+1.

Images with histograms having extremely unequal peaks or a broad and ﬂat valley are unsuitable for this method.

- Prewitt, JMS & Mendelsohn, ML (1966), "The analysis of cell images",
*Annals of the New York Academy of Sciences***128**: 1035-1053, <http://www3.interscience.wiley.com/journal/119758871/abstract?CRETRY=1&SRETRY=0>

Ported from Antti Niemistö's MATLAB code. See here for an excellent slide presentation and the original MATLAB code.

### Moments

Tsai's method attempts to preserve the moments of the original image in the thresholded result.

- Tsai, W (1985), "Moment-preserving thresholding: a new approach",
*Computer Vision, Graphics, and Image Processing***29**: 377-393, <http://portal.acm.org/citation.cfm?id=201578>

Ported from ME Celebi's fourier_0.8 routines [7] and [8].

### Otsu

Otsu's threshold clustering algorithm searches for the threshold that minimizes the intra-class variance, defined as a weighted sum of variances of the two classes.

- Otsu, N (1979), "A threshold selection method from gray-level histograms",
*IEEE Trans. Sys., Man., Cyber.***9**: 62-66, doi:10.1109/TSMC.1979.4310076, <http://ieeexplore.ieee.org/xpl/freeabs_all.jsp?&arnumber=4310076>

See also the Wikipedia article on Otsu's method.

Ported from C++ code by Jordan Bevik.

### Percentile

Assumes the fraction of foreground pixels to be 0.5.

- Doyle, W (1962), "Operation useful for similarity-invariant pattern recognition",
*Journal of the Association for Computing Machinery***9**: 259-267, doi:10.1145/321119.321123, <http://portal.acm.org/citation.cfm?id=321119.321123>

Ported from Antti Niemistö's MATLAB code. See here for an excellent slide presentation and the original MATLAB code.

### RenyiEntropy

Similar to the **MaxEntropy** method, but using Renyi's entropy instead.

- Kapur, JN; Sahoo, PK & Wong, ACK (1985), "A New Method for Gray-Level Picture Thresholding Using the Entropy of the Histogram",
*Graphical Models and Image Processing***29(3)**: 273-285

Ported from ME Celebi's fourier_0.8 routines [9] and [10].

### Shanbhag

Shanbhag, Abhijit G. (1994), "Utilization of information measure as a means of image thresholding", *Graph. Models Image Process.* (Academic Press, Inc.) **56** (5): 414--419, ISSN 1049-9652, DOI 10.1006/cgip.1994.1037

Ported from ME Celebi's fourier_0.8 routines [11] and [12].

### Triangle

This is an implementation of the Triangle method:

- Zack GW, Rogers WE, Latt SA (1977), "Automatic measurement of sister chromatid exchange frequency",
*J. Histochem. Cytochem.***25**(7): 741–53, PMID 70454, <http://www.jhc.org/cgi/pmidlookup?view=long&pmid=70454>

Modified from Johannes Schindelin's plugin Triangle_Algorithm.

See also: http://www.ph.tn.tudelft.nl/Courses/FIP/noframes/fip-Segmenta.html#Heading118

The Triangle algorithm, a geometric method, cannot tell whether the data is skewed to one side or another, but assumes a maximum peak (mode) near one end of the histogram and searches towards the other end. This causes a problem in the absence of information of the type of image to be processed, or when the maximum is not near one of the histogram extremes (resulting in two possible threshold regions between that max and the extremes). Here the algorithm was extended to find on which side of the max peak the data goes the furthest and searches for the threshold within that largest range.

### Yen

Implements Yen's thresholding method from:

- Yen JC, Chang FJ, Chang S (1995), "A New Criterion for Automatic Multilevel Thresholding",
*IEEE Trans. on Image Processing***4**(3): 370-378, ISSN 1057-7149, doi:10.1109/83.366472, <http://ieeexplore.ieee.org/xpl/freeabs_all.jsp?arnumber=366472>

- Sezgin, M & Sankur, B (2004), "Survey over Image Thresholding Techniques and Quantitative Performance Evaluation",
*Journal of Electronic Imaging***13(1)**: 146-165, <http://citeseer.ist.psu.edu/sezgin04survey.html>