]> git.uio.no Git - u/mrichter/AliRoot.git/blobdiff - HLT/rec/AliHLTReconstructor.h
code cleanup, delete some backward compatibility code and call functions of AliHLTSys...
[u/mrichter/AliRoot.git] / HLT / rec / AliHLTReconstructor.h
index 8c518a2618986314772266041a0a74f36e3b9404..8adc7c181a4d1d030c05f012a033e3aac36179d3 100644 (file)
@@ -1,4 +1,5 @@
-// @(#) $Id$
+//-*- Mode: C++ -*-
+// $Id$
 
 #ifndef ALIHLTRECONSTRUCTOR_H
 #define ALIHLTRECONSTRUCTOR_H
@@ -6,40 +7,52 @@
 //* ALICE Experiment at CERN, All rights reserved.                         *
 //* See cxx source for full Copyright notice                               *
 
-/** @file   AliHLTReconstructor.h
-    @author Matthias Richter
-    @date   
-    @brief  Binding class for HLT simulation in AliRoot
-*/
+//  @file   AliHLTReconstructor.h
+//  @author Matthias Richter
+//  @date   
+//  @brief  Binding class for HLT reconstruction in AliRoot
+//          Implements bot the interface to run HLT chains embedded into
+//          AliReconstruction and the unpacking and treatment of HLTOUT
 
 #include "AliReconstructor.h"
-#include "AliHLTReconstructorBase.h"
 
 class AliHLTSystem;
 class AliRawReader;
 class AliESDEvent;
 class AliHLTOUT;
 class AliHLTEsdManager;
+class AliHLTPluginBase;
 /**
  * @defgroup alihlt_aliroot_reconstruction AliRoot reconstruction.
  *
+ * @section alihlt_aliroot_reconstruction_intro General Remarks
  * Like all other ALICE detectors, HLT utilizes the AliReconstruction interface
  * to implement a plugin for the AliRoot reconstruction. The reconstructor can be
  * used to
- * - run HLT analysis chains in the AliRoot reconstruction <br>
- *   This option is mainly intended for the development and debugging cycle. HLT
- *   chains can be defined by means of AliHLTConfiguration and can be run either
- *   stand-alone or embedded into the AliReconstruction cycle.
- * - run the default analysis chains <br>
- *   HLT modules can define default analysis chains to be run during AliRoot
- *   reconstruction.
- * - handle the HLTOUT data<br>
- *   The HLT output stream contains multiple data blocks produced by the various
- *   components of the HLT chain. Each block might need different and even
- *   detector specific processing, like e.g. the processing of ESD objects or the
- *   handling of compressed data.
+ * -# run HLT analysis chains in the AliRoot reconstruction <br>
+ *    This option is mainly intended for the <em>development and debugging cycle</em>. 
+ *    HLT chains can be defined by means of AliHLTConfiguration and can be run either
+ *    stand-alone or embedded into the AliReconstruction cycle.
+ * -# run the default analysis chains <br>
+ *    HLT modules can define default analysis chains to be run during AliRoot
+ *    reconstruction.
+ * -# handle the HLTOUT data<br>
+ *    The HLT output stream contains multiple data blocks produced by the various
+ *    components of the HLT chain. Each block might need different and even
+ *    detector specific processing, like e.g. the processing of ESD objects or the
+ *    handling of compressed data.
+ *
+ * @section alihlt_aliroot_reconstruction_steering Steering
+ * The AliHLTReconstructor provides the main interface for the reconstruction. 
+ * The handling of the HLTOUT data is described in AliRawReaderHLT.
+ *
+ * @section alihlt_aliroot_reconstruction_examples Examples
+ * @subsection alihlt_aliroot_reconstruction_examples_reco Run chains
+ * - @ref tut_reconstruction
+ *
+ * @subsection alihlt_aliroot_reconstruction_examples_hltout Handle HLTOUT
+ * - @ref tut_alirawreaderhlt
  *
- * The AliHLTReconstructor provides the main interface for this group.
  * @ingroup alihlt_system
  */
 
@@ -72,6 +85,12 @@ class AliHLTEsdManager;
  *     level can be a hex number encoding the @ref AliHLTComponentLogSeverity
  * \li alilog=off <br>
  *     disables the logging of HLT log messages through <tt>AliLog</tt> <br>
+ * \li ignore-hltout <br>
+ *     ignore data from the HLTOUT data links
+ * \li ignore-ctp <br>
+ *     ignore CTP trigger setup
+ * \li esdmanager=<option> <br>
+ *     options passed to the AliHLTEsdManager
  *
  * For further information on the AliRoot reconstruction refer to the AliRoot
  * documentation, namely <tt>AliReconstruction</tt>.
@@ -156,6 +175,16 @@ class AliHLTEsdManager;
  * stored to files.
  *
  * @section sec_alihltreconstructor_helper Tools and helper functions
+ * Some helper functions of the AliHLTReconstruction can be used in stand-alone
+ * mode. Remember to Init() the reconstructor.
+ * <pre>
+ * {
+ * gSystem->Load("libHLTrec.so");
+ * AliHLTReconstructor rec;
+ * rec.Init();
+ * // do something
+ * }
+ * </pre>
  * @subsection sec_alihltreconstructor_hltout_standalone Stand-alone HLTOUT processing
  * - HLTOUT processing from a digit file:
  * <pre>
@@ -169,7 +198,7 @@ class AliHLTEsdManager;
  * @ingroup alihlt_aliroot_reconstruction
  * @section sec_alihltreconstructor_members Class members
  */
-class AliHLTReconstructor: public AliReconstructor, public AliHLTReconstructorBase {
+class AliHLTReconstructor: public AliReconstructor {
 public:
   /** standard constructor */
   AliHLTReconstructor();
@@ -184,6 +213,23 @@ public:
   /** init the reconstructor */
   void Init(const char* options);
 
+  /**
+   * Init streamer infos for the relevent classes to be extracted from HLT raw
+   * data payload. Reads the info from HLT/Calib/StreamerInfo
+   */
+  int InitStreamerInfos();
+
+  /**
+   * Init streamer infos for the relevant classes to be extracted from HLT raw
+   * data payload.
+   */
+  int InitStreamerInfos(TObjArray* pSchemas) const;
+
+  /**
+   * Build the CTP_TRIGGER_CLASSES string from CTP trigger configuration
+   */
+  int BuildCTPTriggerClassString(TString& triggerclasses) const;
+
   /**
    * This Reconstructor function is not applicable for the AliHLTReconstructor
    * as it gets a detector specific digits tree. But HLT processes all detectors.
@@ -226,7 +272,7 @@ public:
    * processed and may add additional data to the HLTOUT object. This data is then
    * treated in the same way.
    */
-  void ProcessHLTOUT(AliHLTOUT* pHLTOUT, AliESDEvent* esd) const;
+  void ProcessHLTOUT(AliHLTOUT* pHLTOUT, AliESDEvent* esd, bool bVerbose=false) const;
 
   /**
    * Process HLTOUT data.
@@ -255,19 +301,30 @@ public:
    */
   void PrintHLTOUTContent(AliHLTOUT* pHLTOUT) const;
 
+  enum {
+    /// ignore the blocks from the HLTOUT payload
+    kAliHLTReconstructorIgnoreHLTOUT = 0x1,
+    kAliHLTReconstructorIgnoreCTP = 0x2,
+    kAliHLTReconstructorLastFlag
+  };
+
 private:
   /** copy constructor prohibited */
   AliHLTReconstructor(const AliHLTReconstructor& src);
   /** assignment operator prohibited */
   AliHLTReconstructor& operator=(const AliHLTReconstructor& src);
 
-  /** function pointer: processing of HLTOUT data */
-  void* fFctProcessHLTOUT; //!transient
-
   /** ESD manger instance for this reconstruction */
   AliHLTEsdManager* fpEsdManager; //!transient
 
-  ClassDef(AliHLTReconstructor, 5)   // class for the HLT reconstruction
+  /** base class for AliRoot HLT plugins */
+  AliHLTPluginBase* fpPluginBase;                                     //!transient
+
+  UInt_t fFlags; //! transient
+
+  static const char* fgkCalibStreamerInfoEntry; //! OCDB path
+
+  ClassDef(AliHLTReconstructor, 8)   // class for the HLT reconstruction
 
 };