#include <itkScalarImageToCooccurrenceMatrixFilter.h>
This class computes a co-occurrence matrix (histogram) from a given image and a mask image if provided. Cooccurrence matrices are used for image texture description.
This filters creates a grey-level co-occurrence matrix from a N-D scalar image. This is the first step in texture description a la Haralick. (See [47] and [48].
The basic idea is as follows: Given an image and an offset (e.g. (1, -1) for a 2-d image), grey-level co-occurrences are pairs of intensity values for a specific pixel and the pixel at that offset from the specified pixel. These co-occurrences 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-occurrences for offset (1, 0).
The offset (or offsets) along which the co-occurrences 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, multi-resolution 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-occurrence 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 93 of file itkScalarImageToCooccurrenceMatrixFilter.h.
Static Public Member Functions | |
static Pointer | New () |
![]() | |
static bool | GetGlobalWarningDisplay () |
static void | GlobalWarningDisplayOff () |
static void | GlobalWarningDisplayOn () |
static Pointer | New () |
static void | SetGlobalWarningDisplay (bool val) |
![]() | |
static void | BreakOnError () |
static Pointer | New () |
Static Public Attributes | |
static constexpr unsigned int | DefaultBinsPerAxis = 256 |
Protected Types | |
using | DataObjectPointer = DataObject::Pointer |
using | DataObjectPointerArraySizeType = ProcessObject::DataObjectPointerArraySizeType |
Private Member Functions | |
void | NormalizeHistogram () |
Private Attributes | |
MaskPixelType | m_InsidePixelValue {} |
MeasurementVectorType | m_LowerBound {} |
PixelType | m_Max {} |
PixelType | m_Min {} |
bool | m_Normalize {} |
unsigned int | m_NumberOfBinsPerAxis {} |
OffsetVectorConstPointer | m_Offsets {} |
MeasurementVectorType | m_UpperBound {} |
Additional Inherited Members | |
![]() | |
template<typename TSourceObject> | |
static void | MakeRequiredOutputs (TSourceObject &sourceObject, const DataObjectPointerArraySizeType numberOfRequiredOutputs) |
static constexpr float | progressFixedToFloat (uint32_t fixed) |
static uint32_t | progressFloatToFixed (float f) |
![]() | |
TimeStamp | m_OutputInformationMTime {} |
bool | m_Updating {} |
![]() | |
std::atomic< int > | m_ReferenceCount {} |
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::ConstPointer = SmartPointer<const Self> |
Definition at line 102 of file itkScalarImageToCooccurrenceMatrixFilter.h.
|
protected |
Standard itk::ProcessObject subclass method.
Definition at line 201 of file itkScalarImageToCooccurrenceMatrixFilter.h.
|
protected |
Definition at line 203 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::HistogramConstPointer = typename HistogramType::ConstPointer |
Definition at line 129 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::HistogramPointer = typename HistogramType::Pointer |
Definition at line 128 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::HistogramType = Histogram<MeasurementType, THistogramFrequencyContainer> |
Definition at line 127 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::ImageConstPointer = typename ImageType::ConstPointer |
Definition at line 112 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::ImagePointer = typename ImageType::Pointer |
Definition at line 111 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::ImageType = TImageType |
Definition at line 110 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::MaskConstPointer = typename MaskImageType::ConstPointer |
Definition at line 122 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::MaskImageType = TMaskImageType |
Definition at line 120 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::MaskPixelType = typename MaskImageType::PixelType |
Definition at line 123 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::MaskPointer = typename MaskImageType::Pointer |
Definition at line 121 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::MeasurementType = typename NumericTraits<PixelType>::RealType |
Definition at line 125 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::MeasurementVectorType = typename HistogramType::MeasurementVectorType |
Definition at line 130 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::OffsetType = typename ImageType::OffsetType |
Definition at line 116 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::OffsetVector = VectorContainer<unsigned char, OffsetType> |
Definition at line 117 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::OffsetVectorConstPointer = typename OffsetVector::ConstPointer |
Definition at line 119 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::OffsetVectorPointer = typename OffsetVector::Pointer |
Definition at line 118 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::PixelType = typename ImageType::PixelType |
Definition at line 113 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::Pointer = SmartPointer<Self> |
Definition at line 101 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::RadiusType = typename ImageType::SizeType |
Definition at line 115 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::RegionType = typename ImageType::RegionType |
Definition at line 114 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::Self = ScalarImageToCooccurrenceMatrixFilter |
Standard type alias
Definition at line 99 of file itkScalarImageToCooccurrenceMatrixFilter.h.
using itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::Superclass = ProcessObject |
Definition at line 100 of file itkScalarImageToCooccurrenceMatrixFilter.h.
|
protected |
|
overrideprotecteddefault |
|
virtual |
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::Object.
|
protectedvirtual |
|
protectedvirtual |
|
overrideprotectedvirtual |
This method causes the filter to generate its output.
Reimplemented from itk::ProcessObject.
const ImageType * itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::GetInput | ( | ) | const |
|
virtual |
Set the pixel value of the mask that should be considered "inside" the object. Defaults to one.
const MaskImageType * itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::GetMaskImage | ( | ) | const |
|
virtual |
|
virtual |
|
overridevirtual |
Reimplemented from itk::ProcessObject.
|
virtual |
Set the calculator to normalize the histogram (divide all bins by the total frequency). Normalization is off by default.
|
virtual |
Set number of histogram bins along each axis
|
virtual |
Get/Set the offset or offsets over which the co-occurrence pairs will be computed. Calling either of these methods clears the previous offsets.
const HistogramType * itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::GetOutput | ( | ) | const |
method to get the Histogram
|
protectedvirtual |
Make a DataObject of the correct type to used as the specified output.
Every ProcessObject subclass must be able to create a DataObject that can be used as a specified output. This method is automatically called when DataObject::DisconnectPipeline() is called. DataObject::DisconnectPipeline, disconnects a data object from being an output of its current source. When the data object is disconnected, the ProcessObject needs to construct a replacement output data object so that the ProcessObject is in a valid state. So DataObject::DisconnectPipeline eventually calls ProcessObject::MakeOutput. Note that MakeOutput always returns a itkSmartPointer to a DataObject. ImageSource and MeshSource override this method to create the correct type of image and mesh respectively. If a filter has multiple outputs of different types, then that filter must provide an implementation of MakeOutput().
Reimplemented from itk::ProcessObject.
|
overrideprotectedvirtual |
Make a DataObject of the correct type to used as the specified output.
Every ProcessObject subclass must be able to create a DataObject that can be used as a specified output. This method is automatically called when DataObject::DisconnectPipeline() is called. DataObject::DisconnectPipeline, disconnects a data object from being an output of its current source. When the data object is disconnected, the ProcessObject needs to construct a replacement output data object so that the ProcessObject is in a valid state. So DataObject::DisconnectPipeline eventually calls ProcessObject::MakeOutput. Note that MakeOutput always returns a itkSmartPointer to a DataObject. ImageSource and MeshSource override this method to create the correct type of image and mesh respectively. If a filter has multiple outputs of different types, then that filter must provide an implementation of MakeOutput().
Reimplemented from itk::ProcessObject.
|
static |
standard New() method support
|
private |
|
virtual |
Set the calculator to normalize the histogram (divide all bins by the total frequency). Normalization is off by default.
|
virtual |
Set the calculator to normalize the histogram (divide all bins by the total frequency). Normalization is off by default.
|
overrideprotectedvirtual |
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::ProcessObject.
|
virtual |
Method to set/get the image
Reimplemented from itk::ProcessObject.
void itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::SetInput | ( | const ImageType * | image | ) |
|
virtual |
Set the pixel value of the mask that should be considered "inside" the object. Defaults to one.
void itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::SetMaskImage | ( | const MaskImageType * | image | ) |
Method to set/get the mask image
|
virtual |
Set the calculator to normalize the histogram (divide all bins by the total frequency). Normalization is off by default.
|
virtual |
Set number of histogram bins along each axis
void itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::SetOffset | ( | const OffsetType | offset | ) |
|
virtual |
Get/Set the offset or offsets over which the co-occurrence pairs will be computed. Calling either of these methods clears the previous offsets.
void itk::Statistics::ScalarImageToCooccurrenceMatrixFilter< TImageType, THistogramFrequencyContainer, TMaskImageType >::SetPixelValueMinMax | ( | PixelType | min, |
PixelType | max ) |
Set the min and max (inclusive) pixel value that will be placed in the histogram
|
staticconstexpr |
Definition at line 132 of file itkScalarImageToCooccurrenceMatrixFilter.h.
|
private |
Definition at line 225 of file itkScalarImageToCooccurrenceMatrixFilter.h.
|
private |
Definition at line 221 of file itkScalarImageToCooccurrenceMatrixFilter.h.
|
private |
Definition at line 218 of file itkScalarImageToCooccurrenceMatrixFilter.h.
|
private |
Definition at line 217 of file itkScalarImageToCooccurrenceMatrixFilter.h.
|
private |
Definition at line 223 of file itkScalarImageToCooccurrenceMatrixFilter.h.
|
private |
Definition at line 220 of file itkScalarImageToCooccurrenceMatrixFilter.h.
|
private |
Definition at line 216 of file itkScalarImageToCooccurrenceMatrixFilter.h.
|
private |
Definition at line 222 of file itkScalarImageToCooccurrenceMatrixFilter.h.