+//-*- Mode: C++ -*-
// @(#) $Id$
#ifndef ALIHLTSYSTEM_H
#define ALIHLTSYSTEM_H
-/* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
- * See cxx source for full Copyright notice */
+//* This file is property of and copyright by the ALICE HLT Project *
+//* ALICE Experiment at CERN, All rights reserved. *
+//* See cxx source for full Copyright notice *
/** @file AliHLTSystem.h
@author Matthias Richter
/**
* @defgroup alihlt_system HLT integration into AliRoot
* This section describes the HLT integration into AliRoot.
+ *
+ * @section alihlt_system_intro General Remarks
+ * The HLT analysis is organized in components which can also be used
+ * in off-line processing. Two different types of off-line applications
+ * can be distinguished:
+ * - AliRoot simulation (AliSimulation)
+ * - AliRoot reconstruction (AliReconstruction)
+ *
+ * The foundation of the off-line applications is a HLT chain described
+ * by the means of AliHLTConfiguration. Special components exist, which
+ * emulate the behavoir of the components of the HLT on-line data
+ * transportation framework. Together with the analysis components, this
+ * allows the full emulation of the behavoir of HLT analysis chain off-line.
+ *
+ * More details how to setup up such a chain can be found:
+ * - The examples page under @ref tut_hltsystem
+ *
+ * @section alihlt_system_simulation AliRoot simulation
+ * HLT has a special role in the normal data flow of simulation and
+ * reconstruction. Since the HLT reconstruction and analysis runs on-line
+ * on the HLT farm, the raw data produced by HLT as a detector contains
+ * already reconstructed events. Consequently, the HLT response has to be
+ * simulated as well as the data of all other detectors.
+ *
+ * Since the detector data is needed, the HLT simulation is run at the
+ * end of AliSimulation.
+ *
+ * As a matter of fact, HLT always reconstructs data, <em><b>HLT simulation
+ * </b></em> means <em><b>HLT reconstruction embedded into AliRoot</b></em>.
+ *
+ * More Details an be found in the module:
+ * - @ref alihlt_aliroot_simulation
+ *
+ * @section alihlt_system_reconstruction AliRoot reconstruction
+ *
+ * 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.
+ *
+ * More Details an be found in the module:
+ * - @ref alihlt_aliroot_reconstruction
+ *
*/
#include "AliHLTLogging.h"
#include <TList.h>
+#include <TString.h>
class AliHLTComponentHandler;
class AliHLTConfiguration;
class AliHLTConfigurationHandler;
class AliHLTTask;
+class AliHLTOUT;
+class AliHLTOUTTask;
+class AliHLTControlTask;
class AliRunLoader;
class AliRawReader;
-class AliESD;
+class AliESDEvent;
+class TObjArray;
+class TStopwatch;
/**
* @class AliHLTSystem
class AliHLTSystem : public AliHLTLogging {
public:
/** default constructor */
- AliHLTSystem();
- /** not a valid copy constructor, defined according to effective C++ style */
- AliHLTSystem(const AliHLTSystem&);
- /** not a valid assignment op, but defined according to effective C++ style */
- AliHLTSystem& operator=(const AliHLTSystem&);
+ AliHLTSystem(AliHLTComponentLogSeverity loglevel=kHLTLogDefault, const char* name="");
/** destructor */
virtual ~AliHLTSystem();
int DeleteConfiguration(AliHLTConfiguration* pConf);
/**
- * Build a task list from a configuration object.
+ * Build a task list
* This method is used to build the tasks from the 'master' configuration
* objects which are added to the HLT system handler. This is an iterative
* process since the task might depend upon other configurations. For each
* method will be called iteratively. Finally, after building all tasks which
* the current one depends on have been created, the task is inserted to the
* list of tasks with the InsertTask method.
+ * @param pConf configuration name/id
+ */
+ int BuildTaskList(const char* pConf);
+
+ /**
+ * Build task list from a configuration object.
+ * This method is kept for backward compatibility. Use the version
+ * with the configuration name.
* @param pConf pointer to configuration to build the task list from
*/
int BuildTaskList(AliHLTConfiguration* pConf);
*/
int InsertTask(AliHLTTask* pTask);
+ /**
+ * Add HLTOUT task to the end of the task list.
+ * If one of the specified chains has output, an AliHLTOUTTask is
+ * added which controls the output. All other chains are removed from the
+ * AliHLTOUTTask input.
+ * @return 0 if no task has been added, 1 if task has been added
+ */
+ int AddHLTOUTTask(const char* chains);
+
+ AliHLTOUTTask* GetHLTOUTTask() const {return fpHLTOUTTask;}
+
/**
* Find a task with an id.
* @param id CONFIGURATION id (not a COMPONENT id!)
* Run the task list.
* The method checks whether the task list has already been build. If not,
* or the configuration list has been changed, the @ref BuildTaskList
- * method is scalled
+ * method is called. <br>
* All tasks of the list will be subsequently processed for each event.
+ * The system can remain started if the \em bStop parameter is 0. In that
+ * case the system just waits for the next event. A specific call with
+ * nofEvents==0 is needed to execute the stop sequence.
* @param iNofEvents number of events
+ * @param bStop stop the chain after processing
* @return number of reconstructed events, neg error code if failed
*/
- int Run(Int_t iNofEvents=1);
+ int Run(Int_t iNofEvents=1, int bStop=1);
/**
* Init all tasks from the list.
*/
int InitTasks();
+ /**
+ * Init the stopwatches for all tasks.
+ * @param pStopwatches object array of stopwatches, for types
+ * @see AliHLTComponent::AliHLTStopwatchType
+ * @return neg error code if failed
+ */
+ int InitBenchmarking(TObjArray* pStopwatches);
+
+ /**
+ * Stop the stopwatches for all tasks.
+ * @param pStopwatches object array of stopwatches, for types
+ * @see AliHLTComponent::AliHLTStopwatchType
+ * @return neg error code if failed
+ */
+ int PauseBenchmarking(TObjArray* pStopwatches) const;
+
+ /**
+ * Continue the stopwatches for all tasks.
+ * @param pStopwatches object array of stopwatches, for types
+ * @see AliHLTComponent::AliHLTStopwatchType
+ * @return neg error code if failed
+ */
+ int ResumeBenchmarking(TObjArray* pStopwatches) const;
+
+ /**
+ * Print benchmarking summary.
+ * Optionak: clean up stop watches.
+ * @param pStopwatches object array of stopwatches
+ * @param bClean delete stop watches if 1
+ * @return neg error code if failed
+ */
+ int PrintBenchmarking(TObjArray* pStopwatches, int bClean=0) const;
+
/**
* Start task list.
* The @ref AliHLTTask::StartRun method is called for each task, the
*/
int StopTasks();
+ /**
+ * Send a control event trough the chain.
+ * All data sources in the chain are switched to publish a control event like
+ * SOR or EOR. The event is propagated in the same way as a normal event.
+ * @param dt type of the event
+ */
+ int SendControlEvent(AliHLTComponentDataType dt);
+
/**
* De-init all tasks from the list.
* The @ref AliHLTTask::Deinit method is called for each task, the components
*/
int DeinitTasks();
+ /**
+ * Cleanup all internal objects from HLTOUT processing.
+ */
+ int CleanHLTOUT();
+
/**
* The memory allocation function for components.
* This function is part of the running environment of the components.
static void* AllocMemory( void* param, unsigned long size );
/**
- * Reconstruction inside AliRoot.
- * To be called by the AliHLTReconstructor plugin during the
- * LocalReconstruction step of the AliRoot reconstruction. The latter means
- * that all events are reconstructed at once, the event loop is internally
- * implemented. In contrast to that, the FillESD method is called event by
- * event. This requires an 'ESD' recorder at the end of the HLT chain, in
- * order to have the reconstructed events available for the FillESD loop.
+ * AliRoot embedded reconstruction.
+ * Main entry point to execute the HLT reconstruction from AliRoot. Called
+ * either by the AliHLTReconstructor plugin during AliRoot reconstruction
+ * of raw data, or AliHLTSimulation during simulation of data.
+ *
+ * The two cases are distinguished by the availablility of the run loader
+ * and raw reader.
+ * - AliRoot simulation: run loader is available and is propagated to the
+ * module agents (AliHLTModuleAgent) to generate the corresponding
+ * configurations and chains, and to the AliHLTOfflineSource components.
+ * - AliRoot reconstruction: raw reader is available and is propagated to
+ * the agents and AliHLTOfflineSource components.
+ *
+ * The system remains started after the processing and just waits for the
+ * next event. A specific call with nofEvents==0 is needed to execute the
+ * stop sequence.
+ *
* The 'runLoader' and 'rawReader' parameters are set to all active
* AliHLTOfflineDataSource's and the HLT chain is processed for the given
* number of events. If the rawReader is NULL, reconstruction is done on
* Fill ESD for one event.
* To be called by the AliHLTReconstructor plugin during the event loop
* and FillESD method of the AliRoot reconstruction.
+ *
+ * The method is most likely deprecated as the scheme has been slightly
+ * changed. The ESD is filled by the HLTOUT handlers u=implemented by the
+ * HLT modules rather than by components within the reconstruction chain.
+ * Still, HLT reconstruction chains can be run during the AliRoot
+ * reconstruction, data produced by such chains is automatically added
+ * to the HLTOUT stream in order to be equivalent to the online HLT.
+ * The HLTOUT is processed during AliReconstruction at the end of the
+ * HLT event processing, literally during the FillESD method of the AliRoot
+ * reconstruction interface. The HLT module must implement HLTOUT handlers
+ * and provide those through the module agent.
+ *
* This method is called on event basis, and thus must copy the previously
* reconstructed data of the event from the 'ESD' recorder. The FillESD
* method of all active AliHLTOfflineDataSink's is called.
* processing counter and is not related to the nature/
* origin of the event
* @param runLoader the AliRoot runloader
- * @param esd an AliESD instance
+ * @param esd an AliESDEvent instance
* @return neg. error code if failed
*/
- int FillESD(int eventNo, AliRunLoader* runLoader, AliESD* esd);
+ int FillESD(int eventNo, AliRunLoader* runLoader, AliESDEvent* esd);
+
+ /**
+ * Process the HLTOUT data.
+ */
+ int ProcessHLTOUT(AliHLTOUT* pHLTOUT, AliESDEvent* esd);
+
+ /**
+ * Process all kChain-type data blocks of the HLTOUT data.
+ * The function is involed from ProcessHLTOUT as the first step in
+ * the processing.
+ */
+ int ProcessHLTOUTkChain(AliHLTOUT* pHLTOUT);
/**
* Load component libraries.
*/
int LoadComponentLibraries(const char* libs);
+ /**
+ * Find a symbol in a dynamically loaded library.
+ * @param library library
+ * @param symbol the symbol to find
+ * @return void pointer to function
+ */
+ void* FindDynamicSymbol(const char* library, const char* symbol);
+
/**
* Prepare the HLT system for running.
* - module agents are requested to register configurations
* - task lists are built from the top configurations of the modules
+ *
+ * @param rawReader instance of the raw reader or NULL
+ * @param runloader optional instance of the run loader
+ * @return neg. error code if failed <br>
+ * -EBUSY system is in kRunning state <br>
+ */
+ int Configure(AliRawReader* rawReader, AliRunLoader* runloader=NULL);
+
+ /**
+ * Old method kept for backward compatibilty.
+ *
+ * @param runloader optional instance of the run loader
* @return neg. error code if failed <br>
* -EBUSY system is in kRunning state <br>
*/
int Configure(AliRunLoader* runloader=NULL);
+ /**
+ * Scan options and load component libraries.
+ * The options consist of blank separated tokens. Libraries can be just
+ * specified by their name. Further options
+ * <!-- NOTE: ignore the \li. <i> and </i>: it's just doxygen formatting -->
+ * \li loglevel=<i>level</i> <br>
+ * logging level for this processing
+ * \li frameworklog=<i>level</i> <br>
+ * logging level for framework classes
+ * \li alilog=off
+ * disable redirection of log messages to AliLog class
+ * \li config=<i>macro</i>
+ * configuration macro
+ * \li chains=<i>configuration</i>
+ * comma separated list of configurations to be run during local
+ * reconstruction
+ * \li libmode=<i>static,dynamic(default)</i>
+ * libraries are persistent if loaded in mode <i>static</i>, i.e. they
+ * can't be unloaded
+ */
+ int ScanOptions(const char* options);
+
/**
* Reset the HLT system.
* Reset is not possible while the system is in running state.
* Load the configurations specified by the module agents.
* The runLoader is passed to the agent and allows configuration
* selection.
+ * @param rawReader instance of the raw reader or NULL
+ * @param runloader optional instance of the run loader
* @return neg. error code if failed
*/
- int LoadConfigurations(AliRunLoader* runloader=NULL);
+ int LoadConfigurations(AliRawReader* rawReader, AliRunLoader* runloader=NULL);
/**
* Get the top configurations of all agents and build the task lists.
+ * @param rawReader instance of the raw reader or NULL
+ * @param runloader optional instance of the run loader
* @return neg. error code if failed
*/
- int BuildTaskListsFromTopConfigurations(AliRunLoader* runloader=NULL);
+ int BuildTaskListsFromReconstructionChains(AliRawReader* rawReader,
+ AliRunLoader* runloader=NULL);
- enum AliHLTSystemState_t {
+ enum AliHLTSystemState {
kUninitialized = 0x0,
kLibrariesLoaded = 0x1,
kConfigurationLoaded = 0x2,
kTaskListCreated = 0x4,
kReady = 0x7,
- kRunning = 0x8,
+ kStarted = 0x8,
+ kRunning = 0x10,
kError = 0x1000
};
/**
* Check status of the system.
- * @param flag AliHLTSystemState_t value to check for
+ * @param flag AliHLTSystemState value to check for
* @return 1 if set, 0 if not
*/
int CheckStatus(int flag);
/**
* Get the current status.
- * @return status flags of @ref AliHLTSystemState_t
+ * @return status flags of @ref AliHLTSystemState
*/
int GetStatusFlags();
+ /**
+ * Set logging level for framework classes.
+ * This sets the local logging level of this instance and all subsequent
+ * framework classes to \em level.
+ * @param level local logging level for the framework classes
+ */
+ void SetFrameworkLog(AliHLTComponentLogSeverity level);
+
protected:
private:
+ /** copy constructor prohibited */
+ AliHLTSystem(const AliHLTSystem&);
+ /** assignment operator prohibited */
+ AliHLTSystem& operator=(const AliHLTSystem&);
+
/**
* Set status flags.
*/
/** state of the object */
int fState; // see above
- private:
- ClassDef(AliHLTSystem, 2);
+ /** chains to be run during reconstruction */
+ TString fChains; //!transient
+
+ /** array of stopwatches */
+ TObjArray* fStopwatches; //!transient
+
+ /** number of events processed in total */
+ int fEventCount; //!transient
+
+ /** number of events processed successfully */
+ int fGoodEvents; //!transient
+
+ /** array of default libraries */
+ static const char* fgkHLTDefaultLibs[]; //!transient
+
+ /** active kChain handlers (AliHLTOUT::AliHLTOUTHandlerListEntryVector*) */
+ void* fpChainHandlers; //!transient
+
+ /** active kEsd handlers (AliHLTOUT::AliHLTOUTHandlerListEntryVector*) */
+ void* fpEsdHandlers; //!transient
+
+ /** active kProprietary handlers (AliHLTOUT::AliHLTOUTHandlerListEntryVector*) */
+ void* fpProprietaryHandlers; //!transient
+
+ /** active HLTOUT task for the reconstruction */
+ AliHLTOUTTask* fpHLTOUTTask; //!transient
+
+ /** special task to publish the control events */
+ AliHLTControlTask* fpControlTask; //!transient
+
+ /** name of this system instance */
+ TString fName; //!transient
+
+ ClassDef(AliHLTSystem, 12);
};
-#endif
+#endif