Logo ROOT   6.12/07
Reference Guide
TF2.h
Go to the documentation of this file.
1 // @(#)root/hist:$Id$
2 // Author: Rene Brun 23/08/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 // ---------------------------------- F2.h
12 
13 #ifndef ROOT_TF2
14 #define ROOT_TF2
15 
16 
17 
18 //////////////////////////////////////////////////////////////////////////
19 // //
20 // TF2 //
21 // //
22 // The Parametric 2-D function //
23 // //
24 //////////////////////////////////////////////////////////////////////////
25 
26 #include "TF1.h"
27 #include "TArrayD.h"
28 
29 class TF2 : public TF1 {
30 
31 protected:
32  Double_t fYmin; //Lower bound for the range in y
33  Double_t fYmax; //Upper bound for the range in y
34  Int_t fNpy; //Number of points along y used for the graphical representation
35  TArrayD fContour; //Array to display contour levels
36 
37 public:
38  TF2();
39  TF2(const char *name, const char *formula, Double_t xmin=0, Double_t xmax=1, Double_t ymin=0, Double_t ymax=1, Option_t * opt = nullptr);
40 #ifndef __CINT__
41  TF2(const char *name, Double_t (*fcn)(Double_t *, Double_t *), Double_t xmin=0, Double_t xmax=1, Double_t ymin=0, Double_t ymax=1, Int_t npar=0,Int_t ndim = 2);
42  TF2(const char *name, Double_t (*fcn)(const Double_t *, const Double_t *), Double_t xmin=0, Double_t xmax=1, Double_t ymin=0, Double_t ymax=1, Int_t npar=0, Int_t ndim = 2);
43 #endif
44 
45  // constructor using a functor
46 
47  TF2(const char *name, ROOT::Math::ParamFunctor f, Double_t xmin = 0, Double_t xmax = 1, Double_t ymin = 0, Double_t ymax = 1, Int_t npar = 0, Int_t ndim = 2);
48 
49 
50  // Template constructors from a pointer to any C++ class of type PtrObj with a specific member function of type
51  // MemFn.
52  template <class PtrObj, typename MemFn>
53  TF2(const char *name, const PtrObj& p, MemFn memFn, Double_t xmin, Double_t xmax, Double_t ymin, Double_t ymax, Int_t npar, Int_t ndim = 2) :
54  TF1(name,p,memFn,xmin,xmax,npar,ndim),
55  fYmin(ymin), fYmax(ymax), fNpy(30), fContour(0)
56  {
57  fNpx = 30;
58  }
59  /// backward compatible ctor
60  template <class PtrObj, typename MemFn>
61  TF2(const char *name, const PtrObj& p, MemFn memFn, Double_t xmin, Double_t xmax, Double_t ymin, Double_t ymax, Int_t npar, const char * , const char *) :
62  TF1(name,p,memFn,xmin,xmax,npar,2),
63  fYmin(ymin), fYmax(ymax), fNpy(30), fContour(0)
64  {
65  fNpx = 30;
66  }
67 
68  // Template constructors from any C++ callable object, defining the operator() (double * , double *)
69  // and returning a double.
70  template <typename Func>
71  TF2(const char *name, Func f, Double_t xmin, Double_t xmax, Double_t ymin, Double_t ymax, Int_t npar,Int_t ndim = 2) :
72  TF1(name,f,xmin,xmax,npar,ndim),
73  fYmin(ymin), fYmax(ymax), fNpy(30), fContour(0)
74  {
75  fNpx = 30;
76  }
77  /// backward compatible ctor
78  template <typename Func>
79  TF2(const char *name, Func f, Double_t xmin, Double_t xmax, Double_t ymin, Double_t ymax, Int_t npar,const char *) :
80  TF1(name,f,xmin,xmax,npar,2),
81  fYmin(ymin), fYmax(ymax), fNpy(30), fContour(0)
82  {
83  fNpx = 30;
84  }
85 
86 
87  TF2(const TF2 &f2);
88  TF2 &operator=(const TF2& rhs);
89  virtual ~TF2();
90  virtual void Copy(TObject &f2) const;
91  virtual Int_t DistancetoPrimitive(Int_t px, Int_t py);
92  virtual void Draw(Option_t *option="");
93  virtual TF1 *DrawCopy(Option_t *option="") const;
94  virtual TObject *DrawDerivative(Option_t * ="al") {return 0;}
95  virtual TObject *DrawIntegral(Option_t * ="al") {return 0;}
96  //virtual void DrawF2(const char *formula, Double_t xmin, Double_t xmax, Double_t ymin, Double_t ymax, Option_t *option="");
97  virtual void ExecuteEvent(Int_t event, Int_t px, Int_t py);
98  virtual Int_t GetContour(Double_t *levels=0);
99  virtual Double_t GetContourLevel(Int_t level) const;
100  Int_t GetNpy() const {return fNpy;}
101  virtual char *GetObjectInfo(Int_t px, Int_t py) const;
104  virtual void GetRandom2(Double_t &xrandom, Double_t &yrandom);
105  using TF1::GetRange;
106  virtual void GetRange(Double_t &xmin, Double_t &ymin, Double_t &xmax, Double_t &ymax) const;
107  virtual void GetRange(Double_t &xmin, Double_t &ymin, Double_t &zmin, Double_t &xmax, Double_t &ymax, Double_t &zmax) const;
108  virtual Double_t GetSave(const Double_t *x);
109  virtual Double_t GetMinimumXY(Double_t &x, Double_t &y) const;
110  virtual Double_t GetMaximumXY(Double_t &x, Double_t &y) const;
111  using TF1::GetMinimum;
112  using TF1::GetMaximum;
113  virtual Double_t GetMinimum(Double_t *x ) const;
114  virtual Double_t GetMaximum(Double_t *x ) const;
115  virtual Double_t GetYmin() const {return fYmin;}
116  virtual Double_t GetYmax() const {return fYmax;}
117  using TF1::Integral;
118  virtual Double_t Integral(Double_t ax, Double_t bx, Double_t ay, Double_t by, Double_t epsrel=1.e-6);
119  virtual Bool_t IsInside(const Double_t *x) const;
120  virtual TH1 *CreateHistogram();
121  virtual void Paint(Option_t *option="");
122  virtual void Save(Double_t xmin, Double_t xmax, Double_t ymin, Double_t ymax, Double_t zmin, Double_t zmax);
123  virtual void SavePrimitive(std::ostream &out, Option_t *option = "");
124  virtual void SetNpy(Int_t npy=100); // *MENU*
125  virtual void SetContour(Int_t nlevels=20, const Double_t *levels=0);
126  virtual void SetContourLevel(Int_t level, Double_t value);
127  virtual void SetRange(Double_t xmin, Double_t xmax);
128  virtual void SetRange(Double_t xmin, Double_t ymin, Double_t xmax, Double_t ymax); // *MENU*
129  virtual void SetRange(Double_t xmin, Double_t ymin, Double_t zmin, Double_t xmax, Double_t ymax, Double_t zmax);
130 
131  //Moments
132  virtual Double_t Moment2(Double_t nx, Double_t ax, Double_t bx, Double_t ny, Double_t ay, Double_t by, Double_t epsilon=0.000001);
133  virtual Double_t CentralMoment2(Double_t nx, Double_t ax, Double_t bx, Double_t ny, Double_t ay, Double_t by, Double_t epsilon=0.000001);
134 
135  virtual Double_t Mean2X(Double_t ax, Double_t bx, Double_t ay, Double_t by, Double_t epsilon=0.000001) {return Moment2(1,ax,bx,0,ay,by,epsilon);}
136  virtual Double_t Mean2Y(Double_t ax, Double_t bx, Double_t ay, Double_t by, Double_t epsilon=0.000001) {return Moment2(0,ax,bx,1,ay,by,epsilon);}
137 
138  virtual Double_t Variance2X(Double_t ax, Double_t bx, Double_t ay, Double_t by, Double_t epsilon=0.000001) {return CentralMoment2(2,ax,bx,0,ay,by,epsilon);}
139  virtual Double_t Variance2Y(Double_t ax, Double_t bx, Double_t ay, Double_t by, Double_t epsilon=0.000001) {return CentralMoment2(0,ax,bx,2,ay,by,epsilon);}
140 
141  virtual Double_t Covariance2XY(Double_t ax, Double_t bx, Double_t ay, Double_t by, Double_t epsilon=0.000001) {return CentralMoment2(1,ax,bx,1,ay,by,epsilon);}
142 
143 protected:
144 
145  virtual Double_t FindMinMax(Double_t* x, bool findmax) const;
146 
147  ClassDef(TF2,4) //The Parametric 2-D function
148 };
149 
151  { TF1::SetRange(xmin, xmax); }
153  { SetRange(xmin, ymin, xmax, ymax); }
154 
155 #endif
Int_t GetNpy() const
Definition: TF2.h:100
virtual Double_t GetMaximum(Double_t xmin=0, Double_t xmax=0, Double_t epsilon=1.E-10, Int_t maxiter=100, Bool_t logx=false) const
Returns the maximum value of the function.
Definition: TF1.cxx:1499
Int_t fNpx
Definition: TF1.h:239
float xmin
Definition: THbookFile.cxx:93
virtual void Draw(Option_t *option="")
Draw this function with its current attributes.
Definition: TF2.cxx:217
Param Functor class for Multidimensional functions.
Definition: ParamFunctor.h:274
virtual Double_t GetContourLevel(Int_t level) const
Return the number of contour levels.
Definition: TF2.cxx:296
const char Option_t
Definition: RtypesCore.h:62
float ymin
Definition: THbookFile.cxx:93
virtual Double_t Moment2(Double_t nx, Double_t ax, Double_t bx, Double_t ny, Double_t ay, Double_t by, Double_t epsilon=0.000001)
Return x^nx * y^ny moment of a 2d function in range [ax,bx],[ay,by].
Definition: TF2.cxx:985
TF2(const char *name, const PtrObj &p, MemFn memFn, Double_t xmin, Double_t xmax, Double_t ymin, Double_t ymax, Int_t npar, Int_t ndim=2)
Definition: TF2.h:53
virtual Double_t GetMinimum(Double_t *x) const
Return minimum/maximum value of the function.
Definition: TF2.cxx:423
virtual void SetRange(Double_t xmin, Double_t xmax)
Initialize the upper and lower bounds to draw the function.
Definition: TF1.cxx:3406
TF2(const char *name, Func f, Double_t xmin, Double_t xmax, Double_t ymin, Double_t ymax, Int_t npar, Int_t ndim=2)
Definition: TF2.h:71
virtual void GetRange(Double_t &xmin, Double_t &ymin, Double_t &xmax, Double_t &ymax) const
Return range of a 2-D function.
Definition: TF2.cxx:555
int Int_t
Definition: RtypesCore.h:41
bool Bool_t
Definition: RtypesCore.h:59
virtual Double_t GetYmax() const
Definition: TF2.h:116
virtual Int_t DistancetoPrimitive(Int_t px, Int_t py)
Compute distance from point px,py to a function.
Definition: TF2.cxx:186
virtual Double_t Integral(Double_t a, Double_t b, Double_t epsrel=1.e-12)
IntegralOneDim or analytical integral.
Definition: TF1.cxx:2402
virtual Bool_t IsInside(const Double_t *x) const
Return kTRUE is the point is inside the function range.
Definition: TF2.cxx:641
Double_t fYmin
Definition: TF2.h:32
virtual Double_t Integral(Double_t ax, Double_t bx, Double_t ay, Double_t by, Double_t epsrel=1.e-6)
Return Integral of a 2d function in range [ax,bx],[ay,by] with desired relative accuracy (default val...
Definition: TF2.cxx:620
virtual Double_t Mean2X(Double_t ax, Double_t bx, Double_t ay, Double_t by, Double_t epsilon=0.000001)
Definition: TF2.h:135
TArrayD fContour
Definition: TF2.h:35
virtual void SetContourLevel(Int_t level, Double_t value)
Set value for one contour level.
Definition: TF2.cxx:894
virtual Double_t GetYmin() const
Definition: TF2.h:115
Double_t x[n]
Definition: legend1.C:17
#define ClassDef(name, id)
Definition: Rtypes.h:320
virtual void Copy(TObject &f2) const
Copy this F2 to a new F2.
Definition: TF2.cxx:168
virtual char * GetObjectInfo(Int_t px, Int_t py) const
Redefines TObject::GetObjectInfo.
Definition: TF2.cxx:444
Double_t fYmax
Definition: TF2.h:33
virtual Double_t GetMaximumXY(Double_t &x, Double_t &y) const
Compute the X and Y values corresponding to the maximum value of the function.
Definition: TF2.cxx:398
virtual TH1 * CreateHistogram()
Create a histogram from function.
Definition: TF2.cxx:653
virtual Double_t Variance2X(Double_t ax, Double_t bx, Double_t ay, Double_t by, Double_t epsilon=0.000001)
Definition: TF2.h:138
virtual Int_t GetContour(Double_t *levels=0)
Return contour values into array levels.
Definition: TF2.cxx:284
float ymax
Definition: THbookFile.cxx:93
virtual Double_t GetMinimum(Double_t xmin=0, Double_t xmax=0, Double_t epsilon=1.E-10, Int_t maxiter=100, Bool_t logx=false) const
Returns the minimum value of the function on the (xmin, xmax) interval.
Definition: TF1.cxx:1581
virtual Double_t Variance2Y(Double_t ax, Double_t bx, Double_t ay, Double_t by, Double_t epsilon=0.000001)
Definition: TF2.h:139
Double_t GetRandom()
Return a random number following this function shape.
Definition: TF2.cxx:470
TF2()
TF2 default constructor.
Definition: TF2.cxx:44
virtual Double_t FindMinMax(Double_t *x, bool findmax) const
Return minimum/maximum value of the function.
Definition: TF2.cxx:321
virtual ~TF2()
F2 default destructor.
Definition: TF2.cxx:153
virtual Double_t Covariance2XY(Double_t ax, Double_t bx, Double_t ay, Double_t by, Double_t epsilon=0.000001)
Definition: TF2.h:141
virtual void SetNpy(Int_t npy=100)
Set the number of points used to draw the function.
Definition: TF2.cxx:908
float xmax
Definition: THbookFile.cxx:93
A 2-Dim function with parameters.
Definition: TF2.h:29
virtual void ExecuteEvent(Int_t event, Int_t px, Int_t py)
Execute action corresponding to one event.
Definition: TF2.cxx:274
TF2 & operator=(const TF2 &rhs)
Operator =.
Definition: TF2.cxx:142
REAL epsilon
Definition: triangle.c:617
virtual void SetRange(Double_t xmin, Double_t xmax)
Initialize the upper and lower bounds to draw the function.
Definition: TF2.h:150
double Double_t
Definition: RtypesCore.h:55
virtual void GetRandom2(Double_t &xrandom, Double_t &yrandom)
Return 2 random numbers following this function shape.
Definition: TF2.cxx:505
virtual TF1 * DrawCopy(Option_t *option="") const
Draw a copy of this function with its current attributes-*.
Definition: TF2.cxx:244
Double_t y[n]
Definition: legend1.C:17
virtual void SetContour(Int_t nlevels=20, const Double_t *levels=0)
Set the number and values of contour levels.
Definition: TF2.cxx:873
The TH1 histogram class.
Definition: TH1.h:56
you should not use this method at all Int_t Int_t Double_t Double_t Double_t e
Definition: TRolke.cxx:630
virtual void Paint(Option_t *option="")
Paint this 2-D function with its current attributes.
Definition: TF2.cxx:698
Array of doubles (64 bits per element).
Definition: TArrayD.h:27
virtual void SavePrimitive(std::ostream &out, Option_t *option="")
Save primitive as a C++ statement(s) on output stream out.
Definition: TF2.cxx:796
Mother of all ROOT objects.
Definition: TObject.h:37
TF2(const char *name, const PtrObj &p, MemFn memFn, Double_t xmin, Double_t xmax, Double_t ymin, Double_t ymax, Int_t npar, const char *, const char *)
backward compatible ctor
Definition: TF2.h:61
virtual Double_t Mean2Y(Double_t ax, Double_t bx, Double_t ay, Double_t by, Double_t epsilon=0.000001)
Definition: TF2.h:136
TF2(const char *name, Func f, Double_t xmin, Double_t xmax, Double_t ymin, Double_t ymax, Int_t npar, const char *)
backward compatible ctor
Definition: TF2.h:79
virtual void GetRange(Double_t *xmin, Double_t *xmax) const
Return range of a generic N-D function.
Definition: TF1.cxx:2163
virtual Double_t GetSave(const Double_t *x)
Get value corresponding to X in array of fSave values.
Definition: TF2.cxx:580
1-Dim function class
Definition: TF1.h:211
virtual TObject * DrawIntegral(Option_t *="al")
Draw integral of this function.
Definition: TF2.h:95
virtual Double_t GetMaximum(Double_t *x) const
Return maximum value of the function See TF2::GetMinimum.
Definition: TF2.cxx:432
char name[80]
Definition: TGX11.cxx:109
virtual Double_t GetMinimumXY(Double_t &x, Double_t &y) const
Compute the X and Y values corresponding to the minimum value of the function.
Definition: TF2.cxx:383
virtual void Save(Double_t xmin, Double_t xmax, Double_t ymin, Double_t ymax, Double_t zmin, Double_t zmax)
Save values of function in array fSave.
Definition: TF2.cxx:752
Int_t fNpy
Definition: TF2.h:34
virtual Double_t CentralMoment2(Double_t nx, Double_t ax, Double_t bx, Double_t ny, Double_t ay, Double_t by, Double_t epsilon=0.000001)
Return x^nx * y^ny central moment of a 2d function in range [ax,bx],[ay,by].
Definition: TF2.cxx:1001
virtual TObject * DrawDerivative(Option_t *="al")
Draw derivative of this function.
Definition: TF2.h:94