class HPTools

 expects either a HRootSource (inheritant) or HldFileSource (inheritant) as source
 adds to this given HDataSource source:

   (a) inputFile ends with ".root or .hld": the root/hld inputfile
       to be found in inDir with referenceId refId (default:-1)

   (b) inputFile ends with ".txt": the list of root/hldfiles contained in inputFile
       to be found in inDir with referenceId refId (default:-1)

 if inputFile is not valid exit with exit(EXIT_FAILURE);

 in case of an HRootSource it is check whether a Tree is contained
  (no)  exits with with exit(EXIT_FAILURE);
  (yes) adds all entries together

 return values:
 RootSource: number of Events (default:-1)
 HldSource: (default:-1)

 inputfile example:
 # comment line
 file1.root
 #file2.root
 file3.root

 replaces for a given histogramm hist with geant pid numbers on axis
 the numbers by the pid name

 replaces for a the active histogramm with geant pid numbers on axis
 the numbers by the pid name

 replaces for a given histogramm hist with geant process numbers on axis
 the numbers by the process name

 replaces for the active histogramm hist with geant process numbers on axis
 the numbers by the process name

 plots onto a polar plot a grid corresponding to the HADES orientation

 function returning the relation of pt to theta for a given mass

 plotting grid of constant lab momentum and constant angles for a given mass
 over the active histogramm assuming that it represents a pty distribution

 depending on the startEvt number
 the file information used in my analysis scripts is printed to stdout
 startEvt == -1111: >> "outputName outputFile"
 startEvt == -2222: >> "outputDir outputDirectory"
 startEvt == -3333: >> "inputDir inputDirectory"
 used to get information how the parameters about files are treated and processed before
 running the macro itself completely

 function to add mdc detector to hades detector
 valid beamtime names are:
                           nov01
                           nov02
                           sep03
                           jan04
                           aug04
                           jan05
                           sep05
                           apr06
                           may06
                           apr07
                           oct07

 sets mdc Detector setup with the 6*4 matrix given via mdcMods
  i.e. sep03_mdcMods[6][4] = { {1,1,1,1},
                               {1,1,1,1},
 			           {1,1,1,0},
 				   {1,1,1,1},
 				   {1,1,1,1},
 				   {1,1,1,0} };

 print a counter message if eventiter is x = eventiter*stepsize %
 where stepsize is given in percentage
 default stepsize 5% = 0.05

 calls hades::init and checks the output
 if it has failed the hades object is deleted and the function exits with exit_code -1
 returns kFALSE if init has failed
 kTRUE otherwise

 calls hades event loop
 generates info output
 returns number of processed events

 prints the usage for an executable: name
 of the following syntax
    executable inputfile inDir outputDir [number of events [start evt]]

 returns always kTRUE;

 main function part for compiled macros
 the macro function must have the syntax

 Int_t function(TString outDir, TString inputDir, TString inputFile, Int_t nEvents=0, Int_t startEvt=0)
 the function should also contain a call to the function HPTools::printAnalysisFileInfo

 passing this its function pointer (i.e. just its name without anything else)
 together with argc and argv from the main function
 to this function
 delivers you the following behavior

     (suppose the compiled executable's name is executable)

      executable accepts the following usage:

      executable inputfile inDir outputDir [number of events [start evt]]
      in addition if either 'number of events' or 'start evt' is set to
      'OUTPUTNAME', 'OUTPUTDIR', 'INPUTDIR', 'EXECUTABLE' (case insensitive)
      the corresponding information is printed to stdout


 Behaviour

 (0) in any (yet known) case the return value is EXIT_SUCCESS

 (1) passing less than 3 or more than 5 arguments to the function results in a
     call to HPTools::usageFileInDirOutDirNevtStart
     to explain right behavior

 (1a) if called with option -h HPTools::usageFileInDirOutDirNevtStart will be called (help)

 (2) function is called corresponding to aboves definition of executable

 (3) if either 'number of events' or 'start evt' is set to
     'OUTPUTNAME', 'OUTPUTDIR', 'INPUTDIR', 'EXECUTABLE' (case insensitive)
     the corresponding information is printed to stdout
     by calling the function with predefined negative 'start evt' values
     making usage of HPTools::printAnalysisFileInfo

 sets the persistency for the categories given in persistentArray[nPersistent]
 to value of b
 if clean > 0:
 1. setting the first 'clean' categories' persistency to the inverse of b
 2. sets the categories listet in the array to b
 if not only item 2 is executed

 returns a histogram with a variable binning
 to plot geant pair ids like 8009 14014 ...
 the axis is labeled correspondingly
 min and max set a range
 if extBins is set, extBins with extBinning [default=1] are added

 provides for geant pid index corresponding pid name in latex representation

 provides for geant process index corresponding process name in latex representation