class TQSampleFolder: public TQFolder

 Default constructor of TQSampleFolder class: a new and empty instance of
 TQSampleFolder is created and initialized. Its name will be set to "unkown".
 Please note: users should not use this constructor but the static factory method
 TQSampleFolder::newSampleFolder(...). This default constructor has to be present
 to allow ROOT's CINT to stream instances of TQSampleFolder.

 Default constructor of TQSampleFolder class: a new and empty instance of
 TQSampleFolder is created and initialized. Its name will be set to the value of
 the parameter <name> if it is a valid name.
 Please note: users should not use this constructor but the static factory method
 TQSampleFolder::newSampleFolder(...).

 Returns a new and empty instance of the TQSampleFolder class with name <name>
 if <name> is a valid name and a null pointer otherwise. Please refer to the
 documentation of the static method TQSampleFolder::isValidName(...) for details
 on valid folder names.

 Returns a new and empty instance of the TQSampleFolder class with name <name>
 if <name> is a valid name and a null pointer otherwise. Please note: this method
 does exactly the same as TQSampleFolder::newSampleFolder(...) but may be over-
 written by sub-classes of TQSampleFolder.

 this function works exactly as TQSampleFolder::loadSampleFolder, with the
 exception that all folder branches that have been externalized/splitted
 when writing the file will remain in collapsed state until they are
 accessed. for large files with an excessive use of
 externalization/splitting, this will significantly speed up accessing the
 data, since the branches are only expanded on-demand.

 please note, however, that you will only experience a total speed gain if
 you only access small fractions of your data. if you plan to read most of
 the file's data at some point, requiring the expansion of all branches,
 this 'lazy' feature will only postpone the work of loading the data into
 RAM to the point where it is accessed bringing no total speed gain.

 Loads an instance of TQSampleFolder from an external ROOT file and returns a
 pointer to it and a NULL pointer in case of failure. The ROOT file and the key
 within the key within the ROOT file to be read is identified by <path> which
 has to have the form "filename:keyname", e.g. "file.root:folder".
 If the sample folder to load is stored within a structre of TDirectory in the
 file it can be accessed by prepending the corresponding path to the sample
 folder name, e.g. "file.root:dir1/dir2/folder". To load only a subfolder of an
 instance of TQSampleFolder from the ROOT file one can append the corresponding
 path to the folder name, e.g. "file.root:folder/subfolder". In this case a
 pointer to "subfolder" is returned which is made the root folder before.

 the 'lazy' flag will trigger lazy loading, please refer to TQFolder::loadLazySampleFolder
 for documentation of this feature.

 Scans the file system for files matching the string pattern of file part in
 <treeLocation> and returns an instance of TQSampleFolder with name <name> and
 instances of TQSample referring to each matching file. The tree name is set
 to the tree part in <treeLocation> and the sample normalization is set to
 <normalization>.

 Examples:

 - TQSampleFolder * samples =
 TQSampleFolder::newSampleList("data", "data_*.root:Tree", 1.) will create
 a sample folder of samples for each "data_*.root" ntuple using the TTree
 "Tree".
 make sure the user requested a valid name

 Nothing happens here

 recursively visit this sample (folder) with the given visitor

 Lets the sample visitor (instance of TQSampleVisitor) <visitor> visit those
 sample folders that match the path pattern <category> and returns the number
 visits. <category> may consists of multiple comma-separated paths and wildcards
 "?" and "*" may be used. If an exclamation mark "!" is appended to a path pattern
 the corresponding sample folders are visited non-recursively. This "!" feature doesn't actually work-> TODO: fix or remove comment

 wrapper function for std::set<TQSampleFolder*> variant

 visit an already selected set of folders

get a list of sample folders

 Returns the sample (instance of TQSample) that matches the path pattern <path>
 and a NULL pointer in case no match can be found. If more than one sample matches
 <path> (because wildcards are used) the first match is returned.

 Returns a pointer to the base sample folder and a NULL pointer if either there
 is no base folder or the base folder is not an instance of TQSampleFolder.

 Returns the a pointer to the instance of TQSampleFolder which is the root of
 this samplefolder hierarchy (not necessarily the root of the folder hierarchy).

 wrapper for TQFolder variant (returned set is reduced by TQFolders returned by
 the TQFolder variant of this method (getFoldersWithTagsEquivalentTo) which are
 not also TQSampleFolders.

 wrapper for TQFolder variant (returned set is reduced by TQFolders returned by
 the TQFolder variant of this method (getFoldersWithTagEquivalentTo) which are
 not also TQSampleFolders.

 Returns a list (instance of TList) of samples (instances of TQSample) withing
 this sample folder matching the path pattern <path>. If no matching sample
 can be found a NULL pointer is returned.

 prints a list of samples (instances of TQSample) withing
 this sample folder matching the path pattern <path>.
 the number of matched samples is returned

 Returns the sample folder (instance of TQSampleFolder) that matches the path
 pattern <path_> and a NULL pointer in case no match can be found. If more than
 one sample folder matches <path_> (because wildcards are used) the first match
 is returned. Additionally, a new instance of TQSampleFolder is created as
 requested if it does not already exist and a "+" has been appended to <path_>.
 The path <path_> may be built up from any number of path levels in either case
 and an arbitrary number of nested sample folders may be created by appending
 one "+" to the full path.

 Examples:

 - getSampleFolder("subfolder") returns a pointer to the instance of TQSampleFolder
 named "subfolder" within this instance of TQSampleFolder if it does exist.
 - getSampleFolder("subfolder+") returns a pointer to the instance of TQSampleFolder
 named "subfolder" within this instance of TQSampleFolder and does create it if
 it does not exist
 - getSampleFolder("subfolder/fol2+") returns a pointer to the instance of
 TQSampleFolder named "fol2" within "subfolder" (in turn within this instance of
 TQSampleFolder) and does create it if it does not exist

 Returns the number of sample folders (instances of TQSampleFolder) within this
 instance of TQSampleFolder. If <recursive> == true not only sample folders
 within this instance but also recursively within sub sample folder will be
 counted.

 Returns the number of samples (instances of TQSample) within this instance of
 TQSampleFolder. If <recursive> == true not only samples within this instance
 but also recursively within sub sample folder will be counted.

 Returns true if a histogram <name> in <path> can be retrieved with options
 <options> using TQSampleFolder::getHistogram(...).
 [Please note: this is a wrapper to TQSampleDataReader::hasHistogram(...).]

 Returns true if a counter <name> in <path> can be retrieved with options
 <options> using TQSampleFolder::getCounter(...).
 [Please note: this is a wrapper to TQSampleDataReader::hasCounter(...).]

 Renames a local object within subfolder <category> and name <oldName> into
 <newName> also allowing to move the object to a different subfolder and returns
 true in case of success and false otherwise. This method is used by
 TQSampleFolder::renameLocalHistogram(...) and TQSampleFolder::
 renameLocalCounter(...) to rename local histograms and counters.
 get the local object

 Renames the local histogram (instance of TH1 wihtin ".histograms" subfolder)
 with name <oldName> to <newName> also allowing to move the histogram to a new
 subfolder and returns true in case of success and false otherwise. In case a
 histogram is moved to a new subfolder it is created unless it already exist.
 This method does not affect histograms within sub sample folders.

 Examples:

 - renameLocalHistogram("CutMETRel/MT", "CutMETRel/MT_2") renames the histogram
 "MT" in "CutMETRel" to "MT_2".
 - renameLocalHistogram("CutMETRel/MT", "CutMETRel_2/MT") moves the histogram
 "MT" in "CutMETRel" to "CutMETRel_2".

 Renames the local counter (instance of TQCounter wihtin ".cutflow" subfolder)
 with name <oldName> to <newName> also allowing to move the counter to a new
 subfolder and returns true in case of success and false otherwise. In case a
 counter is moved to a new subfolder it is created unless it already exist.
 This method does not affect counters within sub sample folders.

 Examples:

 - renameLocalCounter("CutMETRel", "CutMETRel_2") renames the counter
 "CutMETRel" to "CutMETRel_2".
 - renameLocalCounter("CutMETRel", "test/CutMETRel") moves the counter
 "CutMETRel" to "test".

 Renames the histogram with name <oldName> into <newName> and returns the number
 of contributing histograms that have been renamed. This method also allows
 to move histograms to new subfolders without the need to take additional
 action. Examples:

 - renameHistogram("Cut_0jet/MT", "Cut_0jet/MT_2") renames the histogram
 "Cut_0jet/MT" into "Cut_0jet/MT_2"
 - renameHistogram("Cut_0jet/MT", "Cut_0jet_test/MT") moves the histogram "MT"
 from "Cut_0jet" to "Cut_0jet_test" (with the latter being created if it does
 not exists prior to the operation
 - renameHistogram("Cut_0jet/MT", "1/2/3/MT") moves the histogram "MT"
 from "Cut_0jet" to "1/2/3" (with the latter being created if it does
 not exists prior to the operation

 Renames the counter with name <oldName> into <newName> and returns the number
 of contributing counter that have been renamed. This method also allows
 to move counter to new subfolders without the need to take additional
 action. Examples:

 - renameCounter("Cut_0jet", "Cut_0jet_2") renames the counter "Cut_0jet" into
 "Cut_0jet_2"
 - renameCounter("Cut_0jet", "1/2/3/Cut_0jet") moves the counter "Cut_0jet"
 to "1/2/3" (with the latter being created if it does not exists prior to the
 operation

 Deletes all contributing histograms to histogram <name> within this instance of
 TQSampleFolder and all sub sample folders and returns the number of contributing
 histograms that have been deleted.

 Deletes all contributing counter to counter <name> within this instance of
 TQSampleFolder and all sub sample folders and returns the number of contributing
 counter that have been deleted.

 Deletes all contributing histograms to histograms matching the string pattern
 <filter> within this instance of TQSampleFolder and all sub sample folders and
 returns the number of histograms that have been deleted. The string pattern
 is matched using TQStringUtils::matchesFilter(...) and allows the use of wildcards
 "*" and "?", a negation by prepending "!", and an OR of multiple comma-separated
 string patterns.

 Deletes all contributing counter to counter matching the string pattern <filter>
 within this instance of TQSampleFolder and all sub sample folders and returns
 the number of counter that have been deleted. The string pattern is matched
 using TQStringUtils::matchesFilter(...) and allows the use of wildcards "*" and
 "?", a negation by prepending "!", and an OR of multiple comma-separated string
 patterns.

 Retrieves the histogram <source> applying options <options>, stores the resulting
 histgram as <destination>, and returns the number of contributions to the new
 histogram.

 Examples:
 - copyHistogram("Cut_0jet/MT + Cut_1jet/MT", "Cut_Sum01jet/MT") creates a new
 histogram "Cut_Sum01jet/MT" from the sum of "Cut_0jet/MT" and "Cut_1jet/MT"
 - copyHistogram("Cut/MT_vs_Mll", "Cut/MT", "projX = true") creates a new
 histogram "Cut/MT" from the projection of "Cut/MT_vs_Mll" onto its X axis

 Returns a histogram (pointer to an instance of TH1) obtained from summing
 contributions matching <name> from sample folders matching <path>. Additional
 options may be passed via <options> and a list of contribution sample folders
 is returned if <sfList> is valid pointer to an instance of TList.

 [Please note: this is a wrapper to TQSampleDataReader::getHistogram(...).
 Please check the corresponding documentation for details.]
 the reader to retrieve histograms

 Returns a histogram (pointer to an instance of TH1) obtained from summing
 contributions matching <name> from sample folders matching <path>. Additional
 options may be passed via <options> and a list of contributing sample folders
 is returned if <sfList> is a valid pointer to an instance of TList.

 [Please note: this is a wrapper to TQSampleDataReader::getHistogram(...).
 Please check the corresponding documentation for details.]
 the reader to retrieve histograms

 Returns a counter (pointer to an instance of TQCounter) obtained from summing
 contributions matching <name> from sample folders matching <path>. Additional
 options may be passed via <options> and a list of contributing sample folders
 is returned if <sfList> is a valid pointer to an instance of TList.

 [Please note: this is a wrapper to TQSampleDataReader::getCounter(...).
 Please check the corresponding documentation for details.]
 the reader to retrieve counter

 Convenience wrapper for getCounter which prints the cunter after checking for
 potential nullptrs and cleans up the retrieved counter afterwards

 Returns a list (pointer to instance of TList) of histogram names (as instances
 of TObjString) present within the sample folder referred to by <path> and a
 NULL pointer if no histogram could be found. Additionally, a list of contributing
 sample folders is returned if <sfList> is a valid pointer to an instance of TList.

 Prints a list of histogram names present within the sample folder

 Returns a list (pointer to instance of TList) of counter names (as instances
 of TObjString) present within the sample folder referred to by <path> and a
 NULL pointer if no counter could be found. Additionally, a list of contributing
 sample folders is returned if <sfList> is a valid pointer to an instance of TList.

 Prints a list of counters present within the sample folder

 Validates all available counter in sample folders referred to by <path1> and
 <path2> by comparing instances with matching names in these two sample folders,
 prints out the result, and returns true if all counter agree or false otherwise.
 The default output is a list of all counter names (present in any of the two
 sample folders) with the second column indicating the result of the comparison
 of the corresponding counter retrieved from the two input sample folders:

 (1) = (2) [green] counter agree within chosen accuracy (weighted number,
 uncertainty, and raw number)
 (1) ~ (2) [yellow] counter agree only in raw number
 (1) > (2) [red] counter retrieved from sample folder 1 has a larger
 weighted number than the one retrieved from sample folder 2
 (1) < (2) [red] similarly
 (1) - [red] counter does not exist in sample folder 2
 - (2) [red] similarly

 Additional options may be passed via <options>. The following options are
 available:

 - "d" additionally trace mismatch of counter that do not agree.
 - "m" only list counter that do not match
 - "e" only list counter that exists in both sample folders
 - "c" print counter states in additional columns
 - "r" show ratio of weighted numbers of the two counter
 - "a[<accuracy>]" set relative accuracy used for comparing counter
 to <accuracy> (default is 1E-7)
 - "f[<filter>]" only list counter whose name match <filter> (allows use
 of wildcards "*" and "?" in the usual "ls-like" way)

get the samples folders to compare

column widths

 Set a scale factor (better: normalization factor) and its uncertainty.
 The 'path' is the name of the corresponding scale factor (typically name of the cut)
 and may be prefixed with "schemeName:" to use a the scale factor scheme 'schemeName'.

 Set a scale factor (better: normalization factor) and its uncertainty.
 The 'path' is the name of the corresponding scale factor (typically name of the cut)
 and may be prefixed with "schemeName:" to use a the scale factor scheme 'schemeName'.

 Set a scale factor (better: normalization factor) and its uncertainty.
 The 'path' is the name of the corresponding scale factor (typically name of the cut)
 and may be prefixed with "schemeName:" to use a the scale factor scheme 'schemeName'.

 Set a scale factor (better: normalization factor) and its uncertainty.
 The 'path' is the name of the corresponding scale factor (typically name of the cut)
 and may be prefixed with "schemeName:" to use a the scale factor scheme 'schemeName'.
 The default scheme is '.default'.

 Set a scale factor (better: normalization factor).
 The 'path' is the name of the corresponding scale factor (typically name of the cut)
 and may be prefixed with "schemeName:" to use a the scale factor scheme 'schemeName'.
 The default scheme is '.default'.

 Set a scale factor (better: normalization factor).
 The 'path' is the name of the corresponding scale factor (typically name of the cut)
 and may be prefixed with "schemeName:" to use a the scale factor scheme 'schemeName'.
 The default scheme is '.default'.

 Prints a summary of scale factors (better: normalization factors) associated
 to this instance of TQSampleFolder. If no normalization factors are associated
 to it a corresponding message is printed.

 Returns a scale factor (better: normalization factor)
 The 'path' is the name of the corresponding scale factor (typically name of the cut)
 and may be prefixed with "schemeName:" to use a the scale factor scheme 'schemeName'.
 The default scheme is '.default'.

 The value of the scale factor will be deployed in the 'scale' argument,
 The uncertainty value will be deployed in the 'uncertainty' argument.

 The recursive flag can be used to collect and multiply corresponding scale factors
 from parent directories in an upward-recursive fashion (default: false).

 convert legacy NFs into the most recent format

 Returns a scale factor (better: normalization factor) as the underlying TQCounter object
 the path is the name of the corresponding scale factor (typically name of the cut)
 and may be prefixed with "schemeName:" to use a the scale factor scheme 'schemeName'.
 The default scheme is '.default'.

 Returns a scale factor (better: normalization factor) as the underlying TQCounter
 object the path is the name of the corresponding scale factor (typically name
 of the cut) and may be prefixed with "schemeName:" to use a the scale factor
 scheme 'schemeName'. The default scheme is '.default'.

 Returns a scale factor (better: normalization factor) as the underlying TQCounter
 object the path is the name of the corresponding scale factor (typically name
 of the cut).

 Returns a scale factor (better: normalization factor) as the underlying TQCounter object
 the path is the name of the corresponding scale factor (typically name of the cut).

 Returns a scale factor (better: normalization factor)
 the path is the name of the corresponding scale factor (typically name of the cut)
 and may be prefixed with "schemeName:" to use a the scale factor scheme 'schemeName'.
 The default scheme is '.default'.

 The value of the scale factor will be returned.

 The recursive flag can be used to collect and multiply corresponding scale factors
 from parent directories in an upward-recursive fashion (default: false).

 Generalizes (merges) contributions to histograms

 Generalizes (merges) contributions to histograms

 Generalizes (merges) contributions to histograms

 Generalizes (merges) contributions to histogram

 Generalizes (merges) contributions to counter

 Generalizes (merges) contributions to histogram

 Generalizes (merges) contributions to counter

 Returns the full path of this instance of TQFolder in the hierarchy. For the
 root folder "/" is returned.
 this version of getPath replaces the names of folders that have the tag
 wildcarded=true
 set with a wildcard ('?')

 merge two sample folders

 merge two sample folders

 merge two sample folders

 find the friends of this sample folder in a branch of the current folder tree

 find the friends of this sample folder in the current folder tree

 public version wrapping protected version which uses additional, performance saving parameters

protected version with additional arguments (pre-compiled contents of otherSF) for performance reasons

 find the friends of this sample folder in some other sample folder
 the otherSFContents shared_ptr can optionally be provided and has to be equivalent
 to obtainig it (as a bare ptr) as other->getListOfSampeFolders("*") . This should only be used
 in recursive calls to save us from recreating this list over and over again

 remove a friend

 add another sample as a friend

 clear the list of friends

 retrieve the set of friends

 retrieve the list of friends

 retrieve the list of friends

 check if another folder is a friend

 print the list of friends