#include <itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h>
Inheritance diagram for itk::Statistics::ScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >:


This generator creates a grey-level co-occurence matrix from a N-D scalar image. This is the first step in texture description a la Haralick. (See Haralick, R.M., K. Shanmugam and I. Dinstein. 1973. Textural Features for Image Classification. IEEE Transactions on Systems, Man and Cybernetics. SMC-3(6):610-620. See also Haralick, R.M. 1979. Statistical and Structural Approaches to Texture. Proceedings of the IEEE, 67:786-804.)
The basic idea is as follows: Given an image and an offset (e.g. (1, -1) for a 2-d image), grey-level co-occurences are pairs of intensity values for a specific pixel and the pixel at that offset from the specified pixel. These co-occurences can provide information about the visual texture of an image region -- for example, an eight-bit image of alternating pixel-wide white and black vertical lines would have a large number of (0, 255) and (255, 0) co-occurences for offset (1, 0).
The offset (or offsets) along which the co-occurences are calculated can be set by the user. Traditionally, only one offset is used per histogram, and offset components in the range [-1, 1] are used. For rotation-invariant features, averages of features computed over several histograms with different offsets are generally used, instead of computing features from one histogram created with several offsets. Additionally, instead of using offsets of two or more pixels in any direction, multy-resulution techniques (e.g. image pyramids) are generally used to deal with texture at different spatial resolutions.
This class calculates a 2-d histogram of all the co-occurence pairs in the given image's requested region, for a given set of offsets. That is, if a given offset falls outside of the requested region at a particular point, that co-occurrence pair will not be added to the matrix.
The number of histogram bins on each axis can be set (defaults to 256). Also, by default the histogram min and max corresponds to the largest and smallest possible pixel value of that pixel type. To customize the histogram bounds for a given image, the max and min pixel values that will be placed in the histogram can be set manually. NB: The min and max are INCLUSIVE.
Further, the type of histogram frequency container used is an optional template parameter. By default, a dense container is used, but for images with little texture or in cases where the user wants more histogram bins, a sparse container can be used for the histogram instead.
WARNING: This probably won't work for pixels of double or long-double type unless you set the histogram min and max manually. This is because the largest histogram bin by default has max value of the largest possible pixel value plus 1. For double and long-double types, whose "RealType" as defined by the NumericTraits class is the same, and thus cannot hold any larger values, this would cause a float overflow.
Definition at line 92 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h.
Public Types | |
| typedef SmartPointer< const Self > | ConstPointer |
| typedef HistogramType::ConstPointer | HistogramConstPointer |
| typedef HistogramType::Pointer | HistogramPointer |
| typedef Histogram< MeasurementType, 2, THistogramFrequencyContainer > | HistogramType |
| typedef ImageType::ConstPointer | ImageConstPointer |
| typedef ImageType::Pointer | ImagePointer |
| typedef TImageType | ImageType |
| typedef NumericTraits< PixelType >::RealType | MeasurementType |
| typedef HistogramType::MeasurementVectorType | MeasurementVectorType |
| typedef ImageType::OffsetType | OffsetType |
| typedef VectorContainer< unsigned char, OffsetType > | OffsetVector |
| typedef OffsetVector::ConstPointer | OffsetVectorConstPointer |
| typedef OffsetVector::Pointer | OffsetVectorPointer |
| typedef ImageType::PixelType | PixelType |
| typedef SmartPointer< Self > | Pointer |
| typedef ImageType::SizeType | RadiusType |
| typedef ImageType::RegionType | RegionType |
| typedef ScalarImageToGreyLevelCooccurrenceMatrixGenerator | Self |
| typedef Object | Superclass |
Public Member Functions | |
| void | Compute (void) |
| virtual LightObject::Pointer | CreateAnother () const |
| virtual void | DebugOff () const |
| virtual void | DebugOn () const |
| virtual void | Delete () |
| Command * | GetCommand (unsigned long tag) |
| bool | GetDebug () const |
| virtual const ImageType * | GetInput () |
| virtual PixelType | GetMax () |
| const MetaDataDictionary & | GetMetaDataDictionary (void) const |
| MetaDataDictionary & | GetMetaDataDictionary (void) |
| virtual PixelType | GetMin () |
| virtual unsigned long | GetMTime () const |
| virtual const char * | GetNameOfClass () const |
| virtual bool | GetNormalize () |
| virtual unsigned int | GetNumberOfBinsPerAxis () |
| virtual const OffsetVector * | GetOffsets () |
| virtual HistogramType * | GetOutput () |
| virtual int | GetReferenceCount () const |
| bool | HasObserver (const EventObject &event) const |
| Set the calculator to normalize the | histogram (divide all bins by the total frequency).Normalization is off by default.*/virtual void SetNormalize(bool _arg) |
| void | InvokeEvent (const EventObject &) const |
| void | InvokeEvent (const EventObject &) |
| itkStaticConstMacro (DefaultBinsPerAxis, unsigned int, 256) | |
| Set the min and | max (inclusive) pixel value that will be placed in the histogram */void SetPixelValueMinMax(PixelType min |
| virtual void | Modified () const |
| virtual void | NormalizeOff () |
| virtual void | NormalizeOn () |
| void | Print (std::ostream &os, Indent indent=0) const |
| virtual void | Register () const |
| void | RemoveAllObservers () |
| void | RemoveObserver (unsigned long tag) |
| void | SetDebug (bool debugFlag) const |
| Connects the input image for which the histogram is going to be computed *virtual void | SetInput (const ImageType *_arg) |
| void | SetMetaDataDictionary (const MetaDataDictionary &rhs) |
| Set number of histogram bins along each axis *virtual void | SetNumberOfBinsPerAxis (unsigned int _arg) |
| void | SetOffset (const OffsetType offset) |
| Set the offset or offsets over which the co occurrence pairs will be computed Calling either of these methods clears the previous offsets *virtual void | SetOffsets (const OffsetVector *_arg) |
| virtual void | SetReferenceCount (int) |
| virtual void | UnRegister () const |
Static Public Member Functions | |
| static void | BreakOnError () |
| static bool | GetGlobalWarningDisplay () |
| static void | GlobalWarningDisplayOff () |
| static void | GlobalWarningDisplayOn () |
| static Pointer | New () |
| This is a global flag that controls whether any warning *or error messages are displayed *static void | SetGlobalWarningDisplay (bool flag) |
Public Attributes | |
| Allow people to add remove invoke observers(callbacks) to any ITK *object.This is an implementation of the subject/observer design *pattern.An observer is added by specifying an event to respond to *and an itk unsigned lon | AddObserver )(const EventObject &event, Command *) const |
| This is a global flag that controls whether any | debug |
| Set the min and PixelType | max |
Protected Member Functions | |
| virtual void | FillHistogram (RadiusType radius, RegionType region) |
| bool | PrintObservers (std::ostream &os, Indent indent) const |
| void | PrintSelf (std::ostream &os, Indent indent) const |
| virtual void | PrintTrailer (std::ostream &os, Indent indent) const |
| ScalarImageToGreyLevelCooccurrenceMatrixGenerator () | |
| virtual | ~ScalarImageToGreyLevelCooccurrenceMatrixGenerator () |
Protected Attributes | |
| int | m_ReferenceCount |
| SimpleFastMutexLock | m_ReferenceCountLock |
| Methods invoked by virtual Print() to print information about the object *including superclasses.Typically not called by the user(use Print()*instead) but used in the hierarchical print process to combine the *output of several classes.*/virtual void PrintSelf(std voi | PrintHeader )(std::ostream &os, Indent indent) const |
|
|||||
|
Reimplemented from itk::Object. Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 99 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 123 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 122 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 121 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 109 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 108 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 105 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 118 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 124 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 113 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 114 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 116 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 115 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 110 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Reimplemented from itk::Object. Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 98 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 112 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 111 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Standard typedefs Reimplemented from itk::Object. Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 96 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||
|
Reimplemented from itk::Object. Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. Definition at line 97 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|||||||||
|
|
|
|||||||||
|
Definition at line 174 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|
This method is called when itkExceptionMacro executes. It allows the debugger to break on error. |
|
||||||||||
|
Triggers the Computation of the histogram |
|
|
Create an object from an instance, potentially deferring to a factory. This method allows you to create an instance of an object that is exactly the same type as the referring object. This is useful in cases where an object has been cast back to a base class. Reimplemented from itk::LightObject. |
|
|
Turn debugging output off. |
|
|
Turn debugging output on. |
|
|
Delete an itk object. This method should always be used to delete an object when the new operator was used to create it. Using the C delete method will not work with reference counting. |
|
||||||||||||||||
|
Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. |
|
|
Get the command associated with the given tag. NOTE: This returns a pointer to a Command, but it is safe to asign this to a Command::Pointer. Since Command inherits from LightObject, at this point in the code, only a pointer or a reference to the Command can be used. |
|
|
Get the value of the debug flag. |
|
|
|
|
|||||||||
|
|
|
|||||||||
|
|
|
|
|
|
|
|
|
|||||||||
|
|
|
|
|||||||||
|
Run-time type information (and related methods). Reimplemented from itk::Object. Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. |
|
|||||||||
|
|
|
|||||||||
|
|
|
|||||||||
|
|
|
|||||||||
|
Return the histogram.
|
|
|
Gets the reference count on this object. Definition at line 98 of file itkLightObject.h. |
|
|
Definition at line 100 of file itkObject.h. References itk::Object::SetGlobalWarningDisplay(). |
|
|
Definition at line 98 of file itkObject.h. References itk::Object::SetGlobalWarningDisplay(). |
|
|
Return true if an observer is registered for this event. |
|
||||||||||
|
|
|
|
Call Execute on all the Commands observing this event id. The actions triggered by this call doesn't modify this object. |
|
|
Call Execute on all the Commands observing this event id. |
|
||||||||||||||||||||
|
|
|
||||||||||
|
|
|
|
|||||||||
|
standard New() method support Reimplemented from itk::Object. Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. |
|
|||||||||
|
|
|
|||||||||
|
|
|
||||||||||||
|
Cause the object to print itself out. |
|
||||||||||||
|
|
|
||||||||||||||||
|
Methods invoked by Print() to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes. Reimplemented from itk::Object. Reimplemented in itk::Statistics::MaskedScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >. |
|
||||||||||||
|
|
|
|
Increase the reference count (mark as used by another object). Reimplemented from itk::LightObject. |
|
|
Remove all observers . |
|
|
Remove the observer with this tag value. |
|
|
Set the value of the debug flag. A non-zero value turns debugging on. |
|
|
Referenced by itk::Object::GlobalWarningDisplayOff(), and itk::Object::GlobalWarningDisplayOn(). |
|
||||||||||
|
|
|
|
|
|
||||||||||
|
|
|
||||||||||
|
||||||||||
|
Referenced by itk::Statistics::ScalarImageToGreyLevelCooccurrenceMatrixGenerator< TImageType, THistogramFrequencyContainer >::SetOffset(). |
|
|
Sets the reference count (use with care) Reimplemented from itk::LightObject. |
|
|
Decrease the reference count (release by another object). Reimplemented from itk::LightObject. |
|
|
|
|
|
Definition at line 94 of file itkObject.h. |
|
|
Number of uses of this object by other objects. Definition at line 119 of file itkLightObject.h. |
|
|
Mutex lock to protect modification to the reference count Definition at line 122 of file itkLightObject.h. |
|
|||||
|
Definition at line 160 of file itkScalarImageToGreyLevelCooccurrenceMatrixGenerator.h. |
|
|
|
1.4.2 written by Dimitri van Heesch,
© 1997-2000