ITK: itk::VoronoiSegmentationImageFilter< TInputImage, TOutputImage, TBinaryPriorImage

Graft the specified DataObject onto this ProcessObject's output. This method grabs a handle to the specified DataObject's bulk data to used as its output's own bulk data. It also copies the region ivars (RequestedRegion, BufferedRegion, LargestPossibleRegion) and meta-data (Spacing, Origin) from the specified data object into this filter's output data object. Most importantly, however, it leaves the Source ivar untouched so the original pipeline routing is intact. This method is used when a process object is implemented using a mini-pipeline which is defined in its GenerateData() method. The usage is:

    // setup the mini-pipeline to process the input to this filter
    firstFilterInMiniPipeline->SetInput( this->GetInput() );

    // setup the mini-pipeline to calculate the correct regions
    // and write to the appropriate bulk data block
    lastFilterInMiniPipeline->GraftOutput( this->GetOutput() );

    // execute the mini-pipeline
    lastFilterInMiniPipeline->Update();

    // graft the mini-pipeline output back onto this filter's output.
    // this is needed to get the appropriate regions passed back.
    this->GraftOutput( lastFilterInMiniPipeline->GetOutput() );

itk::VoronoiSegmentationImageFilter< TInputImage, TOutputImage, TBinaryPriorImage > Class Template Reference
[Hybrid Segmentation Filters]

Detailed Description

template<class TInputImage, class TOutputImage, class TBinaryPriorImage = Image<unsigned char,2>>
class itk::VoronoiSegmentationImageFilter< TInputImage, TOutputImage, TBinaryPriorImage >

Public Types

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Types

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation


Public Types
typedef Superclass::BinaryObjectImage	BinaryObjectImage
typedef BinaryObjectImage::Pointer	BinaryObjectImagePointer
typedef VoronoiDiagram::CellAutoPointer	CellAutoPointer
typedef VoronoiDiagram::CellType	CellType
typedef SmartPointer< const Self >	ConstPointer
typedef DataObject::Pointer	DataObjectPointer
typedef std::vector< DataObjectPointer >	DataObjectPointerArray
typedef VoronoiDiagram::VoronoiEdge	EdgeInfo
typedef VoronoiDiagram::VoronoiEdgeIterator	EdgeIterator
typedef Superclass::IndexList	IndexList
typedef Superclass::IndexType	IndexType
typedef TInputImage::ConstPointer	InputImageConstPointer
typedef InputImageType::PixelType	InputImagePixelType
typedef TInputImage::Pointer	InputImagePointer
typedef InputImageType::RegionType	InputImageRegionType
typedef Superclass::InputImageType	InputImageType
typedef VoronoiDiagram::NeighborIdIterator	NeighborIdIterator
typedef OutputImageType::PixelType	OutputImagePixelType
typedef OutputImageType::Pointer	OutputImagePointer
typedef Superclass::OutputImageRegionType	OutputImageRegionType
typedef TOutputImage	OutputImageType
typedef TOutputImage::PixelType	OutputPixelType
typedef TInputImage::PixelType	PixelType
typedef SmartPointer< Self >	Pointer
typedef CellType::PointIdIterator	PointIdIterator
typedef VoronoiDiagram::PointType	PointType
typedef std::deque< PointType >	PointTypeDeque
typedef std::vector< PointType >	PointTypeVector
typedef Superclass::RegionType	RegionType
typedef VoronoiDiagram::SeedsIterator	SeedsIterator
typedef VoronoiDiagram::SeedsType	SeedsType
typedef VoronoiSegmentationImageFilter	Self
typedef TInputImage::SizeType	SizeType
typedef VoronoiSegmentationImageFilterBase< TInputImage, TOutputImage >	Superclass
typedef Image< unsigned char, 2 >	VDImage
typedef VDImage::Pointer	VDImagePointer
typedef VoronoiDiagram2D< double >	VoronoiDiagram
typedef VoronoiDiagram2DGenerator< double >	VoronoiDiagramGenerator
typedef VoronoiDiagram::Pointer	VoronoiPointer
Public Member Functions
virtual void	AbortGenerateDataOff ()
virtual void	AbortGenerateDataOn ()
void	BeforeNextStep (void)
virtual LightObject::Pointer	CreateAnother () const
virtual void	DebugOff () const
virtual void	DebugOn () const
virtual void	Delete ()
void	DrawDiagram (VDImagePointer result, unsigned char incolor, unsigned char outcolor, unsigned char boundcolor)
virtual void	EnlargeOutputRequestedRegion (DataObject *output)
virtual void	GenerateInputRequestedRegion ()
virtual const bool &	GetAbortGenerateData ()
Command *	GetCommand (unsigned long tag)
bool	GetDebug () const
const InputImageType *	GetInput (unsigned int idx)
const InputImageType *	GetInput (void)
DataObjectPointerArray &	GetInputs ()
virtual bool	GetInteractiveSegmentation ()
virtual int	GetLastStepSeeds ()
virtual double	GetMean ()
virtual double	GetMeanDeviation ()
virtual double	GetMeanPercentError ()
virtual double	GetMeanTolerance ()
const MetaDataDictionary &	GetMetaDataDictionary (void) const
MetaDataDictionary &	GetMetaDataDictionary (void)
virtual int	GetMinRegion ()
virtual unsigned long	GetMTime () const
MultiThreader *	GetMultiThreader ()
virtual const char *	GetNameOfClass () const
std::vector< DataObjectPointer >::size_type	GetNumberOfInputs () const
std::vector< DataObjectPointer >::size_type	GetNumberOfOutputs () const
virtual int	GetNumberOfSeeds ()
virtual int	GetNumberOfSeedsToAdded ()
virtual const int &	GetNumberOfThreads ()
virtual std::vector< DataObjectPointer >::size_type	GetNumberOfValidRequiredInputs () const
OutputImageType *	GetOutput (unsigned int idx)
Get the output data of this process object The output of this function is not valid until an appropriate either explicitly or implicitly Both the filter itself and the data object have and both methods update the data Here are three ways to use	GetOutput () and make sure the data is valid.In these *examples
virtual bool	GetOutputBoundary ()
Return an array with all the outputs of this process object This is useful for tracing forward in the pipeline to contruct graphs etc *DataObjectPointerArray &	GetOutputs ()
virtual const float &	GetProgress ()
virtual int	GetReferenceCount () const
virtual const bool &	GetReleaseDataBeforeUpdateFlag ()
virtual bool	GetReleaseDataFlag () const
PointType	GetSeed (int SeedID)
virtual SizeType	GetSize ()
virtual double	GetSTD ()
Set Get the STD percent error *virtual double	GetSTDPercentError ()
virtual double	GetSTDTolerance ()
virtual int	GetSteps ()
virtual bool	GetUseBackgroundInAPrior ()
VoronoiPointer	GetVoronoiDiagram (void)
virtual void	GraftNthOutput (unsigned int idx, DataObject *output)
virtual void	GraftOutput (DataObject *output)
bool	HasObserver (const EventObject &event) const
Get the output data of this process object The output of this function is not valid until an appropriate either explicitly or implicitly Both the filter itself and the data object have and both methods update the data Here are three ways to use a image is a pointer to some Image and the particular ProcessObjects involved are filters The same examples apply to non	image (e.g.Mesh) data as well.*\code anotherFilter->SetInput(someFilter->GetOutput())
virtual void	InteractiveSegmentationOff ()
virtual void	InteractiveSegmentationOn ()
void	InvokeEvent (const EventObject &) const
void	InvokeEvent (const EventObject &)
	itkStaticConstMacro (ImageDimension, unsigned int, TInputImage::ImageDimension)
	itkStaticConstMacro (OutputImageDimension, unsigned int, TOutputImage::ImageDimension)
ImageDimension enumeration *	itkStaticConstMacro (InputImageDimension, unsigned int, TInputImage::ImageDimension)
virtual DataObjectPointer	MakeOutput (unsigned int idx)
Create the output binary result for boundaries *virtual void	MakeSegmentBoundary (void)
virtual void	MakeSegmentObject (void)
virtual void	Modified () const
virtual void	PopBackInput ()
virtual void	PopFrontInput ()
virtual void	PrepareOutputs ()
void	Print (std::ostream &os, Indent indent=0) const
virtual void	PropagateRequestedRegion (DataObject *output)
Push Pop the input of this process object These methods allow a filter to model its input vector as a queue or stack These routines may not be appropriate for all especially filters with different types of inputs These routines follow the semantics of STL *The routines are useful for applications that need to process rolling sets of images For if an application has images and they need to run a filter on then run the filter on then run the filter on the application can accomplish this by popping an input off the front of the input list and push a new image onto the back of input list this only makes sense for filters that single type of input Other uses are also possible For a single input pushing and popping inputs allow the application to temporarily replace an input to a filter *virtual void	PushBackInput (const InputImageType *image)
virtual void	PushFrontInput (const InputImageType *image)
virtual void	Register () const
virtual void	ReleaseDataBeforeUpdateFlagOff ()
virtual void	ReleaseDataBeforeUpdateFlagOn ()
void	ReleaseDataFlagOff ()
void	ReleaseDataFlagOn ()
void	RemoveAllObservers ()
void	RemoveObserver (unsigned long tag)
virtual void	ResetPipeline ()
Set Get the number of iterations to	run (if set to 0:the classification run process runs until no more cells can be divided)./virtual void SetSteps(int _arg)
void	RunSegment (void)
void	RunSegmentOneStep (void)
virtual void	SetAbortGenerateData (bool _arg)
void	SetDebug (bool debugFlag) const
virtual void	SetInput (unsigned int, const TInputImage *image)
Set Get the image input of this process object *virtual void	SetInput (const InputImageType *image)
Output the segmentation on every iteration Useful for iteractive sessions The setting of OutputBoundary determines the type of output *virtual void	SetInteractiveSegmentation (bool _arg)
Set Get the Estimation of the mean pixel value for the object *virtual void	SetMean (double _arg)
Set Get the mean deviation *virtual void	SetMeanDeviation (double _arg)
Set Get the mean percent error *void	SetMeanPercentError (double x)
Set Get the Tolearance of Mean for classifying the regions *virtual void	SetMeanTolerance (double _arg)
void	SetMetaDataDictionary (const MetaDataDictionary &rhs)
Set Get the smallest region to be divided *virtual void	SetMinRegion (int _arg)
Set Get the initial number of seeds for VD *virtual void	SetNumberOfSeeds (int _arg)
Get Set the number of threads to create when executing *virtual void	SetNumberOfThreads (int _arg)
Enable the generation of the output boundary *virtual void	SetOutputBoundary (bool _arg)
virtual void	SetProgress (float _arg)
virtual void	SetReferenceCount (int)
Turn on off the flags to control whether the bulk data belonging to the outputs of this ProcessObject are released after being used by a downstream ProcessObject Default value is off Another options for controlling memory utilization is the ReleaseDataBeforeUpdateFlag *virtual void	SetReleaseDataFlag (bool flag)
Seeds positions are randomly set If you need to set seeds position then use the SetSeeds method after the InitializeSegment method *void	SetSeeds (int num, SeedsIterator begin)
Set Get the region size *virtual void	SetSize (SizeType _arg)
Set Get the estimation of the STD of the pixel value for the object virtual void	SetSTD (double _arg)
void	SetSTDPercentError (double x)
virtual void	SetSTDTolerance (double _arg)
*virtual void	SetUseBackgroundInAPrior (bool _arg)
void	TakeAPrior (const BinaryObjectImage *aprior)
virtual void	UnRegister () const
endcode In the above the two lines of code can be in either order Note that it may be more efficient to use a pipeline than to call	Update () once for each filter in turn.*For an image
endcode In the above the two lines of code can be in either order *Note that	Update () is not called automatically except within a pipeline as in the first example.When\b streaming(using a StreamingImageFilter) is activated
endcode code someFilter	Update ()
*image	Update ()
*anotherFilter	Update ()
Get the output data of this process object The output of this function is not valid until an appropriate either explicitly or implicitly Both the filter itself and the data object have	Update () methods
Get the output data of this process object The output of this *function is not valid until an appropriate	Update () method has *been called
virtual void	UpdateLargestPossibleRegion ()
virtual void	UpdateOutputData (DataObject *output)
virtual void	UpdateOutputInformation ()
void	UpdateProgress (float amount)
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
Push Pop the input of this process object These methods allow a filter to model its input vector as a queue or stack These routines may not be appropriate for all especially filters with different types of inputs These routines follow the semantics of STL *The routines are useful for applications that need to process rolling sets of images For if an application has images and they need to run a filter on then run the filter on then run the filter on the application can accomplish this by popping an input off the front of the input list and push a new image onto the back of input list	Again
This is a global flag that controls whether any	debug
endcode In the above	example
Push Pop the input of this process object These methods allow a filter to model its input vector as a queue or stack These routines may not be appropriate for all especially filters with different types of inputs These routines follow the semantics of STL *The routines are useful for applications that need to process rolling sets of images For if an application has images and they need to run a filter on then run the filter on then run the filter on the application can accomplish this by popping an input off the front of the input list and push a new image onto the back of input list this only makes sense for filters that single type of input *Other uses are also possible For a single input	filter
Push Pop the input of this process object These methods allow a filter to model its input vector as a queue or stack These routines may not be appropriate for all	filters
*	image = someFilter->GetOutput()
endcode In this a someFilter and a anotherFilter are said to constitute a b pipeline *code	image = someFilter->GetOutput()
Push Pop the input of this process object These methods allow a filter to model its input vector as a queue or stack These routines may not be appropriate for all especially filters with different types of inputs These routines follow the semantics of STL *The routines are useful for applications that need to process rolling sets of images For if an application has images and they need to run a filter on then run the filter on then run the filter on *	images
Push Pop the input of this process object These methods allow a filter to model its input vector as a queue or stack These routines may not be appropriate for all especially filters with different types of inputs These routines follow the semantics of STL *The routines are useful for applications that need to process rolling sets of images For if an application has images and they need to run a filter on then run the filter on	images
Push Pop the input of this process object These methods allow a filter to model its input vector as a queue or stack These routines may not be appropriate for all especially filters with different types of inputs These routines follow the semantics of STL *The routines are useful for applications that need to process rolling sets of images For if an application has *images and they need to run a filter on	images
Push Pop the input of this process object These methods allow a filter to model its input vector as a queue or stack These routines may not be appropriate for all especially filters with different types of inputs These routines follow the semantics of STL *The routines are useful for applications that need to process rolling sets of images For	instance
Get the output data of this process object The output of this function is not valid until an appropriate either explicitly or implicitly Both the filter itself and the data object have and both methods update the data Here are three ways to use a image is a pointer to some Image	object
endcode In the above the two lines of code can be in either order Note that it may be more efficient to use a pipeline than to call the data generated is for the requested *	Region
endcode *In this	situation
Protected Types
typedef ImageToImageFilterDetail::ImageRegionCopier< itkGetStaticConstMacro(OutputImageDimension), itkGetStaticConstMacro(InputImageDimension)	InputToOutputRegionCopierType )
typedef ImageToImageFilterDetail::ImageRegionCopier< itkGetStaticConstMacro(InputImageDimension), itkGetStaticConstMacro(OutputImageDimension)	OutputToInputRegionCopierType )
Protected Member Functions
virtual void	AddInput (DataObject *input)
virtual void	AddOutput (DataObject *output)
virtual void	AfterThreadedGenerateData ()
virtual void	AllocateOutputs ()
virtual void	BeforeThreadedGenerateData ()
virtual void	CacheInputReleaseDataFlags ()
virtual void	CallCopyInputRegionToOutputRegion (OutputImageRegionType &destRegion, const InputImageRegionType &srcRegion)
virtual void	CallCopyOutputRegionToInputRegion (InputImageRegionType &destRegion, const OutputImageRegionType &srcRegion)
virtual void	ClassifyDiagram (void)
void	drawLine (PointType p1, PointType p2)
void	drawVDline (VDImagePointer result, PointType p1, PointType p2, unsigned char color)
void	FillPolygon (PointTypeDeque vertlist, OutputPixelType color=1)
virtual void	GenerateAddingSeeds (void)
void	GenerateData (void)
virtual void	GenerateOutputInformation ()
virtual void	GenerateOutputRequestedRegion (DataObject *output)
const DataObject *	GetInput (unsigned int idx) const
virtual const unsigned int &	GetNumberOfRequiredInputs ()
virtual const unsigned int &	GetNumberOfRequiredOutputs ()
const DataObject *	GetOutput (unsigned int idx) const
void	GetPixelIndexFromPolygon (PointTypeDeque VertList, IndexList *PixelPool)
	ImageToImageFilter ()
bool	PrintObservers (std::ostream &os, Indent indent) const
virtual void	PrintSelf (std::ostream &os, Indent indent) const
virtual void	PrintTrailer (std::ostream &os, Indent indent) const
virtual void	PropagateResetPipeline ()
*these methods end of hiding the versions from the superclass ProcessObject whose arguments are DataObjects we re expose the versions from ProcessObject to avoid warnings about hiding methods from the superclass *void	PushBackInput (const DataObject *input)
*	PushBackInput ()
*	PushFronInput () in the public section force the *input to be the type expected by an ImageToImageFilter.However
void	PushFrontInput (const DataObject *input)
virtual void	ReleaseInputs ()
virtual void	RemoveInput (DataObject *input)
virtual void	RemoveOutput (DataObject *output)
virtual void	RestoreInputReleaseDataFlags ()
Protected methods for setting inputs Subclasses make use of them for setting input virtual void	SetNthInput (unsigned int num, DataObject *input)
Protected methods for setting outputs Subclasses make use of them for getting output virtual void	SetNthOutput (unsigned int num, DataObject *output)
void	SetNumberOfInputs (unsigned int num)
void	SetNumberOfOutputs (unsigned int num)
virtual void	SetNumberOfRequiredInputs (unsigned int _arg)
virtual void	SetNumberOfRequiredOutputs (unsigned int _arg)
virtual int	SplitRequestedRegion (int i, int num, OutputImageRegionType &splitRegion)
virtual void	ThreadedGenerateData (const OutputImageRegionType &outputRegionForThread, int threadId)
	VoronoiSegmentationImageFilter ()
	~VoronoiSegmentationImageFilter ()
Static Protected Member Functions
static ITK_THREAD_RETURN_TYPE	ThreaderCallback (void *arg)
Protected Attributes
*these methods end of hiding the versions from the superclass ProcessObject whose arguments are DataObjects	Here
bool	m_InteractiveSegmentation
std::vector< unsigned char >	m_Label
int	m_LastStepSeeds
double	m_MeanDeviation
int	m_MinRegion
int	m_NumberOfBoundary
std::vector< int >	m_NumberOfPixels
int	m_NumberOfSeeds
int	m_NumberOfSeedsToAdded
bool	m_OutputBoundary
TimeStamp	m_OutputInformationMTime
int	m_ReferenceCount
SimpleFastMutexLock	m_ReferenceCountLock
std::vector< PointType >	m_SeedsToAdded
SizeType	m_Size
int	m_Steps
bool	m_Updating
bool	m_UseBackgroundInAPrior
VoronoiDiagramGenerator::Pointer	m_VDGenerator
VoronoiDiagram::Pointer	m_WorkingVD
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

itk::VoronoiSegmentationImageFilter< TInputImage, TOutputImage, TBinaryPriorImage > Class Template Reference [Hybrid Segmentation Filters]