Class for defining a complex coefficient using a Cartesian nonCP part multiplied by a simple Cartesian CP convention. More...

#include <LauRealImagGammaCPCoeffSet.hh>

Inheritance diagram for LauRealImagGammaCPCoeffSet:

Public Member Functions
	LauRealImagGammaCPCoeffSet (const TString &compName, const Double_t x, const Double_t y, const Double_t xCP, const Double_t yCP, const Double_t xbarCP, const Double_t ybarCP, const Bool_t xFixed, const Bool_t yFixed, const Bool_t xCPFixed, const Bool_t yCPFixed, const Bool_t xbarCPFixed, const Bool_t ybarCPFixed)
	Constructor. More...

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

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

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

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

LauParameter *	xCP_
	The real CP part for the particle. More...

LauParameter *	yCP_
	The imaginary CP part for the particle. More...

LauParameter *	xbarCP_
	The real CP part for the antiparticle. More...

LauParameter *	ybarCP_
	The imaginary CP part for the antiparticle. 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 a Cartesian nonCP part multiplied by a simple Cartesian CP convention.

Holds a set of real values that define the complex coefficient of an amplitude component. The amplitudes have the form: c = ( x + i * y ) * ( 1 + xCP + i * yCP ) cbar = ( x + i * y ) * ( 1 + xbarCP + i * ybarCP ) [Phys. Rev. D79, 051301 (2009)]

Definition at line 52 of file LauRealImagGammaCPCoeffSet.hh.

Constructor & Destructor Documentation

LauRealImagGammaCPCoeffSet::LauRealImagGammaCPCoeffSet	(	const TString &	compName,
		const Double_t	x,
		const Double_t	y,
		const Double_t	xCP,
		const Double_t	yCP,
		const Double_t	xbarCP,
		const Double_t	ybarCP,
		const Bool_t	xFixed,
		const Bool_t	yFixed,
		const Bool_t	xCPFixed,
		const Bool_t	yCPFixed,
		const Bool_t	xbarCPFixed,
		const Bool_t	ybarCPFixed
	)

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 real CP part for the particle
[in]	yCP	the imaginary CP part for the particle
[in]	xbarCP	the real CP part for the antiparticle
[in]	ybarCP	the imaginary CP part for the antiparticle
[in]	xFixed	whether x is fixed
[in]	yFixed	whether y is fixed
[in]	xCPFixed	whether x is fixed
[in]	yCPFixed	whether y is fixed
[in]	xbarCPFixed	whether xbar is fixed
[in]	ybarCPFixed	whether ybar is fixed

Definition at line 45 of file LauRealImagGammaCPCoeffSet.cc.

virtual LauRealImagGammaCPCoeffSet::~LauRealImagGammaCPCoeffSet ( )

inlinevirtual

Destructor.

Definition at line 75 of file LauRealImagGammaCPCoeffSet.hh.

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

Member Function Documentation

LauParameter LauRealImagGammaCPCoeffSet::acp ( )

virtual

Calculate the CP asymmetry.

Returns: the CP asymmetry

Implements LauAbsCoeffSet.

Definition at line 255 of file LauRealImagGammaCPCoeffSet.cc.

const LauComplex & LauRealImagGammaCPCoeffSet::antiparticleCoeff ( )

virtual

Retrieve the complex coefficient for an antiparticle.

Returns: the complex coefficient for an antiparticle

Implements LauAbsCoeffSet.

Definition at line 242 of file LauRealImagGammaCPCoeffSet.cc.

LauAbsCoeffSet * LauRealImagGammaCPCoeffSet::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 285 of file LauRealImagGammaCPCoeffSet.cc.

void LauRealImagGammaCPCoeffSet::finaliseValues ( )

virtual

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

Implements LauAbsCoeffSet.

Definition at line 223 of file LauRealImagGammaCPCoeffSet.cc.

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

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

private

Copy assignment operator (not implemented)

Parameters

[in] rhs the coefficient to clone

const LauComplex & LauRealImagGammaCPCoeffSet::particleCoeff ( )

virtual

Retrieve the complex coefficient for a particle.

Returns: the complex coefficient for a particle

Implements LauAbsCoeffSet.

Definition at line 234 of file LauRealImagGammaCPCoeffSet.cc.

void LauRealImagGammaCPCoeffSet::printParValues ( ) const

virtual

Print the current values of the parameters.

Implements LauAbsCoeffSet.

Definition at line 138 of file LauRealImagGammaCPCoeffSet.cc.

void LauRealImagGammaCPCoeffSet::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 149 of file LauRealImagGammaCPCoeffSet.cc.

void LauRealImagGammaCPCoeffSet::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 157 of file LauRealImagGammaCPCoeffSet.cc.

void LauRealImagGammaCPCoeffSet::randomiseInitValues ( )

virtual

Randomise the starting values of the parameters for a fit.

Implements LauAbsCoeffSet.

Definition at line 189 of file LauRealImagGammaCPCoeffSet.cc.

void LauRealImagGammaCPCoeffSet::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 250 of file LauRealImagGammaCPCoeffSet.cc.