ITK
4.3.0
Insight Segmentation and Registration Toolkit
|
#include <itkRelabelComponentImageFilter.h>
Relabel the components in an image such that consecutive labels are used.
RelabelComponentImageFilter remaps the labels associated with the objects in an image (as from the output of ConnectedComponentImageFilter) such that the label numbers are consecutive with no gaps between the label numbers used. By default, the relabeling will also sort the labels based on the size of the object: the largest object will have label #1, the second largest will have label #2, etc.
Label #0 is assumed to be background is left unaltered by the relabeling.
RelabelComponentImageFilter is typically used on the output of the ConnectedComponentImageFilter for those applications that want to extract the largest object or the "k" largest objects. Any particular object can be extracted from the relabeled output using a BinaryThresholdImageFilter. A group of objects can be extracted from the relabled output using a ThresholdImageFilter.
Once all the objects are relabeled, the application can query the number of objects and the size of each object. Object sizes are returned in a vector. The size of the background is not calculated. So the size of object #1 is GetSizeOfObjectsInPixels()[0], the size of object #2 is GetSizeOfObjectsInPixels()[1], etc.
If user sets a minimum object size, all objects with fewer pixelss than the minimum will be discarded, so that the number of objects reported will be only those remaining. The GetOriginalNumberOfObjects method can be called to find out how many objects were present before the small ones were discarded.
RelabelComponentImageFilter can be run as an "in place" filter, where it will overwrite its output. The default is run out of place (or generate a separate output). "In place" operation can be controlled via methods in the superclass, InPlaceImageFilter::InPlaceOn() and InPlaceImageFilter::InPlaceOff().
Definition at line 79 of file itkRelabelComponentImageFilter.h.
Classes | |
struct | RelabelComponentObjectType |
class | RelabelComponentSizeInPixelsComparator |
Static Public Member Functions | |
static Pointer | New () |
Private Member Functions | |
void | operator= (const Self &) |
RelabelComponentImageFilter (const Self &) | |
Private Attributes | |
ObjectSizeType | m_MinimumObjectSize |
LabelType | m_NumberOfObjects |
LabelType | m_NumberOfObjectsToPrint |
LabelType | m_OriginalNumberOfObjects |
ObjectSizeInPhysicalUnitsContainerType | m_SizeOfObjectsInPhysicalUnits |
ObjectSizeInPixelsContainerType | m_SizeOfObjectsInPixels |
typedef TOutputImage::PixelType | OutputPixelType |
typedef TOutputImage::InternalPixelType | OutputInternalPixelType |
typedef TInputImage::PixelType | InputPixelType |
typedef TInputImage::InternalPixelType | InputInternalPixelType |
static const unsigned int | ImageDimension = TOutputImage::ImageDimension |
static const unsigned int | InputImageDimension = TInputImage::ImageDimension |
Additional Inherited Members | |
Static Public Attributes inherited from itk::InPlaceImageFilter< TInputImage, TOutputImage > | |
static const unsigned int | InputImageDimension = TInputImage::ImageDimension |
static const unsigned int | OutputImageDimension = TOutputImage::ImageDimension |
Protected Types inherited from itk::ImageToImageFilter< TInputImage, TOutputImage > | |
typedef ImageToImageFilterDetail::ImageRegionCopier < itkGetStaticConstMacro(OutputImageDimension), itkGetStaticConstMacro(InputImageDimension) > | InputToOutputRegionCopierType |
typedef ImageToImageFilterDetail::ImageRegionCopier < itkGetStaticConstMacro(InputImageDimension), itkGetStaticConstMacro(OutputImageDimension) > | OutputToInputRegionCopierType |
Static Protected Member Functions inherited from itk::ImageSource< TOutputImage > | |
static ITK_THREAD_RETURN_TYPE | ThreaderCallback (void *arg) |
Protected Attributes inherited from itk::ProcessObject | |
TimeStamp | m_OutputInformationMTime |
bool | m_Updating |
typedef SmartPointer< const Self > itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::ConstPointer |
Definition at line 121 of file itkRelabelComponentImageFilter.h.
typedef TInputImage::IndexType itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::IndexType |
Definition at line 113 of file itkRelabelComponentImageFilter.h.
typedef Superclass::InputImagePointer itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::InputImagePointer |
Types from the Superclass
Definition at line 92 of file itkRelabelComponentImageFilter.h.
typedef TInputImage itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::InputImageType |
Image typedef support
Definition at line 111 of file itkRelabelComponentImageFilter.h.
typedef TInputImage::InternalPixelType itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::InputInternalPixelType |
Extract some information from the image types. Dimensionality of the two images is assumed to be the same.
Definition at line 101 of file itkRelabelComponentImageFilter.h.
typedef TInputImage::PixelType itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::InputPixelType |
Extract some information from the image types. Dimensionality of the two images is assumed to be the same.
Definition at line 100 of file itkRelabelComponentImageFilter.h.
typedef IdentifierType itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::LabelType |
Type used as identifier for the different component lables.
Definition at line 131 of file itkRelabelComponentImageFilter.h.
typedef std::vector< float > itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::ObjectSizeInPhysicalUnitsContainerType |
Definition at line 144 of file itkRelabelComponentImageFilter.h.
typedef std::vector< ObjectSizeType > itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::ObjectSizeInPixelsContainerType |
Definition at line 141 of file itkRelabelComponentImageFilter.h.
typedef SizeValueType itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::ObjectSizeType |
Type used to count number of pixels in objects.
Definition at line 137 of file itkRelabelComponentImageFilter.h.
typedef TOutputImage itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::OutputImageType |
Definition at line 112 of file itkRelabelComponentImageFilter.h.
typedef TOutputImage::InternalPixelType itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::OutputInternalPixelType |
Extract some information from the image types. Dimensionality of the two images is assumed to be the same.
Definition at line 99 of file itkRelabelComponentImageFilter.h.
typedef TOutputImage::PixelType itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::OutputPixelType |
Extract some information from the image types. Dimensionality of the two images is assumed to be the same.
Definition at line 98 of file itkRelabelComponentImageFilter.h.
typedef SmartPointer< Self > itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::Pointer |
Smart pointer typedef support
Definition at line 120 of file itkRelabelComponentImageFilter.h.
typedef TOutputImage::RegionType itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::RegionType |
Definition at line 115 of file itkRelabelComponentImageFilter.h.
typedef RelabelComponentImageFilter itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::Self |
Standard "Self" & Superclass typedef.
Definition at line 86 of file itkRelabelComponentImageFilter.h.
typedef TInputImage::SizeType itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::SizeType |
Definition at line 114 of file itkRelabelComponentImageFilter.h.
typedef InPlaceImageFilter< TInputImage, TOutputImage > itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::Superclass |
Definition at line 87 of file itkRelabelComponentImageFilter.h.
|
inlineprotected |
End concept checking
Definition at line 248 of file itkRelabelComponentImageFilter.h.
|
inlineprotectedvirtual |
Definition at line 252 of file itkRelabelComponentImageFilter.h.
|
private |
|
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 |
Standard pipeline method.
Reimplemented from itk::ImageSource< TOutputImage >.
|
protectedvirtual |
RelabelComponentImageFilter needs the entire input. Therefore it must provide an implementation GenerateInputRequestedRegion().
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
|
virtual |
Get the caller-defined minimum size of an object in pixels. If the caller has not set the minimum, 0 will be returned, which is to be interpreted as meaning that no minimum exists, and all objects in the original label map will be passed through to the output.
|
virtual |
Run-time type information (and related methods)
Reimplemented from itk::InPlaceImageFilter< TInputImage, TOutputImage >.
|
virtual |
Get the number of objects in the image. This information is only valid after the filter has executed.
|
virtual |
Get/Set the number of objects enumerated and described when the filter is printed.
|
virtual |
Get the original number of objects in the image before small objects were discarded. This information is only valid after the filter has executed. If the caller has not specified a minimum object size, OriginalNumberOfObjects is the same as NumberOfObjects.
|
inline |
Get the size of a particular object in physical space (in units of pixel size). This information is only valid after the filter has executed. Size of the background (object #0) is not calculated.
Definition at line 217 of file itkRelabelComponentImageFilter.h.
|
inline |
Get the size of a particular object in pixels. This information is only valid after the filter has executed. Size of the background (object #0) is not calculated.
Definition at line 201 of file itkRelabelComponentImageFilter.h.
|
inline |
Get the size of each object in physical space (in units of pixel size). This information is only valid after the filter has executed. Size of the background is not calculated. Size of object #1 is GetSizeOfObjectsInPhysicalUnits()[0]. Size of object #2 is GetSizeOfObjectsInPhysicalUnits()[1]. Etc.
Definition at line 191 of file itkRelabelComponentImageFilter.h.
|
inline |
Get the size of each object in pixels. This information is only valid after the filter has executed. Size of the background is not calculated. Size of object #1 is GetSizeOfObjectsInPixels()[0]. Size of object #2 is GetSizeOfObjectsInPixels()[1]. Etc.
Definition at line 179 of file itkRelabelComponentImageFilter.h.
|
static |
Method for creation through the object factory.
|
private |
|
protectedvirtual |
Standard printself method
Reimplemented from itk::InPlaceImageFilter< TInputImage, TOutputImage >.
|
virtual |
Set the minimum size in pixels for an object. All objects smaller than this size will be discarded and will not appear in the output label map. NumberOfObjects will count only the objects whose pixel counts are greater than or equal to the minimum size. Call GetOriginalNumberOfObjects to find out how many objects were present in the original label map.
|
virtual |
Get/Set the number of objects enumerated and described when the filter is printed.
itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::typedef | ( | Concept::EqualityComparable< InputPixelType > | ) |
Begin concept checking This class requires InputEqualityComparableCheck in the form of ( Concept::EqualityComparable< InputPixelType > )
itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::typedef | ( | Concept::Convertible< LabelType, InputPixelType > | ) |
This class requires UnsignedLongConvertibleToInputCheck in the form of ( Concept::Convertible< LabelType, InputPixelType > )
itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::typedef | ( | Concept::Convertible< OutputPixelType, LabelType > | ) |
This class requires OutputLongConvertibleToUnsignedLongCheck in the form of ( Concept::Convertible< OutputPixelType, LabelType > )
itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::typedef | ( | Concept::Convertible< InputPixelType, OutputPixelType > | ) |
This class requires InputConvertibleToOutputCheck in the form of ( Concept::Convertible< InputPixelType, OutputPixelType > )
itk::RelabelComponentImageFilter< TInputImage, TOutputImage >::typedef | ( | Concept::SameDimension< InputImageDimension, ImageDimension > | ) |
This class requires SameDimensionCheck in the form of ( Concept::SameDimension< InputImageDimension, ImageDimension > )
|
static |
Extract some information from the image types. Dimensionality of the two images is assumed to be the same.
Definition at line 103 of file itkRelabelComponentImageFilter.h.
|
static |
Extract some information from the image types. Dimensionality of the two images is assumed to be the same.
Definition at line 105 of file itkRelabelComponentImageFilter.h.
|
private |
Definition at line 308 of file itkRelabelComponentImageFilter.h.
|
private |
Definition at line 305 of file itkRelabelComponentImageFilter.h.
|
private |
Definition at line 306 of file itkRelabelComponentImageFilter.h.
|
private |
Definition at line 307 of file itkRelabelComponentImageFilter.h.
|
private |
Definition at line 311 of file itkRelabelComponentImageFilter.h.
|
private |
Definition at line 310 of file itkRelabelComponentImageFilter.h.