1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114
|
/*=========================================================================
Program: Insight Segmentation & Registration Toolkit
Module: $RCSfile: itkOtsuThresholdImageCalculator.h,v $
Language: C++
Date: $Date: 2006-03-28 23:46:10 $
Version: $Revision: 1.7 $
Copyright (c) Insight Software Consortium. All rights reserved.
See ITKCopyright.txt or http://www.itk.org/HTML/Copyright.htm for details.
This software is distributed WITHOUT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the above copyright notices for more information.
=========================================================================*/
#ifndef __itkOtsuThresholdImageCalculator_h
#define __itkOtsuThresholdImageCalculator_h
#include "itkObject.h"
#include "itkObjectFactory.h"
#include "itkNumericTraits.h"
namespace itk
{
/** \class OtsuThresholdImageCalculator
* \brief Computes the Otsu's threshold for an image.
*
* This calculator computes the Otsu's threshold which separates an image
* into foreground and background components. The method relies on a
* histogram of image intensities. The basic idea is to maximize the
* between-class variance.
*
* This class is templated over the input image type.
*
* \warning This method assumes that the input image consists of scalar pixel
* types.
*
* \ingroup Operators
*/
template <class TInputImage>
class ITK_EXPORT OtsuThresholdImageCalculator : public Object
{
public:
/** Standard class typedefs. */
typedef OtsuThresholdImageCalculator Self;
typedef Object Superclass;
typedef SmartPointer<Self> Pointer;
typedef SmartPointer<const Self> ConstPointer;
/** Method for creation through the object factory. */
itkNewMacro(Self);
/** Run-time type information (and related methods). */
itkTypeMacro(OtsuThresholdImageCalculator, Object);
/** Type definition for the input image. */
typedef TInputImage ImageType;
/** Pointer type for the image. */
typedef typename TInputImage::Pointer ImagePointer;
/** Const Pointer type for the image. */
typedef typename TInputImage::ConstPointer ImageConstPointer;
/** Type definition for the input image pixel type. */
typedef typename TInputImage::PixelType PixelType;
/** Type definition for the input image region type. */
typedef typename TInputImage::RegionType RegionType;
/** Set the input image. */
itkSetConstObjectMacro(Image,ImageType);
/** Compute the Otsu's threshold for the input image. */
void Compute(void);
/** Return the Otsu's threshold value. */
itkGetMacro(Threshold,PixelType);
/** Set/Get the number of histogram bins. Default is 128. */
itkSetClampMacro( NumberOfHistogramBins, unsigned long, 1,
NumericTraits<unsigned long>::max() );
itkGetMacro( NumberOfHistogramBins, unsigned long );
/** Set the region over which the values will be computed */
void SetRegion( const RegionType & region );
protected:
OtsuThresholdImageCalculator();
virtual ~OtsuThresholdImageCalculator() {};
void PrintSelf(std::ostream& os, Indent indent) const;
private:
OtsuThresholdImageCalculator(const Self&); //purposely not implemented
void operator=(const Self&); //purposely not implemented
PixelType m_Threshold;
unsigned long m_NumberOfHistogramBins;
ImageConstPointer m_Image;
RegionType m_Region;
bool m_RegionSetByUser;
};
} // end namespace itk
#ifndef ITK_MANUAL_INSTANTIATION
#include "itkOtsuThresholdImageCalculator.txx"
#endif
#endif
|