CASToR  3.2
Tomographic Reconstruction (PET/SPECT/CT)
Public Member Functions | Static Public Member Functions | Private Member Functions | Private Attributes | List of all members
oImageConvolverManager Class Reference

This class is designed to manage the different image convolvers and to apply them. More...

#include <oImageConvolverManager.hh>

Collaboration diagram for oImageConvolverManager:
Collaboration graph

Public Member Functions

 oImageConvolverManager ()
 The constructor of oImageConvolverManager. More...
 
 ~oImageConvolverManager ()
 The destructor of oImageConvolverManager. More...
 
int CheckParameters ()
 A function used to check the parameters settings. More...
 
int Initialize ()
 A function used to initialize the manager and all image convolvers it manages. More...
 
int ConvolveForward (oImageSpace *ap_ImageSpace)
 
int ConvolveBackward (oImageSpace *ap_ImageSpace)
 
int ConvolveSensitivity (oImageSpace *ap_ImageSpace)
 
int ConvolveIntra (oImageSpace *ap_ImageSpace)
 
int ConvolvePost (oImageSpace *ap_ImageSpace)
 
void SetVerbose (int a_verboseLevel)
 
void SetImageDimensionsAndQuantification (oImageDimensionsAndQuantification *ap_ImageDimensionsAndQuantification)
 
void SetOptions (vector< string > a_options)
 
 oImageConvolverManager ()
 
 ~oImageConvolverManager ()
 
int CheckParameters ()
 
int Initialize ()
 
int ApplyConvolution (FLTNB *ap_image)
 A function that simply calls the eponym function from the vImageConvolver. More...
 
int ConvolveForward (oImageSpace *ap_ImageSpace)
 
int ConvolveBackward (oImageSpace *ap_ImageSpace)
 
int ConvolveSensitivity (oImageSpace *ap_ImageSpace)
 
int ConvolveIntra (oImageSpace *ap_ImageSpace)
 
int ConvolvePost (oImageSpace *ap_ImageSpace)
 
void SetVerbose (int a_verboseLevel)
 
void SetImageDimensionsAndQuantification (oImageDimensionsAndQuantification *ap_ImageDimensionsAndQuantification)
 
void SetOptions (vector< string > a_options)
 

Static Public Member Functions

static void ShowCommonHelp ()
 This function does not take any parameter and is used to display some help about the syntax of the options describing the image convolvers that should be used. It is static so that it can be called without any object initialization. More...
 
static void ShowCommonHelp ()
 

Private Member Functions

int ParseOptionsAndInitializeImageConvolvers ()
 A function used to parse options and initialize image convolvers. More...
 
int ParseOptionsAndInitializeImageConvolvers ()
 

Private Attributes

oImageDimensionsAndQuantificationmp_ImageDimensionsAndQuantification
 
vector< string > m_options
 
int m_nbImageConvolvers
 
vImageConvolver ** m2p_ImageConvolvers
 
bool * mp_applyForward
 
bool * mp_applyBackward
 
bool * mp_applyIntra
 
bool * mp_applyPost
 
bool m_checked
 
bool m_initialized
 
int m_verbose
 

Detailed Description

This class is designed to manage the different image convolvers and to apply them.

This manager class is supposed to be created and initialized in the main program. To do so, the following steps must be used:
(i) The empty constructor is called which affect all members with default values.
(ii) All parameters are set through the use of SetXXX() functions.
(iii) The CheckParameters() function is called to check that everything mandatory has been set.
(iv) The Initialize() function is called to initialize everything.
(v) Now the action functions of the manager can be called to apply the different image convolvers.
In a few words, based on supplied options, the manager will create children of the abstract vImageConvolver class which are specific image convolver modules. As an example, see the iImageConvolverTemplate child class that illustrates how a specific image convolver module should be implemented.

Definition at line 31 of file code/include/image/oImageConvolverManager.hh.

Constructor & Destructor Documentation

◆ oImageConvolverManager() [1/2]

oImageConvolverManager::oImageConvolverManager ( )

The constructor of oImageConvolverManager.

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 16 of file code/src/image/oImageConvolverManager.cc.

◆ ~oImageConvolverManager() [1/2]

oImageConvolverManager::~oImageConvolverManager ( )

The destructor of oImageConvolverManager.

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 build by this class.

Definition at line 41 of file code/src/image/oImageConvolverManager.cc.

◆ oImageConvolverManager() [2/2]

oImageConvolverManager::oImageConvolverManager ( )

◆ ~oImageConvolverManager() [2/2]

oImageConvolverManager::~oImageConvolverManager ( )

Member Function Documentation

◆ ApplyConvolution()

public inline int oImageConvolverManager::ApplyConvolution ( FLTNB ap_image)
inline

A function that simply calls the eponym function from the vImageConvolver.

Parameters
FLTNB*ap_image

It will apply a convolution on the provided image, calling the . The convolver is not applied on the dynamic dimensions. This function may be used in specific optimizers needing to apply image-based PSF modeling on a specific image.

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

Definition at line 95 of file include/image/oImageConvolverManager.hh.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ CheckParameters() [1/2]

int oImageConvolverManager::CheckParameters ( )

A function used to check the parameters settings.

This function does not take any parameter and is used to check that all mandatory members were correctly parameterized.

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

Definition at line 56 of file code/src/image/oImageConvolverManager.cc.

Here is the caller graph for this function:

◆ CheckParameters() [2/2]

int oImageConvolverManager::CheckParameters ( )

◆ ConvolveBackward() [1/2]

int oImageConvolverManager::ConvolveBackward ( oImageSpace ap_ImageSpace)

Definition at line 380 of file code/src/image/oImageConvolverManager.cc.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ConvolveBackward() [2/2]

int oImageConvolverManager::ConvolveBackward ( oImageSpace ap_ImageSpace)

◆ ConvolveForward() [1/2]

int oImageConvolverManager::ConvolveForward ( oImageSpace ap_ImageSpace)

Definition at line 333 of file code/src/image/oImageConvolverManager.cc.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ConvolveForward() [2/2]

int oImageConvolverManager::ConvolveForward ( oImageSpace ap_ImageSpace)

◆ ConvolveIntra() [1/2]

int oImageConvolverManager::ConvolveIntra ( oImageSpace ap_ImageSpace)

Definition at line 459 of file code/src/image/oImageConvolverManager.cc.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ConvolveIntra() [2/2]

int oImageConvolverManager::ConvolveIntra ( oImageSpace ap_ImageSpace)

◆ ConvolvePost() [1/2]

int oImageConvolverManager::ConvolvePost ( oImageSpace ap_ImageSpace)

Definition at line 554 of file code/src/image/oImageConvolverManager.cc.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ConvolvePost() [2/2]

int oImageConvolverManager::ConvolvePost ( oImageSpace ap_ImageSpace)

◆ ConvolveSensitivity() [1/2]

int oImageConvolverManager::ConvolveSensitivity ( oImageSpace ap_ImageSpace)

Definition at line 506 of file code/src/image/oImageConvolverManager.cc.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ConvolveSensitivity() [2/2]

int oImageConvolverManager::ConvolveSensitivity ( oImageSpace ap_ImageSpace)

◆ Initialize() [1/2]

int oImageConvolverManager::Initialize ( )

A function used to initialize the manager and all image convolvers it manages.

This function does not take any parameter and is used to initialize everything that should be initialized. In a few words, it parses the options, then creates and initializes all image convolvers based on the provided options.

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

Definition at line 117 of file code/src/image/oImageConvolverManager.cc.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ Initialize() [2/2]

int oImageConvolverManager::Initialize ( )

◆ ParseOptionsAndInitializeImageConvolvers() [1/2]

int oImageConvolverManager::ParseOptionsAndInitializeImageConvolvers ( )
private

A function used to parse options and initialize image convolvers.

This function first parses the options contained in the member m_options. Each string of the vector describes an image convolver to be used. Based on a specific syntax, the options are parsed to get the name of the convolver module, its associated parameters and the steps of application. Based on this, the image convolvers are initialized. This function is private because it is called by the Initialize() function.

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

Definition at line 150 of file code/src/image/oImageConvolverManager.cc.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ParseOptionsAndInitializeImageConvolvers() [2/2]

int oImageConvolverManager::ParseOptionsAndInitializeImageConvolvers ( )
private

◆ SetImageDimensionsAndQuantification() [1/2]

void oImageConvolverManager::SetImageDimensionsAndQuantification ( oImageDimensionsAndQuantification ap_ImageDimensionsAndQuantification)
inline

Definition at line 172 of file code/include/image/oImageConvolverManager.hh.

Here is the caller graph for this function:

◆ SetImageDimensionsAndQuantification() [2/2]

void oImageConvolverManager::SetImageDimensionsAndQuantification ( oImageDimensionsAndQuantification ap_ImageDimensionsAndQuantification)
inline

Definition at line 184 of file include/image/oImageConvolverManager.hh.

◆ SetOptions() [1/2]

void oImageConvolverManager::SetOptions ( vector< string >  a_options)
inline

Definition at line 179 of file code/include/image/oImageConvolverManager.hh.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ SetOptions() [2/2]

void oImageConvolverManager::SetOptions ( vector< string >  a_options)
inline

Definition at line 191 of file include/image/oImageConvolverManager.hh.

Here is the call graph for this function:

◆ SetVerbose() [1/2]

void oImageConvolverManager::SetVerbose ( int  a_verboseLevel)
inline

Definition at line 165 of file code/include/image/oImageConvolverManager.hh.

Here is the caller graph for this function:

◆ SetVerbose() [2/2]

void oImageConvolverManager::SetVerbose ( int  a_verboseLevel)
inline

Definition at line 177 of file include/image/oImageConvolverManager.hh.

◆ ShowCommonHelp() [1/2]

void oImageConvolverManager::ShowCommonHelp ( )
static

This function does not take any parameter and is used to display some help about the syntax of the options describing the image convolvers that should be used. It is static so that it can be called without any object initialization.

Definition at line 81 of file code/src/image/oImageConvolverManager.cc.

Here is the caller graph for this function:

◆ ShowCommonHelp() [2/2]

static void oImageConvolverManager::ShowCommonHelp ( )
static

Member Data Documentation

◆ m2p_ImageConvolvers

vImageConvolver ** oImageConvolverManager::m2p_ImageConvolvers
private

The actual convolvers (as many as m_nbImageConvolvers)

Definition at line 208 of file code/include/image/oImageConvolverManager.hh.

◆ m_checked

bool oImageConvolverManager::m_checked
private

A boolean that says if the function CheckParameters() has been called

Definition at line 213 of file code/include/image/oImageConvolverManager.hh.

◆ m_initialized

bool oImageConvolverManager::m_initialized
private

A boolean that says if the function Initialize() has been called

Definition at line 214 of file code/include/image/oImageConvolverManager.hh.

◆ m_nbImageConvolvers

int oImageConvolverManager::m_nbImageConvolvers
private

The number of convolvers managed by this manager

Definition at line 207 of file code/include/image/oImageConvolverManager.hh.

◆ m_options

vector< string > oImageConvolverManager::m_options
private

A vector containing strings of options, each string is associated to a convolver

Definition at line 206 of file code/include/image/oImageConvolverManager.hh.

◆ m_verbose

int oImageConvolverManager::m_verbose
private

The verbose level associated to this class

Definition at line 215 of file code/include/image/oImageConvolverManager.hh.

◆ mp_applyBackward

bool * oImageConvolverManager::mp_applyBackward
private

As many booleans as m_nbImageConvolvers specifying if each convolver should be apply within the ConvolveBackward function

Definition at line 210 of file code/include/image/oImageConvolverManager.hh.

◆ mp_applyForward

bool * oImageConvolverManager::mp_applyForward
private

As many booleans as m_nbImageConvolvers specifying if each convolver should be apply within the ConvolveForward function

Definition at line 209 of file code/include/image/oImageConvolverManager.hh.

◆ mp_applyIntra

bool * oImageConvolverManager::mp_applyIntra
private

As many booleans as m_nbImageConvolvers specifying if each convolver should be apply within the ConvolveIntra function

Definition at line 211 of file code/include/image/oImageConvolverManager.hh.

◆ mp_applyPost

bool * oImageConvolverManager::mp_applyPost
private

As many booleans as m_nbImageConvolvers specifying if each convolver should be apply within the ConvolvePost function

Definition at line 212 of file code/include/image/oImageConvolverManager.hh.

◆ mp_ImageDimensionsAndQuantification

oImageDimensionsAndQuantification * oImageConvolverManager::mp_ImageDimensionsAndQuantification
private

The image dimensions

Definition at line 205 of file code/include/image/oImageConvolverManager.hh.


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