001/*******************************************************************************
002 * This software is provided as a supplement to the authors' textbooks on digital
003 * image processing published by Springer-Verlag in various languages and editions.
004 * Permission to use and distribute this software is granted under the BSD 2-Clause
005 * "Simplified" License (see http://opensource.org/licenses/BSD-2-Clause).
006 * Copyright (c) 2006-2023 Wilhelm Burger, Mark J. Burge. All rights reserved.
007 * Visit https://imagingbook.com for additional details.
008 ******************************************************************************/
009package Ch09_Automatic_Thresholding;
010
011import ij.IJ;
012import ij.ImagePlus;
013import ij.plugin.filter.PlugInFilter;
014import ij.process.ByteProcessor;
015import ij.process.ImageProcessor;
016import imagingbook.common.threshold.global.GlobalThresholder;
017import imagingbook.common.threshold.global.MinErrorThresholder;
018import imagingbook.core.jdoc.JavaDocHelp;
019import imagingbook.sampleimages.GeneralSampleImage;
020
021import static imagingbook.common.ij.DialogUtils.askForSampleImage;
022import static imagingbook.common.ij.IjUtils.noCurrentImage;
023import static java.lang.Float.isFinite;
024
025/**
026 * <p>
027 * ImageJ plugin showing the use of the {@link MinErrorThresholder} class.
028 * See Sec. 9.1.6 of [1] for additional details.
029 * </p>
030 * <p>
031 * [1] W. Burger, M.J. Burge, <em>Digital Image Processing &ndash; An Algorithmic Introduction</em>,
032 * 3rd ed, Springer (2022).
033 * </p>
034 * 
035 * @author WB
036 * @version 2022/04/02
037 */
038public class Global_MinError implements PlugInFilter, JavaDocHelp {
039        
040        /**
041         * Constructor, asks to open a predefined sample image if no other image
042         * is currently open.
043         */
044        public Global_MinError() {
045                if (noCurrentImage()) {
046                        askForSampleImage(GeneralSampleImage.Kepler);
047                }
048        }
049        
050        @Override
051        public int setup(String arg, ImagePlus imp) {
052                return DOES_8G;
053        }
054
055        @Override
056        public void run(ImageProcessor ip) {
057                ByteProcessor bp = (ByteProcessor) ip;
058                
059                GlobalThresholder thr = new MinErrorThresholder();
060                float q = thr.getThreshold(bp);
061
062                if (isFinite(q)) {
063                        bp.threshold(Math.round(q));
064                }
065                else {
066                        IJ.showMessage("no threshold found");
067                }
068        }
069        
070}
071