bug fix in monitoring histo. Change data format from short to int

[u/mrichter/AliRoot.git] / HLT / SampleLib / AliHLTAgentSample.h

diff --git a/HLT/SampleLib/AliHLTAgentSample.h b/HLT/SampleLib/AliHLTAgentSample.h
index cb5ffabb1f57e1f620f6cb7c2ac7079152bd9733..0e73735d0fa1f856d09aadd49aaf0f01bd315ae2 100644 (file)
--- a/HLT/SampleLib/AliHLTAgentSample.h
+++ b/HLT/SampleLib/AliHLTAgentSample.h
@@ -15,8 +15,60 @@
 
 /**
  * @class AliHLTAgentSample
- * This is the agent for the AliHLTSample library.
+ * This is the agent for the AliHLTSample library.<br>
+ * The AliHLTSample library illustrates usage of the HLT framework. The
+ * agent provides information on the features of the sample components
+ * and the configuration which should be run during AliRoot reconstruction.
  *
+ * The sample agent implements all interface function provided by @ref
+ * AliHLTModuleAgent :
+ * - CreateConfigurations() <br>
+ *   The method gets an instance of the AliHLTConfigurationHanler to add
+ *   configurations, e.g. 
+ *   <pre>
+ *   handler->CreateConfiguration("my-puplisher"  , "FilePublisher", NULL , "data.bin");
+ *   ...
+ *   handler->CreateConfiguration("my-analysis-chain"  , "FileWriter", "my-processor" , "my arguments");
+ *   </pre>
+ * - GetReconstructionChains() <br>
+ *   returns a string of blank separated configurations to be run during
+ *   local event reconstruction.
+ *   <pre>
+ *   return "my-data-sink my-analysis-chain";
+ *   </pre>
+ * - GetRequiredComponentLibraries() <br>
+ *   returns a string of blank separated libraries which have to be loaded
+ *   in addition in order to load all required components. <br>
+ *   @note Not the right place for library dependencies.
+ *   <pre>
+ *   return "libAliHLTUtil.so";
+ *   </pre>
+ * - RegisterComponents() <br>
+ *   registers the components: AliHLTDummyComponent, AliHLTSampleComponent1,
+ *   AliHLTSampleComponent2, and AliHLTSampleMonitoringComponent<br>
+ * - GetHandlerDescription() <br>
+ *   Handles HLTOUT data blocks of type {DDL_RAW,SMPL}
+ *   <pre>
+ *   if (dt==(kAliHLTDataTypeDDLRaw|kAliHLTDataOriginSample)) {
+ *     desc=AliHLTOUTHandlerDesc(kRawReader, dt, GetModuleId());
+ *     return 1;
+ *   }
+ *   </pre>
+ * - GetOutputHandler() <br>
+ *   Returns handler AliHLTOUTHandlerEquId for HLTOUT data blocks of
+ *   type {DDL_RAW,SMPL}
+ *   <pre>
+ *   if (dt==(kAliHLTDataTypeDDLRaw|kAliHLTDataOriginSample)) {
+ *     return new AliHLTOUTHandlerEquId;
+ *   }
+ *   </pre>
+ * - DeleteOutputHandler() <br>
+ *   Deletes the output handler. In this case there is no special handling
+ *   needed.
+ *
+ * In order to hook the sample library up to the HLT system on global object
+ * @ref gAliHLTAgentSample of the agent is defined in the source code.
+ * 
  * @ingroup alihlt_system
  */
 class AliHLTAgentSample : public AliHLTModuleAgent {
@@ -30,27 +82,31 @@ class AliHLTAgentSample : public AliHLTModuleAgent {
   virtual ~AliHLTAgentSample();
 
   /**
-   * Register all configurations belonging to this module with the
+   * Register all configurations belonging to the sample library with the
    * AliHLTConfigurationHandler. The agent can adapt the configurations
    * to be registered to the current AliRoot setup by checking the
    * runloader.
-   * @param handler      the configuration handler
-   * @param runloader    AliRoot runloader
+   * @param handler   [in] the configuration handler
+   * @param rawReader [in] AliRoot RawReader instance 
+   * @param runloader [in] AliRoot runloader
    * @return neg. error code if failed
    */
   int CreateConfigurations(AliHLTConfigurationHandler* handler,
+                          AliRawReader* rawReader=NULL,
                           AliRunLoader* runloader=NULL) const;
 
   /**
-   * Get the top configurations belonging to this module.
+   * Get the top configurations for local event reconstruction.
    * A top configuration describes a processing chain. It can simply be
    * described by the last configuration(s) in the chain. 
    * The agent can adapt the configurations to be registered to the current
    * AliRoot setup by checking the runloader.
-   * @param runloader    AliRoot runloader
-   * @return number of configurations, neg. error code if failed
+   * @param rawReader [in] AliRoot RawReader instance 
+   * @param runloader [in] AliRoot runloader
+   * @return string containing the top configurations separated by blanks
    */
-  const char* GetTopConfigurations(AliRunLoader* runloader=NULL) const;
+  const char* GetReconstructionChains(AliRawReader* rawReader=NULL,
+                                     AliRunLoader* runloader=NULL) const;
 
   /**
    * Component libraries which the configurations of this agent depend on.
@@ -58,10 +114,31 @@ class AliHLTAgentSample : public AliHLTModuleAgent {
    */
   const char* GetRequiredComponentLibraries() const;
 
+  /**
+   * Register components for the AliHLTSample library.
+   * @param pHandler  [in] instance of the component handler          
+   */
+  int RegisterComponents(AliHLTComponentHandler* pHandler) const;
+
+  int GetHandlerDescription(AliHLTComponentDataType dt,
+                           AliHLTUInt32_t spec,
+                           AliHLTOUTHandlerDesc& desc) const;
+  AliHLTOUTHandler* GetOutputHandler(AliHLTComponentDataType dt,
+                                    AliHLTUInt32_t spec);
+  int DeleteOutputHandler(AliHLTOUTHandler* pInstance);
+
+  AliHLTModulePreprocessor* GetPreprocessor();
  protected:
 
  private:
-  ClassDef(AliHLTAgentSample, 0);
+  /** file name of the generated test data*/
+  static const char* fgkAliHLTAgentSampleData;                      //!transient
+
+  /** file name of the output file */
+  static const char* fgkAliHLTAgentSampleOut;                       //!transient
+
+  /** ROOT specific member definition */
+  ClassDef(AliHLTAgentSample, 1);
 };
 
 #endif