Class for defining a complex coefficient using a magnitude and a phase. More...

#include <LauMagPhaseCoeffSet.hh>

Inheritance diagram for LauMagPhaseCoeffSet:

Public Member Functions
	LauMagPhaseCoeffSet (const TString &compName, Double_t magnitude, Double_t phase, Bool_t magFixed, Bool_t phaseFixed)
	Constructor. More...

virtual	~LauMagPhaseCoeffSet ()
	Destructor. More...

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. More...

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. More...

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

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. More...

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
	LauMagPhaseCoeffSet (const LauMagPhaseCoeffSet &rhs, CloneOption cloneOption=All, Double_t constFactor=1.0)
	Copy constructor. More...

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

Private Attributes
LauParameter *	magnitude_
	The magnitude. More...

LauParameter *	phase_
	The phase. More...

LauComplex	coeff_
	The complex coefficient. More...

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. More...

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

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

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

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

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

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

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

Detailed Description

Class for defining a complex coefficient using a magnitude and a phase.

Holds a set of real values that define the complex coefficient of an amplitude component. The amplitude has the form mag*exp(i*phase).

Definition at line 35 of file LauMagPhaseCoeffSet.hh.

Constructor & Destructor Documentation

LauMagPhaseCoeffSet::LauMagPhaseCoeffSet	(	const TString &	compName,
		Double_t	magnitude,
		Double_t	phase,
		Bool_t	magFixed,
		Bool_t	phaseFixed
	)

Constructor.

Parameters

[in]	compName	the name of the coefficient set
[in]	magnitude	the magnitude
[in]	phase	the phase
[in]	magFixed	whether mag is fixed
[in]	phaseFixed	whether phase is fixed

Definition at line 31 of file LauMagPhaseCoeffSet.cc.

virtual LauMagPhaseCoeffSet::~LauMagPhaseCoeffSet ( )

inlinevirtual

Destructor.

Definition at line 49 of file LauMagPhaseCoeffSet.hh.

LauMagPhaseCoeffSet::LauMagPhaseCoeffSet	(	const LauMagPhaseCoeffSet &	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 39 of file LauMagPhaseCoeffSet.cc.

Member Function Documentation

LauParameter LauMagPhaseCoeffSet::acp ( )

virtual

Calculate the CP asymmetry.

Returns: the CP asymmetry (zero by design)

Implements LauAbsCoeffSet.

Definition at line 193 of file LauMagPhaseCoeffSet.cc.

const LauComplex & LauMagPhaseCoeffSet::antiparticleCoeff ( )

virtual

Retrieve the complex coefficient for an antiparticle.

Returns: the complex coefficient for an antiparticle

Implements LauAbsCoeffSet.

Definition at line 167 of file LauMagPhaseCoeffSet.cc.

LauAbsCoeffSet * LauMagPhaseCoeffSet::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 199 of file LauMagPhaseCoeffSet.cc.

void LauMagPhaseCoeffSet::finaliseValues ( )

virtual

Make sure values are in "standard" ranges, e.g. phases should be between -pi and pi.

Implements LauAbsCoeffSet.

Definition at line 116 of file LauMagPhaseCoeffSet.cc.

std::vector< LauParameter * > LauMagPhaseCoeffSet::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 65 of file LauMagPhaseCoeffSet.cc.

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

private

Copy assignment operator (not implemented)

Parameters

[in] rhs the coefficient to clone

const LauComplex & LauMagPhaseCoeffSet::particleCoeff ( )

virtual

Retrieve the complex coefficient for a particle.

Returns: the complex coefficient for a particle

Implements LauAbsCoeffSet.

Definition at line 161 of file LauMagPhaseCoeffSet.cc.

void LauMagPhaseCoeffSet::printParValues ( ) const

virtual

Print the current values of the parameters.

Implements LauAbsCoeffSet.

Definition at line 73 of file LauMagPhaseCoeffSet.cc.

void LauMagPhaseCoeffSet::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 78 of file LauMagPhaseCoeffSet.cc.

void LauMagPhaseCoeffSet::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 86 of file LauMagPhaseCoeffSet.cc.

void LauMagPhaseCoeffSet::randomiseInitValues ( )

virtual

Randomise the starting values of the parameters for a fit.

Implements LauAbsCoeffSet.

Definition at line 102 of file LauMagPhaseCoeffSet.cc.

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

virtual

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

This class does not support CP violation so this method takes the average of the two inputs.

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 172 of file LauMagPhaseCoeffSet.cc.

Member Data Documentation

LauComplex LauMagPhaseCoeffSet::coeff_

private

The complex coefficient.

Definition at line 138 of file LauMagPhaseCoeffSet.hh.

LauParameter* LauMagPhaseCoeffSet::magnitude_

private

The magnitude.

Definition at line 133 of file LauMagPhaseCoeffSet.hh.

LauParameter* LauMagPhaseCoeffSet::phase_

private

The phase.

Definition at line 135 of file LauMagPhaseCoeffSet.hh.

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

inc/LauMagPhaseCoeffSet.hh
src/LauMagPhaseCoeffSet.cc

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation