Logo ROOT  
Reference Guide
TProfile.h
Go to the documentation of this file.
1 // @(#)root/hist:$Id$
2 // Author: Rene Brun 29/09/95
3 
4 /*************************************************************************
5  * Copyright (C) 1995-2000, Rene Brun and Fons Rademakers. *
6  * All rights reserved. *
7  * *
8  * For the licensing terms see $ROOTSYS/LICENSE. *
9  * For the list of contributors see $ROOTSYS/README/CREDITS. *
10  *************************************************************************/
11 
12 #ifndef ROOT_TProfile
13 #define ROOT_TProfile
14 
15 
16 //////////////////////////////////////////////////////////////////////////
17 // //
18 // TProfile //
19 // //
20 // Profile histogram class. //
21 // //
22 //////////////////////////////////////////////////////////////////////////
23 
24 #include "TH1.h"
25 
26 class TProfileHelper;
27 
29 
30 class TF1;
31 
32 class TProfile : public TH1D {
33 
34 public:
35  friend class TProfileHelper;
36  friend class TH1Merger;
37 
38 protected:
39  TArrayD fBinEntries; // number of entries per bin
40  EErrorType fErrorMode; // Option to compute errors
41  Double_t fYmin; // Lower limit in Y (if set)
42  Double_t fYmax; // Upper limit in Y (if set)
43  Bool_t fScaling; //! True when TProfile::Scale is called
44  Double_t fTsumwy; // Total Sum of weight*Y
45  Double_t fTsumwy2; // Total Sum of weight*Y*Y
46  TArrayD fBinSumw2; // Array of sum of squares of weights per bin
47 
48  static Bool_t fgApproximate; // bin error approximation option
49 
50  virtual Int_t BufferFill(Double_t, Double_t) {return -2;} //may not use
52 
53  // helper methods for the Merge unification in TProfileHelper
54  void SetBins(const Int_t* nbins, const Double_t* range) { SetBins(nbins[0], range[0], range[1]); };
55  Int_t Fill(const Double_t* v) { return Fill(v[0], v[1], v[2]); };
56 
57  virtual Double_t RetrieveBinContent(Int_t bin) const { return (fBinEntries.fArray[bin] > 0) ? fArray[bin]/fBinEntries.fArray[bin] : 0; }
58  //virtual void UpdateBinContent(Int_t bin, Double_t content);
59  virtual Double_t GetBinErrorSqUnchecked(Int_t bin) const { Double_t err = GetBinError(bin); return err*err; }
60 
61 private:
62  Int_t Fill(Double_t) { MayNotUse("Fill(Double_t)"); return -1;}
63  void FillN(Int_t, const Double_t *, const Double_t *, Int_t) { MayNotUse("FillN(Int_t, Double_t*, Double_t*, Int_t)"); }
64  Double_t *GetB() {return &fBinEntries.fArray[0];}
65  Double_t *GetB2() {return (fBinSumw2.fN ? &fBinSumw2.fArray[0] : 0 ); }
66  Double_t *GetW() {return &fArray[0];}
67  Double_t *GetW2() {return &fSumw2.fArray[0];}
69  { MayNotUse("SetBins(Int_t, Double_t, Double_t, Int_t, Double_t, Double_t"); }
70  void SetBins(Int_t, const Double_t*, Int_t, const Double_t*)
71  { MayNotUse("SetBins(Int_t, const Double_t*, Int_t, const Double_t*"); }
73  { MayNotUse("SetBins(Int_t, Double_t, Double_t, Int_t, Double_t, Double_t, Int_t, Double_t, Double_t"); }
74  void SetBins(Int_t, const Double_t *, Int_t, const Double_t *, Int_t, const Double_t *)
75  { MayNotUse("SetBins(Int_t, const Double_t*, Int_t, const Double_t*, Int_t, const Double_t*"); }
76 
77 public:
78  TProfile();
79  TProfile(const char *name,const char *title,Int_t nbinsx,Double_t xlow,Double_t xup, Option_t *option="");
80  TProfile(const char *name,const char *title,Int_t nbinsx,Double_t xlow,Double_t xup,Double_t ylow,Double_t yup,Option_t *option="");
81  TProfile(const char *name,const char *title,Int_t nbinsx,const Float_t *xbins, Option_t *option="");
82  TProfile(const char *name,const char *title,Int_t nbinsx,const Double_t *xbins, Option_t *option="");
83  TProfile(const char *name,const char *title,Int_t nbinsx,const Double_t *xbins, Double_t ylow,Double_t yup, Option_t *option="");
84  TProfile(const TProfile &profile);
85  TProfile &operator=(const TProfile &profile);
86  virtual ~TProfile();
87  virtual Bool_t Add(TF1 *h1, Double_t c1=1, Option_t *option="");
88  virtual Bool_t Add(const TH1 *h1, Double_t c1=1);
89  virtual Bool_t Add(const TH1 *h1, const TH1 *h2, Double_t c1=1, Double_t c2=1); // *MENU*
90  static void Approximate(Bool_t approx=kTRUE);
91  virtual Int_t BufferEmpty(Int_t action=0);
93  virtual void Copy(TObject &hnew) const;
94  virtual Bool_t Divide(TF1 *h1, Double_t c1=1);
95  virtual Bool_t Divide(const TH1 *h1);
96  virtual Bool_t Divide(const TH1 *h1, const TH1 *h2, Double_t c1=1, Double_t c2=1, Option_t *option=""); // *MENU*
97  virtual void ExtendAxis(Double_t x, TAxis *axis);
98  virtual Int_t Fill(Double_t x, Double_t y);
99  virtual Int_t Fill(const char *namex, Double_t y);
100  virtual Int_t Fill(Double_t x, Double_t y, Double_t w);
101  virtual Int_t Fill(const char *namex, Double_t y, Double_t w);
102  virtual void FillN(Int_t ntimes, const Double_t *x, const Double_t *y, const Double_t *w, Int_t stride=1);
103  virtual Double_t GetBinContent(Int_t bin) const;
104  virtual Double_t GetBinContent(Int_t bin, Int_t) const {return GetBinContent(bin);}
105  virtual Double_t GetBinContent(Int_t bin, Int_t, Int_t) const {return GetBinContent(bin);}
106  virtual Double_t GetBinError(Int_t bin) const;
107  virtual Double_t GetBinError(Int_t bin, Int_t) const {return GetBinError(bin);}
108  virtual Double_t GetBinError(Int_t bin, Int_t, Int_t) const {return GetBinError(bin);}
109  virtual Double_t GetBinEntries(Int_t bin) const;
110  virtual Double_t GetBinEffectiveEntries(Int_t bin) const;
111  virtual TArrayD *GetBinSumw2() {return &fBinSumw2;}
112  virtual const TArrayD *GetBinSumw2() const {return &fBinSumw2;}
113  Option_t *GetErrorOption() const;
114  virtual void GetStats(Double_t *stats) const;
115  virtual Double_t GetYmin() const {return fYmin;}
116  virtual Double_t GetYmax() const {return fYmax;}
117  virtual void LabelsDeflate(Option_t *axis="X");
118  virtual void LabelsInflate(Option_t *axis="X");
119  virtual void LabelsOption(Option_t *option="h", Option_t *axis="X");
120  virtual Long64_t Merge(TCollection *list);
121  virtual Bool_t Multiply(TF1 *h1, Double_t c1=1);
122  virtual Bool_t Multiply(const TH1 *h1);
123  virtual Bool_t Multiply(const TH1 *h1, const TH1 *h2, Double_t c1=1, Double_t c2=1, Option_t *option=""); // *MENU*
124  TH1D *ProjectionX(const char *name="_px", Option_t *option="e") const;
125  virtual void PutStats(Double_t *stats);
126  TH1 *Rebin(Int_t ngroup=2, const char*newname="", const Double_t *xbins=0);
127  virtual void Reset(Option_t *option="");
128  virtual void SavePrimitive(std::ostream &out, Option_t *option = "");
129  virtual void Scale(Double_t c1=1, Option_t *option="");
130  virtual void SetBinEntries(Int_t bin, Double_t w);
131  virtual void SetBins(Int_t nbins, Double_t xmin, Double_t xmax);
132  virtual void SetBins(Int_t nx, const Double_t *xbins);
133  virtual void SetBinsLength(Int_t n=-1);
134  virtual void SetBuffer(Int_t buffersize, Option_t *option="");
135  virtual void SetErrorOption(Option_t *option=""); // *MENU*
136  virtual void Sumw2(Bool_t flag = kTRUE);
137 
138  ClassDef(TProfile,7) //Profile histogram class
139 };
140 
141 #endif
n
const Int_t n
Definition: legend1.C:16
TAxis
Class to manage histogram axis.
Definition: TAxis.h:30
TProfile::GetBinEntries
virtual Double_t GetBinEntries(Int_t bin) const
Return bin entries of a Profile histogram.
Definition: TProfile.cxx:833
TProfile::SetBinEntries
virtual void SetBinEntries(Int_t bin, Double_t w)
Set the number of entries in bin.
Definition: TProfile.cxx:1696
ymax
float ymax
Definition: THbookFile.cxx:95
kTRUE
const Bool_t kTRUE
Definition: RtypesCore.h:91
TProfile::TProfile
TProfile()
Default constructor for Profile histograms.
Definition: TProfile.cxx:92
Option_t
const char Option_t
Definition: RtypesCore.h:66
TProfile::operator=
TProfile & operator=(const TProfile &profile)
Definition: TProfile.cxx:249
TProfile::GetBinError
virtual Double_t GetBinError(Int_t bin) const
Return bin error of a Profile histogram.
Definition: TProfile.cxx:884
TProfile::Rebin
TH1 * Rebin(Int_t ngroup=2, const char *newname="", const Double_t *xbins=0)
Rebin this profile grouping ngroup bins together.
Definition: TProfile.cxx:1406
TProfile::Merge
virtual Long64_t Merge(TCollection *list)
Merge all histograms in the collection in this histogram.
Definition: TProfile.cxx:1188
TProfile::GetBinEffectiveEntries
virtual Double_t GetBinEffectiveEntries(Int_t bin) const
Return bin effective entries for a weighted filled Profile histogram.
Definition: TProfile.cxx:849
TProfile::LabelsDeflate
virtual void LabelsDeflate(Option_t *axis="X")
Reduce the number of bins for this axis to the number of bins having a label.
Definition: TProfile.cxx:969
TProfile::LabelsInflate
virtual void LabelsInflate(Option_t *axis="X")
Double the number of bins for axis.
Definition: TProfile.cxx:979
TProfile::~TProfile
virtual ~TProfile()
Default destructor for Profile histograms.
Definition: TProfile.cxx:100
TProfile::BufferEmpty
virtual Int_t BufferEmpty(Int_t action=0)
Fill histogram with all entries in the buffer.
Definition: TProfile.cxx:334
xmax
float xmax
Definition: THbookFile.cxx:95
TProfile::Add
virtual Bool_t Add(TF1 *h1, Double_t c1=1, Option_t *option="")
Performs the operation: this = this + c1*f1.
Definition: TProfile.cxx:258
Long64_t
long long Long64_t
Definition: RtypesCore.h:73
TProfile::ExtendAxis
virtual void ExtendAxis(Double_t x, TAxis *axis)
Profile histogram is resized along x axis such that x is in the axis range.
Definition: TProfile.cxx:1579
TH1D
1-D histogram with a double per channel (see TH1 documentation)}
Definition: TH1.h:618
Float_t
float Float_t
Definition: RtypesCore.h:57
Int_t
int Int_t
Definition: RtypesCore.h:45
x
Double_t x[n]
Definition: legend1.C:17
TProfile::GetYmax
virtual Double_t GetYmax() const
Definition: TProfile.h:116
TProfile::SetBins
void SetBins(Int_t, const Double_t *, Int_t, const Double_t *, Int_t, const Double_t *)
Redefine x, y and z axis parameters with variable bin sizes.
Definition: TProfile.h:74
TObject::MayNotUse
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 clas...
Definition: TObject.cxx:943
TProfile::Sumw2
virtual void Sumw2(Bool_t flag=kTRUE)
Create/delete structure to store sum of squares of weights per bin.
Definition: TProfile.cxx:1821
TArray::fN
Int_t fN
Definition: TArray.h:38
TProfile::Divide
virtual Bool_t Divide(TF1 *h1, Double_t c1=1)
Performs the operation: this = this/(c1*f1).
Definition: TProfile.cxx:449
Bool_t
bool Bool_t
Definition: RtypesCore.h:63
v
@ v
Definition: rootcling_impl.cxx:3635
TProfile::fYmax
Double_t fYmax
Definition: TProfile.h:42
h1
TH1F * h1
Definition: legend1.C:5
bool
TProfile::GetB2
Double_t * GetB2()
Definition: TProfile.h:65
kERRORMEAN
@ kERRORMEAN
Definition: TProfile.h:28
TH1Merger
Definition: TH1Merger.h:20
TProfile::GetBinErrorSqUnchecked
virtual Double_t GetBinErrorSqUnchecked(Int_t bin) const
Definition: TProfile.h:59
TProfile::fTsumwy
Double_t fTsumwy
True when TProfile::Scale is called.
Definition: TProfile.h:44
TProfile::PutStats
virtual void PutStats(Double_t *stats)
Replace current statistics with the values in array stats.
Definition: TProfile.cxx:1354
TProfile::LabelsOption
virtual void LabelsOption(Option_t *option="h", Option_t *axis="X")
Set option(s) to draw axis with labels.
Definition: TProfile.cxx:997
TProfile::fTsumwy2
Double_t fTsumwy2
Definition: TProfile.h:45
TProfile::FillN
void FillN(Int_t, const Double_t *, const Double_t *, Int_t)
Fill this histogram with an array x and weights w.
Definition: TProfile.h:63
TProfile::GetW2
Double_t * GetW2()
Definition: TProfile.h:67
TProfile::GetBinContent
virtual Double_t GetBinContent(Int_t bin, Int_t, Int_t) const
Definition: TProfile.h:105
TProfile::GetBinSumw2
virtual TArrayD * GetBinSumw2()
Definition: TProfile.h:111
TProfile::SetBuffer
virtual void SetBuffer(Int_t buffersize, Option_t *option="")
Set the buffer size in units of 8 bytes (double).
Definition: TProfile.cxx:1734
TProfile::GetW
Double_t * GetW()
Definition: TProfile.h:66
TProfile::Approximate
static void Approximate(Bool_t approx=kTRUE)
Static function to set the fgApproximate flag.
Definition: TProfile.cxx:320
TProfile::SetBins
void SetBins(Int_t, const Double_t *, Int_t, const Double_t *)
Redefine x and y axis parameters with variable bin sizes.
Definition: TProfile.h:70
xmin
float xmin
Definition: THbookFile.cxx:95
TProfile::Fill
Int_t Fill(const Double_t *v)
Definition: TProfile.h:55
TProfile::GetYmin
virtual Double_t GetYmin() const
Definition: TProfile.h:115
TProfile::GetStats
virtual void GetStats(Double_t *stats) const
fill the array stats from the contents of this profile.
Definition: TProfile.cxx:917
TProfile::BufferFill
virtual Int_t BufferFill(Double_t, Double_t)
accumulate arguments in buffer.
Definition: TProfile.h:50
y
Double_t y[n]
Definition: legend1.C:17
TProfile::GetBinContent
virtual Double_t GetBinContent(Int_t bin, Int_t) const
Definition: TProfile.h:104
TProfile::Copy
virtual void Copy(TObject &hnew) const
Copy a Profile histogram to a new profile histogram.
Definition: TProfile.cxx:419
kERRORSPREADI
@ kERRORSPREADI
Definition: TProfile.h:28
TProfile::SetErrorOption
virtual void SetErrorOption(Option_t *option="")
Set option to compute profile errors.
Definition: TProfile.cxx:1773
TProfile::GetErrorOption
Option_t * GetErrorOption() const
Return option to compute profile errors.
Definition: TProfile.cxx:892
ymin
float ymin
Definition: THbookFile.cxx:95
TProfile
Profile Histogram.
Definition: TProfile.h:32
TArrayD::Reset
void Reset()
Definition: TArrayD.h:47
TArrayD::fArray
Double_t * fArray
Definition: TArrayD.h:30
Double_t
double Double_t
Definition: RtypesCore.h:59
TProfile::BuildOptions
void BuildOptions(Double_t ymin, Double_t ymax, Option_t *option)
Set Profile histogram structure and options.
Definition: TProfile.cxx:227
TProfile::GetB
Double_t * GetB()
Definition: TProfile.h:64
TProfile::fgApproximate
static Bool_t fgApproximate
Definition: TProfile.h:48
EErrorType
EErrorType
Definition: TProfile.h:28
TH1::fSumw2
TArrayD fSumw2
Array of sum of squares of weights.
Definition: TH1.h:103
TObject
Mother of all ROOT objects.
Definition: TObject.h:37
TProfile::Fill
Int_t Fill(Double_t)
Increment bin with abscissa X by 1.
Definition: TProfile.h:62
ClassDef
#define ClassDef(name, id)
Definition: Rtypes.h:325
TProfile::SetBins
void SetBins(Int_t, Double_t, Double_t, Int_t, Double_t, Double_t, Int_t, Double_t, Double_t)
Redefine x, y and z axis parameters.
Definition: TProfile.h:72
TProfile::GetBinError
virtual Double_t GetBinError(Int_t bin, Int_t, Int_t) const
Definition: TProfile.h:108
TH1
TH1 is the base class of all histogramm classes in ROOT.
Definition: TH1.h:58
name
char name[80]
Definition: TGX11.cxx:110
TProfileHelper
Definition: TProfileHelper.h:30
c2
return c2
Definition: legend2.C:14
TProfile::GetBinError
virtual Double_t GetBinError(Int_t bin, Int_t) const
Definition: TProfile.h:107
kERRORSPREADG
@ kERRORSPREADG
Definition: TProfile.h:28
TProfile::fBinEntries
TArrayD fBinEntries
Definition: TProfile.h:39
TProfile::GetBinSumw2
virtual const TArrayD * GetBinSumw2() const
Definition: TProfile.h:112
TProfile::SetBins
void SetBins(Int_t, Double_t, Double_t, Int_t, Double_t, Double_t)
Redefine x and y axis parameters.
Definition: TProfile.h:68
TCollection
Collection abstract base class.
Definition: TCollection.h:63
TProfile::SetBinsLength
virtual void SetBinsLength(Int_t n=-1)
Set total number of bins including under/overflow.
Definition: TProfile.cxx:1725
TProfile::fScaling
Bool_t fScaling
Definition: TProfile.h:43
TF1
1-Dim function class
Definition: TF1.h:213
TArrayD
Array of doubles (64 bits per element).
Definition: TArrayD.h:27
TProfile::fYmin
Double_t fYmin
Definition: TProfile.h:41
kERRORSPREAD
@ kERRORSPREAD
Definition: TProfile.h:28
TH1.h
TProfile::GetBinContent
virtual Double_t GetBinContent(Int_t bin) const
Return bin content of a Profile histogram.
Definition: TProfile.cxx:820
TProfile::SetBins
void SetBins(const Int_t *nbins, const Double_t *range)
Definition: TProfile.h:54
TProfile::Multiply
virtual Bool_t Multiply(TF1 *h1, Double_t c1=1)
Performs the operation: this = this*c1*f1.
Definition: TProfile.cxx:1198
TProfile::Scale
virtual void Scale(Double_t c1=1, Option_t *option="")
Multiply this profile by a constant c1.
Definition: TProfile.cxx:1688
TProfile::fErrorMode
EErrorType fErrorMode
Definition: TProfile.h:40
fw3dlego::xbins
const double xbins[xbins_n]
Definition: collection_proxies.C:48
TProfile::SavePrimitive
virtual void SavePrimitive(std::ostream &out, Option_t *option="")
Save primitive as a C++ statement(s) on output stream out.
Definition: TProfile.cxx:1608
int
c1
return c1
Definition: legend1.C:41
TProfile::fBinSumw2
TArrayD fBinSumw2
Definition: TProfile.h:46
TProfile::RetrieveBinContent
virtual Double_t RetrieveBinContent(Int_t bin) const
Raw retrieval of bin content on internal data structure see convention for numbering bins in TH1::Get...
Definition: TProfile.h:57
TProfile::ProjectionX
TH1D * ProjectionX(const char *name="_px", Option_t *option="e") const
Project this profile into a 1-D histogram along X.
Definition: TProfile.cxx:1279