Class for defining a complex coefficient using the Cartesian gamma CP convention. More...

#include <LauCartesianGammaCPCoeffSet.hh>

Inheritance diagram for LauCartesianGammaCPCoeffSet:

Public Member Functions
	LauCartesianGammaCPCoeffSet (const TString &compName, const Double_t x, const Double_t y, const Double_t xCP, const Double_t yCP, const Double_t deltaXCP, const Double_t deltaYCP, const Bool_t xFixed, const Bool_t yFixed, const Bool_t xCPFixed, const Bool_t yCPFixed, const Bool_t deltaXCPFixed, const Bool_t deltaYCPFixed, const Bool_t deltaXCPSecondStage=kFALSE, const Bool_t deltaYCPSecondStage=kFALSE)
	Constructor. More...

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

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

Private Attributes
LauParameter *	x_
	The nonCP real part. More...

LauParameter *	y_
	The nonCP imaginary part. More...

LauParameter *	xCP_
	The average CP real part. More...

LauParameter *	yCP_
	The average CP imaginary part. More...

LauParameter *	deltaXCP_
	The asymmetric CP real part. More...

LauParameter *	deltaYCP_
	The asymmetric CP imaginary part. More...

LauComplex	nonCPPart_
	The nonCP part of the complex coefficient. More...

LauComplex	cpPart_
	The CP part of the complex coefficient for the particle. More...

LauComplex	cpAntiPart_
	The CP part of the complex coefficient for the antiparticle. More...

LauComplex	particleCoeff_
	The particle complex coefficient. More...

LauComplex	antiparticleCoeff_
	The antiparticle complex coefficient. More...

LauParameter	acp_
	The CP asymmetry. 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 the Cartesian gamma CP convention.

Holds a set of real values that define the complex coefficient of an amplitude component. The amplitude has the form ( x + i * y ) * ( 1 + xCP +/- delta_xCP + i * ( yCP +/- delta_yCP ) ). [Phys. Rev. D79, 051301 (2009)]

Definition at line 50 of file LauCartesianGammaCPCoeffSet.hh.

Constructor & Destructor Documentation

LauCartesianGammaCPCoeffSet::LauCartesianGammaCPCoeffSet	(	const TString &	compName,
		const Double_t	x,
		const Double_t	y,
		const Double_t	xCP,
		const Double_t	yCP,
		const Double_t	deltaXCP,
		const Double_t	deltaYCP,
		const Bool_t	xFixed,
		const Bool_t	yFixed,
		const Bool_t	xCPFixed,
		const Bool_t	yCPFixed,
		const Bool_t	deltaXCPFixed,
		const Bool_t	deltaYCPFixed,
		const Bool_t	deltaXCPSecondStage = `kFALSE`,
		const Bool_t	deltaYCPSecondStage = `kFALSE`
	)

Constructor.

Parameters

[in]	compName	the name of the coefficient set
[in]	x	the real nonCP part
[in]	y	the imaginary nonCP part
[in]	xCP	the average real CP part
[in]	yCP	the average imaginary CP part
[in]	deltaXCP	the asymmetric real CP part
[in]	deltaYCP	the asymmetric imaginary CP part
[in]	xFixed	whether x is fixed
[in]	yFixed	whether y is fixed
[in]	xCPFixed	whether xCP is fixed
[in]	yCPFixed	whether yCP is fixed
[in]	deltaXCPFixed	whether deltaXCP is fixed
[in]	deltaYCPFixed	whether deltaYCP is fixed
[in]	deltaXCPSecondStage	whether deltaXCP should be floated only in the second stage of the fit
[in]	deltaYCPSecondStage	whether deltaYCP should be floated only in the second stage of the fit

Definition at line 45 of file LauCartesianGammaCPCoeffSet.cc.

virtual LauCartesianGammaCPCoeffSet::~LauCartesianGammaCPCoeffSet ( )

inlinevirtual

Destructor.

Definition at line 76 of file LauCartesianGammaCPCoeffSet.hh.

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

Member Function Documentation

LauParameter LauCartesianGammaCPCoeffSet::acp ( )

virtual

Calculate the CP asymmetry.

Returns: the CP asymmetry

Implements LauAbsCoeffSet.

Definition at line 271 of file LauCartesianGammaCPCoeffSet.cc.

const LauComplex & LauCartesianGammaCPCoeffSet::antiparticleCoeff ( )

virtual

Retrieve the complex coefficient for an antiparticle.

Returns: the complex coefficient for an antiparticle

Implements LauAbsCoeffSet.

Definition at line 258 of file LauCartesianGammaCPCoeffSet.cc.

LauAbsCoeffSet * LauCartesianGammaCPCoeffSet::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 301 of file LauCartesianGammaCPCoeffSet.cc.

void LauCartesianGammaCPCoeffSet::finaliseValues ( )

virtual

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

Implements LauAbsCoeffSet.

Definition at line 239 of file LauCartesianGammaCPCoeffSet.cc.

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

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

private

Copy assignment operator (not implemented)

Parameters

[in] rhs the coefficient to clone

const LauComplex & LauCartesianGammaCPCoeffSet::particleCoeff ( )

virtual

Retrieve the complex coefficient for a particle.

Returns: the complex coefficient for a particle

Implements LauAbsCoeffSet.

Definition at line 250 of file LauCartesianGammaCPCoeffSet.cc.

void LauCartesianGammaCPCoeffSet::printParValues ( ) const

virtual

Print the current values of the parameters.

Implements LauAbsCoeffSet.

Definition at line 154 of file LauCartesianGammaCPCoeffSet.cc.

void LauCartesianGammaCPCoeffSet::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 165 of file LauCartesianGammaCPCoeffSet.cc.

void LauCartesianGammaCPCoeffSet::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 173 of file LauCartesianGammaCPCoeffSet.cc.

void LauCartesianGammaCPCoeffSet::randomiseInitValues ( )

virtual

Randomise the starting values of the parameters for a fit.

Implements LauAbsCoeffSet.

Definition at line 205 of file LauCartesianGammaCPCoeffSet.cc.

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

virtual

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

This method is not supported by this class because there are more than four parameters so there is not a unique solution.

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 266 of file LauCartesianGammaCPCoeffSet.cc.