class TQSample: public TQSampleFolder

 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.

 Default constructor of TQSample class: a new instance of TQSample is created
 and initialized. It will be emtpy and have no base folder and its name will
 be set to "unkown"

 Constructor of TQSample class: a new instance of TQSample is created and
 initialized. It will be emtpy and have no base folder and its name will
 be set to the value of the parameter "name_" if it is a valid name and
 "unknown" otherwise

 Set the normalisation factor of this sample. This factor will be used by any
 analysis to scale its results

 Get the normalisation factor of this sample (= 1. by default)

 set the TTree of this sample from the file and the treename given

 clear the tree belonging to this sample
 is called upon returning all tree tokens

 retrieves the tree from the file to store it in the sample

 promote the tree pointer to some friends
TQSampleFolderIterator itr(this->fFriends);

 retract a tree (and TEvent) pointer from friends
TQSampleFolderIterator itr(this->fFriends);
while(itr.hasNext()){
  TQSample* myFriend = dynamic_cast<TQSample*>(itr.readNext());
  if (!myFriend) throw std::runtime_error("Attempt to promote tree to friend which is not of type TQSample. A SampleFolder within a Sample should never happen, check your analysis setup!");

 Request a tree token (TQToken). Return a tree token containing a pointer to
 the TTree object if the tree is accessible, return a null pointer otherwise.
 Use returnTreeToken(...) to return the tree token after you don't need the
 tree anymore. The first request of a tree token triggers reading of the tree
 (opening the ROOT file, in case it is contained in an external file). After
 every tree token was returned, the tree is released (closing the ROOT file,
 in case it is contained in an external file).

 Your code using the tree might look like this:

 /* try to get a tree token *
 treeToken = sample->getTreeToken();

 if (treeToken) {
 /* get the pointer to the tree *
 TTree* tree = (TTree*)treeToken->getContent();
 /* optional: the sample should know who is using the token *
 treeToken->setOwner(this);

 /* <use your tree here> *

 /* return the tree token *
 sample->returnTreeToken(treeToken);
 } else {
 /* for any reason we didn't get a tree
 * token, so we cannot use the tree *
 }

 Request a file token (TQToken). Return a file token containing a pointer to
 the TFile object if it is accessible, return a null pointer otherwise.
 Use returnToken(...) to return the token after you don't need the file anymore.

 Request an event token (TQToken). Return a tree token containing a pointer to
 the TEvent object if the tree is accessible, return a null pointer otherwise.
 Use returnToken(...) to return the token after you don't need the
 TEvent anymore. The first request of a tree token triggers reading of the tree
 (opening the ROOT file, in case it is contained in an external file). After
 every tree token was returned, the tree is released (closing the ROOT file,
 in case it is contained in an external file).

 Return and delete a tree token that is not needed anymore (for
 details check documentation of getTreeToken()).

 Return and delete a tree or event token that is not needed
 anymore

 Set the tree location. Setting a new tree location will fail, if there are
 still unreturned tree tokens. In that case, false is returned, and true other-
 wise.

 A tree may either be contained in this sample it self, or it may be contained
 in an external ROOT file:

 - if the tree is contained in the sample use

 setTreeLocation("<name_of_the_tree>");

 - if the tree is contained in an external ROOT file, use:

 setTreeLocation("<name_of_the_file>:<name_of_the_tree>");

 Please note: the name of the tree is NOT the name of the pointer, but it is
 the name of the object returned by tree->GetName() (or in case of an external
 file, the name of the key).

 Return the number of unreturned tree tokens

 Print a summary of tree tokens

 Return true if the TTree is accessible and false otherwise

 Update the internally stored tree location based on xsp or initializer tags

 Return the tree location

Returns the treeLocation as a const reference
no checks except for empty internal cache are performed.

 retrieve the filename associated with this sample

 retrieve the treename associated with this sample

 add a subsample to this sample
 can only be done if this sample is not already a subsample

 add a copy of yourself as a subsample

 get the subsample matching a given path

 return true if this sample is the direct child of some other sample
 false otherwise

 retrieve the base sample of this sample

 retrieve the file pointer of this sample

 default destructor

 determine if this sample has any sub-samples
try to find a sub sample
for performance reasons we do not use the path parsing version but manualy check for contents of type TQSample

 crawl all samples in otherSF at once, creating friend links between all of them
 returns true if 'this' sample is amongst the processed TQSample instances
 and false otherwise.

 find the friends of this sample folder in some other sample folder