#include <rtkDisplacedDetectorImageFilter.h>

Inheritance diagram for rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >:

Collaboration diagram for rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >:

Public Types
using	ConstPointer = itk::SmartPointer< const Self >

using	GeometryConstPointer = GeometryType::ConstPointer

using	GeometryType = ThreeDCircularProjectionGeometry

using	InputImageType = TInputImage

using	OutputImageRegionType = typename OutputImageType::RegionType

using	OutputImageType = TOutputImage

using	Pointer = itk::SmartPointer< Self >

using	Self = DisplacedDetectorImageFilter

using	Superclass = itk::ImageToImageFilter< TInputImage, TOutputImage >

using	WeightImageType = itk::Image< double, 1 >

Public Member Functions
virtual ::itk::LightObject::Pointer	CreateAnother () const


virtual const char *	GetNameOfClass () const


virtual const GeometryType *	GetGeometry () const

virtual void	SetGeometry (const GeometryType *_arg)


virtual bool	GetPadOnTruncatedSide ()

virtual void	SetPadOnTruncatedSide (bool _arg)


void	SetOffsets (double minOffset, double maxOffset)

virtual double	GetMinimumOffset ()

virtual double	GetMaximumOffset ()


virtual bool	GetDisable ()

virtual void	SetDisable (bool _arg)

Static Public Member Functions
static Pointer	New ()

Static Public Attributes
static constexpr unsigned int	NDimension = TInputImage::ImageDimension

Protected Member Functions
	DisplacedDetectorImageFilter ()

void	DynamicThreadedGenerateData (const OutputImageRegionType &outputRegionForThread) override

void	GenerateInputRequestedRegion () override

void	GenerateOutputInformation () override

void	VerifyPreconditions () const override

	~DisplacedDetectorImageFilter () override=default


virtual double	GetInferiorCorner ()

virtual double	GetSuperiorCorner ()

Protected Attributes
bool	m_PadOnTruncatedSide { true }

Private Attributes
bool	m_Disable { false }

GeometryConstPointer	m_Geometry

double	m_InferiorCorner { 0. }

double	m_MaximumOffset { 0. }

double	m_MinimumOffset { 0. }

bool	m_OffsetsSet { false }

double	m_SuperiorCorner { 0. }

Detailed Description

template<class TInputImage, class TOutputImage = TInputImage>
class rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >

Weigting for displaced detectors.

Weighting of image projections to handle off-centered panels in tomography reconstruction. Based on [Wang, Med Phys, 2002].

Note that the filter does nothing if the panel shift is less than 10% of its size. Otherwise, it does the weighting described in the publication and zero pads the data on the nearest side to the center. Therefore, the InPlace capability depends on the displacement. It can only be inplace if there is no displacement, it can not otherwise. The GenerateOutputInformation method takes care of properly setting this up.

By default, it computes the minimum and maximum offsets from the complete geometry object. When an independent projection has to be processed, these values have to be set by the user from a priori knowledge of the detector displacements.

The weighting accounts for variations in SourceToDetectorDistances, SourceOffsetsX and ProjectionOffsetsX. It currently assumes constant SourceToIsocenterDistances and 0. InPlaneAngles. The other parameters are not relevant in the computation because the weighting is reproduced at every gantry angle on each line of the projection images.

Test:: rtkdisplaceddetectortest.cxx, rtkdisplaceddetectorcompcudatest.cxx, rtkdisplaceddetectorcompoffsettest.cxx

Author: Simon Rit

Definition at line 60 of file rtkDisplacedDetectorImageFilter.h.

Member Typedef Documentation

◆ ConstPointer

template<class TInputImage , class TOutputImage = TInputImage>

using rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::ConstPointer = itk::SmartPointer<const Self>

Definition at line 69 of file rtkDisplacedDetectorImageFilter.h.

◆ GeometryConstPointer

template<class TInputImage , class TOutputImage = TInputImage>

using rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::GeometryConstPointer = GeometryType::ConstPointer

Definition at line 79 of file rtkDisplacedDetectorImageFilter.h.

◆ GeometryType

template<class TInputImage , class TOutputImage = TInputImage>

using rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::GeometryType = ThreeDCircularProjectionGeometry

Definition at line 78 of file rtkDisplacedDetectorImageFilter.h.

◆ InputImageType

template<class TInputImage , class TOutputImage = TInputImage>

using rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::InputImageType = TInputImage

Some convenient type alias.

Definition at line 72 of file rtkDisplacedDetectorImageFilter.h.

◆ OutputImageRegionType

template<class TInputImage , class TOutputImage = TInputImage>

using rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::OutputImageRegionType = typename OutputImageType::RegionType

Definition at line 75 of file rtkDisplacedDetectorImageFilter.h.

◆ OutputImageType

template<class TInputImage , class TOutputImage = TInputImage>

using rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::OutputImageType = TOutputImage

Definition at line 73 of file rtkDisplacedDetectorImageFilter.h.

◆ Pointer

template<class TInputImage , class TOutputImage = TInputImage>

using rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::Pointer = itk::SmartPointer<Self>

Definition at line 68 of file rtkDisplacedDetectorImageFilter.h.

◆ Self

template<class TInputImage , class TOutputImage = TInputImage>

using rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::Self = DisplacedDetectorImageFilter

Standard class type alias.

Definition at line 66 of file rtkDisplacedDetectorImageFilter.h.

◆ Superclass

template<class TInputImage , class TOutputImage = TInputImage>

using rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::Superclass = itk::ImageToImageFilter<TInputImage, TOutputImage>

Definition at line 67 of file rtkDisplacedDetectorImageFilter.h.

◆ WeightImageType

template<class TInputImage , class TOutputImage = TInputImage>

using rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::WeightImageType = itk::Image<double, 1>

Definition at line 76 of file rtkDisplacedDetectorImageFilter.h.

Constructor & Destructor Documentation

◆ DisplacedDetectorImageFilter()

template<class TInputImage , class TOutputImage = TInputImage>

rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::DisplacedDetectorImageFilter ( )

protected

◆ ~DisplacedDetectorImageFilter()

template<class TInputImage , class TOutputImage = TInputImage>

rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::~DisplacedDetectorImageFilter ( )

overrideprotecteddefault

Member Function Documentation

◆ CreateAnother()

template<class TInputImage , class TOutputImage = TInputImage>

virtual::itk::LightObject::Pointer rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::CreateAnother ( ) const

virtual

Reimplemented from itk::Object.

◆ DynamicThreadedGenerateData()

template<class TInputImage , class TOutputImage = TInputImage>

void rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::DynamicThreadedGenerateData ( const OutputImageRegionType & outputRegionForThread )

overrideprotectedvirtual

Reimplemented from itk::ImageSource< TOutputImage >.

◆ GenerateInputRequestedRegion()

template<class TInputImage , class TOutputImage = TInputImage>

void rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::GenerateInputRequestedRegion ( )

overrideprotectedvirtual

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

◆ GenerateOutputInformation()

template<class TInputImage , class TOutputImage = TInputImage>

void rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::GenerateOutputInformation ( )

overrideprotectedvirtual

Reimplemented from itk::ProcessObject.

◆ GetDisable()

template<class TInputImage , class TOutputImage = TInputImage>

virtual bool rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::GetDisable ( )

virtual

Get / Set the Disable parameter

◆ GetGeometry()

template<class TInputImage , class TOutputImage = TInputImage>

virtual const GeometryType* rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::GetGeometry ( ) const

virtual

Get / Set the object pointer to projection geometry

◆ GetInferiorCorner()

template<class TInputImage , class TOutputImage = TInputImage>

virtual double rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::GetInferiorCorner ( )

protectedvirtual

Retrieve computed inferior and superior corners

◆ GetMaximumOffset()

template<class TInputImage , class TOutputImage = TInputImage>

virtual double rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::GetMaximumOffset ( )

virtual

Get / Set the minimum and maximum offsets of the detector along the weighting direction desribed in ToUntiltedCoordinate.

◆ GetMinimumOffset()

template<class TInputImage , class TOutputImage = TInputImage>

virtual double rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::GetMinimumOffset ( )

virtual

Get / Set the minimum and maximum offsets of the detector along the weighting direction desribed in ToUntiltedCoordinate.

◆ GetNameOfClass()

template<class TInputImage , class TOutputImage = TInputImage>

virtual const char* rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::GetNameOfClass ( ) const

virtual

Runtime information support.

Reimplemented from itk::InPlaceImageFilter< TInputImage, TOutputImage >.

Reimplemented in rtk::DisplacedDetectorForOffsetFieldOfViewImageFilter< TInputImage, TOutputImage >.

◆ GetPadOnTruncatedSide()

template<class TInputImage , class TOutputImage = TInputImage>

virtual bool rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::GetPadOnTruncatedSide ( )

virtual

Get / Set whether the projections should be padded (yes for FDK, no for iterative)

◆ GetSuperiorCorner()

template<class TInputImage , class TOutputImage = TInputImage>

virtual double rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::GetSuperiorCorner ( )

protectedvirtual

Retrieve computed inferior and superior corners

◆ New()

template<class TInputImage , class TOutputImage = TInputImage>

static Pointer rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::New ( )

static

Standard New method.

◆ SetDisable()

template<class TInputImage , class TOutputImage = TInputImage>

virtual void rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::SetDisable ( bool _arg )

virtual

Get / Set the Disable parameter

◆ SetGeometry()

template<class TInputImage , class TOutputImage = TInputImage>

virtual void rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::SetGeometry ( const GeometryType * _arg )

virtual

Get / Set the object pointer to projection geometry

◆ SetOffsets()

template<class TInputImage , class TOutputImage = TInputImage>

void rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::SetOffsets	(	double	minOffset,
		double	maxOffset
	)

Get / Set the minimum and maximum offsets of the detector along the weighting direction desribed in ToUntiltedCoordinate.

◆ SetPadOnTruncatedSide()

template<class TInputImage , class TOutputImage = TInputImage>

virtual void rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::SetPadOnTruncatedSide ( bool _arg )

virtual

Get / Set whether the projections should be padded (yes for FDK, no for iterative)

◆ VerifyPreconditions()

template<class TInputImage , class TOutputImage = TInputImage>

void rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::VerifyPreconditions ( ) const

overrideprotectedvirtual

Checks that inputs are correctly set.

Reimplemented from itk::ProcessObject.

Member Data Documentation

◆ m_Disable

template<class TInputImage , class TOutputImage = TInputImage>

bool rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::m_Disable { false }

private

When using a geometry that the displaced detector cannot manage, it has to be disabled

Definition at line 171 of file rtkDisplacedDetectorImageFilter.h.

◆ m_Geometry

template<class TInputImage , class TOutputImage = TInputImage>

GeometryConstPointer rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::m_Geometry

private

RTK geometry object

Definition at line 147 of file rtkDisplacedDetectorImageFilter.h.

◆ m_InferiorCorner

template<class TInputImage , class TOutputImage = TInputImage>

double rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::m_InferiorCorner { 0. }

private

Superior and inferior position of the detector along the weighting direction, i.e., the virtual detector described in ToUntiltedCoordinate.

Definition at line 165 of file rtkDisplacedDetectorImageFilter.h.

◆ m_MaximumOffset

template<class TInputImage , class TOutputImage = TInputImage>

double rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::m_MaximumOffset { 0. }

private

Definition at line 155 of file rtkDisplacedDetectorImageFilter.h.

◆ m_MinimumOffset

template<class TInputImage , class TOutputImage = TInputImage>

double rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::m_MinimumOffset { 0. }

private

Minimum and maximum offsets of the detector along the weighting direction, i.e. x. If a priori known, these values can be given as input. Otherwise, they are computed from the complete geometry.

Definition at line 154 of file rtkDisplacedDetectorImageFilter.h.

◆ m_OffsetsSet

template<class TInputImage , class TOutputImage = TInputImage>

bool rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::m_OffsetsSet { false }

private

Flag used to know if the user has entered the min/max values of the detector offset.

Definition at line 160 of file rtkDisplacedDetectorImageFilter.h.

◆ m_PadOnTruncatedSide

template<class TInputImage , class TOutputImage = TInputImage>

bool rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::m_PadOnTruncatedSide { true }

protected

Definition at line 143 of file rtkDisplacedDetectorImageFilter.h.

◆ m_SuperiorCorner

template<class TInputImage , class TOutputImage = TInputImage>

double rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::m_SuperiorCorner { 0. }

private

Definition at line 166 of file rtkDisplacedDetectorImageFilter.h.

◆ NDimension

template<class TInputImage , class TOutputImage = TInputImage>

constexpr unsigned int rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >::NDimension = TInputImage::ImageDimension

static

Definition at line 74 of file rtkDisplacedDetectorImageFilter.h.

The documentation for this class was generated from the following file:

rtkDisplacedDetectorImageFilter.h

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Private Attributes

Detailed Description

template<class TInputImage, class TOutputImage = TInputImage> class rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >

Member Typedef Documentation

◆ ConstPointer

◆ GeometryConstPointer

◆ GeometryType

◆ InputImageType

◆ OutputImageRegionType

◆ OutputImageType

◆ Pointer

◆ Self

◆ Superclass

◆ WeightImageType

Constructor & Destructor Documentation

◆ DisplacedDetectorImageFilter()

◆ ~DisplacedDetectorImageFilter()

Member Function Documentation

◆ CreateAnother()

◆ DynamicThreadedGenerateData()

◆ GenerateInputRequestedRegion()

◆ GenerateOutputInformation()

◆ GetDisable()

◆ GetGeometry()

◆ GetInferiorCorner()

◆ GetMaximumOffset()

◆ GetMinimumOffset()

◆ GetNameOfClass()

◆ GetPadOnTruncatedSide()

◆ GetSuperiorCorner()

◆ New()

◆ SetDisable()

◆ SetGeometry()

◆ SetOffsets()

◆ SetPadOnTruncatedSide()

◆ VerifyPreconditions()

Member Data Documentation

◆ m_Disable

◆ m_Geometry

◆ m_InferiorCorner

◆ m_MaximumOffset

◆ m_MinimumOffset

◆ m_OffsetsSet

◆ m_PadOnTruncatedSide

◆ m_SuperiorCorner

◆ NDimension

template<class TInputImage, class TOutputImage = TInputImage>
class rtk::DisplacedDetectorImageFilter< TInputImage, TOutputImage >