Class for defining a complex coefficient using the Belle CP convention. Holds a set of real values that define the complex coefficient of an amplitude component. More...

#include <LauBelleCPCoeffSet.hh>

Inheritance diagram for LauBelleCPCoeffSet:

Public Member Functions
	LauBelleCPCoeffSet (const TString &compName, Double_t a, Double_t delta, Double_t b, Double_t phi, Bool_t aFixed, Bool_t deltaFixed, Bool_t bFixed, Bool_t phiFixed, Bool_t bSecondStage=kFALSE, Bool_t phiSecondStage=kFALSE)
	Constructor. More...

virtual	~LauBelleCPCoeffSet ()
	Destructor.

virtual std::vector< LauParameter * >	getParameters ()
	Retrieve the parameters of the coefficient, e.g. so that they can be loaded into a fit. More...

virtual void	printParValues () const
	Print the current values of the parameters.

virtual void	printTableHeading (std::ostream &stream) const
	Print the column headings for a results table. More...

virtual void	printTableRow (std::ostream &stream) const
	Print the parameters of the complex coefficient as a row in the results table. More...

virtual void	randomiseInitValues ()
	Randomise the starting values of the parameters for a fit.

virtual void	finaliseValues ()
	Make sure values are in "standard" ranges, e.g. phases should be between -pi and pi.

virtual const LauComplex &	particleCoeff ()
	Retrieve the complex coefficient for a particle. More...

virtual const LauComplex &	antiparticleCoeff ()
	Retrieve the complex coefficient for an antiparticle. More...

virtual void	setCoeffValues (const LauComplex &coeff, const LauComplex &coeffBar, Bool_t init)
	Set the parameters based on the complex coefficients for particles and antiparticles. More...

virtual LauParameter	acp ()
	Calculate the CP asymmetry. More...

virtual LauAbsCoeffSet *	createClone (const TString &newName, CloneOption cloneOption=All, Double_t constFactor=1.0)
	Create a clone of the coefficient set. More...

Public Member Functions inherited from LauAbsCoeffSet
virtual	~LauAbsCoeffSet ()
	Destructor.

virtual TString	name () const
	Retrieve the name of the coefficient set. More...

virtual void	name (const TString &theName)
	Set the name of the coefficient set. More...

virtual const TString &	baseName () const
	Retrieve the base name of the coefficient set. More...

virtual void	baseName (const TString &theBasename)
	Set the base name of the coefficient set. More...

virtual UInt_t	index () const
	Retrieve the index number of the coefficient set. More...

virtual void	index (UInt_t newIndex)
	Set the index number of the coefficient set. More...

virtual void	setParameterValue (const TString &parName, Double_t value, Bool_t init)
	Set the value of the named parameter. More...

virtual void	setParameterError (const TString &parName, Double_t error)
	Set the error of the named parameter. More...

virtual void	fixParameter (const TString &parName)
	Set the named parameter to be fixed in the fit. More...

virtual void	floatParameter (const TString &parName)
	Set the named parameter to float in the fit. More...

virtual void	blindParameter (const TString &parName, const TString &blindingString, const Double_t width)
	Blind the named parameter. More...

virtual void	addGaussianConstraint (const TString &parName, const Double_t mean, const Double_t width)
	Add Gaussian constraint to the named parameter. More...

virtual void	addSuffixToParameterName (const TString &parName, const TString &suffix)
	Add suffix to the name of the given parameter. More...

Private Member Functions
	LauBelleCPCoeffSet (const LauBelleCPCoeffSet &rhs, CloneOption cloneOption=All, Double_t constFactor=1.0)
	Copy constructor. More...

LauBelleCPCoeffSet &	operator= (const LauBelleCPCoeffSet &rhs)
	Copy assignment operator (not implemented) More...

Private Attributes
LauParameter *	a_
	The magnitude a.

LauParameter *	b_
	The magnitude b.

LauParameter *	delta_
	The strong phase.

LauParameter *	phi_
	The weak phase.

LauComplex	particleCoeff_
	The particle complex coefficient.

LauComplex	antiparticleCoeff_
	The antiparticle complex coefficient.

LauParameter	acp_
	The CP asymmetry.

Additional Inherited Members
Public Types inherited from LauAbsCoeffSet
enum	CloneOption { All, TiePhase, TieMagnitude, TieRealPart, TieImagPart, TieCPPars }
	Options for cloning operation. More...

Static Public Member Functions inherited from LauAbsCoeffSet
static void	setMagnitudeRange (Double_t minMag, Double_t maxMag)
	Set the allowed range for magnitude parameters. More...

static void	setPhaseRange (Double_t minPhase, Double_t maxPhase)
	Set the allowed range for phase parameters. More...

static void	setRealImagRange (Double_t minPar, Double_t maxPar)
	Set the allowed range for real/imaginary part parameters. More...

static void	setCPParRange (Double_t minPar, Double_t maxPar)
	Set the allowed range for CP-violating parameters. More...

static void	setRandomiser (TRandom *randomiser)
	Set the randomiser. More...

static TRandom *	getRandomiser ()
	Access the randomiser. More...

Protected Member Functions inherited from LauAbsCoeffSet
	LauAbsCoeffSet (const TString &theName, const TString &theBaseName="A")
	Constructor. More...

LauParameter *	findParameter (const TString &parName)
	Find the parameter with the given name. More...

virtual void	adjustName (LauParameter *par, const TString &oldBaseName)
	Prepend the base name and index to the name of a parameter. More...

	LauAbsCoeffSet (const LauAbsCoeffSet &rhs)
	Copy constructor. More...

LauAbsCoeffSet &	operator= (const LauAbsCoeffSet &rhs)
	Copy assignment operator. More...

Static Protected Attributes inherited from LauAbsCoeffSet
static Double_t	minMagnitude_ = -10.0
	Minimum allowed value of magnitude parameters.

static Double_t	maxMagnitude_ = 10.0
	Maximum allowed value of magnitude parameters.

static Double_t	minPhase_ = -LauConstants::threePi
	Minimum allowed value of phase parameters.

static Double_t	maxPhase_ = LauConstants::threePi
	Maximum allowed value of phase parameters.

static Double_t	minRealImagPart_ = -10.0
	Minimum allowed value of real/imaginary part parameters.

static Double_t	maxRealImagPart_ = 10.0
	Maximum allowed value of real/imaginary part parameters.

static Double_t	minDelta_ = -2.0
	Minimum allowed value of CP-violating real/imaginary part parameters.

static Double_t	maxDelta_ = 2.0
	Maximum allowed value of CP-violating real/imaginary part parameters.

Detailed Description

Class for defining a complex coefficient using the Belle CP convention. Holds a set of real values that define the complex coefficient of an amplitude component.

The amplitude has the form a * exp(i*delta) * ( 1 +/- b * exp(i*phi) ) where a is a CP conserving magnitude, b is a CP violating magnitude, delta is the strong phase and phi is the weak phase. [Phys.Rev.Lett. 96 (2006) 251803]

Definition at line 53 of file LauBelleCPCoeffSet.hh.

Constructor & Destructor Documentation

◆ LauBelleCPCoeffSet() [1/2]

LauBelleCPCoeffSet::LauBelleCPCoeffSet	(	const TString &	compName,
		Double_t	a,
		Double_t	delta,
		Double_t	b,
		Double_t	phi,
		Bool_t	aFixed,
		Bool_t	deltaFixed,
		Bool_t	bFixed,
		Bool_t	phiFixed,
		Bool_t	bSecondStage = `kFALSE`,
		Bool_t	phiSecondStage = `kFALSE`
	)

Constructor.

Parameters

[in]	compName	the name of the coefficient set
[in]	a	the magnitude a
[in]	delta	the strong phase
[in]	b	the magnitude b
[in]	phi	the weak phase
[in]	aFixed	whether a is fixed
[in]	deltaFixed	whether delta is fixed
[in]	bFixed	whether b is fixed
[in]	phiFixed	whether phi is fixed
[in]	bSecondStage	whether b should be floated only in the second stage of the fit
[in]	phiSecondStage	whether phi should be floated only in the second stage of the fit

Definition at line 43 of file LauBelleCPCoeffSet.cc.

◆ LauBelleCPCoeffSet() [2/2]

LauBelleCPCoeffSet::LauBelleCPCoeffSet	(	const LauBelleCPCoeffSet &	rhs,
		CloneOption	cloneOption = `All`,
		Double_t	constFactor = `1.0`
	)

private

Copy constructor.

This creates cloned parameters, not copies.

Parameters

[in]	rhs	the coefficient to clone
[in]	cloneOption	special option for the cloning operation
[in]	constFactor	a constant factor to multiply the clone's parameters by

Definition at line 73 of file LauBelleCPCoeffSet.cc.

Member Function Documentation

◆ acp()

LauParameter LauBelleCPCoeffSet::acp ( )

virtual

Calculate the CP asymmetry.

Returns: the CP asymmetry

Implements LauAbsCoeffSet.

Definition at line 344 of file LauBelleCPCoeffSet.cc.

◆ antiparticleCoeff()

const LauComplex & LauBelleCPCoeffSet::antiparticleCoeff ( )

virtual

Retrieve the complex coefficient for an antiparticle.

Returns: the complex coefficient for an antiparticle

Implements LauAbsCoeffSet.

Definition at line 301 of file LauBelleCPCoeffSet.cc.

◆ createClone()

LauAbsCoeffSet * LauBelleCPCoeffSet::createClone	(	const TString &	newName,
		CloneOption	cloneOption = `All`,
		Double_t	constFactor = `1.0`
	)

virtual

Create a clone of the coefficient set.

Parameters

[in]	newName	the clone's name
[in]	cloneOption	special option for the cloning operation
[in]	constFactor	a constant factor to multiply the clone's parameters by

Returns: a clone of the coefficient set

Implements LauAbsCoeffSet.

Definition at line 368 of file LauBelleCPCoeffSet.cc.

◆ getParameters()

std::vector< LauParameter * > LauBelleCPCoeffSet::getParameters ( )

virtual

Retrieve the parameters of the coefficient, e.g. so that they can be loaded into a fit.

Returns: the parameters of the coefficient

Implements LauAbsCoeffSet.

Definition at line 127 of file LauBelleCPCoeffSet.cc.

◆ operator=()

LauBelleCPCoeffSet& LauBelleCPCoeffSet::operator= ( const LauBelleCPCoeffSet & rhs )

private

Copy assignment operator (not implemented)

Parameters

[in] rhs the coefficient to clone

◆ particleCoeff()

const LauComplex & LauBelleCPCoeffSet::particleCoeff ( )

virtual

Retrieve the complex coefficient for a particle.

Returns: the complex coefficient for a particle

Implements LauAbsCoeffSet.

Definition at line 289 of file LauBelleCPCoeffSet.cc.

◆ printTableHeading()

void LauBelleCPCoeffSet::printTableHeading ( std::ostream & stream ) const

virtual

Print the column headings for a results table.

Parameters

[out] stream the stream to print to

Implements LauAbsCoeffSet.

Definition at line 147 of file LauBelleCPCoeffSet.cc.

◆ printTableRow()

void LauBelleCPCoeffSet::printTableRow ( std::ostream & stream ) const

virtual

Print the parameters of the complex coefficient as a row in the results table.

Parameters

[out] stream the stream to print to

Implements LauAbsCoeffSet.

Definition at line 155 of file LauBelleCPCoeffSet.cc.

◆ setCoeffValues()

void LauBelleCPCoeffSet::setCoeffValues	(	const LauComplex &	coeff,
		const LauComplex &	coeffBar,
		Bool_t	init
	)

virtual

Set the parameters based on the complex coefficients for particles and antiparticles.

Parameters

[in]	coeff	the complex coefficient for a particle
[in]	coeffBar	the complex coefficient for an antiparticle
[in]	init	whether or not the initial and generated values should also be adjusted

Implements LauAbsCoeffSet.

Definition at line 313 of file LauBelleCPCoeffSet.cc.

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

/home/epp/phsdba/Development/Laura++/master-dev/laura/inc/LauBelleCPCoeffSet.hh
/home/epp/phsdba/Development/Laura++/master-dev/laura/src/LauBelleCPCoeffSet.cc

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ LauBelleCPCoeffSet() [1/2]

◆ LauBelleCPCoeffSet() [2/2]

Member Function Documentation

◆ acp()

◆ antiparticleCoeff()

◆ createClone()

◆ getParameters()

◆ operator=()

◆ particleCoeff()

◆ printTableHeading()

◆ printTableRow()

◆ setCoeffValues()