Class for defining a complex coefficient useful for extracting the CKM angle gamma from B -> D h h Dalitz plots. More...

#include <LauPolarGammaCPCoeffSet.hh>

Inheritance diagram for LauPolarGammaCPCoeffSet:

Public Types
enum	DecayType { GLW_CPOdd, GLW_CPEven, ADS_Favoured, ADS_Suppressed, GLW_CPOdd_btouOnly, GLW_CPEven_btouOnly, ADS_Favoured_btouOnly, ADS_Suppressed_btouOnly }
	The possible D decay modes. More...

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

Public Member Functions
	LauPolarGammaCPCoeffSet (const TString &compName, const DecayType decayType, const Double_t x, const Double_t y, const Double_t rB, const Double_t deltaB, const Double_t gamma, const Double_t rD, const Double_t deltaD, const Bool_t xFixed, const Bool_t yFixed, const Bool_t rBFixed, const Bool_t deltaBFixed, const Bool_t gammaFixed, const Bool_t rDFixed, const Bool_t deltaDFixed, const Bool_t rBSecondStage=kFALSE, const Bool_t deltaBSecondStage=kFALSE, const Bool_t gammaSecondStage=kFALSE, const Bool_t rDSecondStage=kFALSE, const Bool_t deltaDSecondStage=kFALSE, const Bool_t useGlobalGamma=kFALSE, const Bool_t useGlobalADSPars=kFALSE)
	Constructor. More...

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

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

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

void	updateAmplitudes ()
	Update the amplitudes based on the new values of the parameters. More...

Private Attributes
const DecayType	decayType_
	The type of the D decay. More...

LauParameter *	x_
	The real part of the b -> c amplitude. More...

LauParameter *	y_
	The imaginary part of the b -> c amplitude. More...

LauParameter *	rB_
	the magnitude of the ratio of the b -> u and b -> c amplitudes More...

LauParameter *	deltaB_
	the relative CP-conserving (strong) phase of the b -> u and b -> c amplitudes More...

LauParameter *	gamma_
	the relative CP-violating (weak) phase of the b -> u and b -> c amplitudes More...

LauParameter *	rD_
	the magnitude of the ratio of the favoured and suppressed D-decay amplitudes More...

LauParameter *	deltaD_
	the relative strong phase of the favoured and suppressed D-decay amplitudes More...

const Bool_t	useGlobalGamma_
	Whether the global gamma is used for this resonance. More...

const Bool_t	useGlobalADSPars_
	Whether the global rD and deltaD are used for this resonance. More...

LauComplex	nonCPPart_
	The b -> c part of the complex coefficient. More...

LauComplex	cpPart_
	The b -> u part of the complex coefficient for the particle. More...

LauComplex	cpAntiPart_
	The b -> u 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...

Static Private Attributes
static LauParameter *	gammaGlobal_ = 0
	The CP-violating phase (shared by multiple resonances) More...

static LauParameter *	rDGlobal_ = 0
	the magnitude of the ratio of the favoured and suppressed D-decay amplitudes (shared by multiple resonances) More...

static LauParameter *	deltaDGlobal_ = 0
	the relative strong phase of the favoured and suppressed D-decay amplitudes (shared by multiple resonances) More...

Additional Inherited Members
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...

	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 useful for extracting the CKM angle gamma from B -> D h h Dalitz plots.

Holds a set of real values that define the complex coefficient of an amplitude component. Depending on the type of the D decay, the amplitude has one of the following forms: CP-odd eigenstate: ( x + i * y ) * ( 1 - rB * exp( i * ( deltaB +/- gamma ) ) ) CP-even eigenstate: ( x + i * y ) * ( 1 + rB * exp( i * ( deltaB +/- gamma ) ) ) ADS favoured state: ( x + i * y ) * ( 1 + rB * rD * exp( i * ( deltaB - deltaD +/- gamma ) ) ) ADS suppressed state: ( x + i * y ) * ( rD * exp( - i * deltaD ) + rB * exp( i * ( deltaB +/- gamma ) ) ) [Phys. Rev. D79, 051301 (2009)]

Definition at line 40 of file LauPolarGammaCPCoeffSet.hh.

Member Enumeration Documentation

enum LauPolarGammaCPCoeffSet::DecayType

The possible D decay modes.

Enumerator
GLW_CPOdd	GLW CP-odd, e.g. D0 -> K0 pi0
GLW_CPEven	GLW CP-even, e.g. D0 -> K+ K-
ADS_Favoured	ADS Favoured, e.g. D0 -> K- pi+
ADS_Suppressed	ADS Suppressed, e.g. D0 -> K+ pi-
GLW_CPOdd_btouOnly	GLW CP-odd, e.g. D0 -> K0 pi0, where B decay only proceeds via b -> u transition
GLW_CPEven_btouOnly	GLW CP-even, e.g. D0 -> K+ K-, where B decay only proceeds via b -> u transition
ADS_Favoured_btouOnly	ADS Favoured, e.g. D0 -> K- pi+, where B decay only proceeds via b -> u transition
ADS_Suppressed_btouOnly	ADS Suppressed, e.g. D0 -> K+ pi-, where B decay only proceeds via b -> u transition

Definition at line 44 of file LauPolarGammaCPCoeffSet.hh.

Constructor & Destructor Documentation

LauPolarGammaCPCoeffSet::LauPolarGammaCPCoeffSet	(	const TString &	compName,
		const DecayType	decayType,
		const Double_t	x,
		const Double_t	y,
		const Double_t	rB,
		const Double_t	deltaB,
		const Double_t	gamma,
		const Double_t	rD,
		const Double_t	deltaD,
		const Bool_t	xFixed,
		const Bool_t	yFixed,
		const Bool_t	rBFixed,
		const Bool_t	deltaBFixed,
		const Bool_t	gammaFixed,
		const Bool_t	rDFixed,
		const Bool_t	deltaDFixed,
		const Bool_t	rBSecondStage = `kFALSE`,
		const Bool_t	deltaBSecondStage = `kFALSE`,
		const Bool_t	gammaSecondStage = `kFALSE`,
		const Bool_t	rDSecondStage = `kFALSE`,
		const Bool_t	deltaDSecondStage = `kFALSE`,
		const Bool_t	useGlobalGamma = `kFALSE`,
		const Bool_t	useGlobalADSPars = `kFALSE`
	)

Constructor.

Parameters

[in]	compName	the name of the coefficient set
[in]	decayType	the type of the D decay
[in]	x	the real part of the b -> c amplitude
[in]	y	the imaginary part of the b -> c amplitude
[in]	rB	the magnitude of the ratio of the b -> u and b -> c amplitudes
[in]	deltaB	the relative CP-conserving (strong) phase of the b -> u and b -> c amplitudes
[in]	gamma	the relative CP-violating (weak) phase of the b -> u and b -> c amplitudes
[in]	rD	the magnitude of the ratio of the favoured and suppressed D-decay amplitudes
[in]	deltaD	the relative strong phase of the favoured and suppressed D-decay amplitudes
[in]	xFixed	whether x is fixed
[in]	yFixed	whether y is fixed
[in]	rBFixed	whether rB is fixed
[in]	deltaBFixed	whether deltaB is fixed
[in]	gammaFixed	whether gamma is fixed
[in]	rDFixed	whether rD is fixed
[in]	deltaDFixed	whether deltaD is fixed
[in]	rBSecondStage	whether rB should be floated only in the second stage of the fit
[in]	deltaBSecondStage	whether deltaB should be floated only in the second stage of the fit
[in]	gammaSecondStage	whether gamma should be floated only in the second stage of the fit
[in]	rDSecondStage	whether rD should be floated only in the second stage of the fit
[in]	deltaDSecondStage	whether deltaD should be floated only in the second stage of the fit
[in]	useGlobalGamma	whether gamma should be shared with other resonances
[in]	useGlobalADSPars	whether rD and deltaD should be shared with other resonances

Definition at line 35 of file LauPolarGammaCPCoeffSet.cc.

virtual LauPolarGammaCPCoeffSet::~LauPolarGammaCPCoeffSet ( )

inlinevirtual

Destructor.

Definition at line 94 of file LauPolarGammaCPCoeffSet.hh.

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

Member Function Documentation

LauParameter LauPolarGammaCPCoeffSet::acp ( )

virtual

Calculate the CP asymmetry.

Returns: the CP asymmetry

Implements LauAbsCoeffSet.

Definition at line 640 of file LauPolarGammaCPCoeffSet.cc.

void LauPolarGammaCPCoeffSet::adjustName	(	LauParameter *	par,
		const TString &	oldBaseName
	)

privatevirtual

Prepend the base name and index to the name of a parameter.

Parameters

[in,out]	par	pointer to the parameter
[in]	oldBaseName	the old base name, which might need to be removed before adding the new one

Reimplemented from LauAbsCoeffSet.

Definition at line 235 of file LauPolarGammaCPCoeffSet.cc.

const LauComplex & LauPolarGammaCPCoeffSet::antiparticleCoeff ( )

virtual

Retrieve the complex coefficient for an antiparticle.

Returns: the complex coefficient for an antiparticle

Implements LauAbsCoeffSet.

Definition at line 550 of file LauPolarGammaCPCoeffSet.cc.

LauAbsCoeffSet * LauPolarGammaCPCoeffSet::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 743 of file LauPolarGammaCPCoeffSet.cc.

void LauPolarGammaCPCoeffSet::finaliseValues ( )

virtual

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

Implements LauAbsCoeffSet.

Definition at line 420 of file LauPolarGammaCPCoeffSet.cc.

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

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

private

Copy assignment operator (not implemented)

Parameters

[in] rhs the coefficient to clone

const LauComplex & LauPolarGammaCPCoeffSet::particleCoeff ( )

virtual

Retrieve the complex coefficient for a particle.

Returns: the complex coefficient for a particle

Implements LauAbsCoeffSet.

Definition at line 544 of file LauPolarGammaCPCoeffSet.cc.

void LauPolarGammaCPCoeffSet::printParValues ( ) const

virtual

Print the current values of the parameters.

Implements LauAbsCoeffSet.

Definition at line 274 of file LauPolarGammaCPCoeffSet.cc.

void LauPolarGammaCPCoeffSet::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 290 of file LauPolarGammaCPCoeffSet.cc.

void LauPolarGammaCPCoeffSet::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 337 of file LauPolarGammaCPCoeffSet.cc.

void LauPolarGammaCPCoeffSet::randomiseInitValues ( )

virtual

Randomise the starting values of the parameters for a fit.

Implements LauAbsCoeffSet.

Definition at line 377 of file LauPolarGammaCPCoeffSet.cc.

void LauPolarGammaCPCoeffSet::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, hence 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 635 of file LauPolarGammaCPCoeffSet.cc.

void LauPolarGammaCPCoeffSet::updateAmplitudes ( )

private

Update the amplitudes based on the new values of the parameters.

Definition at line 556 of file LauPolarGammaCPCoeffSet.cc.