laura is hosted by Hepforge, IPPP Durham
Laura++  v3r1
A maximum likelihood fitting package for performing Dalitz-plot analysis.
LauAbsResonance.hh
Go to the documentation of this file.
1 
2 // Copyright University of Warwick 2004 - 2014.
3 // Distributed under the Boost Software License, Version 1.0.
4 // (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
5 
6 // Authors:
7 // Thomas Latham
8 // John Back
9 // Paul Harrison
10 
24 #ifndef LAU_ABS_RESONANCE
25 #define LAU_ABS_RESONANCE
26 
27 #include "TString.h"
28 
30 #include "LauComplex.hh"
31 #include "LauParameter.hh"
32 
33 class LauDaughters;
34 class LauKinematics;
35 class LauResonanceInfo;
36 
38 
39  public:
42  BW,
44  GS,
49  LASS,
69  };
70 
72 
76  static bool isIncoherentModel(LauResonanceModel model);
77 
79 
84  LauAbsResonance(LauResonanceInfo* resInfo, const Int_t resPairAmpInt, const LauDaughters* daughters);
85 
87 
92  LauAbsResonance(const TString& resName, const Int_t resPairAmpInt, const LauDaughters* daughters);
93 
95  virtual ~LauAbsResonance();
96 
98  virtual void initialise() = 0;
99 
101 
105  virtual LauComplex amplitude(const LauKinematics* kinematics);
106 
108 
111  virtual LauResonanceModel getResonanceModel() const = 0;
112 
114 
117  const TString& getResonanceName() const {return resName_;}
118 
120 
123  const TString& getSanitisedName() const {return sanitisedName_;}
124 
126 
129  Int_t getPairInt() const {return resPairAmpInt_;}
130 
132 
135  Int_t getSpin() const {return resSpin_;}
136 
138 
141  Int_t getCharge() const {return resCharge_;}
142 
144 
147  Double_t getMass() const {return (resMass_!=0) ? resMass_->unblindValue() : -1.0;}
148 
150 
153  Double_t getWidth() const {return (resWidth_!=0) ? resWidth_->unblindValue() : -1.0;}
154 
156 
160 
162 
166 
168 
171  virtual const std::vector<LauParameter*>& getFloatingParameters() { return this->getParameters(); };
172 
174 
179  virtual Bool_t preSymmetrised() const {return kFALSE;}
180 
182 
185  Bool_t flipHelicity() const {return flipHelicity_;}
186 
188 
191  void flipHelicity(const Bool_t boolean) {flipHelicity_ = boolean;}
192 
194 
197  Bool_t ignoreMomenta() const {return ignoreMomenta_;}
198 
200 
203  void ignoreMomenta(const Bool_t boolean) {ignoreMomenta_ = boolean;}
204 
206 
209  Bool_t ignoreSpin() const {return ignoreSpin_;}
210 
212 
215  void ignoreSpin(const Bool_t boolean) {ignoreSpin_ = boolean;}
216 
217 
219 
223 
225 
228  void ignoreBarrierScaling(const Bool_t boolean) {ignoreBarrierScaling_ = boolean;}
229 
231 
240  void changeResonance(const Double_t newMass, const Double_t newWidth, const Int_t newSpin);
241 
243 
251  void changeBWBarrierRadii(const Double_t resRadius, const Double_t parRadius);
252 
254 
258  virtual void setResonanceParameter(const TString& name, const Double_t value);
259 
261 
264  virtual void floatResonanceParameter(const TString& name);
265 
267 
271  virtual LauParameter* getResonanceParameter(const TString& name);
272 
274 
277  void fixMass(const Bool_t parFixed) { if (resMass_!=0) { resMass_->fixed(parFixed); } }
278 
280 
283  void fixWidth(const Bool_t parFixed) { if (resWidth_!=0) { resWidth_->fixed(parFixed); } }
284 
286 
289  Bool_t fixMass() const { return (resMass_!=0) ? resMass_->fixed() : kTRUE; }
290 
292 
295  Bool_t fixWidth() const { return (resWidth_!=0) ? resWidth_->fixed() : kTRUE; }
296 
298 
303  {
304  resBWFactor_ = resFactor;
305  parBWFactor_ = parFactor;
306  }
307 
309  void fixBarrierRadii(const Bool_t fixResRadius, const Bool_t fixParRadius);
310 
312  Bool_t fixResRadius() const;
313 
315  Bool_t fixParRadius() const;
316 
318  Double_t getResRadius() const;
319 
321  Double_t getParRadius() const;
322 
323  protected:
325  TString getNameParent() const;
327  TString getNameDaug1() const;
329  TString getNameDaug2() const;
331  TString getNameBachelor() const;
333  Double_t getMassParent() const;
335  Double_t getMassDaug1() const;
337  Double_t getMassDaug2() const;
339  Double_t getMassBachelor() const;
341  Int_t getChargeParent() const;
343  Int_t getChargeDaug1() const;
345  Int_t getChargeDaug2() const;
347  Int_t getChargeBachelor() const;
348 
350  Double_t getQ() const {return q_;}
352  Double_t getP() const {return p_;}
354  Double_t getPstar() const {return pstar_;}
355 
362 
365 
367  const LauDaughters* getDaughters() const {return daughters_;}
368 
370 
374  Double_t calcSpinTerm( const Double_t cosHel, const Double_t pProd ) const;
375 
377 
381  virtual LauComplex resAmp(Double_t mass, Double_t spinTerm) = 0;
382 
385 
387 
390  void addFloatingParameter( LauParameter* param );
391 
393  std::vector<LauParameter*>& getParameters() { return resParameters_; }
394 
395 
396  private:
398  LauAbsResonance(const LauAbsResonance& rhs);
399 
402 
405 
408 
410  TString nameParent_;
412  TString nameDaug1_;
414  TString nameDaug2_;
416  TString nameBachelor_;
417 
421  Int_t chargeDaug1_;
423  Int_t chargeDaug2_;
426 
428  Double_t massParent_;
430  Double_t massDaug1_;
432  Double_t massDaug2_;
433  // Bachelor mass
434  Double_t massBachelor_;
435 
437  TString resName_;
438 
440  TString sanitisedName_;
441 
446 
448  std::vector<LauParameter*> resParameters_;
449 
451  Int_t resSpin_;
453  Int_t resCharge_;
460 
466  Bool_t ignoreSpin_;
469 
471  Double_t q_;
473  Double_t p_;
475  Double_t pstar_;
476 
477  ClassDef(LauAbsResonance,0) // Abstract resonance class
478 
479 };
480 
481 #endif
virtual void initialise()=0
Initialise the model.
Double_t getQ() const
Get the current value of the daughter momentum in the resonance rest frame.
Int_t getChargeBachelor() const
Get the charge of the bachelor daughter.
LauParameter * getMassPar()
Get the mass parameter of the resonance.
Bool_t fixed() const
Check whether the parameter is fixed or floated.
Double_t massDaug2_
Daughter 2 mass.
Double_t getMassBachelor() const
Get the mass of the bachelor daughter.
void setBarrierRadii(LauBlattWeisskopfFactor *resFactor, LauBlattWeisskopfFactor *parFactor)
Set the form factor model and parameters.
LauAbsResonance(LauResonanceInfo *resInfo, const Int_t resPairAmpInt, const LauDaughters *daughters)
Constructor (for use by standard resonances)
Bool_t fixWidth() const
Get the status of resonance width (fixed or released)
Bool_t ignoreMomenta_
Boolean to ignore q_ and p_ in spinTerm, as well as ignoring momentum dependent widths.
Double_t getMass() const
Get the mass of the resonance.
const TString & getResonanceName() const
Get the name of the resonance.
void changeResonance(const Double_t newMass, const Double_t newWidth, const Int_t newSpin)
Allow the mass, width and spin of the resonance to be changed.
LauAbsResonance & operator=(const LauAbsResonance &rhs)
Copy assignment operator (not implemented)
Double_t getMassParent() const
Get the parent particle mass.
Double_t massDaug1_
Daughter 1 mass.
Class for defining the properties of a resonant particle.
LauResonanceInfo * resInfo_
Information on the resonance.
Class that defines the particular 3-body decay under study.
Definition: LauDaughters.hh:33
void ignoreBarrierScaling(const Bool_t boolean)
Set the ignore barrier factor scaling flag.
TString nameDaug2_
Daughter 2 name.
virtual void floatResonanceParameter(const TString &name)
Allow the various parameters to float in the fit.
Double_t getPstar() const
Get the current value of the bachelor momentum in the parent rest frame.
Double_t getP() const
Get the current value of the bachelor momentum in the resonance rest frame.
const TString & getSanitisedName() const
Get the name of the resonance.
TString getNameDaug2() const
Get the name of the second daughter of the resonance.
LauParameter * resWidth_
Resonance width.
void ignoreMomenta(const Bool_t boolean)
Set the ignore p_ and q_ flag.
LauParameter * resMass_
Resonance mass.
LauBlattWeisskopfFactor * resBWFactor_
Blatt Weisskopf barrier for resonance decay.
const LauBlattWeisskopfFactor * getParBWFactor() const
Double_t massParent_
Parent mass.
Double_t getMassDaug1() const
Get the mass of daughter 1.
const LauDaughters * getDaughters() const
Access the daughters object.
Int_t getPairInt() const
Get the integer to identify which DP axis the resonance belongs to.
Bool_t fixResRadius() const
Get the status of resonance barrier radius (fixed or released)
Bool_t flipHelicity() const
Get the helicity flip flag.
Double_t getParRadius() const
Get the radius of the parent barrier factor.
Bool_t fixMass() const
Get the status of resonance mass (fixed or released)
Double_t getMassDaug2() const
Get the mass of daughter 2.
virtual LauParameter * getResonanceParameter(const TString &name)
Access the given resonance parameter.
void flipHelicity(const Bool_t boolean)
Set the helicity flip flag.
void addFloatingParameter(LauParameter *param)
Add parameter to the list of floating parameters.
LauBlattWeisskopfFactor * getParBWFactor()
Get the centrifugal barrier for the parent decay.
TString sanitisedName_
Resonance name with illegal characters removed.
Int_t chargeBachelor_
Bachelor charge.
File containing declaration of LauBlattWeisskopfFactor class.
Int_t getChargeDaug1() const
Get the charge of daughter 1.
const LauDaughters * daughters_
Information on the particles.
virtual LauResonanceModel getResonanceModel() const =0
Get the resonance model type.
void ignoreSpin(const Bool_t boolean)
Set the ignore p_ and q_ flag.
File containing declaration of LauParameter class.
std::vector< LauParameter * > resParameters_
All parameters of the resonance.
virtual void setResonanceParameter(const TString &name, const Double_t value)
Set value of the various parameters.
Int_t getChargeParent() const
Get the Charge of the parent particle.
File containing declaration of LauComplex class.
virtual ~LauAbsResonance()
Destructor.
LauBlattWeisskopfFactor * parBWFactor_
Blatt Weisskopf barrier for parent decay.
virtual LauComplex resAmp(Double_t mass, Double_t spinTerm)=0
Complex resonant amplitude.
TString getNameParent() const
Get the name of the parent particle.
std::vector< LauParameter * > & getParameters()
Access the list of floating parameters.
Int_t getCharge() const
Get the charge of the resonance.
LauParameter * getWidthPar()
Get the width parameter of the resonance.
TString nameBachelor_
Bachelor name.
Int_t chargeDaug2_
Daughter 2 charge.
Bool_t flipHelicity_
Boolean to flip helicity.
Class for defining the fit parameter objects.
Definition: LauParameter.hh:35
Bool_t ignoreMomenta() const
Get the ignore momenta flag.
Int_t resCharge_
Resonance charge.
TString nameParent_
Parent name.
Int_t chargeParent_
Parent charge.
TString getNameBachelor() const
Get the name of the daughter that does not originate form the resonance.
Int_t getChargeDaug2() const
Get the charge of daughter 2.
LauResonanceModel
Define the allowed resonance types.
Double_t getResRadius() const
Get the radius of the resonance barrier factor.
Double_t calcSpinTerm(const Double_t cosHel, const Double_t pProd) const
Calculate the amplitude spin term.
Double_t getWidth() const
Get the width of the resonance.
Bool_t fixParRadius() const
Get the status of parent barrier radius (fixed or released)
void fixBarrierRadii(const Bool_t fixResRadius, const Bool_t fixParRadius)
Fix or release the Blatt-Weisskopf barrier radii.
void fixWidth(const Bool_t parFixed)
Fix or release the resonance width.
Bool_t ignoreBarrierScaling_
Boolean to ignore barrier factor amplitude scaling; they are still used for the width.
Abstract class for defining type for resonance amplitude models (Breit-Wigner, Flatte etc...
void changeBWBarrierRadii(const Double_t resRadius, const Double_t parRadius)
Allow the Blatt-Weisskopf radius for the resonance and parent factors to be changed.
Bool_t ignoreSpin_
Boolean to set the spinTerm to unity always.
TString resName_
Resonance name.
LauResonanceInfo * getResInfo() const
Access the resonance info object.
Int_t resPairAmpInt_
DP axis identifier.
const LauBlattWeisskopfFactor * getResBWFactor() const
LauBlattWeisskopfFactor * getResBWFactor()
Get the centrifugal barrier for the resonance decay.
Double_t unblindValue() const
The unblinded value of the parameter.
Int_t chargeDaug1_
Daughter 1 charge.
Class for defining a complex number.
Definition: LauComplex.hh:47
Class that implements the Blatt-Weisskopf barrier factor.
TString getNameDaug1() const
Get the name of the first daughter of the resonance.
Class for calculating 3-body kinematic quantities.
Int_t resSpin_
Resonance spin.
virtual const std::vector< LauParameter * > & getFloatingParameters()
Retrieve the resonance parameters, e.g. so that they can be loaded into a fit.
virtual Bool_t preSymmetrised() const
Is the amplitude pre-symmetrised?
void fixMass(const Bool_t parFixed)
Fix or release the resonance mass.
Bool_t ignoreSpin() const
Get the ignore spin flag.
TString nameDaug1_
Daughter 1 name.
virtual LauComplex amplitude(const LauKinematics *kinematics)
Calculate the complex amplitude.
Int_t getSpin() const
Get the spin of the resonance.
static bool isIncoherentModel(LauResonanceModel model)
Is the resonance model incoherent?
Double_t p_
Bachelor momentum in resonance rest frame.
Bool_t ignoreBarrierScaling() const
Get the ignore barrier factor scaling flag.
Double_t pstar_
Bachelor momentum in parent rest frame.
Double_t q_
Daughter momentum in resonance rest frame.
void clearFloatingParameters()
Clear list of floating parameters.