class HParticleCand: public HVirtualCand

_HADES_CLASS_DESCRIPTION



 HParticleCand

 In this container matched hits from all detectors are stored.
 The class does not define the algorithm how the matching is done.
 This is defined in HMetaMatchF2 (coarse matching) and HParticleCandFiller.


 Track Cleaner flags
 To clean the ParticleCand objects from unwanted fakes
 the object carries a bitfield (32 bit Int_t). The different
 qualitiy criteria can be used to select the best reconstructed
 candidate in the case of multiple use of single detector hits.
 The single bit numbers are defined by enum eFlagBits (see hparticledef.h)

  The selection of tracks and setting of the corresponding flags is performed
  by HParticleCandCleaner and HParticleCandSorter classes (see the documentation).

  For example void  setFlagBit(HParticle::kIsDoubleRICH) sets the bit flag that
  the RICH hit has been used in more than one HParticleCand object.
  Correspondingly one can ask for the flag with Bool_t isFlagBit(HParticle::kIsDoubleRICH)
  void   setFlagBit(Int_t bit) and  Bool_t isFlagBit(Int_t bit) works for the bitnumber (0-31) specified
  manually (if one knows what one is doing....)
  void   setFlagBit   (eFlagBits bit)
  void   unsetFlagBit (eFlagBits bit)
  Bool_t isFlagBit    (eFlagBits bit)
  void   setFlagBit   (Int_t bit);
  void   unsetFlagBit (Int_t bit);
  Bool_t isFlagBit    (Int_t bit);
  void   setFlagBitByValue(eFlagBits bit, Bool_t val) sets/unsets bit depending on val
  void   setFlagBitByValue(Int_t     bit, Bool_t val) sets/unsets bit depending on val
  Bool_t isFlagDoubleHit ()           check all Double_t hits flags simultanously (false if none set)
  Bool_t isFlagAllBestHit()           check all best hit flags simultanously    (true if all are set)
  Int_t  getDoubleHitsLeptons() returns the 4 bit Double_t hit word as Int_t
  Int_t  getDoubleHitsHadrons() returns the 3 bit Double_t hit word (excluding RICH) as Int_t
  Bool_t isFlagNoBestHit ()           check all best hit flags simultanously    (true if none set)
  Int_t  getFlagField()               do what you want with flags field
  Bool_t isFlagAND(Int_t num,Int_t fl, ...) check all flags in argument simultanously (false if none set)
  Bool_t isFlagOR(Int_t num,Int_t fl, ...)  check all flags in argument simultanously (true if any set)
  void   printFlags(TString comment="") prints all flags in binary representation.
  void   printInfo()                    prints indices of detector hits + quality criteria + flags

  The function
  Bool_t select(Bool_t (*function)(HParticleCand* ))  { return  (*function)(this); }
  taking a pointer to function with argument HParticleCand* returning a Bool_t allows
  todo complex selection on the HParticleCand object as one has
  full access to all members of HParticleCand inside the test function.
  The function pointer can be a pointer to a global function or member function
  of an Object for example:

  Bool_t test(HParticleCand* cand){               // global function
           if ( put all selection criteria here ) return kTRUE;
           else                                   return kFALSE;
  } or

  static Bool_t dummy::test(HParticleCand* cand){   // member function of object dummy
                                                    // needs to be declared static !
           if ( put all selection criteria here ) return kTRUE;
           else                                   return kFALSE;
  }
  would be called in the code like

  dummy d;
  HParticleCand* p= new HParticleCand() // just to get an object
  p->select(test))        // global function
  p->select(dummy::test)) // member function of object dummy (static call without object creation)
  p->select(d.test))      // member function of real object dummy