CASToR
3.0
Tomographic Reconstruction (PET/SPECT/CT)
|
This class implements the "median root prior". More...
#include <iPenaltyMedianRootPrior.hh>
Public Member Functions | |
iPenaltyMedianRootPrior () | |
The constructor of iPenaltyMedianRootPrior. More... | |
~iPenaltyMedianRootPrior () | |
The destructor of iPenaltyMedianRootPrior. 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... | |
int | LocalPreProcessingStep (int a_tbf, int a_rbf, int a_cbf, INTNB a_voxel, int a_th) |
A public function computing a local pre-processing step for the penalty. More... | |
FLTNB | ComputePenaltyValue (int a_tbf, int a_rbf, int a_cbf, INTNB a_voxel, int a_th) |
Implementation of the pure virtual vPenalty::ComputePenaltyValue() More... | |
FLTNB | ComputeFirstDerivative (int a_tbf, int a_rbf, int a_cbf, INTNB a_voxel, int a_th) |
Implementation of the pure virtual vPenalty::ComputeFirstDerivative() More... | |
FLTNB | ComputeSecondDerivative (int a_tbf, int a_rbf, int a_cbf, INTNB a_voxel, int a_th) |
Implementation of the pure virtual vPenalty::ComputeSecondDerivative() More... | |
Public Member Functions inherited from vPenalty | |
vPenalty () | |
The constructor of vPenalty. More... | |
virtual | ~vPenalty () |
The destructor of vPenalty. More... | |
void | ShowHelp () |
A function used to show help about the penalty. More... | |
int | CheckParameters () |
A public function used to check the parameters settings. More... | |
int | Initialize () |
A public function used to initialize the penalty. More... | |
virtual int | GlobalPreProcessingStep () |
A public function computing a global pre-processing step for the penalty. More... | |
void | SetVerbose (int a_verbose) |
Set the verbose level. More... | |
void | SetImageDimensionsAndQuantification (oImageDimensionsAndQuantification *ap_ImageDimensionsAndQuantification) |
Set the pointer to the image dimensions in use. More... | |
void | SetImageSpace (oImageSpace *ap_ImageSpace) |
Set the pointer to the image space in use. More... | |
void | SetPenaltyStrength (FLTNB a_penaltyStrength) |
Set the penalty strength. More... | |
FLTNB | GetPenaltyStrength () |
Get the penalty strength. More... | |
int | GetPenaltyDerivativesOrder () |
Get the penalty deratives order. More... | |
void | SetPenaltyID (const string &a_penaltyID) |
Set the penalty ID. More... | |
const string & | GetPenaltyID () |
Private Member Functions | |
void | ShowHelpSpecific () |
A function used to show help about the child penalty. More... | |
int | CheckSpecificParameters () |
A private function used to check the parameters settings specific to the child penalty. More... | |
int | InitializeSpecific () |
This function is used to initialize specific stuff to the child penalty. More... | |
int | BuildNeighborhoodKernel () |
A function used to build the neighborhood kernel. More... | |
int | BuildSpecificNeighborhood (INTNB a_voxel, int a_th) |
int | ComputeMedianInNeighborhood (int a_tbf, int a_rbf, int a_cbf, INTNB a_voxel, int a_th) |
A private function computing the median in the neighborhood of the provided index. More... | |
Additional Inherited Members | |
Protected Attributes inherited from vPenalty | |
string | m_penaltyID |
oImageDimensionsAndQuantification * | mp_ImageDimensionsAndQuantification |
oImageSpace * | mp_ImageSpace |
int | m_verbose |
int | m_penaltyDerivativesOrder |
FLTNB | m_penaltyStrength |
This class implements the "median root prior".
This class inherits from vPenalty and implements the "median root prior".
Definition at line 52 of file iPenaltyMedianRootPrior.hh.
iPenaltyMedianRootPrior::iPenaltyMedianRootPrior | ( | ) |
The constructor of iPenaltyMedianRootPrior.
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 37 of file iPenaltyMedianRootPrior.cc.
iPenaltyMedianRootPrior::~iPenaltyMedianRootPrior | ( | ) |
The destructor of iPenaltyMedianRootPrior.
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 60 of file iPenaltyMedianRootPrior.cc.
|
private |
A function used to build the neighborhood kernel.
This function build the table m2p_neighborhoodKernel, that prepare neighborhood indices operations. It is called only one time at initialization. The kernel will be used when computing the specific neighborhood of any voxel later on.
Definition at line 277 of file iPenaltyMedianRootPrior.cc.
|
private |
Definition at line 410 of file iPenaltyMedianRootPrior.cc.
|
privatevirtual |
A private function used to check the parameters settings specific to the child penalty.
This function is used to check that all parameters specific to the penalty 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 vPenalty.
Implements vPenalty.
Definition at line 197 of file iPenaltyMedianRootPrior.cc.
|
virtual |
Implementation of the pure virtual vPenalty::ComputeFirstDerivative()
int | a_tbf |
int | a_rbf |
int | a_cbf |
INTNB | a_voxel |
int | a_th |
This function computes the first derivative of the penalty. It is the implementation of the pure virtual vPenalty::ComputeFirstDerivative().
Implements vPenalty.
Definition at line 527 of file iPenaltyMedianRootPrior.cc.
|
private |
A private function computing the median in the neighborhood of the provided index.
int | a_tbf |
int | a_rbf |
int | a_cbf |
INTNB | a_voxel |
int | a_th |
This function sorts the values of neighbors and store the median in the m2p_medianValue table for the current thread.
Definition at line 476 of file iPenaltyMedianRootPrior.cc.
|
virtual |
Implementation of the pure virtual vPenalty::ComputePenaltyValue()
int | a_tbf |
int | a_rbf |
int | a_cbf |
INTNB | a_voxel |
int | a_th |
This function computes the value of the penalty function for the provided indices. It is the implementation of the pure virtual vPenalty::ComputePenaltyValue().
Implements vPenalty.
Definition at line 510 of file iPenaltyMedianRootPrior.cc.
|
virtual |
Implementation of the pure virtual vPenalty::ComputeSecondDerivative()
int | a_tbf |
int | a_rbf |
int | a_cbf |
INTNB | a_voxel |
int | a_th |
This function computes the second derivative of the penalty. It is the implementation of the pure virtual vPenalty::ComputeSecondDerivative().
Implements vPenalty.
Definition at line 542 of file iPenaltyMedianRootPrior.cc.
|
privatevirtual |
This function is used to initialize specific stuff to the child penalty.
It is called by the public Initialize() function from the mother.
Implements vPenalty.
Definition at line 225 of file iPenaltyMedianRootPrior.cc.
|
virtual |
A public function computing a local pre-processing step for the penalty.
int | a_tbf |
int | a_rbf |
int | a_cbf |
INTNB | a_voxel |
int | a_th |
This function overloads the mother class function that does nothing. The idea here is to build the specific neighborhood of the given voxel.
Reimplemented from vPenalty.
Definition at line 453 of file iPenaltyMedianRootPrior.cc.
|
virtual |
A function used to read options from a configuration file.
const | string& a_configurationFile |
This function implements the reading of all options associated to the child penalty, from a configuration file. It is the implementation of the pure virtual function inherited from the abstract class vPenalty. It checks the reading status but not the options values that will be checked by the CheckSpecificParameters() function.
Implements vPenalty.
Definition at line 119 of file iPenaltyMedianRootPrior.cc.
|
virtual |
A function used to read options from a list of options.
const | string& a_optionsList |
This function implements the reading of all options associated to the child penalty, from a list of options. It is the implementation of the pure virtual function inherited from the abstract class vPenalty. It checks the reading status but not the options values that will be checked by the CheckSpecificParameters() function.
Implements vPenalty.
Definition at line 185 of file iPenaltyMedianRootPrior.cc.
|
privatevirtual |
A function used to show help about the child penalty.
This function must describe what the module does and how to use it. It describes in details the different parameters of the penalty, and how to set them through the use of a configuration file or a list of options. It is the implementation of the pure virtual function inherited from the abstract class vPenalty. It is called by the public ShowHelp() function.
Implements vPenalty.
Definition at line 94 of file iPenaltyMedianRootPrior.cc.
|
private |
Neighborhood indices of a specific voxel. First index is on the threads, second one contains the list of the voxels in the neighborhood (as many as m_neighborhoodMaxNbVoxels). It follows strictly the same order than m2p_neighborhoodKernel, with the convention -1: out of image boundaries
Definition at line 228 of file iPenaltyMedianRootPrior.hh.
|
private |
Neighborhood of a virtual voxel of coordinates 0, 0, 0 without boundary. First index on neighboring voxels, second one on indexes
Definition at line 226 of file iPenaltyMedianRootPrior.hh.
|
private |
In case of a box neighborhood, remove the corners as in some papers, or not (keep them by default)
Definition at line 224 of file iPenaltyMedianRootPrior.hh.
|
private |
In case of a box neighborhood, order of the box
Definition at line 223 of file iPenaltyMedianRootPrior.hh.
|
private |
Maximum number of voxels in the neighborhood
Definition at line 225 of file iPenaltyMedianRootPrior.hh.
|
private |
Type of neighborhood (sphere, box)
Definition at line 221 of file iPenaltyMedianRootPrior.hh.
|
private |
In case of a spherical neighborhood, radius of the sphere
Definition at line 222 of file iPenaltyMedianRootPrior.hh.
|
private |
Used to store the median value of the neighborhood, per thread
Definition at line 230 of file iPenaltyMedianRootPrior.hh.
|
private |
Number of voxels in a specific neighborhood. The index is on threads
Definition at line 227 of file iPenaltyMedianRootPrior.hh.