class TGraph: public TNamed, public TAttLine, public TAttFill, public TAttMarker


Graph class

A Graph is a graphics object made of two arrays X and Y with npoints each. This class supports essentially two graph categories:
  • General case with non equidistant points
  • Special case with equidistant points
The various format options to draw a Graph are explained in TGraphPainter::PaintGraph and TGraph::PaintGrapHist These two functions are derived from the HIGZ routines IGRAPH and IGHIST and many modifications.

The picture below gives an example:

output of MACRO_TGraph_1_c1
{
   TCanvas *c1 = new TCanvas("c1","A Simple Graph Example",200,10,700,500);
   Double_t x[100], y[100];
   Int_t n = 20;
   for (Int_t i=0;i<n;i++) {
     x[i] = i*0.1;
     y[i] = 10*sin(x[i]+0.2);
   }
   gr = new TGraph(n,x,y);
   gr->Draw("AC*");
   return c1;
}
 

Function Members (Methods)

public:
TGraph()
TGraph(Int_t n)
TGraph(const TGraph& gr)
TGraph(const TH1* h)
TGraph(const TVectorF& vx, const TVectorF& vy)
TGraph(const TVectorD& vx, const TVectorD& vy)
TGraph(const TF1* f, Option_t* option = "")
TGraph(Int_t n, const Int_t* x, const Int_t* y)
TGraph(Int_t n, const Float_t* x, const Float_t* y)
TGraph(Int_t n, const Double_t* x, const Double_t* y)
TGraph(const char* filename, const char* format = "%lg %lg", Option_t* option = "")
virtual~TGraph()
voidTObject::AbstractMethod(const char* method) const
virtual voidTObject::AppendPad(Option_t* option = "")
virtual voidApply(TF1* f)
virtual voidBrowse(TBrowser* b)
virtual Double_tChisquare(const TF1* f1) const
static TClass*Class()
virtual const char*TObject::ClassName() const
virtual voidTNamed::Clear(Option_t* option = "")
virtual TObject*TNamed::Clone(const char* newname = "") const
virtual Int_tTNamed::Compare(const TObject* obj) const
static Bool_tCompareArg(const TGraph* gr, Int_t left, Int_t right)
static Bool_tCompareRadius(const TGraph* gr, Int_t left, Int_t right)
static Bool_tCompareX(const TGraph* gr, Int_t left, Int_t right)
static Bool_tCompareY(const TGraph* gr, Int_t left, Int_t right)
virtual voidComputeRange(Double_t& xmin, Double_t& ymin, Double_t& xmax, Double_t& ymax) const
virtual voidTNamed::Copy(TObject& named) const
virtual voidTObject::Delete(Option_t* option = "")MENU
Int_tTAttLine::DistancetoLine(Int_t px, Int_t py, Double_t xp1, Double_t yp1, Double_t xp2, Double_t yp2)
virtual Int_tDistancetoPrimitive(Int_t px, Int_t py)
virtual voidDraw(Option_t* chopt = "")
virtual voidTObject::DrawClass() constMENU
virtual TObject*TObject::DrawClone(Option_t* option = "") constMENU
virtual voidDrawGraph(Int_t n, const Int_t* x, const Int_t* y, Option_t* option = "")
virtual voidDrawGraph(Int_t n, const Float_t* x, const Float_t* y, Option_t* option = "")
virtual voidDrawGraph(Int_t n, const Double_t* x = 0, const Double_t* y = 0, Option_t* option = "")
virtual voidDrawPanel()MENU
virtual voidTObject::Dump() constMENU
virtual voidTObject::Error(const char* method, const char* msgfmt) const
virtual Double_tEval(Double_t x, TSpline* spline = 0, Option_t* option = "") const
virtual voidTObject::Execute(const char* method, const char* params, Int_t* error = 0)
virtual voidTObject::Execute(TMethod* method, TObjArray* params, Int_t* error = 0)
virtual voidExecuteEvent(Int_t event, Int_t px, Int_t py)
virtual voidExpand(Int_t newsize)
virtual voidExpand(Int_t newsize, Int_t step)
virtual voidTObject::Fatal(const char* method, const char* msgfmt) const
virtual voidTNamed::FillBuffer(char*& buffer)
virtual TObject*FindObject(const char* name) const
virtual TObject*FindObject(const TObject* obj) const
virtual Int_tFit(const char* formula, Option_t* option = "", Option_t* goption = "", Axis_t xmin = 0, Axis_t xmax = 0)MENU
virtual Int_tFit(TF1* f1, Option_t* option = "", Option_t* goption = "", Axis_t xmin = 0, Axis_t xmax = 0)MENU
virtual voidFitPanel()MENU
virtual Double_tGetCorrelationFactor() const
virtual Double_tGetCovariance() const
virtual Option_t*TObject::GetDrawOption() const
static Long_tTObject::GetDtorOnly()
Bool_tGetEditable() const
virtual Double_tGetErrorX(Int_t bin) const
virtual Double_tGetErrorXhigh(Int_t bin) const
virtual Double_tGetErrorXlow(Int_t bin) const
virtual Double_tGetErrorY(Int_t bin) const
virtual Double_tGetErrorYhigh(Int_t bin) const
virtual Double_tGetErrorYlow(Int_t bin) const
virtual Double_t*GetEX() const
virtual Double_t*GetEXhigh() const
virtual Double_t*GetEXhighd() const
virtual Double_t*GetEXlow() const
virtual Double_t*GetEXlowd() const
virtual Double_t*GetEY() const
virtual Double_t*GetEYhigh() const
virtual Double_t*GetEYhighd() const
virtual Double_t*GetEYlow() const
virtual Double_t*GetEYlowd() const
virtual Color_tTAttFill::GetFillColor() const
virtual Style_tTAttFill::GetFillStyle() const
TF1*GetFunction(const char* name) const
TH1F*GetHistogram() const
virtual const char*TObject::GetIconName() const
virtual Color_tTAttLine::GetLineColor() const
virtual Style_tTAttLine::GetLineStyle() const
virtual Width_tTAttLine::GetLineWidth() const
TList*GetListOfFunctions() const
virtual Color_tTAttMarker::GetMarkerColor() const
virtual Size_tTAttMarker::GetMarkerSize() const
virtual Style_tTAttMarker::GetMarkerStyle() const
Double_tGetMaximum() const
Int_tGetMaxSize() const
virtual Double_tGetMean(Int_t axis = 1) const
Double_tGetMinimum() const
Int_tGetN() const
virtual const char*TNamed::GetName() const
virtual char*TObject::GetObjectInfo(Int_t px, Int_t py) const
static Bool_tTObject::GetObjectStat()
virtual Option_t*TObject::GetOption() const
virtual Int_tGetPoint(Int_t i, Double_t& x, Double_t& y) const
virtual Double_tGetRMS(Int_t axis = 1) const
virtual const char*TNamed::GetTitle() const
virtual UInt_tTObject::GetUniqueID() const
Double_t*GetX() const
TAxis*GetXaxis() const
Double_t*GetY() const
TAxis*GetYaxis() const
virtual Bool_tTObject::HandleTimer(TTimer* timer)
virtual ULong_tTNamed::Hash() const
virtual voidTObject::Info(const char* method, const char* msgfmt) const
virtual Bool_tTObject::InheritsFrom(const char* classname) const
virtual Bool_tTObject::InheritsFrom(const TClass* cl) const
virtual voidInitExpo(Double_t xmin = 0, Double_t xmax = 0)
virtual voidInitGaus(Double_t xmin = 0, Double_t xmax = 0)
virtual voidInitPolynom(Double_t xmin = 0, Double_t xmax = 0)
virtual Int_tInsertPoint()MENU
virtual voidTObject::Inspect() constMENU
voidTObject::InvertBit(UInt_t f)
virtual TClass*IsA() const
virtual Bool_tIsEditable() const
virtual Bool_tTObject::IsEqual(const TObject* obj) const
virtual Bool_tTObject::IsFolder() const
Bool_tTObject::IsOnHeap() const
virtual Bool_tTNamed::IsSortable() const
virtual Bool_tTAttFill::IsTransparent() const
Bool_tTObject::IsZombie() const
virtual voidLeastSquareFit(Int_t m, Double_t* a, Double_t xmin = 0, Double_t xmax = 0)
virtual voidLeastSquareLinearFit(Int_t n, Double_t& a0, Double_t& a1, Int_t& ifail, Double_t xmin = 0, Double_t xmax = 0)
virtual voidTNamed::ls(Option_t* option = "") const
voidTObject::MayNotUse(const char* method) const
virtual Int_tMerge(TCollection* list)
virtual voidTAttLine::Modify()
virtual Bool_tTObject::Notify()
static voidTObject::operator delete(void* ptr)
static voidTObject::operator delete(void* ptr, void* vp)
static voidTObject::operator delete[](void* ptr)
static voidTObject::operator delete[](void* ptr, void* vp)
void*TObject::operator new(size_t sz)
void*TObject::operator new(size_t sz, void* vp)
void*TObject::operator new[](size_t sz)
void*TObject::operator new[](size_t sz, void* vp)
TGraph&operator=(const TGraph&)
virtual voidPaint(Option_t* chopt = "")
voidPaintGraph(Int_t npoints, const Double_t* x, const Double_t* y, Option_t* chopt)
voidPaintGrapHist(Int_t npoints, const Double_t* x, const Double_t* y, Option_t* chopt)
virtual voidPaintStats(TF1* fit)
virtual voidTObject::Pop()
virtual voidPrint(Option_t* chopt = "") const
virtual Int_tTObject::Read(const char* name)
virtual voidRecursiveRemove(TObject* obj)
virtual Int_tRemovePoint()MENU
virtual Int_tRemovePoint(Int_t ipoint)
virtual voidTAttFill::ResetAttFill(Option_t* option = "")
virtual voidTAttLine::ResetAttLine(Option_t* option = "")
virtual voidTAttMarker::ResetAttMarker(Option_t* toption = "")
voidTObject::ResetBit(UInt_t f)
virtual voidTObject::SaveAs(const char* filename = "", Option_t* option = "") constMENU
virtual voidTAttFill::SaveFillAttributes(ostream& out, const char* name, Int_t coldef = 1, Int_t stydef = 1001)
virtual voidTAttLine::SaveLineAttributes(ostream& out, const char* name, Int_t coldef = 1, Int_t stydef = 1, Int_t widdef = 1)
virtual voidTAttMarker::SaveMarkerAttributes(ostream& out, const char* name, Int_t coldef = 1, Int_t stydef = 1, Int_t sizdef = 1)
virtual voidSavePrimitive(ostream& out, Option_t* option = "")
virtual voidSet(Int_t n)
voidTObject::SetBit(UInt_t f)
voidTObject::SetBit(UInt_t f, Bool_t set)
virtual voidTObject::SetDrawOption(Option_t* option = "")MENU
static voidTObject::SetDtorOnly(void* obj)
virtual voidSetEditable(Bool_t editable = kTRUE)TOGGLE GETTER
virtual voidTAttFill::SetFillAttributes()MENU
virtual voidTAttFill::SetFillColor(Color_t fcolor)
virtual voidTAttFill::SetFillStyle(Style_t fstyle)
virtual voidSetHistogram(TH1* h)
virtual voidTAttLine::SetLineAttributes()MENU
virtual voidTAttLine::SetLineColor(Color_t lcolor)
virtual voidTAttLine::SetLineStyle(Style_t lstyle)
virtual voidTAttLine::SetLineWidth(Width_t lwidth)
virtual voidTAttMarker::SetMarkerAttributes()MENU
virtual voidTAttMarker::SetMarkerColor(Color_t tcolor = 1)
virtual voidTAttMarker::SetMarkerSize(Size_t msize = 1)
virtual voidTAttMarker::SetMarkerStyle(Style_t mstyle = 1)
virtual voidSetMaximum(Double_t maximum = -1111)MENU
virtual voidSetMinimum(Double_t minimum = -1111)MENU
virtual voidTNamed::SetName(const char* name)MENU
virtual voidTNamed::SetNameTitle(const char* name, const char* title)
static voidTObject::SetObjectStat(Bool_t stat)
virtual voidSetPoint(Int_t i, Double_t x, Double_t y)
virtual voidSetTitle(const char* title = "")MENU
virtual voidTObject::SetUniqueID(UInt_t uid)
virtual voidShowMembers(TMemberInspector& insp, char* parent)
virtual Int_tTNamed::Sizeof() const
virtual voidSort(Bool_t (*)(const TGraph*, Int_t, Int_t) greater = &TGraph::CompareX, Bool_t ascending = kTRUE, Int_t low = 0, Int_t high = -1111)
virtual voidStreamer(TBuffer& b)
voidStreamerNVirtual(TBuffer& b)
virtual voidTObject::SysError(const char* method, const char* msgfmt) const
Bool_tTObject::TestBit(UInt_t f) const
Int_tTObject::TestBits(UInt_t f) const
virtual voidUseCurrentStyle()
virtual voidTObject::Warning(const char* method, const char* msgfmt) const
virtual Int_tTObject::Write(const char* name = 0, Int_t option = 0, Int_t bufsize = 0)
virtual Int_tTObject::Write(const char* name = 0, Int_t option = 0, Int_t bufsize = 0) const
voidZero(Int_t& k, Double_t AZ, Double_t BZ, Double_t E2, Double_t& X, Double_t& Y, Int_t maxiterations)
protected:
virtual Double_t**Allocate(Int_t newsize)
Double_t**AllocateArrays(Int_t Narrays, Int_t arraySize)
virtual voidCopyAndRelease(Double_t** newarrays, Int_t ibegin, Int_t iend, Int_t obegin)
virtual Bool_tCopyPoints(Double_t** newarrays, Int_t ibegin, Int_t iend, Int_t obegin)
Bool_tCtorAllocate()
virtual voidTObject::DoError(int level, const char* location, const char* fmt, va_list va) const
virtual Int_tDoFit(TF1* f1, Option_t* option, Option_t* goption, Axis_t xmin, Axis_t xmax)
Double_t**ExpandAndCopy(Int_t size, Int_t iend)
virtual voidFillZero(Int_t begin, Int_t end, Bool_t from_ctor = kTRUE)
voidTObject::MakeZombie()
Double_t**ShrinkAndCopy(Int_t size, Int_t iend)
virtual voidSwapPoints(Int_t pos1, Int_t pos2)
static voidSwapValues(Double_t* arr, Int_t pos1, Int_t pos2)

Data Members

public:
enum { kClipFrame
kNotEditable
};
enum TObject::EStatusBits { kCanDelete
kMustCleanup
kObjInCanvas
kIsReferenced
kHasUUID
kCannotPick
kNoContextMenu
kInvalidObject
};
enum TObject::[unnamed] { kIsOnHeap
kNotDeleted
kZombie
kBitMask
kSingleKey
kOverwrite
kWriteDelete
};
protected:
Color_tTAttFill::fFillColorfill area color
Style_tTAttFill::fFillStylefill area style
TList*fFunctionsPointer to list of functions (fits and user)
TH1F*fHistogramPointer to histogram used for drawing axis
Color_tTAttLine::fLineColorline color
Style_tTAttLine::fLineStyleline style
Width_tTAttLine::fLineWidthline width
Color_tTAttMarker::fMarkerColorMarker color index
Size_tTAttMarker::fMarkerSizeMarker size
Style_tTAttMarker::fMarkerStyleMarker style
Int_tfMaxSize!Current dimension of arrays fX and fY
Double_tfMaximumMaximum value for plotting along y
Double_tfMinimumMinimum value for plotting along y
TStringTNamed::fNameobject identifier
Int_tfNpointsNumber of points <= fMaxSize
TStringTNamed::fTitleobject title
Double_t*fX[fNpoints] array of X points
Double_t*fY[fNpoints] array of Y points

Class Charts

Inheritance Inherited Members Includes Libraries
Class Charts

Function documentation

TGraph()
 Graph default constructor.
TGraph(Int_t n)
 Constructor with only the number of points set
 the arrsys x and y will be set later
TGraph(Int_t n, const Int_t *x, const Int_t *y)
 Graph normal constructor with ints.
TGraph(Int_t n, const Float_t *x, const Float_t *y)
 Graph normal constructor with floats.
TGraph(Int_t n, const Double_t *x, const Double_t *y)
 Graph normal constructor with doubles.
TGraph(const TGraph &gr)
 Copy constructor for this graph
TGraph& operator=(const TGraph& )
 Equal operator for this graph
TGraph(const TVectorF &vx, const TVectorF &vy)
 Graph constructor with two vectors of floats in input
 A graph is build with the X coordinates taken from vx and Y coord from vy
 The number of points in the graph is the minimum of number of points
 in vx and vy.
TGraph(const TVectorD &vx, const TVectorD &vy)
 Graph constructor with two vectors of doubles in input
 A graph is build with the X coordinates taken from vx and Y coord from vy
 The number of points in the graph is the minimum of number of points
 in vx and vy.
TGraph(const TH1 *h)
 Graph constructor importing its parameters from the TH1 object passed as argument
TGraph(const TF1 *f, Option_t *option)
 Graph constructor importing its parameters from the TF1 object passed as argument
 if option =="" (default), a TGraph is created with points computed
                at the fNpx points of f.
 if option =="d", a TGraph is created with points computed with the derivatives
                at the fNpx points of f.
 if option =="i", a TGraph is created with points computed with the integral
                at the fNpx points of f.
 if option =="I", a TGraph is created with points computed with the integral
                at the fNpx+1 points of f and the integral is normalized to 1.
TGraph(const char *filename, const char *format, Option_t *)
 Graph constructor reading input from filename
 filename is assumed to contain at least two columns of numbers
 the string format is by default "%lg %lg"
~TGraph()
 Graph default destructor.
Double_t** AllocateArrays(Int_t Narrays, Int_t arraySize)
 Allocate arrays.
void Apply(TF1* f)
 Apply function f to all the data points
 f may be a 1-D function TF1 or 2-d function TF2
 The Y values of the graph are replaced by the new values computed
 using the function
void Browse(TBrowser* b)
 Browse
Double_t Chisquare(const TF1* f1) const
 Return the chisquare of this graph with respect to f1.
 The chisquare is computed as the sum of the quantity below at each point:

#frac{(y-f1(x))^{2}}{ey^{2}+(#frac{1}{2}(exl+exh)f1'(x))^{2}}
 where x and y are the graph point coordinates and f1'(x) is the derivative of function f1(x).
 This method to approximate the uncertainty in y because of the errors in x, is called
 "effective variance" method.
 In case of a pure TGraph, the denominator is 1.
 In case of a TGraphErrors or TGraphAsymmErrors the errors are taken
 into account.
Bool_t CompareArg(const TGraph* gr, Int_t left, Int_t right)
 Return kTRUE if point number "left"'s argument (angle with respect to positive
 x-axis) is bigger than that of point number "right". Can be used by Sort.
Bool_t CompareX(const TGraph* gr, Int_t left, Int_t right)
 Return kTRUE if fX[left] > fX[right]. Can be used by Sort.
Bool_t CompareY(const TGraph* gr, Int_t left, Int_t right)
 Return kTRUE if fY[left] > fY[right]. Can be used by Sort.
Bool_t CompareRadius(const TGraph* gr, Int_t left, Int_t right)
 Return kTRUE if point number "left"'s distance to origin is bigger than
 that of point number "right". Can be used by Sort.
void ComputeRange(Double_t& xmin, Double_t& ymin, Double_t& xmax, Double_t& ymax) const
 Compute the x/y range of the points in this graph
void CopyAndRelease(Double_t** newarrays, Int_t ibegin, Int_t iend, Int_t obegin)
 Copy points from fX and fY to arrays[0] and arrays[1]
 or to fX and fY if arrays == 0 and ibegin != iend.
 If newarrays is non null, replace fX, fY with pointers from newarrays[0,1].
 Delete newarrays, old fX and fY
Bool_t CopyPoints(Double_t** newarrays, Int_t ibegin, Int_t iend, Int_t obegin)
 Copy points from fX and fY to arrays[0] and arrays[1]
 or to fX and fY if arrays == 0 and ibegin != iend.
Bool_t CtorAllocate()
 In constructors set fNpoints than call this method.
 Return kFALSE if the graph will contain no points.
void Draw(Option_t* chopt = "")
 Draw this graph with its current attributes.

   Options to draw a graph are described in TGraphPainter::PaintGraph
Int_t DistancetoPrimitive(Int_t px, Int_t py)
 Compute distance from point px,py to a graph.

  Compute the closest distance of approach from point px,py to this line.
  The distance is computed in pixels units.
void DrawGraph(Int_t n, const Int_t *x, const Int_t *y, Option_t *option)
 Draw this graph with new attributes.
void DrawGraph(Int_t n, const Float_t *x, const Float_t *y, Option_t *option)
 Draw this graph with new attributes.
void DrawGraph(Int_t n, const Double_t *x, const Double_t *y, Option_t *option)
 Draw this graph with new attributes.
void DrawPanel()
 Display a panel with all graph drawing options.
Double_t Eval(Double_t x, TSpline* spline = 0, Option_t* option = "") const
 Interpolate points in this graph at x using a TSpline
  -if spline==0 and option="" a linear interpolation between the two points
   close to x is computed. If x is outside the graph range, a linear
   extrapolation is computed.
  -if spline==0 and option="S" a TSpline3 object is created using this graph
   and the interpolated value from the spline is returned.
   the internally created spline is deleted on return.
  -if spline is specified, it is used to return the interpolated value.
void ExecuteEvent(Int_t event, Int_t px, Int_t py)
 Execute action corresponding to one event.

  This member function is called when a graph is clicked with the locator

  If Left button clicked on one of the line end points, this point
     follows the cursor until button is released.

  if Middle button clicked, the line is moved parallel to itself
     until the button is released.
void Expand(Int_t newsize)
 If array sizes <= newsize, expand storage to 2*newsize.
void Expand(Int_t newsize, Int_t step)
 If graph capacity is less than newsize points then make array sizes
 equal to least multiple of step to contain newsize points.
 Returns kTRUE if size was altered
Double_t ** ExpandAndCopy(Int_t size, Int_t iend)
 if size > fMaxSize allocate new arrays of 2*size points
  and copy oend first points.
 Return pointer to new arrays.
void FillZero(Int_t begin, Int_t end, Bool_t from_ctor = kTRUE)
 Set zero values for point arrays in the range [begin, end)
 Should be redefined in descendant classes
TObject * FindObject(const char *name)
 Search object named name in the list of functions
TObject * FindObject(const TObject *obj)
 Search object obj in the list of functions
Int_t Fit(const char *fname, Option_t *option, Option_t *, Axis_t xmin, Axis_t xmax)
 Fit this graph with function with name fname.

  interface to TGraph::Fit(TF1 *f1...

      fname is the name of an already predefined function created by TF1 or TF2
      Predefined functions such as gaus, expo and poln are automatically
      created by ROOT.
      fname can also be a formula, accepted by the linear fitter (linear parts divided
      by "++" sign), for example "x++sin(x)" for fitting "[0]*x+[1]*sin(x)"
Int_t Fit(TF1 *f1, Option_t *option, Option_t *goption, Axis_t rxmin, Axis_t rxmax)
 Fit this graph with function f1.

   f1 is an already predefined function created by TF1.
   Predefined functions such as gaus, expo and poln are automatically
   created by ROOT.

   The list of fit options is given in parameter option.
      option = "W" Set all weights to 1; ignore error bars
             = "U" Use a User specified fitting algorithm (via SetFCN)
             = "Q" Quiet mode (minimum printing)
             = "V" Verbose mode (default is between Q and V)
             = "B" Use this option when you want to fix one or more parameters
                   and the fitting function is like "gaus","expo","poln","landau".
             = "R" Use the Range specified in the function range
             = "N" Do not store the graphics function, do not draw
             = "0" Do not plot the result of the fit. By default the fitted function
                   is drawn unless the option"N" above is specified.
             = "+" Add this new fitted function to the list of fitted functions
                   (by default, any previous function is deleted)
             = "C" In case of linear fitting, not calculate the chisquare
                    (saves time)
             = "F" If fitting a polN, switch to minuit fitter
             = "ROB" In case of linear fitting, compute the LTS regression
                     coefficients (robust(resistant) regression), using
                     the default fraction of good points
               "ROB=0.x" - compute the LTS regression coefficients, using
                           0.x as a fraction of good points

   When the fit is drawn (by default), the parameter goption may be used
   to specify a list of graphics options. See TGraph::Paint for a complete
   list of these options.

   In order to use the Range option, one must first create a function
   with the expression to be fitted. For example, if your graph
   has a defined range between -4 and 4 and you want to fit a gaussian
   only in the interval 1 to 3, you can do:
        TF1 *f1 = new TF1("f1","gaus",1,3);
        graph->Fit("f1","R");


 Who is calling this function:

   Note that this function is called when calling TGraphErrors::Fit
   or TGraphAsymmErrors::Fit ot TGraphBentErrors::Fit
   see the discussion below on the errors calulation.

 Linear fitting:

   When the fitting function is linear (contains the "++" sign) or the fitting
   function is a polynomial, a linear fitter is initialised.
   To create a linear function, use the following syntaxis: linear parts
   separated by "++" sign.
   Example: to fit the parameters of "[0]*x + [1]*sin(x)", create a
    TF1 *f1=new TF1("f1", "x++sin(x)", xmin, xmax);
   For such a TF1 you don't have to set the initial conditions
   Going via the linear fitter for functions, linear in parameters, gives a considerable
   advantage in speed.

 Setting initial conditions:

   Parameters must be initialized before invoking the Fit function.
   The setting of the parameter initial values is automatic for the
   predefined functions : poln, expo, gaus, landau. One can however disable
   this automatic computation by specifying the option "B".
   You can specify boundary limits for some or all parameters via
        f1->SetParLimits(p_number, parmin, parmax);
   if parmin>=parmax, the parameter is fixed
   Note that you are not forced to fix the limits for all parameters.
   For example, if you fit a function with 6 parameters, you can do:
     func->SetParameters(0,3.1,1.e-6,0.1,-8,100);
     func->SetParLimits(4,-10,-4);
     func->SetParLimits(5, 1,1);
   With this setup, parameters 0->3 can vary freely
   Parameter 4 has boundaries [-10,-4] with initial value -8
   Parameter 5 is fixed to 100.

 Fit range:

   The fit range can be specified in two ways:
     - specify rxmax > rxmin (default is rxmin=rxmax=0)
     - specify the option "R". In this case, the function will be taken
       instead of the full graph range.

 Changing the fitting function:

   By default the fitting function GraphFitChisquare is used.
   To specify a User defined fitting function, specify option "U" and
   call the following functions:
     TVirtualFitter::Fitter(mygraph)->SetFCN(MyFittingFunction)
   where MyFittingFunction is of type:
   extern void MyFittingFunction(Int_t &npar, Double_t *gin, Double_t &f, Double_t *u, Int_t flag);

 How errors are used in the chisquare function (see TFitter GraphFitChisquare)//   Access to the fit results

   In case of a TGraphErrors object, ex, the error along x,  is projected
   along the y-direction by calculating the function at the points x-exlow and
   x+exhigh.

   The chisquare is computed as the sum of the quantity below at each point:


#frac{(y-f(x))^{2}}{ey^{2}+(#frac{1}{2}(exl+exh)f'(x))^{2}}

   where x and y are the point coordinates, and f'(x) is the derivative of function f(x).

   In case the function lies below (above) the data point, ey is ey_low (ey_high).

   thanks to Andy Haas (haas@yahoo.com) for adding the case with TGraphasymmerrors
             University of Washington

   The approach used to approximate the uncertainty in y because of the
   errors in x, is to make it equal the error in x times the slope of the line.
   The improvement, compared to the first method (f(x+ exhigh) - f(x-exlow))/2
   is of (error of x)**2 order. This approach is called "effective variance method".
   This improvement has been made in version 4.00/08 by Anna Kreshuk.

 NOTE:
   1) By using the "effective variance" method a simple linear regression
      becomes a non-linear case, which takes several iterations
      instead of 0 as in the linear case .

   2) The effective variance technique assumes that there is no correlation
      between the x and y coordinate .

   Note, that the linear fitter doesn't take into account the errors in x. If errors
   in x are important, go through minuit (use option "F" for polynomial fitting).

   3) When fitting a TGraph (ie no errors associated to each point),
   a correction is applied to the errors on the parameters with the following
   formula:
      errorp *= sqrt(chisquare/(ndf-1))

 Associated functions:

   One or more object (typically a TF1*) can be added to the list
   of functions (fFunctions) associated to each graph.
   When TGraph::Fit is invoked, the fitted function is added to this list.
   Given a graph gr, one can retrieve an associated function
   with:  TF1 *myfunc = gr->GetFunction("myfunc");

   If the graph is made persistent, the list of
   associated functions is also persistent. Given a pointer (see above)
   to an associated function myfunc, one can retrieve the function/fit
   parameters with calls such as:
     Double_t chi2 = myfunc->GetChisquare();
     Double_t par0 = myfunc->GetParameter(0); //value of 1st parameter
     Double_t err0 = myfunc->GetParError(0);  //error on first parameter

 Fit Statistics

   You can change the statistics box to display the fit parameters with
   the TStyle::SetOptFit(mode) method. This mode has four digits.
   mode = pcev  (default = 0111)
     v = 1;  print name/values of parameters
     e = 1;  print errors (if e=1, v must be 1)
     c = 1;  print Chisquare/Number of degress of freedom
     p = 1;  print Probability

   For example: gStyle->SetOptFit(1011);
   prints the fit probability, parameter names/values, and errors.
   You can change the position of the statistics box with these lines
   (where g is a pointer to the TGraph):

   Root > TPaveStats *st = (TPaveStats*)g->GetListOfFunctions()->FindObject("stats")
   Root > st->SetX1NDC(newx1); //new x start position
   Root > st->SetX2NDC(newx2); //new x end position

      Access to the fit status

   The function return the status of the fit (fitResult) in the following form
     fitResult = migradResult + 10*minosResult + 100*hesseResult + 1000*improveResult
   The fitResult is 0 is the fit is OK.
   The fitResult is negative in case of an error not connected with the fit.
void FitPanel()
 Display a GUI panel with all graph fit options.

   See class TFitEditor for example
Double_t GetCorrelationFactor() const
 Return graph correlation factor
Double_t GetCovariance() const
 Return covariance of vectors x,y
Double_t GetMean(Int_t axis = 1) const
 Return mean value of X (axis=1)  or Y (axis=2)
Double_t GetRMS(Int_t axis = 1) const
 Return RMS of X (axis=1)  or Y (axis=2)
Double_t GetErrorX(Int_t bin) const
 This function is called by GraphFitChisquare.
 It always returns a negative value. Real implementation in TGraphErrors
Double_t GetErrorY(Int_t bin) const
 This function is called by GraphFitChisquare.
 It always returns a negative value. Real implementation in TGraphErrors
Double_t GetErrorXhigh(Int_t bin) const
 This function is called by GraphFitChisquare.
 It always returns a negative value. Real implementation in TGraphErrors
 and TGraphAsymmErrors
Double_t GetErrorXlow(Int_t bin) const
 This function is called by GraphFitChisquare.
 It always returns a negative value. Real implementation in TGraphErrors
 and TGraphAsymmErrors
Double_t GetErrorYhigh(Int_t bin) const
 This function is called by GraphFitChisquare.
 It always returns a negative value. Real implementation in TGraphErrors
 and TGraphAsymmErrors
Double_t GetErrorYlow(Int_t bin) const
 This function is called by GraphFitChisquare.
 It always returns a negative value. Real implementation in TGraphErrors
 and TGraphAsymmErrors
TF1 * GetFunction(const char* name) const
 Return pointer to function with name.

 Functions such as TGraph::Fit store the fitted function in the list of
 functions of this graph.
TH1F * GetHistogram() const
 Returns a pointer to the histogram used to draw the axis
 Takes into account the two following cases.
    1- option 'A' was specified in TGraph::Draw. Return fHistogram
    2- user had called TPad::DrawFrame. return pointer to hframe histogram
Int_t GetPoint(Int_t i, Double_t& x, Double_t& y) const
 Get x and y values for point number i.
 The function returns -1 in case of an invalid request or the point number otherwise
TAxis * GetXaxis() const
 Get x axis of the graph.
TAxis * GetYaxis() const
 Get y axis of the graph.
void InitGaus(Double_t xmin = 0, Double_t xmax = 0)
 Compute Initial values of parameters for a gaussian.
void InitExpo(Double_t xmin = 0, Double_t xmax = 0)
 Compute Initial values of parameters for an exponential.
void InitPolynom(Double_t xmin = 0, Double_t xmax = 0)
 Compute Initial values of parameters for a polynom.
Int_t InsertPoint()
 Insert a new point at the mouse position
void LeastSquareFit(Int_t m, Double_t* a, Double_t xmin = 0, Double_t xmax = 0)
 Least squares lpolynomial fitting without weights.

  m     number of parameters
  a     array of parameters
  first 1st point number to fit (default =0)
  last  last point number to fit (default=fNpoints-1)

   based on CERNLIB routine LSQ: Translated to C++ by Rene Brun
void LeastSquareLinearFit(Int_t n, Double_t& a0, Double_t& a1, Int_t& ifail, Double_t xmin = 0, Double_t xmax = 0)
 Least square linear fit without weights.

  Fit a straight line (a0 + a1*x) to the data in this graph.
  ndata:  if ndata<0, fits the logarithm of the graph (used in InitExpo() to set
          the initial parameter values for a fit with exponential function.
  a0:     constant
  a1:     slope
  ifail:  return parameter indicating the status of the fit (ifail=0, fit is OK)
  xmin, xmax: fitting range

  extracted from CERNLIB LLSQ: Translated to C++ by Rene Brun
void Paint(Option_t* chopt = "")
 Draw this graph with its current attributes.
void PaintGraph(Int_t npoints, const Double_t* x, const Double_t* y, Option_t* chopt)
 Draw the (x,y) as a graph.
void PaintGrapHist(Int_t npoints, const Double_t* x, const Double_t* y, Option_t* chopt)
 Draw the (x,y) as a histogram.
void PaintStats(TF1* fit)
 Draw the stats
void Print(Option_t* chopt = "") const
 Print graph values.
void RecursiveRemove(TObject* obj)
 Recursively remove object from the list of functions
Int_t RemovePoint()
 Delete point close to the mouse position
Int_t RemovePoint(Int_t ipoint)
 Delete point number ipoint
void SavePrimitive(ostream& out, Option_t* option = "")
 Save primitive as a C++ statement(s) on output stream out
void Set(Int_t n)
 Set number of points in the graph
 Existing coordinates are preserved
 New coordinates above fNpoints are preset to 0.
Bool_t GetEditable() const
 Return kTRUE if kNotEditable bit is not set, kFALSE otherwise.
void SetEditable(Bool_t editable = kTRUE)
 if editable=kFALSE, the graph cannot be modified with the mouse
  by default a TGraph is editable
void SetMaximum(Double_t maximum = -1111)
 Set the maximum of the graph.
void SetMinimum(Double_t minimum = -1111)
 Set the minimum of the graph.
void SetPoint(Int_t i, Double_t x, Double_t y)
 Set x and y values for point number i.
void SetTitle(const char* title = "")
 Set graph title.
Double_t ** ShrinkAndCopy(Int_t size, Int_t iend)
 if size*2 <= fMaxSize allocate new arrays of size points,
 copy points [0,oend).
 Return newarray (passed or new instance if it was zero
 and allocations are needed)
void Sort(Bool_t (*greaterfunc)(const TGraph*, Int_t, Int_t) /*=TGraph::CompareX()*/, Bool_t ascending /*=kTRUE*/, Int_t low /* =0 */, Int_t high /* =-1111 */)
 Sorts the points of this TGraph using in-place quicksort (see e.g. older glibc).
 To compare two points the function parameter greaterfunc is used (see TGraph::CompareX for an
 example of such a method, which is also the default comparison function for Sort). After
 the sort, greaterfunc(this, i, j) will return kTRUE for all i>j if ascending == kTRUE, and
 kFALSE otherwise.

 The last two parameters are used for the recursive quick sort, stating the range to be sorted

 Examples:
   // sort points along x axis
   graph->Sort();
   // sort points along their distance to origin
   graph->Sort(&TGraph::CompareRadius);

   Bool_t CompareErrors(const TGraph* gr, Int_t i, Int_t j) {
     const TGraphErrors* ge=(const TGraphErrors*)gr;
     return (ge->GetEY()[i]>ge->GetEY()[j]); }
   // sort using the above comparison function, largest errors first
   graph->Sort(&CompareErrors, kFALSE);
void Streamer(TBuffer& b)
 Stream an object of class TGraph.
void SwapPoints(Int_t pos1, Int_t pos2)
 Swap points.
void SwapValues(Double_t* arr, Int_t pos1, Int_t pos2)
 Swap values.
void UseCurrentStyle()
 Set current style settings in this graph
 This function is called when either TCanvas::UseCurrentStyle
 or TROOT::ForceStyle have been invoked.
Int_t Merge(TCollection* list)
 Adds all graphs from the collection to this graph.
 Returns the total number of poins in the result or -1 in case of an error.
void Zero(Int_t& k, Double_t AZ, Double_t BZ, Double_t E2, Double_t& X, Double_t& Y, Int_t maxiterations)
 Find zero of a continuous function.
 This function finds a real zero of the continuous real
 function Y(X) in a given interval (A,B). See accompanying
 notes for details of the argument list and calling sequence
Double_t ** Allocate(Int_t newsize)
Int_t DoFit(TF1* f1, Option_t* option, Option_t* goption, Axis_t xmin, Axis_t xmax)
TList * GetListOfFunctions() const
{ return fFunctions; }
Int_t GetMaxSize() const
{return fMaxSize;}
Int_t GetN() const
{return fNpoints;}
Double_t * GetX() const
{return fX;}
Double_t * GetY() const
{return fY;}
Double_t * GetEX() const
{return 0;}
Double_t * GetEY() const
{return 0;}
Double_t * GetEXhigh() const
{return 0;}
Double_t * GetEXlow() const
{return 0;}
Double_t * GetEYhigh() const
{return 0;}
Double_t * GetEYlow() const
{return 0;}
Double_t * GetEXlowd() const
{return 0;}
Double_t * GetEXhighd() const
{return 0;}
Double_t * GetEYlowd() const
{return 0;}
Double_t * GetEYhighd() const
{return 0;}
Double_t GetMaximum() const
{return fMaximum;}
Double_t GetMinimum() const
{return fMinimum;}
Bool_t IsEditable() const
{return !TestBit(kNotEditable);}
void SetHistogram(TH1* h)
{fHistogram = (TH1F*)h;}

Author: Rene Brun, Olivier Couet 12/12/94
Last change: root/hist:$Id: TGraph.h 25487 2008-09-22 12:44:13Z moneta $
Last generated: 2008-12-05 09:53
Copyright (C) 1995-2000, Rene Brun and Fons Rademakers. *

This page has been automatically generated. If you have any comments or suggestions about the page layout send a mail to ROOT support, or contact the developers with any questions or problems regarding ROOT.