class PTools

 divides given canvas mycanvas into xpad times ypads pads
 returns pointer to pad of divided TPad

 divides given canvas mycanvas into xpad times ypads pads
 adds a header with title
 returns pointer to pad of divided TPad

 divides given canvas mycanvas into xpad times ypads pads
 adds a header with title
 containing filename and
 returns pointer to pad of divided TPad

 divides given canvas mycanvas into xpad times ypads pads
 adds a header with title
 containing filename and
 number of entries
 returns pointer to pad of divided TPad

 divides given canvas mycanvas into xpad times ypads pads
 adds a header with title
 containing filename and
 number of entries
 creates an info box at the right of the canvas
 returns pointer to pad of divided TPad

 divides given canvas mycanvas into xpad times ypads pads
 adds a header with title
 containing filename and
 number of entries
 creates an info box at the right of the canvas
 returns pointer to pad of divided TPad

 divides new canvas mycanvas of size xsizy * ysize
 into xpad times ypads pads
 returns pointer to pad of divided TPad
 memory leak! only for CINT use

 divides new canvas mycanvas of size xsizy * ysize
 into xpad times ypads pads
 adds a header with title
 returns pointer to pad of divided TPad
 memory leak! only for CINT use

 divides new canvas mycanvas of size xsizy * ysize
 into xpad times ypads pads
 adds a header with title
 containing filename and
 returns pointer to pad of divided TPad
 memory leak! only for CINT use

 divides new canvas mycanvas of size xsizy * ysize
 into xpad times ypads pads
 adds a header with title
 containing filename and
 number of entries
 returns pointer to pad of divided TPad
 memory leak! only for CINT use

 divides new canvas mycanvas of size xsizy * ysize
 into xpad times ypads pads
 adds a header with title
 containing filename and
 number of entries
 creates an info box at the right of the canvas
 returns pointer to pad of divided TPad
 memory leak! only for CINT use

 divides new canvas mycanvas of size xsizy * ysize
 into xpad times ypads pads
 adds a header with title
 containing filename and
 number of entries
 creates an info box at the right of the canvas
 returns pointer to pad of divided TPad
 memory leak! only for CINT use

 divides new canvas mycanvas of size xsizy * ysize
 into xpad times ypads pads
 adds a header with title
 containing filename and
 number of entries
 creates an info box at the right of the canvas
 returns pointer to pad of divided TPad
 memory leak! only for CINT use

 divides new canvas mycanvas into xpad times ypads pads
 adds a header with title
 containing filename and
 memory leak! only for CINT use

 divides new canvas mycanvas into xpad times ypads pads
 adds a header with title
 containing filename and
 memory leak! only for CINT use

 divides new canvas mycanvas into xpad times ypads pads
 adds a header with title
 containing filename and
 memory leak! only for CINT use

 divides new canvas mycanvas into xpad times ypads pads
 adds a header with title
 containing filename and
 number of entries
 returns pointer to pad of divided TPad
 memory leak! only for CINT use

 divides new canvas mycanvas into xpad times ypads pads
 adds a header with title
 containing filename and
 number of entries
 creates an info box at the right of the canvas
 returns pointer to pad of divided TPad
 memory leak! only for CINT use

 divides new canvas mycanvas into xpad times ypads pads
 adds a header with title
 containing filename and
 number of entries
 creates an info box at the right of the canvas
 returns pointer to pad of divided TPad
 memory leak! only for CINT use

 divides new canvas mycanvas into xpad times ypads pads
 adds a header with title
 containing filename and
 number of entries
 creates an info box at the right of the canvas
 returns pointer to pad of divided TPad
 memory leak! only for CINT use

 divides given canvas mycanvas into xpad times ypads pads
 adds a header with title
 containing filename and
 number of entries
 creates an info box at the right of the canvas
 returns pointer to pad of divided TPad

 prints header of canvas containing in the parent pad
 header contains filename and number of entries

 evaluates Stopwatch for given number of events
 also plots the machine where it was running on

 sets titles of x axis, y axis, fill color and font type for histogramm
 with colors "black","red","bright green","bright blue","yellow","hot pink","aqua","green","blue","default"

 sets titles of x axis, y axis, fill color and font type for histogramm
 with colors "black","red","bright green","bright blue","yellow","hot pink","aqua","green","blue","default"

 sets titles of x axis, y axis, fill color and font type for histogramm

 sets titles of x axis, y axis, fill color and font type for histogramm
 with colors "black","red","bright green","bright blue","yellow","hot pink","aqua","green","blue","default"

 sets titles of x axis, y axis, font type for histogramm for histogramm stack

 sets titles of x axis, y axis, font type for histogramm for histogramm stack

 draws default canvas divided xsize times ysize and fills it with the contents of histarray[i] at pad(i) using plot option
 only useful for 6 pads!!

 draws default canvas divided 3 times 2 and fills it with the contents of histarray[i] at pad(i) using plot option

 draws default canvas divided 3 times 2 and fills it with the contents of histarray[i] at pad(i) using plot option "option"

 cuts from infi end from the end

 executes command in
 and returns Char_t pointer to result string
 user have to delete return string

 executes command in
 and returns Char_t pointer to result string
 user have to delete return string

 small minidebug message, with increasing static counter
 prints out called if called different from -1
 useful example
 PTools::mdb(\__LINE__)

 Function to create subdirectories
 of dirOld with name newDirName
 if index differs from -99 then index is attached to the name with the precision of precision
 changes to the new created directory
 returns the pointer to the new directory
Thanks to J.Kempter (J.Markert)

 see:   PTools::Mkdir(TDirectory *dirOld, const Char_t *newDirName, Int_t index, Int_t precision

 returns the limits of hist

 returns the limits of hist

 returns the limits of hist

 prints the limits of hist

 prints the limits of hist

 prints the limits of hist

 compares limits of hist1 with limits hist2 (nbins, min, max)
 if exitIfNotEqual is set exit.

 get number of filled bins where the
 bin contents are within the limits of min and max

 cleans histograms
 bin contents out of the limits of min and max
 are set to 0
 errors are set to 0

 if errorMode is not equal [default=0]
 then instead of the binContent
 the min-max condition is applied on the errors

 errorMode = 0: bin contents
 errorMode > 0: absolute Values are compared
 errorMode < 0: relative Errors are considere
 (for this purpose the function getErrorsOfHistogram() is used, see there for definitions of exceptions)

 attaches to the name of TNamed name "_postfix"
 and      " - postfix" to its title

 attaches to TNamed name " - postfix" to its title

 attaches to the name of TNamed name "_postfix"
 and      " - postfix" to its title

 cuts 2-dim histogram hist by using the graphical cut
 complement inverts the selection

 cuts 2-dim histogram hist by using logical or of the graphical cuts in the cutarray
 complement inverts the selection

 plots above each bin of hist
 the bin content
 in color
 format can specify via e.g. %2.4f special output formats
 but only fixed to floating precisions, so if you want to display just integers e.g. choose %4.0f

 one command for initializing a TH1F histogramm
 object has to be deleted by user

 one command for initializing a TH2F histogramm
 object has to be deleted by user

 one command for initializing a TH3F histogramm
 object has to be deleted by user

 one command for initializing a TH1D histogramm
 object has to be deleted by user

 one command for initializing a TH2D histogramm
 object has to be deleted by user

 one command for initializing a TH3D histogramm
 object has to be deleted by user

 reverses the X-Axis of the histogramm
 creates a new histogramm

 reverses the Y-Axis of the histogramm
 creates a new histogramm

 reverses the Z-Axis of the histogramm
 creates a new histogramm

 plots polar axis
 starting from min
 ending at max
 pointing in direction (angle [rad])
 with n divisions

 plots polar axis using the limits of hist
 see plotPolarAxis

 plots in polar coordiates
 a circular grid
 with the hades naming of phi angles

 plots in polar coordiates
 a line axis grid
 with the hades naming of phi angles

 saves canvas to pdf
 to path
 using filename
 if separate is used
 each sub pad is printed to its own file
 (requieres external function ps2pdf)
 Thanks to Jochen Markert, GSI
 selection selects one specific subpad number if selection > 0
 produced now output in compatiblity mode 1.4 (Acrobat 5 and higher)

 saves pad to pdf
 to path
 using filename
 if separate is used
 each sub pad is printed to its own file
 (requieres external function ps2pdf)
 Thanks to Jochen Markert, GSI
 selection selects one specific subpad number if selection > 0
 produced now output in compatiblity mode 1.4 (Acrobat 5 and higher)

 saves canvas to png
 to path
 using filename
 if separate is used
 each sub pad is printed to its own file
 (requieres external function convert)
 Thanks to Jochen Markert, GSI
 selection selects one specific subpad number if selection > 0

 saves pad to png
 to path
 using filename
 if separate is used
 each sub pad is printed to its own file
 (requieres external function convert)
 Thanks to Jochen Markert, GSI
 selection selects one specific subpad number if selection > 0

 saves canvas to gif
 to path
 using filename
 if separate is used
 each sub pad is printed to its own file
 (requieres external function convert)
 Thanks to Jochen Markert, GSI
 selection selects one specific subpad number if selection > 0

 saves pad to gif
 to path
 using filename
 if separate is used
 each sub pad is printed to its own file
 (requieres external function convert)
 Thanks to Jochen Markert, GSI
 selection selects one specific subpad number if selection > 0

 Thanks to Jochen Markert, GSI

 Thanks to Jochen Markert, GSI

 Thanks to Jochen Markert, GSI

 Thanks to Jochen Markert, GSI

 Thanks to Jochen Markert, GSI

 add entry for object with label and color and option to legend

 Thanks to Jochen Markert, GSI

 Thanks to Jochen Markert, GSI
 coordinates in NDC!

 calculates the error of arithmetic mean of a TH1
 in a range between minX and maxX
 position: determines the value of the bin taken
           "center" : bin center value [default]
           "up"     : bin upper edge
           "low"    : bin lower edge value

 calculates the error of arithmetic mean of a TH1
 in a range between bin minX and bin maxX
 position: determines the value of the bin taken
           "center" : bin center value [default]
           "up"     : bin upper edge
           "low"    : bin lower edge value

 calculates the arithmetic mean of a TH1
 in a range between minX and maxX
 position: determines the value of the bin taken
           "center" : bin center value [default]
           "up"     : bin upper edge
           "low"    : bin lower edge value

 calculates the arithmetic mean of a TH1
 in a range between bin minX and bin maxX
 position: determines the value of the bin taken
           "center" : bin center value [default]
           "up"     : bin upper edge
           "low"    : bin lower edge value

 calculates the sqrt of each histogram bin

 Clones named object name and sets the name no newname and its title to title
 if newname and or title are empty
 title and name are extended by "_clone"

 copies any THx histogramm to THxD histograms
 you have to cast to the corresponding type
 attaches to name "_THxD"

 copy any TH1 histogramm to TH1D histogramm

 copy any TH2 histogramm to TH2D histogramm

 copy any TH3 histogramm to TH3D histogramm

 copy any TH1 histogramm to TH1D histogramm
 returned histogram has to be deleted by user

 copy any TH2 histogramm to TH2D histogramm
 returned histogram has to be deleted by user

 copy any TH3 histogramm to TH3D histogramm
 returned histogram has to be deleted by user

 Copy TAxis attributes

 copies bin labels from one axis to the other
 if bin numbers differ overlap is taken

 checks whether h1 and h1

   * have the same type       +(0000001)
   * have the same dimension  +(0000100)
   * have the same binning    +(0010000)
   * have the same limits     +(1000000)

 returns the sum of conditions not matched
 i.e. not same type && not same binning =>  1000001;
 returns 0, if all conditions match
 returns -1, if h1 or h2 is a NULL pointer

 checks whether h1 and h1

   * have the same binning
   * have the same dimension
   * have the same limits

   NOTE: it allows differences in the types (ClassNames)
   if you want to check for this use checkHistogramCompatibility directly

 returns kTRUE if they are compatible to these checks
 returns kFALSE if not
 returns also kFALSE, if h1 or h2 is a NULL pointer

 compares two TArrays
 in size, type and values

 if identical kTRUE is returned
 else kFALSE
 returns also kFALSE, if array1 or array2 is a NULL pointer

 supported types are TArrayC, TArrayD, TArrayF, TArrayI, TArrayL, TArrayS

 fills an TH1 histogramm hist to a TGraphError
 depending on position
 the x value is chosen
 "center" or "middle": in the middle of the bin
 "low" or "left"     : at the lower edge of the bin
 "up" or "right"     : at the upper edge of the bin

 if name is set, name is assigned as the objects name, otherwise "_graph" is put to the name of hist

 if xerrors is set xerrors are taken as 50% of the bin width

 returns pointer to TGraphError
 if hist does not exists,
   NULL pointer ist returned
 if invalid position is chosen (case insensitive)
   NULL pointer ist returned

 returns for a given (plotted) histogramm the pointer to the statistics TPaveStat

 returns for a given TCanvas/TPad pointer to the statistics TPaveStat of a
 histogram with name "name"
 before calling getHistStats(hist) a pad->Update() is executed

 sets y1 and y2 position in NDC coordinates of stats box of histogramm
 returns pointer to stats' TPaveStats

 sets y1 and y2 position in NDC coordinates of stats box of histogramm
 with name "name" in pad
 returns pointer to stats' TPaveStats

 sets x1 and x2 position in NDC coordinates of stats box of histogramm
 returns pointer to stats' TPaveStats

 sets x1 and x2 position in NDC coordinates of stats box of histogramm
 with name "name" in pad
 returns pointer to stats' TPaveStats

 sets x1,y1 and x2,y2 position in NDC coordinates of stats box of histogramm
 returns pointer to stats' TPaveStats

 sets x1,y1 and x2,y2 position in NDC coordinates of stats box of histogramm
 with name "name" in pad
 returns pointer to stats' TPaveStats

 gets y1 and y2 position in NDC coordinates of stats box of histogramm
 returns pointer to stats' TPaveStats

 gets y1 and y2 position in NDC coordinates of stats box of histogramm
 with name "name" in pad
 returns pointer to stats' TPaveStats

 gets x1 and x2 position in NDC coordinates of stats box of histogramm
 returns pointer to stats' TPaveStats

 gets x1 and x2 position in NDC coordinates of stats box of histogramm
 with name "name" in pad
 returns pointer to stats' TPaveStats

 gets x1,y1 and x2,y2 position in NDC coordinates of stats box of histogramm
 returns pointer to stats' TPaveStats

 gets x1,y1 and x2,y2 position in NDC coordinates of stats box of histogramm
 with name "name" in pad
 returns pointer to stats' TPaveStats

 sets text color of stats box of histogramm
 returns pointer to stats' TPaveStats

 sets text color of stats box of histogramm
 with name "name" in pad
 returns pointer to stats' TPaveStats

 sets attributes of TLatex object tex:
 x,y positions (choose setLatexArtsNDC for NDC coords)
 color
 size
 alignment
 font
 angle
 ndc: use ndc coordinates

 see TAttText for detailed information

 sets attributes of TLatex object tex:
 x,y positions in NDC coords
 color
 size
 alignment
 font
 angle
 see TAttText for detailed information

 loads Macro only if macro has not yet been loaded before
 returns true if macro is loaded
 returns true if no action is necessary

 loads Macro only if macro has not yet been loaded before
 returns true if macro is loaded
 returns true if no action is necessary

 Translates i.e. array coordinate 0,2,3 of array[3][8][1]
 in a linear unique coordinate starting from 0

 coordinates starting from 0 !!!

 if x(i) is < 0 then only the x(i-1) coords are taken into account
 if indizes are out of bounds -1 is returned

 Translates i.e. array coordinate 0,2,3 of array[3][8][1]
 in a linear unique coordinate starting from 0

 coordinates starting from 0 !!!

 if x(i) is < 0 then only the x(i-1) coords are taken into account
 x is contains the coordinates and has dimension dim
 xmax are the sizes and is of dimension dim
 if indizes are out of bounds -1 is returned

 Draws text as TLatex in current pad
 at pos x,y not in NDC but it WC
 using setLatexArtsNDC
 returns pointer to new created TLatex object (user must care of removal)

 Draws text as TLatex in current pad
 at pos x,y not in NDC but it WC
 using setLatexArtsNDC
 returns pointer to new created TLatex object (user must care of removal)

 Draws text as TLatex in current pad
 at pos x,y in NDC
 using setLatexArtsNDC
 returns pointer to new created TLatex object (user must care of removal)

 Draws text as TLatex in current pad
 at pos x,y in NDC
 using setLatexArtsNDC
 returns pointer to new created TLatex object (user must care of removal)

 Draws text as TLatex in current pad
 at pos x,y in NDC
 using setLatexArtsNDC
 returns pointer to new created TLatex object (user must care of removal)

 Draws text as TLatex in current pad
 at pos x,y in NDC
 using setLatexArtsNDC
 returns pointer to new created TLatex object (user must care of removal)

 Draws text as TLatex in current pad
 at pos x,y in NDC
 using setLatexArts
 returns pointer to new created TLatex object (user must care of removal)

 Draws text as TLatex in current pad
 at pos x,y in NDC
 using setLatexArts
 returns pointer to new created TLatex object (user must care of removal)

 creates histogram
 which contains the errors of hist
 if an error occurs NULL is returned
 the name and title of the new histogramm will expanded by "_Error" or "_relError"
 relativeError is kTRUE then |relativeError| is calculated
   (if hist does not contain in a bin the relative error is set to -1)
 otherwise the absolute error is given

 sets the errors of histogram hist with the bin contents of hist err
 provided the histograms are compatible

 if hist or err are NULL pointer, or the histograms are not compatible,
 an error message is issued, but nothing happens

 copies any THx histogramm to THxD histograms
 you have to cast to the corresponding type
 attaches to name "_THxD"
 the histogramm has as many bins as the original but a binning of binningXYZ [default =1]

 substracts from each bin of histogram the value val newbin = bin - val
 if inverse = kTRUE: newbin = val - bin

 returns a pointer to a histogram containing the distribution of the bin contents
 by default in 1000 bins

 The histogram range is determined by searching for the minimum and maximum bin content
 and then setting the output histograms minimum to the found minimum,
 the maximum to maximum+(maximum - minimum)/binning, i.e. maximum+binWidth
 this one bin more is accounted for by having not binning, but binning + 1 bins.

 if hist is NULL ... NULL is returned

 Also the underflow and overflow bins are by default taken into account
 -- those can be excluded by setting excludeUnderAndOverFlowBins to kTRUE

 returns a pointer to a histogram containing for each bin the value 1/value
 if value = 0, the ratio is set to 0

 the name is "OneOverHist" and the title "1/hist"
 if hist is NULL ... NULL is returned

 sets bincontent of hist h2 as errors of h
 lent from jochen

 returns a pointer to a histogram containing for each bin the value 1/value
 if value = 0, the ratio is set to 0

 the name is "OneOverHist" and the title "1/hist"
 if hist is NULL ... NULL is returned

 cleans histograms
 bin contents out of the limits for p min and max
 are set to replaceBy
 errors are set to error 0
 mass of particle needed

 returns bin number where distribution ends
 i.e where no data is beyond threshold
 starting from left to right at bin number min
 returns -1 if hist is NULL
 if compact is set no bin larger min is accepted to be below threshold
 otherwise wholes of 1 bins are allowed

 returns bin number where distribution begins
 i.e where no data is beyond threshold
 starting from right to left at bin number max
 returns -1 if hist is NULL
 if compact is set no bin smaller than max is accepted to be below threshold
 otherwise wholes of 1 bins are allowed

 scales Errors of hist by scaleFactor

 copies subsection of any THx histogramm hist to THxD histograms
 you have to speciy via xbinmin [default:-1], xbinmax [default:-1],
                        ybinmin [default:-1], ybinmax [default:-1],
                        zbinmin [default:-1], zbinmax [default:-1]
 the bin range you want to select
 (NOTE: To choose the coordinates you have to use ((TAxis*)hist->GetXaxis())->FindBin(value); )
 (NOTE: you have to cast to the corresponding type of histogram)

 attaches to name "_subset_X_xminbin-xmaxbin"
                  "_subset_X_xminbin-xmaxbin_Y_yminbin-ymaxbin"
                  "_subset_X_xminbin-xmaxbin_Y_yminbin-ymaxbin_Z_zminbin-zmaxbin

 if hist is NULL, NULL is returned
 in case dimension doesn't match with bin minima and maxima dimensions
 the choice is ignored.
 if xbinmin, xbinmax, ybinmin, yzbinmax, zbinmin, yxbinmax are negativ the full range is taken
 if minima > maxima NULL is returned

 The entries are copied from the original histogram, because they cannot calculated

 copies subsection of any THx histogramm hist to THxD histograms
 you have to speciy via xmin [default: PTools::copySubsetOfHistDefaultValue],
                        xmax [default: PTools::copySubsetOfHistDefaultValue],
                        ymin [default: PTools::copySubsetOfHistDefaultValue],
                        ymax [default: PTools::copySubsetOfHistDefaultValue],
                        zmin [default: PTools::copySubsetOfHistDefaultValue],
                        zmax [default: PTools::copySubsetOfHistDefaultValue]
 the range you want to select
 via ((TAxis*)hist->GetXaxis())->FindBin(value); the corresponding bin range is calculated

 Following copyBinSubsetOfHist is called and afterwards the name and title of the histogram are just adopted

          to name "_subset_X_xmin-xmax"
                  "_subset_X_xmin-xmax_Y_ymin-ymax"
                  "_subset_X_xmin-xmax_Y_ymin-ymax_Z_zmin-zmax

 if hist is NULL, NULL is returned
 in case dimension doesn't match with bin minima and maxima dimensions
 the choice is ignored.
 if xbinmin, xbinmax, ybinmin, yzbinmax, zbinmin, yxbinmax are PTools::copySubsetOfHistDefaultValue
 the full range is taken
 if minima > maxima NULL is returned

 The entries are copied from the original histogram, because they cannot calculated

 (NOTE: you have to cast to the corresponding type of histogram)

  static void             postfixToNameTitle(TNamed *name, Char_t * postfix);

  static void             suffixToTitle(TNamed *name, Char_t * suffix){postfixToTitle(name,  suffix);};

  static void             suffixToNameTitle(TNamed *name, Char_t * suffix){postfixToNameTitle(name,  suffix);};