class TQNFCalculator: public TQNFBase

 default constructor taking base sample folder

 default constructor taking base sample folder

 retrieve the default data path currently set

 default destructor, cleaning up all pointer fields

 deploys a selected NF in all known locations
 stop if this cut is an point of tree of cuts on which to apply the NFs

  std::cout<<"deployNF called with cutName = "<< cutName.Data()<<", stopAtCutNames:"<<std::endl;
  TQListUtils::print(stopAtCutNames);
  std::cout<<"This is where I'd apply NFs with the new code:"<<std::endl;
  std::vector<TString> startCuts;
  startCuts.push_back(cutName);
  std::vector<TString> targets = this->getTargetCuts(startCuts,stopAtCutNames);
  TQListUtils::print(targets);
  std::cout<<"Now go and compare if I did it right ;)"<<std::endl;

 clear all names, paths and results

 set the default data path
 this path is going to be used if no path is supplied
 when adding regions via addRegion(...)

 add a new region. the region name will be the cut name
 optional argument: supply a data path from which data will be obtained

 add a new monte carlo sample group from the given location
 optional argument: supply a name for easy reference

 add a new monte carlo sample group from the given location
 optional argument: supply a name for easy reference

 add a new monte carlo sample group from the given location
 as opposed to TQNFCalculator::addSample, no NF will be fitted
 instead, the NF will be fixed to 1

 initialize the data histogram

 ensure positive mc for all samples

 initialize all mc histograms

 initialize the NF Calculator
 - initializes the data histogram
 - initializeds the mc histograms
 will set the initialize flag to true
 further calls of initialize will have no effect
 until clear is called

 return the number of "floating" (i.e. non-fixed) samples

 in the case where the number of samples
 and the number of regions are identical
 the TFractionFitter cannot be used
 hence, this function implements a matrix calculation
 for this particular case

 in the case of only one sample group
 the TFractionFitter cannot be used
 hence, this function implements a manual calculation
 for the case of only one sample group

 this is the worker function
 actually performing the NF calculation
 in the default case of more than one sample group

 calculate the NFs with a certain method (given by the string)
 the following tags control the side-effects of this function:
 - saveLog: string, name of the log file to be used
 if not given, print to the console
 - writePreFitHistograms: string, name of the root file to be created
 if not given, nothing will be written
 - writePostFitHistograms: string, name of the root file to be created
 if not given, nothing will be written
 - saveResults: string, name of the text file to be used for result output
 if not given, nothing will be written

 actually perform the NF calculation
 based on all information supplied earlier
 the following tags control the side-effects of this function:
 - saveLog: string, name of the log file to be used
 if not given, print to the console
 - writePreFitHistograms: string, name of the root file to be created
 if not given, nothing will be written
 - writePostFitHistograms: string, name of the root file to be created
 if not given, nothing will be written
 - saveResults: string, name of the text file to be used for result output
 if not given, nothing will be written

 set all the NFs to one

 acquire failure state

 actually perform the NF calculation
 based on all information supplied earlier

 get the contribution index coresponding to the given NF name

 get the value of the NF with the given name

 get the uncertainty of the NF with the given name

 get the value and uncertainty of the NF with the given name
 store both in the values supplied as second and third argument

 print all regions scheduled for NF calculation

 print all sample groups scheduled for NF calculatrion

 print the results of the evaluation

 obtain the histogram associated with the given sample group
 will accept all mc names as well as "data" (for the data histogram)

 scale the histogram associated to the sample with the given name by the
 given value

 retrieve the sample path
 corresponding to the sample
 with the given name

 retrieve the status

 decode the integer status code

 print the status

start calculation

 return true if calculation was successful
 false otherwise

 set the epsilon deviation allowed for fixed samples
 smaller values will increase the accuracy of the calculation
 but also increase the probability of the fit to fail

 get the current value of the epsilon deviation
 allowed for fixed samples

 dump the results of the NF calculation to a text file

 dump the results of the NF calculation for a particular contribution
 into a string that is formatted according to the TQTaggable syntax

 dump the results of the NF calculation for a particular contribution
 into an object of the TQTaggable type

 dump the results of the NF calculation for a particular entry
 into an object of the TQTaggable type

 dump the results of the NF calculation to an output stream

 read a configuration from a TQFolder instance
 the following tags are interpreted:
 verbosity: integer, increasing value increases verbosity
 epsilon: double, the 'epsilon'-value for the calculation
 defaultDataPath: string, the default data path
 methods: list, methods to be used in order of priority
 all tags are copied to the calculator

 a subfolder 'samples' is expected
 each folder in 'samples/?' is interpreted as one sample group
 the following parameters are accepted and interpreted
 name: string, the name of this group
 path: string, the path of this group
 fixed: bool, true for fixed samples, false for floating ones
 upper: upper bound for this NF (recommended, but not required)
 lower: lower bound for this NF (recommended, but not required)

 a subfolder 'regions' is expected
 each folder in 'regions/?' is interpreted as one sample group
 the following parameters are accepted and interpreted
 name: string, the name of this region (name of the counter)
 datapath: string, the data path to be used for this region
 if not set, the defaultDataPath will be used
 active: bool. if false, this region is ignored. default is true.

 this function returns true if at least one region and at least one floating
 sample group have been found and added successfully.

 retrieve the histogram
 corresponding to the sample
 with the given name

 export the histograms to a new sample folder

 export the histograms to some root file
 the 'recreate' flag controls if the file is opened in APPEND or RECREATE mode
 if postfit=true, the post-fit histograms are saved (if possible)
 if the calculation has not yet been performed or has failed, the pre-fit ones are saved instead

 export the histograms to an existing sample folder
 if postfit=true, the post-fit histograms are saved (if possible)
 if the calculation has not yet been performed or has failed, the pre-fit ones are saved instead

 add a method at the back of the queue

 empty the method queue

 print all currently scheduled methods in order of priority