PARTONS  
PARtonic Tomography Of Nucleon Software
Public Member Functions | Static Public Attributes | Protected Member Functions | Protected Attributes | List of all members
PARTONS::DDVCSProcessModule Class Referenceabstract

Abstract class for computing the differential cross section of the photon electroproduction process (also called DDVCS; Deeply Virtual Compton Scattering). More...

Inheritance diagram for PARTONS::DDVCSProcessModule:
PARTONS::ProcessModule< DDVCSObservableKinematic, DDVCSObservableResult > PARTONS::ModuleObject PARTONS::BaseObject PARTONS::DDVCSProcessDMSW22

Public Member Functions

virtual ~DDVCSProcessModule ()
 Destructor. More...
 
virtual DDVCSProcessModuleclone () const =0
 Virtual clone function to allow the factory to clone all derived members object stored in the BaseObjectRegistry. More...
 
virtual std::string toString () const
 Return a pre-formatted characters string for output visualization of class member's values. More...
 
virtual void resolveObjectDependencies ()
 Because of the initialization step order of the program, objects are registered in a total random order and some objects depend on others. More...
 
virtual void run ()
 
virtual void configure (const ElemUtils::Parameters &parameters)
 Provides a generic method to configure all types of modules by passing a Parameters object. More...
 
virtual void prepareSubModules (const std::map< std::string, BaseObjectData > &subModulesData)
 Method used in automation to prepare all the modules used by this current module and configure them recursively. More...
 
virtual DDVCSObservableResult compute (double beamHelicity, double beamCharge, NumA::Vector3D targetPolarization, const DDVCSObservableKinematic &kinematic, const List< GPDType > &gpdType=List< GPDType >())
 
virtual List< GPDTypegetListOfAvailableGPDTypeForComputation () const
 Must be implemented in child class. More...
 
DDVCSObservableResult compute (double beamHelicity, double beamCharge, NumA::Vector3D targetPolarization, const DDVCSObservableKinematic &kinematic, const List< GPDType > &gpdType, VCSSubProcessType::Type processType)
 Computes the differential cross-section. More...
 
virtual void resetPreviousKinematic ()
 Reset previous kinematics. More...
 
bool isPreviousCCFKinematicDifferent (const DDVCSConvolCoeffFunctionKinematic &kinematic) const
 Check if this kinematics is different than the previous one. More...
 
DDVCSScalesModulegetScaleModule () const
 Get scale module. More...
 
void setScaleModule (DDVCSScalesModule *pScaleModule)
 Set scale module. More...
 
DDVCSXiConverterModulegetXiConverterModule () const
 Get xi converter module. More...
 
void setXiConverterModule (DDVCSXiConverterModule *pXiConverterModule)
 Set xi converted module. More...
 
DDVCSConvolCoeffFunctionModulegetConvolCoeffFunctionModule () const
 Get CCF module;. More...
 
void setConvolCoeffFunctionModule (DDVCSConvolCoeffFunctionModule *pConvolCoeffFunctionModule)
 Set CCF module. More...
 
virtual PhysicalType< double > CrossSectionBH ()
 Bethe-Heitler differential cross section. More...
 
virtual PhysicalType< double > CrossSectionVCS ()
 Virtual Compton Scattering differential cross section. More...
 
virtual PhysicalType< double > CrossSectionInterf ()
 Interference differential cross section. More...
 
- Public Member Functions inherited from PARTONS::ProcessModule< DDVCSObservableKinematic, DDVCSObservableResult >
virtual ~ProcessModule ()
 Destructor. More...
 
bool isCCFModuleDependent () const
 Check if this process module depends on a CCF module. More...
 
void setIsCCFModuleDependent (bool isCCFModuleDependent)
 Set if this process module depends on a CCF module. More...
 
- Public Member Functions inherited from PARTONS::ModuleObject
 ModuleObject (const std::string &className, ChannelType::Type channelType)
 Constructor. More...
 
virtual ~ModuleObject ()
 Default destructor. More...
 
unsigned int getReferenceModuleId () const
 Get reference module id. More...
 
void setReferenceModuleId (unsigned int referenceModuleId)
 Set reference module id. More...
 
ChannelType::Type getChannelType () const
 Get channel type. More...
 
- Public Member Functions inherited from PARTONS::BaseObject
 BaseObject (const std::string &className)
 Constructor. More...
 
virtual ~BaseObject ()
 Default destructor. More...
 
void serialize (ElemUtils::Packet &packet) const
 Used to split a complex C++ object into a concatenation of simple types. More...
 
void unserialize (ElemUtils::Packet &packet)
 Used to rebuild a complex C++ object from a concatenation of simple type. More...
 
bool operator< (const BaseObject &other) const
 Overload of < operator to sort BaseObject object by its indexId value. More...
 
const std::string & getClassName () const
 
unsigned int getObjectId () const
 
int getIndexId () const
 
void setIndexId (int indexId)
 

Static Public Attributes

static const std::string DDVCS_PROCESS_MODULE_CLASS_NAME
 Type of the module in XML automation. More...
 
- Static Public Attributes inherited from PARTONS::ModuleObject
static const std::string CLASS_NAME = "className"
 

Protected Member Functions

 DDVCSProcessModule (const std::string &className)
 Default constructor. More...
 
 DDVCSProcessModule (const DDVCSProcessModule &other)
 Copy constructor. More...
 
virtual void setKinematics (const DDVCSObservableKinematic &kinematic)
 Set internal kinematics. More...
 
virtual void setExperimentalConditions (double beamHelicity, double beamCharge, NumA::Vector3D targetPolarization)
 
virtual void initModule ()
 Pure virtual function that provides skeleton for module initialization. More...
 
virtual void isModuleWellConfigured ()
 Pure virtual function that provides skeleton to check if the module is well initialized and configured. More...
 
void computeConvolCoeffFunction (const DDVCSObservableKinematic &kinematic, const List< GPDType > &gpdType=List< GPDType >())
 Compute CCF for a given kinematics. More...
 
std::complex< double > getConvolCoeffFunctionValue (GPDType::Type gpdType)
 Gives back a previously computed Compton Form Factor. More...
 
- Protected Member Functions inherited from PARTONS::ProcessModule< DDVCSObservableKinematic, DDVCSObservableResult >
 ProcessModule (const std::string &className, ChannelType::Type channelType)
 Constructor. More...
 
 ProcessModule (const ProcessModule &other)
 Copy constructor. More...
 
- Protected Member Functions inherited from PARTONS::ModuleObject
 ModuleObject (const ModuleObject &other)
 
- Protected Member Functions inherited from PARTONS::BaseObject
 BaseObject (const BaseObject &other)
 Copy constructor. More...
 
void info (const std::string &functionName, const std::string &message) const
 Print info message into logger. More...
 
void debug (const std::string &functionName, const std::string &message) const
 Print debug message into logger. More...
 
void warn (const std::string &functionName, const std::string &message) const
 Print warning message into logger. More...
 
void errorMissingParameter (const std::string &parameterName) const
 Use in automation process to throw exception when a parameter is missing from the XML scenario file. More...
 

Protected Attributes

double m_xB
 Bjorken variable. More...
 
double m_t
 Mandelstam variable (square of the 4-momentum transferm in GeV2). More...
 
double m_Q2
 Virtuality of the incoming photon (in GeV2). More...
 
double m_Q2Prim
 Virtuality of the outgoing photon (in GeV2). More...
 
double m_E
 Beam energy in target rest frame (in GeV). More...
 
double m_phi
 Angle between leptonic and hadronic plane (in radians, Trento convention). More...
 
double m_phiL
 Azimuthal angle of the lepton pair (in radians). More...
 
double m_thetaL
 Polar angle of the lepton pair (in radians). More...
 
double m_beamHelicity
 Beam helicity. More...
 
double m_beamCharge
 Beam charge. More...
 
NumA::Vector3D m_targetPolarization
 Target polarization. More...
 
DDVCSScalesModulem_pScaleModule
 Pointer to the underlying scale module. More...
 
DDVCSXiConverterModulem_pXiConverterModule
 Pointer to the underlying xi converter module. More...
 
DDVCSConvolCoeffFunctionModulem_pConvolCoeffFunctionModule
 Pointer to the underlying CCF module. More...
 
DDVCSConvolCoeffFunctionResult m_dvcsConvolCoeffFunctionResult
 Stored Compton Form Factor result. More...
 
DDVCSConvolCoeffFunctionKinematic m_lastCCFKinematics
 Last Compton Form Factor kinematics. More...
 
- Protected Attributes inherited from PARTONS::ProcessModule< DDVCSObservableKinematic, DDVCSObservableResult >
bool m_isCCFModuleDependent
 Boolean (true if this Process module depends on a CCF module). More...
 
- Protected Attributes inherited from PARTONS::ModuleObject
ModuleObjectFactorym_pModuleObjectFactory
 Pointer tp module object factory. More...
 

Detailed Description

Abstract class for computing the differential cross section of the photon electroproduction process (also called DDVCS; Deeply Virtual Compton Scattering).

The cross-section is five-fold differential with respect to the variables: \( x_B \), \( Q^2 \), \( t \) and the two angles.

Constructor & Destructor Documentation

◆ ~DDVCSProcessModule()

PARTONS::DDVCSProcessModule::~DDVCSProcessModule ( )
virtual

Destructor.

◆ DDVCSProcessModule() [1/2]

PARTONS::DDVCSProcessModule::DDVCSProcessModule ( const std::string &  className)
protected

Default constructor.

◆ DDVCSProcessModule() [2/2]

PARTONS::DDVCSProcessModule::DDVCSProcessModule ( const DDVCSProcessModule other)
protected

Copy constructor.

Parameters
otherObject to be copied.

Member Function Documentation

◆ clone()

virtual DDVCSProcessModule* PARTONS::DDVCSProcessModule::clone ( ) const
pure virtual

Virtual clone function to allow the factory to clone all derived members object stored in the BaseObjectRegistry.

Returns

Implements PARTONS::ProcessModule< DDVCSObservableKinematic, DDVCSObservableResult >.

Implemented in PARTONS::DDVCSProcessDMSW22.

◆ compute() [1/2]

DDVCSObservableResult PARTONS::DDVCSProcessModule::compute ( double  beamHelicity,
double  beamCharge,
NumA::Vector3D  targetPolarization,
const DDVCSObservableKinematic kinematic,
const List< GPDType > &  gpdType,
VCSSubProcessType::Type  processType 
)

Computes the differential cross-section.

Must be implemented in the child class.

Parameters
beamHelicityHelicity of the beam (in units of hbar/2).
beamChargeCharge of the beam (in units of positron charge).
targetPolarizationPolarization of the target. In GV conventions.
kinematicKinematics.
processTypeSubprocess type.
Returns
Result.

◆ compute() [2/2]

DDVCSObservableResult PARTONS::DDVCSProcessModule::compute ( double  beamHelicity,
double  beamCharge,
NumA::Vector3D  targetPolarization,
const DDVCSObservableKinematic kinematic,
const List< GPDType > &  gpdType = List<GPDType>() 
)
virtual

◆ computeConvolCoeffFunction()

void PARTONS::DDVCSProcessModule::computeConvolCoeffFunction ( const DDVCSObservableKinematic kinematic,
const List< GPDType > &  gpdType = List<GPDType>() 
)
protected

Compute CCF for a given kinematics.

Parameters
kinematicKinematics to be computed.
gpdTypeList of GPD types to be computed.

◆ configure()

void PARTONS::DDVCSProcessModule::configure ( const ElemUtils::Parameters &  parameters)
virtual

Provides a generic method to configure all types of modules by passing a Parameters object.

Parameters class represents a list of couples key/value (see Parameters class documentation for more info).

Parameters
parametersElemUtils::Parameters object.

Reimplemented from PARTONS::ProcessModule< DDVCSObservableKinematic, DDVCSObservableResult >.

◆ CrossSectionBH()

PhysicalType< double > PARTONS::DDVCSProcessModule::CrossSectionBH ( )
virtual

Bethe-Heitler differential cross section.

Reimplemented in PARTONS::DDVCSProcessDMSW22.

◆ CrossSectionInterf()

PhysicalType< double > PARTONS::DDVCSProcessModule::CrossSectionInterf ( )
virtual

Interference differential cross section.

Reimplemented in PARTONS::DDVCSProcessDMSW22.

◆ CrossSectionVCS()

PhysicalType< double > PARTONS::DDVCSProcessModule::CrossSectionVCS ( )
virtual

Virtual Compton Scattering differential cross section.

Reimplemented in PARTONS::DDVCSProcessDMSW22.

◆ getConvolCoeffFunctionModule()

DDVCSConvolCoeffFunctionModule * PARTONS::DDVCSProcessModule::getConvolCoeffFunctionModule ( ) const

Get CCF module;.

◆ getConvolCoeffFunctionValue()

std::complex< double > PARTONS::DDVCSProcessModule::getConvolCoeffFunctionValue ( GPDType::Type  gpdType)
protected

Gives back a previously computed Compton Form Factor.

Parameters
gpdTypeCFF type (e.g. H or E).
Returns
CFF value for the given type.

◆ getListOfAvailableGPDTypeForComputation()

List< GPDType > PARTONS::DDVCSProcessModule::getListOfAvailableGPDTypeForComputation ( ) const
virtual

Must be implemented in child class.

Returns
List of GPD/CCF types the child class can compute.

Implements PARTONS::ProcessModule< DDVCSObservableKinematic, DDVCSObservableResult >.

◆ getScaleModule()

DDVCSScalesModule * PARTONS::DDVCSProcessModule::getScaleModule ( ) const

Get scale module.

◆ getXiConverterModule()

DDVCSXiConverterModule * PARTONS::DDVCSProcessModule::getXiConverterModule ( ) const

Get xi converter module.

◆ initModule()

void PARTONS::DDVCSProcessModule::initModule ( )
protectedvirtual

Pure virtual function that provides skeleton for module initialization.

Children must define and override it.

Reimplemented from PARTONS::ProcessModule< DDVCSObservableKinematic, DDVCSObservableResult >.

Reimplemented in PARTONS::DDVCSProcessDMSW22.

◆ isModuleWellConfigured()

void PARTONS::DDVCSProcessModule::isModuleWellConfigured ( )
protectedvirtual

Pure virtual function that provides skeleton to check if the module is well initialized and configured.

Children must define and override it.

Reimplemented from PARTONS::ProcessModule< DDVCSObservableKinematic, DDVCSObservableResult >.

Reimplemented in PARTONS::DDVCSProcessDMSW22.

◆ isPreviousCCFKinematicDifferent()

bool PARTONS::DDVCSProcessModule::isPreviousCCFKinematicDifferent ( const DDVCSConvolCoeffFunctionKinematic kinematic) const

Check if this kinematics is different than the previous one.

◆ prepareSubModules()

void PARTONS::DDVCSProcessModule::prepareSubModules ( const std::map< std::string, BaseObjectData > &  subModulesData)
virtual

Method used in automation to prepare all the modules used by this current module and configure them recursively.

The recursion is linked to the imbrication in XML files.
Can be implemented in the child class if it needs modules not needed by the parent class. But there must be first a call to the parent method.

Parameters
subModulesDataData used to retrieve the needed modules and their configuration.

Reimplemented from PARTONS::ProcessModule< DDVCSObservableKinematic, DDVCSObservableResult >.

◆ resetPreviousKinematic()

void PARTONS::DDVCSProcessModule::resetPreviousKinematic ( )
virtual

Reset previous kinematics.

◆ resolveObjectDependencies()

void PARTONS::DDVCSProcessModule::resolveObjectDependencies ( )
virtual

Because of the initialization step order of the program, objects are registered in a total random order and some objects depend on others.

To avoid the problem of pointer resolution order, this method is called by the BaseObjectRegistery after all objects are well registered in it. See BaseObjectRegistry class documentation for more details.

Reimplemented from PARTONS::ProcessModule< DDVCSObservableKinematic, DDVCSObservableResult >.

◆ run()

void PARTONS::DDVCSProcessModule::run ( )
virtual

◆ setConvolCoeffFunctionModule()

void PARTONS::DDVCSProcessModule::setConvolCoeffFunctionModule ( DDVCSConvolCoeffFunctionModule pConvolCoeffFunctionModule)

Set CCF module.

◆ setExperimentalConditions()

void PARTONS::DDVCSProcessModule::setExperimentalConditions ( double  beamHelicity,
double  beamCharge,
NumA::Vector3D  targetPolarization 
)
protectedvirtual

◆ setKinematics()

void PARTONS::DDVCSProcessModule::setKinematics ( const DDVCSObservableKinematic kinematic)
protectedvirtual

Set internal kinematics.

Parameters
kinematicKinematics to be set

Implements PARTONS::ProcessModule< DDVCSObservableKinematic, DDVCSObservableResult >.

◆ setScaleModule()

void PARTONS::DDVCSProcessModule::setScaleModule ( DDVCSScalesModule pScaleModule)

Set scale module.

◆ setXiConverterModule()

void PARTONS::DDVCSProcessModule::setXiConverterModule ( DDVCSXiConverterModule pXiConverterModule)

Set xi converted module.

◆ toString()

std::string PARTONS::DDVCSProcessModule::toString ( ) const
virtual

Return a pre-formatted characters string for output visualization of class member's values.

Returns
a pre-formatted characters string.

Reimplemented from PARTONS::ProcessModule< DDVCSObservableKinematic, DDVCSObservableResult >.

Member Data Documentation

◆ DDVCS_PROCESS_MODULE_CLASS_NAME

const std::string PARTONS::DDVCSProcessModule::DDVCS_PROCESS_MODULE_CLASS_NAME
static
Initial value:
=
"DDVCSProcessModule"

Type of the module in XML automation.

◆ m_beamCharge

double PARTONS::DDVCSProcessModule::m_beamCharge
protected

Beam charge.

◆ m_beamHelicity

double PARTONS::DDVCSProcessModule::m_beamHelicity
protected

Beam helicity.

◆ m_dvcsConvolCoeffFunctionResult

DDVCSConvolCoeffFunctionResult PARTONS::DDVCSProcessModule::m_dvcsConvolCoeffFunctionResult
protected

Stored Compton Form Factor result.

◆ m_E

double PARTONS::DDVCSProcessModule::m_E
protected

Beam energy in target rest frame (in GeV).

◆ m_lastCCFKinematics

DDVCSConvolCoeffFunctionKinematic PARTONS::DDVCSProcessModule::m_lastCCFKinematics
protected

Last Compton Form Factor kinematics.

◆ m_pConvolCoeffFunctionModule

DDVCSConvolCoeffFunctionModule* PARTONS::DDVCSProcessModule::m_pConvolCoeffFunctionModule
protected

Pointer to the underlying CCF module.

◆ m_phi

double PARTONS::DDVCSProcessModule::m_phi
protected

Angle between leptonic and hadronic plane (in radians, Trento convention).

◆ m_phiL

double PARTONS::DDVCSProcessModule::m_phiL
protected

Azimuthal angle of the lepton pair (in radians).

◆ m_pScaleModule

DDVCSScalesModule* PARTONS::DDVCSProcessModule::m_pScaleModule
protected

Pointer to the underlying scale module.

◆ m_pXiConverterModule

DDVCSXiConverterModule* PARTONS::DDVCSProcessModule::m_pXiConverterModule
protected

Pointer to the underlying xi converter module.

◆ m_Q2

double PARTONS::DDVCSProcessModule::m_Q2
protected

Virtuality of the incoming photon (in GeV2).

◆ m_Q2Prim

double PARTONS::DDVCSProcessModule::m_Q2Prim
protected

Virtuality of the outgoing photon (in GeV2).

◆ m_t

double PARTONS::DDVCSProcessModule::m_t
protected

Mandelstam variable (square of the 4-momentum transferm in GeV2).

◆ m_targetPolarization

NumA::Vector3D PARTONS::DDVCSProcessModule::m_targetPolarization
protected

Target polarization.

◆ m_thetaL

double PARTONS::DDVCSProcessModule::m_thetaL
protected

Polar angle of the lepton pair (in radians).

◆ m_xB

double PARTONS::DDVCSProcessModule::m_xB
protected

Bjorken variable.


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