CASToR  2.0
Tomographic Reconstruction (PET/SPECT/CT)
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Public Member Functions | Private Member Functions | Private Attributes | List of all members
iProjectorJoseph Class Reference

This class is a child of the vProjector class implementing the Joseph ray tracer. More...

#include <iProjectorJoseph.hh>

Inheritance diagram for iProjectorJoseph:
Inheritance graph
Collaboration diagram for iProjectorJoseph:
Collaboration graph

Public Member Functions

 iProjectorJoseph ()
 The constructor of iProjectorJoseph. More...
 
 ~iProjectorJoseph ()
 The destructor of iProjectorJoseph. More...
 
int ReadConfigurationFile (const string &a_configurationFile)
 A function used to read options from a configuration file. More...
 
int ReadOptionsList (const string &a_optionsList)
 A function used to read options from a list of options. More...
 
INTNB EstimateMaxNumberOfVoxelsPerLine ()
 This function is used to compute and provide an estimate of the maximum number of voxels that could contribute to a projected line. More...
 
- Public Member Functions inherited from vProjector
 vProjector ()
 The constructor of vProjector. More...
 
virtual ~vProjector ()
 The destructor of vProjector. More...
 
void ShowHelp ()
 A function used to show help about the projector. More...
 
int ReadCommonOptionsList (const string &a_optionsList)
 This function is used to read options common to all projectors given as a string. More...
 
int CheckParameters ()
 A public function used to check the parameters settings. More...
 
int Initialize ()
 A public function used to initialize the projector. More...
 
int Project (int a_direction, oProjectionLine *ap_ProjectionLine, uint32_t *ap_index1, uint32_t *ap_index2, int a_nbIndices)
 A function use to computed the projection elements with respect to the provided parameters. More...
 
void SetVerbose (int a_verbose)
 Set the verbose level. More...
 
void SetScanner (vScanner *ap_Scanner)
 Set the pointer to the scanner in use. More...
 
void SetSensitivityMode (bool a_sensitivityMode)
 Set the sensitivity mode on or off. More...
 
void SetApplyTOF (int a_applyTOF)
 Set the TOF mode. More...
 
void SetApplyPOI (bool a_applyPOI)
 Set the POI mode. More...
 
int SetImageDimensionsAndQuantification (oImageDimensionsAndQuantification *ap_ImageDimensionsAndQuantification)
 Set the pointer to the image dimensions in use and copy locally some often use variables. More...
 
bool GetCompatibilityWithSPECTAttenuationCorrection ()
 
bool GetCompatibilityWithCompression ()
 
void SetMask (bool *ap_mask)
 Set a mask for voxels. More...
 

Private Member Functions

void ShowHelpSpecific ()
 A function used to show help about the child module. More...
 
int CheckSpecificParameters ()
 A private function used to check the parameters settings specific to the child projector. More...
 
int InitializeSpecific ()
 This function is used to initialize specific stuff to the child projector. More...
 
int ProjectWithoutTOF (int a_direction, oProjectionLine *ap_ProjectionLine)
 A function to project without TOF. More...
 
int ProjectWithTOFPos (int a_direction, oProjectionLine *ap_ProjectionLine)
 A function to project with TOF continuous information. More...
 
int ProjectWithTOFBin (int a_direction, oProjectionLine *ap_ProjectionLine)
 A function to project with TOF binned information. More...
 

Private Attributes

HPFLTNBmp_boundariesX
 
HPFLTNBmp_boundariesY
 
HPFLTNBmp_boundariesZ
 
uint8_t * mp_maskPad
 
HPFLTNB m_toleranceX
 
HPFLTNB m_toleranceY
 
HPFLTNB m_toleranceZ
 
HPFLTNB m_boundX
 
HPFLTNB m_boundY
 
HPFLTNB m_boundZ
 

Additional Inherited Members

- Static Public Member Functions inherited from vProjector
static void ShowCommonHelp ()
 This function is used to print out some help about the use of options common to all projectors. It is static because it is called in main without instantiating an object. More...
 
- Protected Attributes inherited from vProjector
FLTNB mp_sizeVox [3]
 
INTNB mp_nbVox [3]
 
INTNB m_nbVoxXY
 
FLTNB mp_halfFOV [3]
 
oImageDimensionsAndQuantificationmp_ImageDimensionsAndQuantification
 
vScannermp_Scanner
 
int m_applyTOF
 
FLTNB m_TOFnbSigmas
 
bool m_applyPOI
 
bool m_sensitivityMode
 
bool m_compatibleWithSPECTAttenuationCorrection
 
bool m_compatibleWithCompression
 
int m_verbose
 
bool m_checked
 
bool m_initialized
 
bool * mp_mask
 
bool m_hasMask
 

Detailed Description

This class is a child of the vProjector class implementing the Joseph ray tracer.

This class implements the Joseph algorithm which is a ray-tracer using bi-linear interpolations. Reference: P. M. Joseph, "An improved algorithm for reprojecting rays through pixel images", IEEE Trans. Med. Imaging, vol. 1, pp. 192-6, 1982.

Definition at line 45 of file iProjectorJoseph.hh.

Constructor & Destructor Documentation

iProjectorJoseph::iProjectorJoseph ( )

The constructor of iProjectorJoseph.

This is the default and unique constructor. It does not take any parameter and its role is only to affect default values to each member of the class.

Definition at line 47 of file iProjectorJoseph.cc.

iProjectorJoseph::~iProjectorJoseph ( )

The destructor of iProjectorJoseph.

This is the default and unique destructor. It does not take any parameter and its role is only to free or delete all structures that were built by this class.

Definition at line 71 of file iProjectorJoseph.cc.

Member Function Documentation

int iProjectorJoseph::CheckSpecificParameters ( )
privatevirtual

A private function used to check the parameters settings specific to the child projector.

This function is used to check that all parameters specific to the projector are correctly set within allowed values. It is called by the CheckParameters() function of the mother class. It is the implementation of the pure virtual function inherited from the abstract mother class vProjector.

Returns
An integer reflecting the check status; 0 if no problem, another value otherwise.

Implements vProjector.

Definition at line 141 of file iProjectorJoseph.cc.

INTNB iProjectorJoseph::EstimateMaxNumberOfVoxelsPerLine ( )
virtual

This function is used to compute and provide an estimate of the maximum number of voxels that could contribute to a projected line.

This function is an overloaded implementation of the virtual mother function. It is used to compute and provide an estimate of the maximum number of voxels that could contribute to a projected line.

Returns
The estimate of the maximum number of voxels contributing to a line.

Reimplemented from vProjector.

Definition at line 202 of file iProjectorJoseph.cc.

Here is the call graph for this function:

int iProjectorJoseph::InitializeSpecific ( )
privatevirtual

This function is used to initialize specific stuff to the child projector.

It is called by the public Initialize() function from the mother.

Returns
An integer reflecting the initialization status; 0 if no problem, another value otherwise.

Implements vProjector.

Definition at line 154 of file iProjectorJoseph.cc.

int iProjectorJoseph::ProjectWithoutTOF ( int  a_direction,
oProjectionLine ap_ProjectionLine 
)
privatevirtual

A function to project without TOF.

Parameters
inta_direction
oProjectionLine*ap_ProjectionLine

Projects the provided line following the provided direction, without TOF. It fills the provided oProjectionLine. It is an implementation of the pure virtual function from the mother class.

Returns
An integer reflecting the projection status; 0 if no problem, another value otherwise.

Implements vProjector.

Definition at line 219 of file iProjectorJoseph.cc.

Here is the call graph for this function:

int iProjectorJoseph::ProjectWithTOFBin ( int  a_direction,
oProjectionLine ap_ProjectionLine 
)
privatevirtual

A function to project with TOF binned information.

Parameters
inta_direction
oProjectionLine*ap_ProjectionLine

Projects the provided line following the provided direction, with TOF information describe as a histogram bin. It fills the provided oProjectionLine. It is an implementation of the pure virtual function from the mother class.

Returns
An integer reflecting the projection status; 0 if no problem, another value otherwise.

Implements vProjector.

Definition at line 896 of file iProjectorJoseph.cc.

Here is the call graph for this function:

int iProjectorJoseph::ProjectWithTOFPos ( int  a_direction,
oProjectionLine ap_ProjectionLine 
)
privatevirtual

A function to project with TOF continuous information.

Parameters
inta_direction
oProjectionLine*ap_ProjectionLine

Projects the provided line following the provided direction, with TOF described as a continuous measurement. It fills the provided oProjectionLine. It is an implementation of the pure virtual function from the mother class.

Returns
An integer reflecting the projection status; 0 if no problem, another value otherwise.

Implements vProjector.

Definition at line 521 of file iProjectorJoseph.cc.

Here is the call graph for this function:

int iProjectorJoseph::ReadConfigurationFile ( const string &  a_configurationFile)
virtual

A function used to read options from a configuration file.

Parameters
conststring& a_configurationFile

This function implements the reading of all options associated to the child projector, from a configuration file. It is the implementation of the pure virtual function inherited from the abstract class vProjector. It checks the reading status but not the options values that will be checked by the CheckSpecificParameters() function.

Returns
An integer reflecting the reading success; 0 if success, another value otherwise.

Implements vProjector.

Definition at line 103 of file iProjectorJoseph.cc.

int iProjectorJoseph::ReadOptionsList ( const string &  a_optionsList)
virtual

A function used to read options from a list of options.

Parameters
conststring& a_configurationFile

This function implements the reading of all options associated to the child projector, from a list of options. It is the implementation of the pure virtual function inherited from the abstract class vProjector. It checks the reading status but not the options values that will be checked by the CheckSpecificParameters() function.

Returns
An integer reflecting the reading success; 0 if success, another value otherwise.

Implements vProjector.

Definition at line 116 of file iProjectorJoseph.cc.

void iProjectorJoseph::ShowHelpSpecific ( )
privatevirtual

A function used to show help about the child module.

This function must describe what the projector does and how to use it. It describes in details the different parameters of the projector, and how to set them through the use of a configuration file or a list of options. It is pure virtual so is implemented by children. It is private because called by the public ShowHelp() function.

Implements vProjector.

Definition at line 129 of file iProjectorJoseph.cc.

Member Data Documentation

HPFLTNB iProjectorJoseph::m_boundX
private

Limit bound for X-axis

Definition at line 181 of file iProjectorJoseph.hh.

HPFLTNB iProjectorJoseph::m_boundY
private

Limit bound for Y-axis

Definition at line 182 of file iProjectorJoseph.hh.

HPFLTNB iProjectorJoseph::m_boundZ
private

Limit bound for Z-axis

Definition at line 183 of file iProjectorJoseph.hh.

HPFLTNB iProjectorJoseph::m_toleranceX
private

Tolerance to avoid error on boundaries, for X axis

Definition at line 178 of file iProjectorJoseph.hh.

HPFLTNB iProjectorJoseph::m_toleranceY
private

Tolerance to avoid error on boundaries, for Y axis

Definition at line 179 of file iProjectorJoseph.hh.

HPFLTNB iProjectorJoseph::m_toleranceZ
private

Tolerance to avoid error on boundaries, for Z axis

Definition at line 180 of file iProjectorJoseph.hh.

HPFLTNB* iProjectorJoseph::mp_boundariesX
private

Boundaries for X axis

Definition at line 171 of file iProjectorJoseph.hh.

HPFLTNB* iProjectorJoseph::mp_boundariesY
private

Boundaries for Y axis

Definition at line 172 of file iProjectorJoseph.hh.

HPFLTNB* iProjectorJoseph::mp_boundariesZ
private

Boundaries for Z axis

Definition at line 173 of file iProjectorJoseph.hh.

uint8_t* iProjectorJoseph::mp_maskPad
private

Mask for the padded image space

Definition at line 174 of file iProjectorJoseph.hh.


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