4 #ifndef ALIHLTVZEROAGENT_H
5 #define ALIHLTVZEROAGENT_H
7 /* This file is property of and copyright by the ALICE HLT Project *
8 * ALICE Experiment at CERN, All rights reserved. *
9 * See cxx source for full Copyright notice */
11 /** @file AliHLTVZEROAgent.h
12 @author Jochen Thaeder <jochen@thaeder.de>
13 @brief Agent of the libAliHLTVZERO library
16 // see below for class documentation
18 // refer to README to build package
20 // visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
22 #include "AliHLTModuleAgent.h"
25 * @class AliHLTVZEROAgent
26 * This is the agent for the AliHLTVZERO library.<br>
28 * The sample agent implements all interface function provided by @ref
30 * - CreateConfigurations() <br>
31 * The method gets an instance of the AliHLTConfigurationHanler to add
32 * configurations, e.g.
34 * handler->CreateConfiguration("my-puplisher" , "FilePublisher", NULL , "data.bin");
36 * handler->CreateConfiguration("my-analysis-chain" , "FileWriter", "my-processor" , "my arguments");
38 * - GetReconstructionChains() <br>
39 * returns a string of blank separated configurations to be run during
40 * local event reconstruction.
42 * return "my-data-sink my-analysis-chain";
44 * - GetRequiredComponentLibraries() <br>
45 * returns a string of blank separated libraries which have to be loaded
46 * in addition in order to load all required components. <br>
47 * @note Not the right place for library dependencies.
49 * return "libAliHLTUtil.so";
51 * - RegisterComponents() <br>
52 * registers the components: AliHLTDummyComponent, AliHLTSampleComponent1,
53 * AliHLTSampleComponent2, and AliHLTSampleMonitoringComponent<br>
54 * - GetHandlerDescription() <br>
55 * Handles HLTOUT data blocks of type {DDL_RAW,SMPL}
57 * if (dt==(kAliHLTDataTypeDDLRaw|kAliHLTDataOriginSample)) {
58 * desc=AliHLTOUTHandlerDesc(kRawReader, dt, GetModuleId());
62 * - GetOutputHandler() <br>
63 * Returns handler AliHLTOUTHandlerEquId for HLTOUT data blocks of
66 * if (dt==(kAliHLTDataTypeDDLRaw|kAliHLTDataOriginSample)) {
67 * return new AliHLTOUTHandlerEquId;
70 * - DeleteOutputHandler() <br>
71 * Deletes the output handler. In this case there is no special handling
74 * In order to hook the sample library up to the HLT system on global object
75 * @ref gAliHLTVZEROAgent of the agent is defined in the source code.
77 * @ingroup alihlt_system
79 class AliHLTVZEROAgent : public AliHLTModuleAgent {
83 * ---------------------------------------------------------------------------------
84 * Constructor / Destructor
85 * ---------------------------------------------------------------------------------
89 * standard constructor. The agent is automatically registered in the
90 * global agent manager
95 virtual ~AliHLTVZEROAgent();
98 * ---------------------------------------------------------------------------------
99 * Public functions to implement AliHLTModuleAgent's interface.
100 * These functions are required for the registration process
101 * ---------------------------------------------------------------------------------
105 * Register all configurations belonging to the VZERO library with the
106 * AliHLTConfigurationHandler.
107 * @param handler [in] the configuration handler
108 * @param rawReader [in] AliRoot RawReader instance
109 * @param runloader [in] AliRoot runloader
110 * @return neg. error code if failed
112 Int_t CreateConfigurations(AliHLTConfigurationHandler* handler,
113 AliRawReader* rawReader=NULL,
114 AliRunLoader* runloader=NULL) const;
117 * Get the top configurations for local event reconstruction.
118 * A top configuration describes a processing chain. It can simply be
119 * described by the last configuration(s) in the chain.
120 * @param rawReader [in] AliRoot RawReader instance
121 * @param runloader [in] AliRoot runloader
122 * @return string containing the top configurations separated by blanks
124 const Char_t* GetReconstructionChains(AliRawReader* rawReader=NULL,
125 AliRunLoader* runloader=NULL) const;
128 * Component libraries which the configurations of this agent depend on.
129 * @return list of component libraries as a blank-separated string.
131 const Char_t* GetRequiredComponentLibraries() const;
134 * Register components for the AliHLTVZERO library.
135 * @param pHandler [in] instance of the component handler
137 Int_t RegisterComponents(AliHLTComponentHandler* pHandler) const;
139 /** interface function, see @ref AliHLTModuleAgent for description */
140 Int_t GetHandlerDescription(AliHLTComponentDataType dt, AliHLTUInt32_t spec,
141 AliHLTOUTHandlerDesc& desc) const;
143 /** interface function, see @ref AliHLTModuleAgent for description */
144 AliHLTOUTHandler* GetOutputHandler(AliHLTComponentDataType dt, AliHLTUInt32_t spec);
146 /** interface function, see @ref AliHLTModuleAgent for description */
147 Int_t DeleteOutputHandler(AliHLTOUTHandler* pInstance);
149 /** interface function, see @ref AliHLTModuleAgent for description */
150 AliHLTModulePreprocessor* GetPreprocessor();
154 ///////////////////////////////////////////////////////////////////////////////////
159 * ---------------------------------------------------------------------------------
160 * Private functions to implement AliHLTModuleAgent's interface.
161 * These functions provide initialization as well as the actual processing
162 * capabilities of the component.
163 * ---------------------------------------------------------------------------------
166 /** copy constructor prohibited */
167 AliHLTVZEROAgent(const AliHLTVZEROAgent&);
169 /** assignment operator prohibited */
170 AliHLTVZEROAgent& operator=(const AliHLTVZEROAgent&);
173 * ---------------------------------------------------------------------------------
175 * ---------------------------------------------------------------------------------
178 /** ROOT specific member definition */
179 ClassDef(AliHLTVZEROAgent, 0);