#include <itkImageRandomCoordinateSampler.h>

Detailed Description

template<class TInputImage>
class itk::ImageRandomCoordinateSampler< TInputImage >

Samples an image by randomly composing a set of physical coordinates.

This image sampler generates not only samples that correspond with pixel locations, but selects points in physical space.

Definition at line 40 of file itkImageRandomCoordinateSampler.h.

Inheritance diagram for itk::ImageRandomCoordinateSampler< TInputImage >:

[legend]

Data Structures
struct	UserData

Public Types
using	ConstPointer = SmartPointer<const Self>

using	CoordRepType = double

using	DefaultInterpolatorType = BSplineInterpolateImageFunction<InputImageType, CoordRepType, double>

using	InputImageSpacingType = typename InputImageType::SpacingType

using	InterpolatorPointer = typename InterpolatorType::Pointer

using	InterpolatorType = InterpolateImageFunction<InputImageType, CoordRepType>

using	Pointer = SmartPointer<Self>

using	RandomGeneratorPointer = typename RandomGeneratorType::Pointer

using	RandomGeneratorType = itk::Statistics::MersenneTwisterRandomVariateGenerator

using	Self = ImageRandomCoordinateSampler

using	Superclass = ImageRandomSamplerBase<TInputImage>

Public Types inherited from itk::ImageRandomSamplerBase< TInputImage >
using	ConstPointer = SmartPointer<const Self>

using	ImageSampleContainerPointer

using	ImageSampleContainerType

using	ImageSampleType

using	InputImageConstPointer

using	InputImagePixelType

using	InputImagePointer

using	InputImageRegionType

using	InputImageType

using	MaskType

using	Pointer = SmartPointer<Self>

using	SeedIntegerType = Statistics::MersenneTwisterRandomVariateGenerator::IntegerType

using	Self = ImageRandomSamplerBase

using	Superclass = ImageSamplerBase<TInputImage>

Public Types inherited from itk::ImageSamplerBase< TInputImage >
using	ConstPointer = SmartPointer<const Self>

using	ImageSampleContainerPointer = typename ImageSampleContainerType::Pointer

using	ImageSampleContainerType = VectorDataContainer<std::vcl_size_t, ImageSampleType>

using	ImageSampleType = ImageSample<InputImageType>

using	ImageSampleValueType = typename ImageSampleType::RealType

using	InputImageConstPointer = typename InputImageType::ConstPointer

using	InputImageIndexType = typename InputImageType::IndexType

using	InputImagePixelType = typename InputImageType::PixelType

using	InputImagePointer = typename InputImageType::Pointer

using	InputImagePointType = typename InputImageType::PointType

using	InputImagePointValueType = typename InputImagePointType::ValueType

using	InputImageRegionType = typename InputImageType::RegionType

using	InputImageRegionVectorType = std::vector<InputImageRegionType>

using	InputImageSizeType = typename InputImageType::SizeType

using	InputImageType = TInputImage

using	MaskConstPointer = typename MaskType::ConstPointer

using	MaskPointer = typename MaskType::Pointer

using	MaskType = ImageMaskSpatialObject<Self::InputImageDimension>

using	MaskVectorType = std::vector<MaskConstPointer>

using	Pointer = SmartPointer<Self>

using	Self = ImageSamplerBase

using	Superclass = VectorContainerSource<VectorDataContainer<std::vcl_size_t, ImageSample<TInputImage>>>

Public Types inherited from itk::VectorContainerSource< VectorDataContainer< std::vcl_size_t, ImageSample< TInputImage > > >
using	ConstPointer

using	OutputVectorContainerPointer

using	OutputVectorContainerType

using	Pointer

using	Self

using	Superclass

Public Member Functions
virtual const char *	GetClassName () const

virtual const InputImageSpacingType &	GetSampleRegionSize ()

virtual bool	GetUseRandomSampleRegion () const

	ITK_DISALLOW_COPY_AND_MOVE (ImageRandomCoordinateSampler)

	itkGetModifiableObjectMacro (Interpolator, InterpolatorType)

	itkStaticConstMacro (InputImageDimension, unsigned int, Superclass::InputImageDimension)

virtual void	SetInterpolator (InterpolatorType *_arg)

virtual void	SetSampleRegionSize (InputImageSpacingType _arg)

virtual void	SetUseRandomSampleRegion (bool _arg)

Public Member Functions inherited from itk::ImageRandomSamplerBase< TInputImage >
std::optional< SeedIntegerType >	GetOptionalSeed () const

	ITK_DISALLOW_COPY_AND_MOVE (ImageRandomSamplerBase)

	itkStaticConstMacro (InputImageDimension, unsigned int, Superclass::InputImageDimension)

void	SetOptionalSeed (const std::optional< SeedIntegerType > arg)

void	SetSeed (const SeedIntegerType arg)

Public Member Functions inherited from itk::ImageSamplerBase< TInputImage >
virtual const InputImageRegionType &	GetCroppedInputImageRegion ()

const InputImageType *	GetInput ()

const InputImageType *	GetInput (unsigned int idx)

virtual const InputImageRegionType &	GetInputImageRegion () const

virtual const InputImageRegionType &	GetInputImageRegion (unsigned int pos) const

virtual const MaskType *	GetMask () const

virtual const MaskType *	GetMask (unsigned int pos) const

virtual unsigned int	GetNumberOfInputImageRegions () const

virtual unsigned int	GetNumberOfMasks () const

virtual unsigned long	GetNumberOfSamples () const

OutputVectorContainerType *	GetOutput ()

	ITK_DISALLOW_COPY_AND_MOVE (ImageSamplerBase)

	itkStaticConstMacro (InputImageDimension, unsigned int, InputImageType::ImageDimension)

DataObject::Pointer	MakeOutput (ProcessObject::DataObjectPointerArraySizeType idx) override

virtual bool	SelectingNewSamplesOnUpdateSupported () const

virtual bool	SelectNewSamplesOnUpdate ()

void	SetInput (const InputImageType *input)

void	SetInput (unsigned int idx, const InputImageType *input)

virtual void	SetInputImageRegion (const InputImageRegionType _arg)

virtual void	SetInputImageRegion (const InputImageRegionType _arg, unsigned int pos)

virtual void	SetMask (const MaskType *_arg)

virtual void	SetMask (const MaskType *_arg, unsigned int pos)

virtual void	SetNumberOfInputImageRegions (const unsigned int _arg)

virtual void	SetNumberOfMasks (const unsigned int _arg)

virtual void	SetNumberOfSamples (unsigned long _arg)

virtual void	SetUseMultiThread (bool _arg)

Public Member Functions inherited from itk::VectorContainerSource< VectorDataContainer< std::vcl_size_t, ImageSample< TInputImage > > >
OutputVectorContainerType *	GetOutput ()

OutputVectorContainerType *	GetOutput (unsigned int idx)

virtual void	GraftNthOutput (unsigned int idx, DataObject *output)

virtual void	GraftOutput (DataObject *output)

	ITK_DISALLOW_COPY_AND_MOVE (VectorContainerSource)

DataObjectPointer	MakeOutput (ProcessObject::DataObjectPointerArraySizeType idx) override

Static Public Member Functions
static Pointer	New ()

Static Public Member Functions inherited from itk::ImageRandomSamplerBase< TInputImage >
static Pointer	New ()

Static Public Member Functions inherited from itk::ImageSamplerBase< TInputImage >
static Pointer	New ()

Static Public Member Functions inherited from itk::VectorContainerSource< VectorDataContainer< std::vcl_size_t, ImageSample< TInputImage > > >
static Pointer	New ()

Protected Types
using	InputImageContinuousIndexType = typename InterpolatorType::ContinuousIndexType

Protected Member Functions
void	GenerateData () override

virtual void	GenerateRandomCoordinate (const InputImageContinuousIndexType &smallestContIndex, const InputImageContinuousIndexType &largestContIndex, InputImageContinuousIndexType &randomContIndex)

virtual void	GenerateSampleRegion (const InputImageContinuousIndexType &smallestImageContIndex, const InputImageContinuousIndexType &largestImageContIndex, InputImageContinuousIndexType &smallestContIndex, InputImageContinuousIndexType &largestContIndex)

	ImageRandomCoordinateSampler ()=default

void	PrintSelf (std::ostream &os, Indent indent) const override

	~ImageRandomCoordinateSampler () override=default

Protected Member Functions inherited from itk::ImageRandomSamplerBase< TInputImage >
void	GenerateRandomNumberList ()

	ImageRandomSamplerBase ()

void	PrintSelf (std::ostream &os, Indent indent) const override

	~ImageRandomSamplerBase () override=default

Protected Member Functions inherited from itk::ImageSamplerBase< TInputImage >
virtual bool	CheckInputImageRegions ()

void	CropInputImageRegion ()

void	GenerateInputRequestedRegion () override

	ImageSamplerBase ()

virtual bool	IsInsideAllMasks (const InputImagePointType &point) const

void	PrintSelf (std::ostream &os, Indent indent) const override

virtual void	UpdateAllMasks ()

	~ImageSamplerBase () override=default

Protected Member Functions inherited from itk::VectorContainerSource< VectorDataContainer< std::vcl_size_t, ImageSample< TInputImage > > >
void	PrintSelf (std::ostream &os, Indent indent) const override

	VectorContainerSource ()

	~VectorContainerSource () override=default

Protected Attributes
InterpolatorPointer	m_Interpolator

RandomGeneratorPointer	m_RandomGenerator { RandomGeneratorType::GetInstance() }

InputImageSpacingType	m_SampleRegionSize { itk::MakeFilled<InputImageSpacingType>(1.0) }

Protected Attributes inherited from itk::ImageRandomSamplerBase< TInputImage >
std::vector< double >	m_RandomNumberList {}

Protected Attributes inherited from itk::ImageSamplerBase< TInputImage >
unsigned long	m_NumberOfSamples { 0 }

bool	m_UseMultiThread { true }

Static Private Member Functions
static ITK_THREAD_RETURN_FUNCTION_CALL_CONVENTION	ThreaderCallback (void *arg)

Private Attributes
std::vector< InputImageContinuousIndexType >	m_RandomCoordinates {}

bool	m_UseRandomSampleRegion { false }

Additional Inherited Members
Static Protected Member Functions inherited from itk::ImageSamplerBase< TInputImage >
static std::vector< InputImageRegionType >	SplitRegion (const InputImageRegionType &inputRegion, const vcl_size_t requestedNumberOfSubregions)

Member Typedef Documentation

◆ ConstPointer

template<class TInputImage >

using itk::ImageRandomCoordinateSampler< TInputImage >::ConstPointer = SmartPointer<const Self>

Definition at line 49 of file itkImageRandomCoordinateSampler.h.

◆ CoordRepType

template<class TInputImage >

using itk::ImageRandomCoordinateSampler< TInputImage >::CoordRepType = double

This image sampler samples the image on physical coordinates and thus needs an interpolator.

Definition at line 82 of file itkImageRandomCoordinateSampler.h.

◆ DefaultInterpolatorType

template<class TInputImage >

using itk::ImageRandomCoordinateSampler< TInputImage >::DefaultInterpolatorType = BSplineInterpolateImageFunction<InputImageType, CoordRepType, double>

Definition at line 85 of file itkImageRandomCoordinateSampler.h.

◆ InputImageContinuousIndexType

template<class TInputImage >

using itk::ImageRandomCoordinateSampler< TInputImage >::InputImageContinuousIndexType = typename InterpolatorType::ContinuousIndexType

protected

Definition at line 106 of file itkImageRandomCoordinateSampler.h.

◆ InputImageSpacingType

template<class TInputImage >

using itk::ImageRandomCoordinateSampler< TInputImage >::InputImageSpacingType = typename InputImageType::SpacingType

Definition at line 71 of file itkImageRandomCoordinateSampler.h.

◆ InterpolatorPointer

template<class TInputImage >

using itk::ImageRandomCoordinateSampler< TInputImage >::InterpolatorPointer = typename InterpolatorType::Pointer

Definition at line 84 of file itkImageRandomCoordinateSampler.h.

◆ InterpolatorType

template<class TInputImage >

using itk::ImageRandomCoordinateSampler< TInputImage >::InterpolatorType = InterpolateImageFunction<InputImageType, CoordRepType>

Definition at line 83 of file itkImageRandomCoordinateSampler.h.

◆ Pointer

template<class TInputImage >

using itk::ImageRandomCoordinateSampler< TInputImage >::Pointer = SmartPointer<Self>

Definition at line 48 of file itkImageRandomCoordinateSampler.h.

◆ RandomGeneratorPointer

template<class TInputImage >

using itk::ImageRandomCoordinateSampler< TInputImage >::RandomGeneratorPointer = typename RandomGeneratorType::Pointer

Definition at line 89 of file itkImageRandomCoordinateSampler.h.

◆ RandomGeneratorType

template<class TInputImage >

using itk::ImageRandomCoordinateSampler< TInputImage >::RandomGeneratorType = itk::Statistics::MersenneTwisterRandomVariateGenerator

The random number generator used to generate random coordinates.

Definition at line 88 of file itkImageRandomCoordinateSampler.h.

◆ Self

template<class TInputImage >

using itk::ImageRandomCoordinateSampler< TInputImage >::Self = ImageRandomCoordinateSampler

Standard ITK-stuff.

Definition at line 46 of file itkImageRandomCoordinateSampler.h.

◆ Superclass

template<class TInputImage >

using itk::ImageRandomCoordinateSampler< TInputImage >::Superclass = ImageRandomSamplerBase<TInputImage>

Definition at line 47 of file itkImageRandomCoordinateSampler.h.

Constructor & Destructor Documentation

◆ ImageRandomCoordinateSampler()

template<class TInputImage >

itk::ImageRandomCoordinateSampler< TInputImage >::ImageRandomCoordinateSampler ( )

protecteddefault

The constructor.

◆ ~ImageRandomCoordinateSampler()

template<class TInputImage >

itk::ImageRandomCoordinateSampler< TInputImage >::~ImageRandomCoordinateSampler ( )

overrideprotecteddefault

The destructor.

Member Function Documentation

◆ GenerateData()

template<class TInputImage >

void itk::ImageRandomCoordinateSampler< TInputImage >::GenerateData ( )

overrideprotected

Function that does the work.

◆ GenerateRandomCoordinate()

template<class TInputImage >

virtual void itk::ImageRandomCoordinateSampler< TInputImage >::GenerateRandomCoordinate	(	const InputImageContinuousIndexType &	smallestContIndex,
		const InputImageContinuousIndexType &	largestContIndex,
		InputImageContinuousIndexType &	randomContIndex )

protectedvirtual

Generate a point randomly in a bounding box.

◆ GenerateSampleRegion()

template<class TInputImage >

virtual void itk::ImageRandomCoordinateSampler< TInputImage >::GenerateSampleRegion	(	const InputImageContinuousIndexType &	smallestImageContIndex,
		const InputImageContinuousIndexType &	largestImageContIndex,
		InputImageContinuousIndexType &	smallestContIndex,
		InputImageContinuousIndexType &	largestContIndex )

protectedvirtual

Generate the two corners of a sampling region, given the two corners of an image. If UseRandomSampleRegion=false, the smallesPoint and largestPoint are just copies of the smallestImagePoint and largestImagePoint Otherwise, the midpoint of the sample region is randomly selected and the two corners are computed using the SampleRegionSize

◆ GetClassName()

template<class TInputImage >

virtual const char * itk::ImageRandomCoordinateSampler< TInputImage >::GetClassName ( ) const

virtual

Run-time type information (and related methods).

Reimplemented from itk::ImageRandomSamplerBase< TInputImage >.

Reimplemented in elastix::RandomCoordinateSampler< TElastix >.

◆ GetSampleRegionSize()

template<class TInputImage >

virtual const InputImageSpacingType & itk::ImageRandomCoordinateSampler< TInputImage >::GetSampleRegionSize ( )

virtual

◆ GetUseRandomSampleRegion()

template<class TInputImage >

virtual bool itk::ImageRandomCoordinateSampler< TInputImage >::GetUseRandomSampleRegion ( ) const

virtual

Set/Get whether to use randomly selected sample regions, or just the whole image Default: false.

◆ ITK_DISALLOW_COPY_AND_MOVE()

template<class TInputImage >

itk::ImageRandomCoordinateSampler< TInputImage >::ITK_DISALLOW_COPY_AND_MOVE ( ImageRandomCoordinateSampler< TInputImage > )

◆ itkGetModifiableObjectMacro()

template<class TInputImage >

itk::ImageRandomCoordinateSampler< TInputImage >::itkGetModifiableObjectMacro	(	Interpolator	,
		InterpolatorType	)

◆ itkStaticConstMacro()

template<class TInputImage >

itk::ImageRandomCoordinateSampler< TInputImage >::itkStaticConstMacro	(	InputImageDimension	,
		unsigned int	,
		Superclass::InputImageDimension	)

The input image dimension.

◆ New()

template<class TInputImage >

static Pointer itk::ImageRandomCoordinateSampler< TInputImage >::New ( )

static

Method for creation through the object factory.

◆ PrintSelf()

template<class TInputImage >

void itk::ImageRandomCoordinateSampler< TInputImage >::PrintSelf	(	std::ostream &	os,
		Indent	indent ) const

overrideprotected

PrintSelf.

◆ SetInterpolator()

template<class TInputImage >

virtual void itk::ImageRandomCoordinateSampler< TInputImage >::SetInterpolator ( InterpolatorType * _arg )

virtual

Set/Get the interpolator. A 3rd order B-spline interpolator is used by default.

◆ SetSampleRegionSize()

template<class TInputImage >

virtual void itk::ImageRandomCoordinateSampler< TInputImage >::SetSampleRegionSize ( InputImageSpacingType _arg )

virtual

Set/Get the sample region size (in mm). Only needed when UseRandomSampleRegion==true; default: filled with ones.

◆ SetUseRandomSampleRegion()

template<class TInputImage >

virtual void itk::ImageRandomCoordinateSampler< TInputImage >::SetUseRandomSampleRegion ( bool _arg )

virtual

◆ ThreaderCallback()

template<class TInputImage >

static ITK_THREAD_RETURN_FUNCTION_CALL_CONVENTION itk::ImageRandomCoordinateSampler< TInputImage >::ThreaderCallback ( void * arg )

staticprivate

Field Documentation

◆ m_Interpolator

template<class TInputImage >

InterpolatorPointer itk::ImageRandomCoordinateSampler< TInputImage >::m_Interpolator

protected

Initial value:

= [] {
    const auto interpolator = DefaultInterpolatorType::New();
    interpolator->SetSplineOrder(3);
    return interpolator;
  }()

Definition at line 128 of file itkImageRandomCoordinateSampler.h.

◆ m_RandomCoordinates

template<class TInputImage >

std::vector<InputImageContinuousIndexType> itk::ImageRandomCoordinateSampler< TInputImage >::m_RandomCoordinates {}

private

Definition at line 159 of file itkImageRandomCoordinateSampler.h.

◆ m_RandomGenerator

template<class TInputImage >

RandomGeneratorPointer itk::ImageRandomCoordinateSampler< TInputImage >::m_RandomGenerator { RandomGeneratorType::GetInstance() }

protected

Definition at line 134 of file itkImageRandomCoordinateSampler.h.

◆ m_SampleRegionSize

template<class TInputImage >

InputImageSpacingType itk::ImageRandomCoordinateSampler< TInputImage >::m_SampleRegionSize { itk::MakeFilled<InputImageSpacingType>(1.0) }

protected

Definition at line 135 of file itkImageRandomCoordinateSampler.h.

◆ m_UseRandomSampleRegion

template<class TInputImage >

bool itk::ImageRandomCoordinateSampler< TInputImage >::m_UseRandomSampleRegion { false }

private

Definition at line 164 of file itkImageRandomCoordinateSampler.h.

Detailed Description

Data Structures

Public Types

Public Member Functions

Static Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Static Private Member Functions

Private Attributes

Additional Inherited Members

Member Typedef Documentation

◆ ConstPointer

◆ CoordRepType

◆ DefaultInterpolatorType

◆ InputImageContinuousIndexType

◆ InputImageSpacingType

◆ InterpolatorPointer

◆ InterpolatorType

◆ Pointer

◆ RandomGeneratorPointer

◆ RandomGeneratorType

◆ Self

◆ Superclass

Constructor & Destructor Documentation

◆ ImageRandomCoordinateSampler()

◆ ~ImageRandomCoordinateSampler()

Member Function Documentation

◆ GenerateData()

◆ GenerateRandomCoordinate()

◆ GenerateSampleRegion()

◆ GetClassName()

◆ GetSampleRegionSize()

◆ GetUseRandomSampleRegion()

◆ ITK_DISALLOW_COPY_AND_MOVE()

◆ itkGetModifiableObjectMacro()

◆ itkStaticConstMacro()

◆ New()

◆ PrintSelf()

◆ SetInterpolator()

◆ SetSampleRegionSize()

◆ SetUseRandomSampleRegion()

◆ ThreaderCallback()

Field Documentation

◆ m_Interpolator

◆ m_RandomCoordinates

◆ m_RandomGenerator

◆ m_SampleRegionSize

◆ m_UseRandomSampleRegion