Logo ROOT  
Reference Guide
 
Loading...
Searching...
No Matches
TFeldmanCousins Class Reference

Class to calculate the CL upper limit using the Feldman-Cousins method as described in PRD V57 #7, p3873-3889.

The default confidence interval calculated using this method is 90% This is set either by having a default the constructor, or using the appropriate fraction when instantiating an object of this class (e.g. 0.9)

The simple extension to a gaussian resolution function bounded at zero has not been addressed as yet -> ‘time is of the essence’ as they write on the wall of the maze in that classic game ...

VARIABLES THAT CAN BE ALTERED

=> depending on your desired precision: The initial values of fMuMin, fMuMax, fMuStep and fNMax are those used in the PRD:

fMuMin = 0.0
fMuMax = 50.0
fMuStep= 0.005

but there is total flexibility in changing this should you desire.

see example of use in $ROOTSYS/tutorials/math/FeldmanCousins.C

see note about: "Should I use TRolke, TFeldmanCousins, TLimit?" in the TRolke class description.

Author
: Adrian Bevan, Liverpool University

Copyright Liverpool University 2001 bevan.nosp@m.@sla.nosp@m.c.sta.nosp@m.nfor.nosp@m.d.edu

Definition at line 47 of file TFeldmanCousins.h.

Public Member Functions

 TFeldmanCousins (Double_t newCL=0.9, TString options="")
 Constructor.
 
virtual ~TFeldmanCousins ()
 
Double_t CalculateLowerLimit (Double_t Nobserved, Double_t Nbackground)
 given Nobserved and Nbackground, try different values of mu that give lower limits that are consistent with Nobserved.
 
Double_t CalculateUpperLimit (Double_t Nobserved, Double_t Nbackground)
 given Nobserved and Nbackground, try different values of mu that give upper limits that are consistent with Nobserved.
 
Double_t GetCL (void) const
 
Double_t GetLowerLimit (void) const
 
Double_t GetMuMax (void) const
 
Double_t GetMuMin (void) const
 
Double_t GetMuStep (void) const
 
Double_t GetNbackground (void) const
 
Double_t GetNMax (void) const
 
Double_t GetNobserved (void) const
 
Double_t GetUpperLimit (void) const
 
void SetCL (Double_t newCL)
 
void SetMuMax (Double_t newMax=50.0)
 Set maximum value of signal to use in calculating the tables.
 
void SetMuMin (Double_t newMin=0.0)
 
void SetMuStep (Double_t newMuStep=0.005)
 Set the step in signal to use when generating tables.
 
void SetNbackground (Double_t Nbg)
 
void SetNobserved (Double_t NObs)
 
- Public Member Functions inherited from TObject
 TObject ()
 TObject constructor.
 
 TObject (const TObject &object)
 TObject copy ctor.
 
virtual ~TObject ()
 TObject destructor.
 
void AbstractMethod (const char *method) const
 Use this method to implement an "abstract" method that you don't want to leave purely abstract.
 
virtual void AppendPad (Option_t *option="")
 Append graphics object to current pad.
 
virtual void Browse (TBrowser *b)
 Browse object. May be overridden for another default action.
 
ULong_t CheckedHash ()
 Check and record whether this class has a consistent Hash/RecursiveRemove setup (*) and then return the regular Hash value for this object.
 
virtual const char * ClassName () const
 Returns name of class to which the object belongs.
 
virtual void Clear (Option_t *="")
 
virtual TObjectClone (const char *newname="") const
 Make a clone of an object using the Streamer facility.
 
virtual Int_t Compare (const TObject *obj) const
 Compare abstract method.
 
virtual void Copy (TObject &object) const
 Copy this to obj.
 
virtual void Delete (Option_t *option="")
 Delete this object.
 
virtual Int_t DistancetoPrimitive (Int_t px, Int_t py)
 Computes distance from point (px,py) to the object.
 
virtual void Draw (Option_t *option="")
 Default Draw method for all objects.
 
virtual void DrawClass () const
 Draw class inheritance tree of the class to which this object belongs.
 
virtual TObjectDrawClone (Option_t *option="") const
 Draw a clone of this object in the current selected pad for instance with: gROOT->SetSelectedPad(gPad).
 
virtual void Dump () const
 Dump contents of object on stdout.
 
virtual void Error (const char *method, const char *msgfmt,...) const
 Issue error message.
 
virtual void Execute (const char *method, const char *params, Int_t *error=0)
 Execute method on this object with the given parameter string, e.g.
 
virtual void Execute (TMethod *method, TObjArray *params, Int_t *error=0)
 Execute method on this object with parameters stored in the TObjArray.
 
virtual void ExecuteEvent (Int_t event, Int_t px, Int_t py)
 Execute action corresponding to an event at (px,py).
 
virtual void Fatal (const char *method, const char *msgfmt,...) const
 Issue fatal error message.
 
virtual TObjectFindObject (const char *name) const
 Must be redefined in derived classes.
 
virtual TObjectFindObject (const TObject *obj) const
 Must be redefined in derived classes.
 
virtual Option_tGetDrawOption () const
 Get option used by the graphics system to draw this object.
 
virtual const char * GetIconName () const
 Returns mime type name of object.
 
virtual const char * GetName () const
 Returns name of object.
 
virtual char * GetObjectInfo (Int_t px, Int_t py) const
 Returns string containing info about the object at position (px,py).
 
virtual Option_tGetOption () const
 
virtual const char * GetTitle () const
 Returns title of object.
 
virtual UInt_t GetUniqueID () const
 Return the unique object id.
 
virtual Bool_t HandleTimer (TTimer *timer)
 Execute action in response of a timer timing out.
 
virtual ULong_t Hash () const
 Return hash value for this object.
 
Bool_t HasInconsistentHash () const
 Return true is the type of this object is known to have an inconsistent setup for Hash and RecursiveRemove (i.e.
 
virtual void Info (const char *method, const char *msgfmt,...) const
 Issue info message.
 
virtual Bool_t InheritsFrom (const char *classname) const
 Returns kTRUE if object inherits from class "classname".
 
virtual Bool_t InheritsFrom (const TClass *cl) const
 Returns kTRUE if object inherits from TClass cl.
 
virtual void Inspect () const
 Dump contents of this object in a graphics canvas.
 
void InvertBit (UInt_t f)
 
Bool_t IsDestructed () const
 IsDestructed.
 
virtual Bool_t IsEqual (const TObject *obj) const
 Default equal comparison (objects are equal if they have the same address in memory).
 
virtual Bool_t IsFolder () const
 Returns kTRUE in case object contains browsable objects (like containers or lists of other objects).
 
R__ALWAYS_INLINE Bool_t IsOnHeap () const
 
virtual Bool_t IsSortable () const
 
R__ALWAYS_INLINE Bool_t IsZombie () const
 
virtual void ls (Option_t *option="") const
 The ls function lists the contents of a class on stdout.
 
void MayNotUse (const char *method) const
 Use this method to signal that a method (defined in a base class) may not be called in a derived class (in principle against good design since a child class should not provide less functionality than its parent, however, sometimes it is necessary).
 
virtual Bool_t Notify ()
 This method must be overridden to handle object notification.
 
void Obsolete (const char *method, const char *asOfVers, const char *removedFromVers) const
 Use this method to declare a method obsolete.
 
void operator delete (void *ptr)
 Operator delete.
 
void operator delete[] (void *ptr)
 Operator delete [].
 
voidoperator new (size_t sz)
 
voidoperator new (size_t sz, void *vp)
 
voidoperator new[] (size_t sz)
 
voidoperator new[] (size_t sz, void *vp)
 
TObjectoperator= (const TObject &rhs)
 TObject assignment operator.
 
virtual void Paint (Option_t *option="")
 This method must be overridden if a class wants to paint itself.
 
virtual void Pop ()
 Pop on object drawn in a pad to the top of the display list.
 
virtual void Print (Option_t *option="") const
 This method must be overridden when a class wants to print itself.
 
virtual Int_t Read (const char *name)
 Read contents of object with specified name from the current directory.
 
virtual void RecursiveRemove (TObject *obj)
 Recursively remove this object from a list.
 
void ResetBit (UInt_t f)
 
virtual void SaveAs (const char *filename="", Option_t *option="") const
 Save this object in the file specified by filename.
 
virtual void SavePrimitive (std::ostream &out, Option_t *option="")
 Save a primitive as a C++ statement(s) on output stream "out".
 
void SetBit (UInt_t f)
 
void SetBit (UInt_t f, Bool_t set)
 Set or unset the user status bits as specified in f.
 
virtual void SetDrawOption (Option_t *option="")
 Set drawing option for object.
 
virtual void SetUniqueID (UInt_t uid)
 Set the unique object id.
 
virtual void SysError (const char *method, const char *msgfmt,...) const
 Issue system error message.
 
R__ALWAYS_INLINE Bool_t TestBit (UInt_t f) const
 
Int_t TestBits (UInt_t f) const
 
virtual void UseCurrentStyle ()
 Set current style settings in this object This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked.
 
virtual void Warning (const char *method, const char *msgfmt,...) const
 Issue warning message.
 
virtual Int_t Write (const char *name=0, Int_t option=0, Int_t bufsize=0)
 Write this object to the current directory.
 
virtual Int_t Write (const char *name=0, Int_t option=0, Int_t bufsize=0) const
 Write this object to the current directory.
 

Protected Member Functions

Int_t FindLimitsFromTable (Double_t mu)
 calculate the probability table for a given mu for n = 0, NMAX and return 1 if the number of observed events is consistent with the CL bad
 
Double_t Prob (Int_t N, Double_t mu, Double_t B)
 Calculate the poissonian probability for a mean of mu+B events with a variance of N.
 
- Protected Member Functions inherited from TObject
virtual void DoError (int level, const char *location, const char *fmt, va_list va) const
 Interface to ErrorHandler (protected).
 
void MakeZombie ()
 

Protected Attributes

Double_t fCL
 
Double_t fLowerLimit
 
Double_t fMuMax
 
Double_t fMuMin
 
Double_t fMuStep
 
Double_t fNbackground
 
Int_t fNMax
 
Int_t fNMuStep
 
Double_t fNobserved
 
Int_t fQUICK
 
Double_t fUpperLimit
 

Additional Inherited Members

- Public Types inherited from TObject
enum  {
  kIsOnHeap = 0x01000000 , kNotDeleted = 0x02000000 , kZombie = 0x04000000 , kInconsistent = 0x08000000 ,
  kBitMask = 0x00ffffff
}
 
enum  { kSingleKey = BIT(0) , kOverwrite = BIT(1) , kWriteDelete = BIT(2) }
 
enum  EDeprecatedStatusBits { kObjInCanvas = BIT(3) }
 
enum  EStatusBits {
  kCanDelete = BIT(0) , kMustCleanup = BIT(3) , kIsReferenced = BIT(4) , kHasUUID = BIT(5) ,
  kCannotPick = BIT(6) , kNoContextMenu = BIT(8) , kInvalidObject = BIT(13)
}
 
- Static Public Member Functions inherited from TObject
static Longptr_t GetDtorOnly ()
 Return destructor only flag.
 
static Bool_t GetObjectStat ()
 Get status of object stat flag.
 
static void SetDtorOnly (void *obj)
 Set destructor only flag.
 
static void SetObjectStat (Bool_t stat)
 Turn on/off tracking of objects in the TObjectTable.
 
- Protected Types inherited from TObject
enum  { kOnlyPrepStep = BIT(3) }
 

#include <TFeldmanCousins.h>

Inheritance diagram for TFeldmanCousins:
[legend]

Constructor & Destructor Documentation

◆ TFeldmanCousins()

TFeldmanCousins::TFeldmanCousins ( Double_t  newCL = 0.9,
TString  options = "" 
)

Constructor.

Definition at line 57 of file TFeldmanCousins.cxx.

◆ ~TFeldmanCousins()

TFeldmanCousins::~TFeldmanCousins ( )
virtual

Definition at line 79 of file TFeldmanCousins.cxx.

Member Function Documentation

◆ CalculateLowerLimit()

Double_t TFeldmanCousins::CalculateLowerLimit ( Double_t  Nobserved,
Double_t  Nbackground 
)

given Nobserved and Nbackground, try different values of mu that give lower limits that are consistent with Nobserved.

The closed interval (plus any stragglers) corresponds to the F&C interval

Definition at line 88 of file TFeldmanCousins.cxx.

◆ CalculateUpperLimit()

Double_t TFeldmanCousins::CalculateUpperLimit ( Double_t  Nobserved,
Double_t  Nbackground 
)

given Nobserved and Nbackground, try different values of mu that give upper limits that are consistent with Nobserved.

The closed interval (plus any stragglers) corresponds to the F&C interval

Definition at line 100 of file TFeldmanCousins.cxx.

◆ FindLimitsFromTable()

Int_t TFeldmanCousins::FindLimitsFromTable ( Double_t  mu)
protected

calculate the probability table for a given mu for n = 0, NMAX and return 1 if the number of observed events is consistent with the CL bad

Definition at line 155 of file TFeldmanCousins.cxx.

◆ GetCL()

Double_t TFeldmanCousins::GetCL ( void  ) const
inline

Definition at line 93 of file TFeldmanCousins.h.

◆ GetLowerLimit()

Double_t TFeldmanCousins::GetLowerLimit ( void  ) const
inline

Definition at line 90 of file TFeldmanCousins.h.

◆ GetMuMax()

Double_t TFeldmanCousins::GetMuMax ( void  ) const
inline

Definition at line 96 of file TFeldmanCousins.h.

◆ GetMuMin()

Double_t TFeldmanCousins::GetMuMin ( void  ) const
inline

Definition at line 95 of file TFeldmanCousins.h.

◆ GetMuStep()

Double_t TFeldmanCousins::GetMuStep ( void  ) const
inline

Definition at line 97 of file TFeldmanCousins.h.

◆ GetNbackground()

Double_t TFeldmanCousins::GetNbackground ( void  ) const
inline

Definition at line 92 of file TFeldmanCousins.h.

◆ GetNMax()

Double_t TFeldmanCousins::GetNMax ( void  ) const
inline

Definition at line 98 of file TFeldmanCousins.h.

◆ GetNobserved()

Double_t TFeldmanCousins::GetNobserved ( void  ) const
inline

Definition at line 91 of file TFeldmanCousins.h.

◆ GetUpperLimit()

Double_t TFeldmanCousins::GetUpperLimit ( void  ) const
inline

Definition at line 89 of file TFeldmanCousins.h.

◆ Prob()

Double_t TFeldmanCousins::Prob ( Int_t  N,
Double_t  mu,
Double_t  B 
)
protected

Calculate the poissonian probability for a mean of mu+B events with a variance of N.

Definition at line 201 of file TFeldmanCousins.cxx.

◆ SetCL()

void TFeldmanCousins::SetCL ( Double_t  newCL)
inline

Definition at line 102 of file TFeldmanCousins.h.

◆ SetMuMax()

void TFeldmanCousins::SetMuMax ( Double_t  newMax = 50.0)

Set maximum value of signal to use in calculating the tables.

Definition at line 209 of file TFeldmanCousins.cxx.

◆ SetMuMin()

void TFeldmanCousins::SetMuMin ( Double_t  newMin = 0.0)
inline

Definition at line 104 of file TFeldmanCousins.h.

◆ SetMuStep()

void TFeldmanCousins::SetMuStep ( Double_t  newMuStep = 0.005)

Set the step in signal to use when generating tables.

Definition at line 219 of file TFeldmanCousins.cxx.

◆ SetNbackground()

void TFeldmanCousins::SetNbackground ( Double_t  Nbg)
inline

Definition at line 101 of file TFeldmanCousins.h.

◆ SetNobserved()

void TFeldmanCousins::SetNobserved ( Double_t  NObs)
inline

Definition at line 100 of file TFeldmanCousins.h.

Member Data Documentation

◆ fCL

Double_t TFeldmanCousins::fCL
protected

Definition at line 49 of file TFeldmanCousins.h.

◆ fLowerLimit

Double_t TFeldmanCousins::fLowerLimit
protected

Definition at line 51 of file TFeldmanCousins.h.

◆ fMuMax

Double_t TFeldmanCousins::fMuMax
protected

Definition at line 55 of file TFeldmanCousins.h.

◆ fMuMin

Double_t TFeldmanCousins::fMuMin
protected

Definition at line 54 of file TFeldmanCousins.h.

◆ fMuStep

Double_t TFeldmanCousins::fMuStep
protected

Definition at line 56 of file TFeldmanCousins.h.

◆ fNbackground

Double_t TFeldmanCousins::fNbackground
protected

Definition at line 53 of file TFeldmanCousins.h.

◆ fNMax

Int_t TFeldmanCousins::fNMax
protected

Definition at line 58 of file TFeldmanCousins.h.

◆ fNMuStep

Int_t TFeldmanCousins::fNMuStep
protected

Definition at line 57 of file TFeldmanCousins.h.

◆ fNobserved

Double_t TFeldmanCousins::fNobserved
protected

Definition at line 52 of file TFeldmanCousins.h.

◆ fQUICK

Int_t TFeldmanCousins::fQUICK
protected

Definition at line 59 of file TFeldmanCousins.h.

◆ fUpperLimit

Double_t TFeldmanCousins::fUpperLimit
protected

Definition at line 50 of file TFeldmanCousins.h.

Libraries for TFeldmanCousins:

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