From: aszostak Date: Tue, 10 Nov 2009 19:21:49 +0000 (+0000) Subject: Improving documentation and macros. X-Git-Url: http://git.uio.no/git/?p=u%2Fmrichter%2FAliRoot.git;a=commitdiff_plain;h=1d8ae082c8d76a35d632b33f4ea7889fac007ecb Improving documentation and macros. Fixing up svn Id log tags. Removing obsolete files. --- diff --git a/HLT/MUON/AliHLTMUONChannelsBlockStruct.cxx b/HLT/MUON/AliHLTMUONChannelsBlockStruct.cxx index 46248858bbb..c2ef4ad726c 100644 --- a/HLT/MUON/AliHLTMUONChannelsBlockStruct.cxx +++ b/HLT/MUON/AliHLTMUONChannelsBlockStruct.cxx @@ -13,7 +13,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONChannelsBlockStruct.cxx diff --git a/HLT/MUON/AliHLTMUONChannelsBlockStruct.h b/HLT/MUON/AliHLTMUONChannelsBlockStruct.h index 7a4303f4b5f..eaba97165e6 100644 --- a/HLT/MUON/AliHLTMUONChannelsBlockStruct.h +++ b/HLT/MUON/AliHLTMUONChannelsBlockStruct.h @@ -3,7 +3,7 @@ /* Copyright(c) 1998-2007, ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONChannelsBlockStruct.h diff --git a/HLT/MUON/AliHLTMUONClustersBlockStruct.cxx b/HLT/MUON/AliHLTMUONClustersBlockStruct.cxx index 8ee629eb217..f61f61d37fe 100644 --- a/HLT/MUON/AliHLTMUONClustersBlockStruct.cxx +++ b/HLT/MUON/AliHLTMUONClustersBlockStruct.cxx @@ -13,7 +13,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONClustersBlockStruct.cxx diff --git a/HLT/MUON/AliHLTMUONClustersBlockStruct.h b/HLT/MUON/AliHLTMUONClustersBlockStruct.h index 35266e1ea82..cc61b544338 100644 --- a/HLT/MUON/AliHLTMUONClustersBlockStruct.h +++ b/HLT/MUON/AliHLTMUONClustersBlockStruct.h @@ -3,7 +3,7 @@ /* Copyright(c) 1998-2007, ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONClustersBlockStruct.h diff --git a/HLT/MUON/AliHLTMUONConstants.cxx b/HLT/MUON/AliHLTMUONConstants.cxx index 722f7493e21..ca4eaaf2298 100644 --- a/HLT/MUON/AliHLTMUONConstants.cxx +++ b/HLT/MUON/AliHLTMUONConstants.cxx @@ -1,5 +1,5 @@ /************************************************************************** - * This file is property of and copyright by the ALICE HLT Project * + * This file is property of and copyright by the ALICE HLT Project * * All rights reserved. * * * * Primary Authors: * @@ -11,11 +11,11 @@ * without fee, provided that the above copyright notice appears in all * * copies and that both the copyright notice and this permission notice * * appear in the supporting documentation. The authors make no claims * - * about the suitability of this software for any purpose. It is * + * about the suitability of this software for any purpose. It is * * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONConstants.cxx diff --git a/HLT/MUON/AliHLTMUONConstants.h b/HLT/MUON/AliHLTMUONConstants.h index 08f283131f1..215a6d3ee65 100644 --- a/HLT/MUON/AliHLTMUONConstants.h +++ b/HLT/MUON/AliHLTMUONConstants.h @@ -17,7 +17,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONConstants.h diff --git a/HLT/MUON/AliHLTMUONCountedList.h b/HLT/MUON/AliHLTMUONCountedList.h index 55e0ca5f1d3..71b0b4d25fd 100644 --- a/HLT/MUON/AliHLTMUONCountedList.h +++ b/HLT/MUON/AliHLTMUONCountedList.h @@ -15,7 +15,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONCountedList.h diff --git a/HLT/MUON/AliHLTMUONDataBlockReader.h b/HLT/MUON/AliHLTMUONDataBlockReader.h index ef39b66d9f0..418acea1b38 100644 --- a/HLT/MUON/AliHLTMUONDataBlockReader.h +++ b/HLT/MUON/AliHLTMUONDataBlockReader.h @@ -15,12 +15,12 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONDataBlockReader.h * @author Artur Szostak - * @date + * @date 19 May 2007 * @brief Definition of a reader class for internal dimuon HLT raw data blocks. */ diff --git a/HLT/MUON/AliHLTMUONDataBlockWriter.h b/HLT/MUON/AliHLTMUONDataBlockWriter.h index c83050231d2..d3f49cad64a 100644 --- a/HLT/MUON/AliHLTMUONDataBlockWriter.h +++ b/HLT/MUON/AliHLTMUONDataBlockWriter.h @@ -15,12 +15,12 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONDataBlockWriter.h * @author Artur Szostak - * @date + * @date 19 May 2007 * @brief Definition of a writer class for internal dimuon HLT raw data blocks. */ diff --git a/HLT/MUON/AliHLTMUONDataTypes.h b/HLT/MUON/AliHLTMUONDataTypes.h index 1e90e1e768e..8fae57b9e35 100644 --- a/HLT/MUON/AliHLTMUONDataTypes.h +++ b/HLT/MUON/AliHLTMUONDataTypes.h @@ -15,12 +15,12 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONDataTypes.h * @author Artur Szostak - * @date + * @date 18 May 2007 * @brief Declaration of basic data types used in HLT/MUON module. * * The types and structs are defined with C linkage since C generally gives us diff --git a/HLT/MUON/AliHLTMUONDecision.cxx b/HLT/MUON/AliHLTMUONDecision.cxx index 0b6e6e71490..351ccd1c519 100644 --- a/HLT/MUON/AliHLTMUONDecision.cxx +++ b/HLT/MUON/AliHLTMUONDecision.cxx @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id: $ */ +// $Id: $ /// /// @file AliHLTMUONDecision.cxx diff --git a/HLT/MUON/AliHLTMUONDecision.h b/HLT/MUON/AliHLTMUONDecision.h index ad883d33ad3..36ec21a9f60 100644 --- a/HLT/MUON/AliHLTMUONDecision.h +++ b/HLT/MUON/AliHLTMUONDecision.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id: $ */ +// $Id: $ /// /// @file AliHLTMUONDecision.h diff --git a/HLT/MUON/AliHLTMUONEvent.cxx b/HLT/MUON/AliHLTMUONEvent.cxx index 106fbb66e31..fe5b61b975b 100644 --- a/HLT/MUON/AliHLTMUONEvent.cxx +++ b/HLT/MUON/AliHLTMUONEvent.cxx @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id: $ */ +// $Id: $ /// /// @file AliHLTMUONEvent.cxx diff --git a/HLT/MUON/AliHLTMUONEvent.h b/HLT/MUON/AliHLTMUONEvent.h index 640464599e7..cb35c8c5f9d 100644 --- a/HLT/MUON/AliHLTMUONEvent.h +++ b/HLT/MUON/AliHLTMUONEvent.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id: $ */ +// $Id: $ /// /// @file AliHLTMUONRootifierComponent.h diff --git a/HLT/MUON/AliHLTMUONLinkDef.h b/HLT/MUON/AliHLTMUONLinkDef.h index 94b6ac472ff..f552d096e00 100644 --- a/HLT/MUON/AliHLTMUONLinkDef.h +++ b/HLT/MUON/AliHLTMUONLinkDef.h @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file HLTMUONLinkDef.h diff --git a/HLT/MUON/AliHLTMUONList.h b/HLT/MUON/AliHLTMUONList.h index d5e34bb4e97..6cfa855927c 100644 --- a/HLT/MUON/AliHLTMUONList.h +++ b/HLT/MUON/AliHLTMUONList.h @@ -15,14 +15,13 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONList.h * @author Artur Szostak - * @date - * @brief Declaration of a singly linked-list class which preallocates memory - * to give faster online performance. + * @date 29 May 2007 + * @brief Declaration of a singly linked-list class which preallocates memory to give faster online performance. */ #include "AliHLTDataTypes.h" diff --git a/HLT/MUON/AliHLTMUONMansoCandidatesBlockStruct.cxx b/HLT/MUON/AliHLTMUONMansoCandidatesBlockStruct.cxx index 8dee54a8500..5319264dbe5 100644 --- a/HLT/MUON/AliHLTMUONMansoCandidatesBlockStruct.cxx +++ b/HLT/MUON/AliHLTMUONMansoCandidatesBlockStruct.cxx @@ -13,12 +13,12 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONMansoCandidatesBlockStruct.cxx * @author Artur Szostak - * @date + * @date 21 May 2007 * @brief Implementation of useful stream and comparison operators. */ diff --git a/HLT/MUON/AliHLTMUONMansoCandidatesBlockStruct.h b/HLT/MUON/AliHLTMUONMansoCandidatesBlockStruct.h index 5da8e0bd15c..46cdaf4b522 100644 --- a/HLT/MUON/AliHLTMUONMansoCandidatesBlockStruct.h +++ b/HLT/MUON/AliHLTMUONMansoCandidatesBlockStruct.h @@ -3,15 +3,14 @@ /* Copyright(c) 1998-2007, ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONMansoCandidatesBlockStruct.h * @author Artur Szostak - * @date - * @brief Definition of internal dimuon HLT track candidates data block - * structure generated by the Manso algorithm. - * + * @date 21 May 2007 + * @brief Definition of internal dimuon HLT track candidates data block structure generated by the Manso algorithm. + * * The structures are defined with C linkage since C generally gives us more * binary compatibility between compilers. */ diff --git a/HLT/MUON/AliHLTMUONMansoTrack.cxx b/HLT/MUON/AliHLTMUONMansoTrack.cxx index 73ec3bef404..e3259fd51b7 100644 --- a/HLT/MUON/AliHLTMUONMansoTrack.cxx +++ b/HLT/MUON/AliHLTMUONMansoTrack.cxx @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONMansoTrack.cxx diff --git a/HLT/MUON/AliHLTMUONMansoTrack.h b/HLT/MUON/AliHLTMUONMansoTrack.h index 29749d51d83..65587d4e6d7 100644 --- a/HLT/MUON/AliHLTMUONMansoTrack.h +++ b/HLT/MUON/AliHLTMUONMansoTrack.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONMansoTrack.h diff --git a/HLT/MUON/AliHLTMUONMansoTracksBlockStruct.cxx b/HLT/MUON/AliHLTMUONMansoTracksBlockStruct.cxx index c90938c1274..53b03cbcdf0 100644 --- a/HLT/MUON/AliHLTMUONMansoTracksBlockStruct.cxx +++ b/HLT/MUON/AliHLTMUONMansoTracksBlockStruct.cxx @@ -13,7 +13,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONMansoTracksBlockStruct.cxx diff --git a/HLT/MUON/AliHLTMUONMansoTracksBlockStruct.h b/HLT/MUON/AliHLTMUONMansoTracksBlockStruct.h index e5f4a7dfb6b..d3485684d53 100644 --- a/HLT/MUON/AliHLTMUONMansoTracksBlockStruct.h +++ b/HLT/MUON/AliHLTMUONMansoTracksBlockStruct.h @@ -3,7 +3,7 @@ /* Copyright(c) 1998-2007, ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONMansoTracksBlockStruct.h diff --git a/HLT/MUON/AliHLTMUONPairsDecisionBlockStruct.cxx b/HLT/MUON/AliHLTMUONPairsDecisionBlockStruct.cxx index 9e75cbec984..8cdb794c23e 100644 --- a/HLT/MUON/AliHLTMUONPairsDecisionBlockStruct.cxx +++ b/HLT/MUON/AliHLTMUONPairsDecisionBlockStruct.cxx @@ -13,12 +13,12 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONPairsDecisionBlockStruct.cxx * @author Artur Szostak - * @date + * @date 21 May 2007 * @brief Implementation of useful stream and comparison operators. */ diff --git a/HLT/MUON/AliHLTMUONPairsDecisionBlockStruct.h b/HLT/MUON/AliHLTMUONPairsDecisionBlockStruct.h index a14d928ff8e..f3f9dad8459 100644 --- a/HLT/MUON/AliHLTMUONPairsDecisionBlockStruct.h +++ b/HLT/MUON/AliHLTMUONPairsDecisionBlockStruct.h @@ -3,15 +3,14 @@ /* Copyright(c) 1998-2007, ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONPairsDecisionBlockStruct.h * @author Artur Szostak - * @date - * @brief Definition of internal dimuon HLT trigger decision data structure - * containing decision information for pairs of tracks. - * + * @date 21 May 2007 + * @brief Definition of internal dimuon HLT trigger decision data structure containing decision information for pairs of tracks. + * * The structures are defined with C linkage since C generally gives us more * binary compatibility between compilers. */ diff --git a/HLT/MUON/AliHLTMUONProcessor.cxx b/HLT/MUON/AliHLTMUONProcessor.cxx index 5c34fc6451f..f3281426de5 100644 --- a/HLT/MUON/AliHLTMUONProcessor.cxx +++ b/HLT/MUON/AliHLTMUONProcessor.cxx @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id: $ */ +// $Id: $ /// /// @file AliHLTMUONProcessor.cxx diff --git a/HLT/MUON/AliHLTMUONProcessor.h b/HLT/MUON/AliHLTMUONProcessor.h index 97125a1d2ac..d788f108d35 100644 --- a/HLT/MUON/AliHLTMUONProcessor.h +++ b/HLT/MUON/AliHLTMUONProcessor.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id: $ */ +// $Id: $ /// /// @file AliHLTMUONProcessor.h @@ -26,6 +26,27 @@ class AliMUONRecoParam; * Some common methods useful to all dHLT specific components are implemented * by this class. * + * The following argument can be inherited by components derived from the + * AliHLTMUONProcessor class, as long as the protected methods provided are used + * properly and the argument evaluation is handled as indicated in DoInit. + * \li -cdbpath path
+ * This allows one to override the path to use for the CDB location. + * path must be a valid CDB URI. By default the HLT system framework + * sets the CDB path.
+ * \li -run number
+ * This allows one to override the run number to use. number must be + * a positive integer number. By default the HLT system framework sets the + * run number.
+ * \li -delaysetup
+ * If indicated then part of the initialisation of the component is forcefully + * delayed to the first event received, i.e. the Start-of-Run event.
+ * \li -dumponerror
+ * This flag will cause the component to dump the data blocks it received if + * an error occurs during the processing of an event.
+ * \li -dumppath path
+ * Allows one to specify the path in which to dump the received data blocks + * if an error occurs.
+ * * @ingroup alihlt_dimuon_component */ class AliHLTMUONProcessor : public AliHLTProcessor diff --git a/HLT/MUON/AliHLTMUONRecHit.cxx b/HLT/MUON/AliHLTMUONRecHit.cxx index d9d61c1a5c3..a4fe521c472 100644 --- a/HLT/MUON/AliHLTMUONRecHit.cxx +++ b/HLT/MUON/AliHLTMUONRecHit.cxx @@ -1,5 +1,5 @@ /************************************************************************** - * This file is property of and copyright by the ALICE HLT Project * + * This file is property of and copyright by the ALICE HLT Project * * All rights reserved. * * * * Primary Authors: * @@ -10,11 +10,11 @@ * without fee, provided that the above copyright notice appears in all * * copies and that both the copyright notice and this permission notice * * appear in the supporting documentation. The authors make no claims * - * about the suitability of this software for any purpose. It is * + * about the suitability of this software for any purpose. It is * * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONRecHit.cxx diff --git a/HLT/MUON/AliHLTMUONRecHit.h b/HLT/MUON/AliHLTMUONRecHit.h index a421331134b..e249d93422a 100644 --- a/HLT/MUON/AliHLTMUONRecHit.h +++ b/HLT/MUON/AliHLTMUONRecHit.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONRecHit.h diff --git a/HLT/MUON/AliHLTMUONRecHitsBlockStruct.cxx b/HLT/MUON/AliHLTMUONRecHitsBlockStruct.cxx index 78dc1f9c63c..71f17c37368 100644 --- a/HLT/MUON/AliHLTMUONRecHitsBlockStruct.cxx +++ b/HLT/MUON/AliHLTMUONRecHitsBlockStruct.cxx @@ -13,7 +13,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONRecHitsBlockStruct.h diff --git a/HLT/MUON/AliHLTMUONRecHitsBlockStruct.h b/HLT/MUON/AliHLTMUONRecHitsBlockStruct.h index b7edcb4875f..a3a263a3d0e 100644 --- a/HLT/MUON/AliHLTMUONRecHitsBlockStruct.h +++ b/HLT/MUON/AliHLTMUONRecHitsBlockStruct.h @@ -3,7 +3,7 @@ /* Copyright(c) 1998-2007, ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONRecHitsBlockStruct.h @@ -11,7 +11,7 @@ * Artur Szostak * @date 17 May 2007 * @brief Definition of internal dimuon HLT reconstructed hit data block structure. - * + * * The structures are defined with C linkage since C generally gives us more * binary compatibility between compilers. */ diff --git a/HLT/MUON/AliHLTMUONSinglesDecisionBlockStruct.cxx b/HLT/MUON/AliHLTMUONSinglesDecisionBlockStruct.cxx index 4df793b3d7d..4e1cf2c378f 100644 --- a/HLT/MUON/AliHLTMUONSinglesDecisionBlockStruct.cxx +++ b/HLT/MUON/AliHLTMUONSinglesDecisionBlockStruct.cxx @@ -13,12 +13,12 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONSinglesDecisionBlockStruct.cxx * @author Artur Szostak - * @date + * @date 21 May 2007 * @brief Implementation of useful stream and comparison operators. */ diff --git a/HLT/MUON/AliHLTMUONSinglesDecisionBlockStruct.h b/HLT/MUON/AliHLTMUONSinglesDecisionBlockStruct.h index 82a93a39b12..4bb1db11ee3 100644 --- a/HLT/MUON/AliHLTMUONSinglesDecisionBlockStruct.h +++ b/HLT/MUON/AliHLTMUONSinglesDecisionBlockStruct.h @@ -3,15 +3,15 @@ /* Copyright(c) 1998-2007, ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONSinglesDecisionBlockStruct.h * @author Artur Szostak - * @date + * @date 21 May 2007 * @brief Definition of internal dimuon HLT trigger decision data structure * containing decision information for single tracks. - * + * * The structures are defined with C linkage since C generally gives us more * binary compatibility between compilers. */ diff --git a/HLT/MUON/AliHLTMUONTrigRecsDebugBlockStruct.cxx b/HLT/MUON/AliHLTMUONTrigRecsDebugBlockStruct.cxx index 3b96b924091..880c9569171 100644 --- a/HLT/MUON/AliHLTMUONTrigRecsDebugBlockStruct.cxx +++ b/HLT/MUON/AliHLTMUONTrigRecsDebugBlockStruct.cxx @@ -13,12 +13,12 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONTrigRecsDebugBlockStruct.cxx * @author Artur Szostak - * @date + * @date 19 May 2007 * @brief Implementation of useful stream and comparison operators. */ diff --git a/HLT/MUON/AliHLTMUONTrigRecsDebugBlockStruct.h b/HLT/MUON/AliHLTMUONTrigRecsDebugBlockStruct.h index 97c0bbef34b..c4a779a6dec 100644 --- a/HLT/MUON/AliHLTMUONTrigRecsDebugBlockStruct.h +++ b/HLT/MUON/AliHLTMUONTrigRecsDebugBlockStruct.h @@ -3,15 +3,15 @@ /* Copyright(c) 1998-2007, ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONTrigRecsDebugBlockStruct.h * @author Artur Szostak - * @date + * @date 19 May 2007 * @brief Definition of internal dimuon HLT data structures for storing debugging * information about trigger records. - * + * * The structures are defined with C linkage since C generally gives us more * binary compatibility between compilers. */ diff --git a/HLT/MUON/AliHLTMUONTriggerRecord.cxx b/HLT/MUON/AliHLTMUONTriggerRecord.cxx index 4ebd945ec46..126b29305b5 100644 --- a/HLT/MUON/AliHLTMUONTriggerRecord.cxx +++ b/HLT/MUON/AliHLTMUONTriggerRecord.cxx @@ -1,5 +1,5 @@ /************************************************************************** - * This file is property of and copyright by the ALICE HLT Project * + * This file is property of and copyright by the ALICE HLT Project * * All rights reserved. * * * * Primary Authors: * @@ -10,11 +10,11 @@ * without fee, provided that the above copyright notice appears in all * * copies and that both the copyright notice and this permission notice * * appear in the supporting documentation. The authors make no claims * - * about the suitability of this software for any purpose. It is * + * about the suitability of this software for any purpose. It is * * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONTriggerRecord.cxx diff --git a/HLT/MUON/AliHLTMUONTriggerRecord.h b/HLT/MUON/AliHLTMUONTriggerRecord.h index d5514e3fd47..500d944eade 100644 --- a/HLT/MUON/AliHLTMUONTriggerRecord.h +++ b/HLT/MUON/AliHLTMUONTriggerRecord.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONTriggerRecord.h diff --git a/HLT/MUON/AliHLTMUONTriggerRecordsBlockStruct.cxx b/HLT/MUON/AliHLTMUONTriggerRecordsBlockStruct.cxx index bd1f6af6605..394ae71d5f9 100644 --- a/HLT/MUON/AliHLTMUONTriggerRecordsBlockStruct.cxx +++ b/HLT/MUON/AliHLTMUONTriggerRecordsBlockStruct.cxx @@ -13,12 +13,12 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONTriggerRecordsBlockStruct.cxx * @author Artur Szostak - * @date + * @date 18 May 2007 * @brief Implementation of useful stream and comparison operators. */ diff --git a/HLT/MUON/AliHLTMUONTriggerRecordsBlockStruct.h b/HLT/MUON/AliHLTMUONTriggerRecordsBlockStruct.h index ee1a019c303..601ec28e105 100644 --- a/HLT/MUON/AliHLTMUONTriggerRecordsBlockStruct.h +++ b/HLT/MUON/AliHLTMUONTriggerRecordsBlockStruct.h @@ -3,14 +3,14 @@ /* Copyright(c) 1998-2007, ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONTriggerRecordsBlockStruct.h * @author Artur Szostak - * @date + * @date 18 May 2007 * @brief Definition of internal dimuon HLT trigger record data block structure. - * + * * The structures are defined with C linkage since C generally gives us more * binary compatibility between compilers. */ diff --git a/HLT/MUON/AliHLTMUONUtils.cxx b/HLT/MUON/AliHLTMUONUtils.cxx index 1fb7c59bba5..aa371137c6a 100644 --- a/HLT/MUON/AliHLTMUONUtils.cxx +++ b/HLT/MUON/AliHLTMUONUtils.cxx @@ -13,7 +13,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONUtils.cxx diff --git a/HLT/MUON/AliHLTMUONUtils.h b/HLT/MUON/AliHLTMUONUtils.h index ee93a424b40..366e5280255 100644 --- a/HLT/MUON/AliHLTMUONUtils.h +++ b/HLT/MUON/AliHLTMUONUtils.h @@ -3,7 +3,7 @@ /* Copyright(c) 1998-2007, ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONUtils.h diff --git a/HLT/MUON/OfflineInterface/AliHLTMUONAgent.cxx b/HLT/MUON/OfflineInterface/AliHLTMUONAgent.cxx index abe5853388d..82f3147b71d 100644 --- a/HLT/MUON/OfflineInterface/AliHLTMUONAgent.cxx +++ b/HLT/MUON/OfflineInterface/AliHLTMUONAgent.cxx @@ -13,7 +13,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONAgent.cxx diff --git a/HLT/MUON/OfflineInterface/AliHLTMUONAgent.h b/HLT/MUON/OfflineInterface/AliHLTMUONAgent.h index 5b77b9fefd5..8b699eb116d 100644 --- a/HLT/MUON/OfflineInterface/AliHLTMUONAgent.h +++ b/HLT/MUON/OfflineInterface/AliHLTMUONAgent.h @@ -3,14 +3,13 @@ /* Copyright(c) 1998-2007, ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONAgent.h /// @author Artur Szostak /// @date 28 May 2007 -/// @brief The HLT module agent for libAliHLTMUON.so which interfaces HLT -/// components with offline. +/// @brief The HLT module agent for libAliHLTMUON.so which interfaces HLT components with offline. /// #include "AliHLTModuleAgent.h" diff --git a/HLT/MUON/OfflineInterface/AliHLTMUONDigitPublisherComponent.cxx b/HLT/MUON/OfflineInterface/AliHLTMUONDigitPublisherComponent.cxx index d180e107257..65483838864 100644 --- a/HLT/MUON/OfflineInterface/AliHLTMUONDigitPublisherComponent.cxx +++ b/HLT/MUON/OfflineInterface/AliHLTMUONDigitPublisherComponent.cxx @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id: AliHLTMUONDigitPublisherComponent.cxx 26179 2008-05-29 22:27:27Z aszostak $ */ +// $Id: AliHLTMUONDigitPublisherComponent.cxx 26179 2008-05-29 22:27:27Z aszostak $ /// /// @file AliHLTMUONDigitPublisherComponent.cxx diff --git a/HLT/MUON/OfflineInterface/AliHLTMUONDigitPublisherComponent.h b/HLT/MUON/OfflineInterface/AliHLTMUONDigitPublisherComponent.h index cdfcd6f408e..59db0f2eb30 100644 --- a/HLT/MUON/OfflineInterface/AliHLTMUONDigitPublisherComponent.h +++ b/HLT/MUON/OfflineInterface/AliHLTMUONDigitPublisherComponent.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id: AliHLTMUONDigitPublisherComponent.h 26179 2008-05-29 22:27:27Z aszostak $ */ +// $Id: AliHLTMUONDigitPublisherComponent.h 26179 2008-05-29 22:27:27Z aszostak $ /// /// @file AliHLTMUONDigitPublisherComponent.h diff --git a/HLT/MUON/OfflineInterface/AliHLTMUONESDMaker.cxx b/HLT/MUON/OfflineInterface/AliHLTMUONESDMaker.cxx index 83feee336a5..e674377e524 100644 --- a/HLT/MUON/OfflineInterface/AliHLTMUONESDMaker.cxx +++ b/HLT/MUON/OfflineInterface/AliHLTMUONESDMaker.cxx @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id: $ */ +// $Id: $ /// /// @file AliHLTMUONESDMaker.cxx diff --git a/HLT/MUON/OfflineInterface/AliHLTMUONESDMaker.h b/HLT/MUON/OfflineInterface/AliHLTMUONESDMaker.h index 8e5fe7bd81f..b65c185d5a7 100644 --- a/HLT/MUON/OfflineInterface/AliHLTMUONESDMaker.h +++ b/HLT/MUON/OfflineInterface/AliHLTMUONESDMaker.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id: $ */ +// $Id: $ /// /// @file AliHLTMUONESDMaker.h @@ -17,6 +17,8 @@ /** * @class AliHLTMUONESDMaker + * \brief Component for converting dHLT results into ESD format. + * * The component is used to convert dHLT reconstructed data into AliESDEvent * objects which can be stored in ROOT files during offline reconstruction. * Only the dHLT track and trigger record data is converted, then filled in the ESD. @@ -32,9 +34,18 @@ * \li -make_minimal_esd
* Indicates that AliESDEvent objects should be created with only the TClonesArray * for the muon tracks created. (default is to generate all standard ESD objects)
+ * \li -add_rootified_objects
+ * If specified then the any rootified dHLT event data that is found is added to the + * ESD list of objects as a custom data object.
* \li -warn_on_unexpected_block
* If set, then warning messages are generated for any data block types that * were not expected. (default is to generate only debug messages)
+ * \li -dumponerror
+ * This flag will cause the component to dump the data blocks it received if + * an error occurs during the processing of an event.
+ * \li -dumppath path
+ * Allows one to specify the path in which to dump the received data blocks + * if an error occurs.
* * @ingroup alihlt_dimuon_component */ diff --git a/HLT/MUON/OfflineInterface/AliHLTMUONRecHitsSource.cxx b/HLT/MUON/OfflineInterface/AliHLTMUONRecHitsSource.cxx index a65e47cb568..9fa31dd0637 100644 --- a/HLT/MUON/OfflineInterface/AliHLTMUONRecHitsSource.cxx +++ b/HLT/MUON/OfflineInterface/AliHLTMUONRecHitsSource.cxx @@ -14,12 +14,12 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONRecHitsSource.cxx /// @author Artur Szostak -/// @date +/// @date 28 May 2007 /// @brief Implementation of the AliHLTMUONRecHitsSource component. /// diff --git a/HLT/MUON/OfflineInterface/AliHLTMUONRecHitsSource.h b/HLT/MUON/OfflineInterface/AliHLTMUONRecHitsSource.h index c43b228c755..b0e4d002800 100644 --- a/HLT/MUON/OfflineInterface/AliHLTMUONRecHitsSource.h +++ b/HLT/MUON/OfflineInterface/AliHLTMUONRecHitsSource.h @@ -1,7 +1,7 @@ #ifndef ALIHLTMUONRECHITSSOURCE_H #define ALIHLTMUONRECHITSSOURCE_H /************************************************************************** - * This file is property of and copyright by the ALICE HLT Project * + * This file is property of and copyright by the ALICE HLT Project * * All rights reserved. * * * * Primary Authors: * @@ -12,16 +12,16 @@ * without fee, provided that the above copyright notice appears in all * * copies and that both the copyright notice and this permission notice * * appear in the supporting documentation. The authors make no claims * - * about the suitability of this software for any purpose. It is * + * about the suitability of this software for any purpose. It is * * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONRecHitsSource.h /// @author Artur Szostak -/// @date +/// @date 28 May 2007 /// @brief Class for generating reconstructed hits data blocks from AliRoot data. /// diff --git a/HLT/MUON/OfflineInterface/AliHLTMUONRootifierComponent.cxx b/HLT/MUON/OfflineInterface/AliHLTMUONRootifierComponent.cxx index 674c1a3fd94..1b22e6383ed 100644 --- a/HLT/MUON/OfflineInterface/AliHLTMUONRootifierComponent.cxx +++ b/HLT/MUON/OfflineInterface/AliHLTMUONRootifierComponent.cxx @@ -1,5 +1,5 @@ /************************************************************************** - * This file is property of and copyright by the ALICE HLT Project * + * This file is property of and copyright by the ALICE HLT Project * * All rights reserved. * * * * Primary Authors: * @@ -10,11 +10,11 @@ * without fee, provided that the above copyright notice appears in all * * copies and that both the copyright notice and this permission notice * * appear in the supporting documentation. The authors make no claims * - * about the suitability of this software for any purpose. It is * + * about the suitability of this software for any purpose. It is * * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONRootifierComponent.cxx @@ -22,6 +22,7 @@ /// @date 29 Sep 2007 /// @brief Implementation of the AliHLTMUONRootifierComponent component. /// +/// Implements a component to convert dHLT raw data into TObjects. #include "AliHLTMUONRootifierComponent.h" #include "AliHLTMUONEvent.h" @@ -139,7 +140,7 @@ int AliHLTMUONRootifierComponent::GetOutputDataTypes(AliHLTComponentDataTypeList { /// Inherited from AliHLTComponent. Returns the output data types. - tgtList.push_back(kAliHLTAnyDataType); + tgtList.push_back(AliHLTMUONConstants::RootifiedEventDataType()); return tgtList.size(); } diff --git a/HLT/MUON/OfflineInterface/AliHLTMUONRootifierComponent.h b/HLT/MUON/OfflineInterface/AliHLTMUONRootifierComponent.h index 6bca3dc2858..32698514380 100644 --- a/HLT/MUON/OfflineInterface/AliHLTMUONRootifierComponent.h +++ b/HLT/MUON/OfflineInterface/AliHLTMUONRootifierComponent.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONRootifierComponent.h @@ -16,7 +16,52 @@ #include "AliHLTMUONProcessor.h" /** - * Converts dHLT raw data blocks into ROOT objects. + * \class AliHLTMUONRootifierComponent + * \brief Converts dHLT raw data blocks into ROOT objects. + * + * This component class is used to convert all internal raw dHLT data blocks into + * ROOT object that can be stored in '.root' files in a platform independant manner. + * This can also make some of the analysis easier because the dHLT internal data + * will be available in TObjects. + * + *

General properties:

+ * + * Component ID: \b MUONRootifier
+ * Library: \b libAliHLTMUON.so
+ * Input Data Types: kAliHLTAnyDataType = "*******:***"
+ * Output Data Types: AliHLTMUONConstants::RootifiedEventDataType() = "ROOTEVNT:MUON"
+ * + *

Mandatory arguments:

+ * None. + * + *

Optional arguments:

+ * \li -warn_on_unexpected_block
+ * This will cause the component to generate warnings when it receives data block + * types it does not know how to handle. Without this option the component only + * generates debug messages when they are compiled in.
+ * \li -dumponerror
+ * This flag will cause the component to dump the data blocks it received if + * an error occurs during the processing of an event.
+ * \li -dumppath path
+ * Allows one to specify the path in which to dump the received data blocks + * if an error occurs.
+ * + *

Standard configuration:

+ * There is no special configuration for this component. + * + *

Default CDB entries:

+ * None. + * + *

Performance:

+ * A few milliseconds per event. + * + *

Memory consumption:

+ * A few MBytes. + * + *

Output size:

+ * A few kBytes. + * + * @ingroup alihlt_dimuon_component */ class AliHLTMUONRootifierComponent : public AliHLTMUONProcessor { diff --git a/HLT/MUON/OfflineInterface/AliHLTMUONTriggerRecordsSource.cxx b/HLT/MUON/OfflineInterface/AliHLTMUONTriggerRecordsSource.cxx index aa6163dc31e..bfe48b33829 100644 --- a/HLT/MUON/OfflineInterface/AliHLTMUONTriggerRecordsSource.cxx +++ b/HLT/MUON/OfflineInterface/AliHLTMUONTriggerRecordsSource.cxx @@ -14,12 +14,12 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONTriggerRecordsSource.cxx * @author Artur Szostak - * @date + * @date 16 Sep 2007 * @brief Implementation of the AliHLTMUONTriggerRecordsSource component. */ diff --git a/HLT/MUON/OfflineInterface/AliHLTMUONTriggerRecordsSource.h b/HLT/MUON/OfflineInterface/AliHLTMUONTriggerRecordsSource.h index 9bc7c4315db..7e065eb05f1 100644 --- a/HLT/MUON/OfflineInterface/AliHLTMUONTriggerRecordsSource.h +++ b/HLT/MUON/OfflineInterface/AliHLTMUONTriggerRecordsSource.h @@ -1,7 +1,7 @@ #ifndef ALIHLTMUONTRIGGERRECORDSSOURCE_H #define ALIHLTMUONTRIGGERRECORDSSOURCE_H /************************************************************************** - * This file is property of and copyright by the ALICE HLT Project * + * This file is property of and copyright by the ALICE HLT Project * * All rights reserved. * * * * Primary Authors: * @@ -12,16 +12,16 @@ * without fee, provided that the above copyright notice appears in all * * copies and that both the copyright notice and this permission notice * * appear in the supporting documentation. The authors make no claims * - * about the suitability of this software for any purpose. It is * + * about the suitability of this software for any purpose. It is * * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONTriggerRecordsSource.h * @author Artur Szostak - * @date + * @date 16 Sep 2007 * @brief Class for generating trigger record data blocks from AliRoot data. */ diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONCalculations.cxx b/HLT/MUON/OnlineAnalysis/AliHLTMUONCalculations.cxx index 4e32e70faca..e1c1f18e0de 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONCalculations.cxx +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONCalculations.cxx @@ -13,7 +13,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ //////////////////////////////////////////////////////////////////////////////// // diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONCalculations.h b/HLT/MUON/OnlineAnalysis/AliHLTMUONCalculations.h index 095a77015dd..f5832e3326a 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONCalculations.h +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONCalculations.h @@ -3,7 +3,7 @@ /* Copyright(c) 1998-2007, ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ //////////////////////////////////////////////////////////////////////////////// // diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONClusterFinderComponent.cxx b/HLT/MUON/OnlineAnalysis/AliHLTMUONClusterFinderComponent.cxx index 839669845ff..d5cb8073fb0 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONClusterFinderComponent.cxx +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONClusterFinderComponent.cxx @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id: $ */ +// $Id: $ /// /// @file AliHLTMUONClusterFinderComponent.cxx diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONClusterFinderComponent.h b/HLT/MUON/OnlineAnalysis/AliHLTMUONClusterFinderComponent.h index c664db44fab..c077ec947c2 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONClusterFinderComponent.h +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONClusterFinderComponent.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id: $ */ +// $Id: $ /// /// @file AliHLTMUONClusterFinderComponent.h @@ -57,9 +57,23 @@ class AliMUONRecoParam; * \li -run number
* Specifies the run number to use, given by number. This option will * override the current run number automatically set by the HLT framework.
+ * \li -dumponerror
+ * This flag will cause the component to dump the data blocks it received if + * an error occurs during the processing of an event.
+ * \li -dumppath path
+ * Allows one to specify the path in which to dump the received data blocks + * if an error occurs.
* \li -tryrecover
* This is a special option to the raw data decoder to turn on logic which will * try and recover from corrupt raw DDL data. This is off by default.
+ * \li -nostore
+ * If specified then the AliMUONVClusterStore object generated by the offline + * reconstruction code is not added to the output data. The default to send this object.
+ * \li -makehits
+ * If specified then the clusters found by the offline reconstruction algorithm are + * converted to internal dHLT reconstructed hit format and a reconstructed hits data + * block is generated. The default is not to write in dHLT internal format since the + * closter store object is already written by default.
* *

Standard configuration:

* This component should normally be configured with no extra options in the XML @@ -70,7 +84,7 @@ class AliMUONRecoParam; * subdirectory in the CDB, MUON/Calib and MUON/Align. * *

Performance:

- * A few tens of Hertz. + * A few tens of Hertz during online running. * *

Memory consumption:

* A few MBytes. diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONDecisionComponent.cxx b/HLT/MUON/OnlineAnalysis/AliHLTMUONDecisionComponent.cxx index 89e02d8697e..74ce1333eb8 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONDecisionComponent.cxx +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONDecisionComponent.cxx @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id: $ */ +// $Id: $ /// /// @file AliHLTMUONDecisionComponent.cxx diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONDecisionComponent.h b/HLT/MUON/OnlineAnalysis/AliHLTMUONDecisionComponent.h index 82cb8fd5ea6..d8ada98fe7d 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONDecisionComponent.h +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONDecisionComponent.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id: $ */ +// $Id: $ /// /// @file AliHLTMUONDecisionComponent.h @@ -43,6 +43,86 @@ extern "C" struct AliHLTMUONPairsDecisionBlockStruct; * are applied. The number of pairs that pass the low or high mass cut are then * counted. The results are encoded into two data blocks, one for trigger decisions * for single tracks and another for the track pairs. + * + *

General properties:

+ * + * Component ID: \b MUONDecisionComponent
+ * Library: \b libAliHLTMUON.so
+ * Input Data Types: AliHLTMUONConstants::MansoTracksBlockDataType() = "MANTRACK:MUON"
+ * Output Data Types: \li AliHLTMUONConstants::SinglesDecisionBlockDataType() = "DECIDSIN:MUON" + * \li AliHLTMUONConstants::PairsDecisionBlockDataType() = "DECIDPAR:MUON"
+ * + *

Mandatory arguments:

+ * None. + * + *

Optional arguments:

+ * + * \li -lowptcut value
+ * Sets the low pT cut value to use when applying the decision. The value + * should be a floating point number and has units GeV/c. If this parameter is + * specified then it will not be loaded from CDB.
+ * \li -highptcut value
+ * Sets the high pT cut value to use when applying the decision. The value + * should be a floating point number and has units GeV/c. If this parameter is + * specified then it will not be loaded from CDB.
+ * \li -lowmasscut value
+ * Sets the low invariant mass cut value to use when applying the decision. + * The value should be a floating point number and has units GeV/c^2. + * If this parameter is specified then it will not be loaded from CDB.
+ * \li -highmasscut value
+ * Sets the high invariant mass cut value to use when applying the decision. + * The value should be a floating point number and has units GeV/c^2. + * If this parameter is specified then it will not be loaded from CDB.
+ * \li -no_singles_detail
+ * If specified the detailed decision information for tracks is not added to + * the output. Only the scalar values are then present in the output data block + * for decisions on single tracks.
+ * \li -no_pairs_detail
+ * If specified the detailed decision information for track pairs is not added + * to the output. Only the scalar values are then present in the output data + * block for decisions for track pairs.
+ * \li -warn_on_unexpected_block
+ * This will cause the component to generate warnings when it receives data block + * types it does not know how to handle. Without this option the component only + * generates debug messages when they are compiled in.
+ * \li -cdbpath path
+ * This allows one to override the path to use for the CDB location. + * path must be a valid CDB URI. By default the HLT system framework + * sets the CDB path.
+ * \li -run number
+ * This allows one to override the run number to use. number must be + * a positive integer number. By default the HLT system framework sets the + * run number.
+ * \li -delaysetup
+ * If indicated then part of the initialisation of the component is forcefully + * delayed to the first event received, i.e. the Start-of-Run event.
+ * \li -dumponerror
+ * This flag will cause the component to dump the data blocks it received if + * an error occurs during the processing of an event.
+ * \li -dumppath path
+ * Allows one to specify the path in which to dump the received data blocks + * if an error occurs.
+ * + *

Standard configuration:

+ * The configuration is taken from the CDB by default. It can be overridden with + * the command line arguments. + * + *

Default CDB entries:

+ * HLT/ConfigMUON/DecisionComponent - Contains a TMap with the cut parameters. + * + *

Performance:

+ * For worst case numbers of tracks the decision component requires less than a + * millisecond to process an event. + * + *

Memory consumption:

+ * This is a linear function of the input data size, but only a fraction. Thus the + * memory usage is minimal. It should be under 1 MBytes. + * + *

Output size:

+ * This will depend linearly on the number of tracks found. But for nominal + * multiplicities this should be less than 16 kBytes. + * + * @ingroup alihlt_dimuon_component */ class AliHLTMUONDecisionComponent : public AliHLTMUONProcessor { diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructor.cxx b/HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructor.cxx index fa108a5400f..3ba337e99d5 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructor.cxx +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructor.cxx @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /////////////////////////////////////////////// //Author : Indranil Das, SINP, INDIA diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructor.h b/HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructor.h index 086f2134bcc..9d569a567c2 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructor.h +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructor.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /////////////////////////////////////////////// //Author : Indranil Das, SINP, INDIA diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructorComponent.cxx b/HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructorComponent.cxx index d667d4daa7d..c2d4bf1b2d2 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructorComponent.cxx +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructorComponent.cxx @@ -15,7 +15,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONHitReconstructorComponent.cxx diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructorComponent.h b/HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructorComponent.h index 69da25c94aa..c35ab50bb09 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructorComponent.h +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructorComponent.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONHitReconstructorComponent.h @@ -60,7 +60,7 @@ extern "C" struct AliHLTMUONHitRecoLutRow; * process in DoEvent. * If -ddl or -ddlid were not used, then the DDL number will be taken from * the first block's specification during runtime from the first - * event (Start-of-Run event). + * event (i.e. Start-of-Run event). * Using the -lut or -dccut arguments will override loading from CDB for a * delayed setup.
* @@ -114,6 +114,12 @@ extern "C" struct AliHLTMUONHitRecoLutRow; * \li -warnifpadskipped
* If this option is set the a warning message is generated for every pad that * is skipped because it contains invalid value markers in the calibration data.
+ * \li -dumponerror
+ * This flag will cause the component to dump the data blocks it received if + * an error occurs during the processing of an event.
+ * \li -dumppath path
+ * Allows one to specify the path in which to dump the received data blocks + * if an error occurs.
* *

Standard configuration:

* This component should normally be configured with either of the two sets of diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerComponent.cxx b/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerComponent.cxx deleted file mode 100644 index f1753f020e7..00000000000 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerComponent.cxx +++ /dev/null @@ -1,270 +0,0 @@ -/************************************************************************** - * Copyright(c) 1998-2007, ALICE Experiment at CERN, All rights reserved. * - * * - * Author: The ALICE Off-line Project. * - * Contributors are mentioned in the code where appropriate. * - * * - * Permission to use, copy, modify and distribute this software and its * - * documentation strictly for non-commercial purposes is hereby granted * - * without fee, provided that the above copyright notice appears in all * - * copies and that both the copyright notice and this permission notice * - * appear in the supporting documentation. The authors make no claims * - * about the suitability of this software for any purpose. It is * - * provided "as is" without express or implied warranty. * - **************************************************************************/ - -/* $Id$ */ - -/** - * @file AliHLTMUONMansoTrackerComponent.cxx - * @author Artur Szostak - * @date - * @brief Implementation of AliHLTMUONMansoTrackerComponent class. - */ - -#include "AliHLTMUONMansoTrackerComponent.h" -#include "Util/AliHLTMUONRecPoint.h" -#include -#include - -namespace -{ - // this is a global object used for automatic component registration, do not use this - AliHLTMUONMansoTrackerComponent gAliHLTMUONMansoTrackerComponent; -} - - -ClassImp(AliHLTMUONMansoTrackerComponent); - - -AliHLTMUONMansoTrackerComponent::AliHLTMUONMansoTrackerComponent() - : - fOutputPercentage(100) // By default we copy to the output exactly what we got as input - { - } - -AliHLTMUONMansoTrackerComponent::~AliHLTMUONMansoTrackerComponent() - { - } - -const char* AliHLTMUONMansoTrackerComponent::GetComponentID() - { - return "tracking"; // The ID of this component - } - -void AliHLTMUONMansoTrackerComponent::GetInputDataTypes( vector& list) - { - /* in order to be backward compatible we have to keep the old code, at - * least for a while. Remember to use the new const kAliHLTVoidDataType - * if you are using a more recent AliRoot version (from Jan 07) - list.push_back(kAliHLTAnyDataType); // We do not have any requirements for our input data type(s). - */ - - AliHLTComponentDataType dt = - { sizeof(AliHLTComponentDataType), - {'*','*','*','*','*','*','*','\0'}, - {'*','*','*','\0'}}; - list.push_back(dt); - } - -AliHLTComponentDataType AliHLTMUONMansoTrackerComponent::GetOutputDataType() - { - /* in order to be backward compatible we have to keep the old code, at - * least for a while. Remember to use the new const kAliHLTVoidDataType - * if you are using a more recent AliRoot version (from Jan 07) - return kAliHLTVoidDataType; - */ - AliHLTComponentDataType dt = - { sizeof(AliHLTComponentDataType), - {'\0','\0','\0','0','\0','\0','\0','\0'}, - {'\0','\0','\0','\0'}}; - return dt; - } - -void AliHLTMUONMansoTrackerComponent::GetOutputDataSize( unsigned long& constBase, double& inputMultiplier ) - { - constBase = 0; - inputMultiplier = ((double)fOutputPercentage)/100.0; - } - - - -// Spawn function, return new instance of this class -AliHLTComponent* AliHLTMUONMansoTrackerComponent::Spawn() - { - return new AliHLTMUONMansoTrackerComponent; - } - -int AliHLTMUONMansoTrackerComponent::DoInit( int argc, const char** argv ) - { - // perform initialization. We check whether our relative output size is specified in the arguments. - fOutputPercentage = 100; - - fTracker = new AliHLTMUONMansoTracker(); - - Logging(kHLTLogInfo, "dHLT", "Tracking", "hitrec, DoInit"); - if (argc==0 && argv==NULL) { - // this is just to get rid of the warning "unused parameter" - } - - int i = 0; - char* cpErr; - while ( i < argc ) - { - Logging( kHLTLogDebug, "AliHLTMUONMansoTrackerComponent::DoInit", "Arguments", "argv[%d] == %s", i, argv[i] ); - if ( !strcmp( argv[i], "output_percentage" ) ) - { - if ( i+1>=argc ) - { - Logging(kHLTLogError, "AliHLTMUONMansoTrackerComponent::DoInit", "Missing Argument", "Missing output_percentage parameter"); - return ENOTSUP; - } - Logging( kHLTLogDebug, "AliHLTMUONMansoTrackerComponent::DoInit", "Arguments", "argv[%d+1] == %s", i, argv[i+1] ); - fOutputPercentage = strtoul( argv[i+1], &cpErr, 0 ); - if ( *cpErr ) - { - Logging(kHLTLogError, "AliHLTMUONMansoTrackerComponent::DoInit", "Wrong Argument", "Cannot convert output_percentage parameter '%s'", argv[i+1] ); - return EINVAL; - } - Logging( kHLTLogInfo, "AliHLTMUONMansoTrackerComponent::DoInit", "Output percentage set", "Output percentage set to %lu %%", fOutputPercentage ); - i += 2; - continue; - } - Logging(kHLTLogError, "AliHLTMUONMansoTrackerComponent::DoInit", "Unknown Option", "Unknown option '%s'", argv[i] ); - return EINVAL; - }// while loop - return 0; - } - -int AliHLTMUONMansoTrackerComponent::DoDeinit() -{ - if(fTracker) - delete fTracker; - return 0; -} - -int AliHLTMUONMansoTrackerComponent::DoEvent( const AliHLTComponentEventData& evtData, const AliHLTComponentBlockData* blocks, - AliHLTComponentTriggerData& trigData, AliHLTUInt8_t* outputPtr, - AliHLTUInt32_t& size, vector& outputBlocks ) -{ - Logging( kHLTLogInfo, "AliHLTMUONMansoTrackerComponent::DoEvent", "Output percentage set", "Output percentage set to %lu %%", fOutputPercentage ); - // Process an event - unsigned long totalSize = 0; - AliHLTUInt32_t maxTracksPerEvent = 1024; - - fTracker->Reset(); - fTracker->SetTrackOutputBuffer((AliHLTMUONTrackPoints*)outputPtr,maxTracksPerEvent); - -// cout<<"BlockSize :"< size ) - break; - // Determine the size we should use for the output for this block (the input block's size times the relative output size) - unsigned long mySize = (blocks[n].fSize * fOutputPercentage) / 100; - Logging( kHLTLogInfo, "AliHLTMUONMansoTrackerComponent::DoEvent", "mySize set (1)", "mySize == %lu B - blocks[%lu].fSize == %lu - fOutputPercentage == %lu - totalSize == %lu", - mySize, n, blocks[n].fSize, fOutputPercentage, totalSize ); - - Int_t noftrigData,nofhitData; - if(n== (evtData.fBlockCnt - 1)){// for trigger - UInt_t trigDataSize; - memcpy(&trigDataSize,blocks[n].fPtr,sizeof(UInt_t)); -// cout<<"trigDataSize :"<FindTracks(fTrigData,noftrigData); -// cout<<"Nof tracks found :"<TrackCount()<AddRecHits(chamber,recHit,nofhitData); - - }// hit or trig condn - - - //for(Int_t itrig = 0 ; itrig < nofTrigData ; itrig++){ - - //} - - - // Check how much space we have left and adapt this output block's size accordingly. -// if ( totalSize + mySize > size ) -// mySize = size-totalSize; -// Logging( kHLTLogInfo, "AliHLTMUONMansoTrackerComponent::DoEvent", "mySize set (2)", "mySize == %lu B - totalSize == %lu - size == %lu", -// mySize, totalSize, size ); -// if ( mySize<=0 ) -// continue; // No room left to write a further block. -// // Now copy the input block -// unsigned long copied = 0; -// // First copy all full multiples of the input block -// while ( copied+blocks[n].fSize <= mySize ) -// { -// Logging( kHLTLogInfo, "AliHLTMUONMansoTrackerComponent::DoEvent", "Copying", "Copying %lu B - Copied: %lu B - totalSize: %lu B", -// blocks[n].fSize, copied, totalSize ); -// memcpy( outputPtr+totalSize+copied, blocks[n].fPtr, blocks[n].fSize ); -// copied += blocks[n].fSize; -// } -// // And the copy the remaining fragment of the block -// Logging( kHLTLogInfo, "AliHLTMUONMansoTrackerComponent::DoEvent", "Copying", "Copying %lu B - Copied: %lu B - totalSize: %lu B", -// mySize-copied, copied, totalSize ); -// memcpy( outputPtr+totalSize+copied, blocks[n].fPtr, mySize-copied ); -// Logging( kHLTLogInfo, "AliHLTMUONMansoTrackerComponent::DoEvent", "Copied", "Copied: %lu B - totalSize: %lu B", -// copied, totalSize ); -// // Fill a block data structure for our output block. -// AliHLTComponentBlockData ob; -// // Let the structure be filled with the default values. -// // This takes care of setting the shared memory and data type values to default values, -// // so that they can be filled in by the calling code. -// FillBlockData( ob ); -// // This block's start (offset) is after all other blocks written so far -// ob.fOffset = totalSize; -// // the size of this block's data. -// ob.fSize = mySize; -// // The specification of the data is copied from the input block. -// ob.fSpecification = blocks[n].fSpecification; -// // The data type is set automatically to the component's specified output data type. -// // Place this block into the list of output blocks -// outputBlocks.push_back( ob ); -// // Increase the total amount of data written so far to our output memory -// totalSize += mySize; - } - // Finally we set the total size of output memory we consumed. - size = totalSize; - return 0; -} diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerComponent.h b/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerComponent.h deleted file mode 100644 index 36f7f3cbf55..00000000000 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerComponent.h +++ /dev/null @@ -1,73 +0,0 @@ -#ifndef AliHLTMUONMANSOTRACKERCOMPONENT_H -#define AliHLTMUONMANSOTRACKERCOMPONENT_H -/* Copyright(c) 1998-2007, ALICE Experiment at CERN, All rights reserved. * - * See cxx source for full Copyright notice */ - -/* $Id$ */ - -/** - * @file AliHLTMUONMansoTrackerComponent.h - * @author Artur Szostak - * @date - * @brief Tracker component implementing the Manso algorithm for the dimuon HLT. - */ - -#include "AliHLTProcessor.h" -#include "AliHLTMUONConstants.h" -#include "AliHLTMUONMansoTracker.h" - -/** - * @class AliHLTMUONMansoTrackerComponent - * @brief Manso tracker component - */ -class AliHLTMUONMansoTrackerComponent : public AliHLTProcessor - { - public: - AliHLTMUONMansoTrackerComponent(); - virtual ~AliHLTMUONMansoTrackerComponent(); - - // Public functions to implement AliHLTComponent's interface. - // These functions are required for the registration process - - const char* GetComponentID(); - void GetInputDataTypes( vector& list); - AliHLTComponentDataType GetOutputDataType(); - virtual void GetOutputDataSize( unsigned long& constBase, double& inputMultiplier ); - AliHLTComponent* Spawn(); - - protected: - - // Protected functions to implement AliHLTComponent's interface. - // These functions provide initialization as well as the actual processing - // capabilities of the component. - - int DoInit( int argc, const char** argv ); - int DoDeinit(); - int DoEvent( const AliHLTComponentEventData& evtData, const AliHLTComponentBlockData* blocks, - AliHLTComponentTriggerData& trigData, AliHLTUInt8_t* outputPtr, - AliHLTUInt32_t& size, vector& outputBlocks ); - - private: - - // The size of the output data produced, as a percentage of the input data's size. - // Can be greater than 100 (%) - unsigned fOutputPercentage; - - // For Tracking - - //TrackerCallback callback; - AliHLTMUONMansoTracker* fTracker; - -/* struct TriggerBlock */ -/* { */ -/* const AliHLTMUONCoreTriggerRecord *data; */ -/* }; */ - - AliHLTMUONCoreTriggerRecord *fTrigData; - //std::vector fTriggerBlocks; // array of trigger record blocks - - ClassDef(AliHLTMUONMansoTrackerComponent, 0); - - }; - -#endif // AliHLTMUONMANSOTRACKERCOMPONENT_H diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSM.cxx b/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSM.cxx index b3c4bcfec90..7c387a1fb86 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSM.cxx +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSM.cxx @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONMansoTrackerFSM.cxx diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSM.h b/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSM.h index d02fcf45a79..4a9c18402f9 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSM.h +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSM.h @@ -16,7 +16,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONMansoTrackerFSM.h diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSMCallback.h b/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSMCallback.h index 400a74742a3..4285ed171a2 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSMCallback.h +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSMCallback.h @@ -16,7 +16,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file AliHLTMUONMansoTrackerFSMCallback.h diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSMComponent.cxx b/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSMComponent.cxx index 9ac24721164..380df05ff1c 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSMComponent.cxx +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSMComponent.cxx @@ -15,7 +15,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONMansoTrackerFSMComponent.cxx diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSMComponent.h b/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSMComponent.h index 447a8d3321e..fed3f5f9577 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSMComponent.h +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSMComponent.h @@ -17,7 +17,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONMansoTrackerFSMComponent.h @@ -115,6 +115,23 @@ struct AliHLTMUONRecHitStruct; * This will cause the component to generate warnings when it receives data block * types it does not know how to handle. Without this option the component only * generates debug messages when they are compiled in.
+ * \li -cdbpath path
+ * This allows one to override the path to use for the CDB location. + * path must be a valid CDB URI. By default the HLT system framework + * sets the CDB path.
+ * \li -run number
+ * This allows one to override the run number to use. number must be + * a positive integer number. By default the HLT system framework sets the + * run number.
+ * \li -delaysetup
+ * If indicated then part of the initialisation of the component is forcefully + * delayed to the first event received, i.e. the Start-of-Run event.
+ * \li -dumponerror
+ * This flag will cause the component to dump the data blocks it received if + * an error occurs during the processing of an event.
+ * \li -dumppath path
+ * Allows one to specify the path in which to dump the received data blocks + * if an error occurs.
* *

Standard configuration:

* This component should normally be configured with no extra options. diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructor.cxx b/HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructor.cxx index 043d89443f8..aecf98769f7 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructor.cxx +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructor.cxx @@ -15,7 +15,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /********************************************************************** Created on : 16/05/2007 diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructor.h b/HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructor.h index 31b65c6e117..93ef794e3d8 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructor.h +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructor.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /********************************************************************** Created on : 16/05/2007 diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructorComponent.cxx b/HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructorComponent.cxx index 1398d8aa158..ce0840bd5f0 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructorComponent.cxx +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructorComponent.cxx @@ -15,7 +15,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONTriggerReconstructorComponent.cxx diff --git a/HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructorComponent.h b/HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructorComponent.h index d24b218bdd7..c43e96584b8 100644 --- a/HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructorComponent.h +++ b/HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructorComponent.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONTriggerReconstructorComponent.h @@ -25,6 +25,126 @@ class AliHLTMUONTriggerReconstructor; /** * @class AliHLTMUONTriggerReconstructorComponent * @brief A processing component for the dHLT trigger DDL reconstruction. + * + * The trigger reconstructor component is used to decode the raw data coming + * from the trigger chambers and electronics of the muon spectrometer. + * The local trigger decisions are converted into trigger records which is a + * usable format by the tracking stage. + * No full cluster finding is performed, rather just the fired strip information + * as received from the trigger electronics is converted into global coordinates + * to be used by the tracker as track seeds. + * + *

General properties:

+ * + * Component ID: \b MUONTriggerReconstructor
+ * Library: \b libAliHLTMUON.so
+ * Input Data Types: AliHLTMUONConstants::DDLRawDataType() = "DDL_RAW :MUON"
+ * Output Data Types: AliHLTMUONConstants::TriggerRecordsBlockDataType() = "TRIGRECS:MUON"
+ * + *

Mandatory arguments:

+ * \li -ddl number
+ * This indicates the DDL from which the component is expect to receive data + * and for which it should load the appropriate electronics mapping lookup + * table. + * The number should be in the range [21..22], following local dimuon + * spectrometer DDL numbering. If either the -ddlid, -lut or -delaysetup + * arguments are used, then -ddl becomes optional.
+ * \li -ddlid number
+ * This indicates the DDL by equipment ID, from which the component is expect + * to receive data and for which it should load the appropriate electronics + * mapping lookup table. + * The number should be in the range [2816..2817]. + * If either the -ddl, -lut or -delaysetup arguments are used, then -ddlid + * becomes optional.
+ * \li -delaysetup
+ * Specifying this option causes the component to initialise the lookup table + * and magnetic field parameters from CDB only after receiving the first event + * to process in DoEvent. + * If -ddl or -ddlid were not used, then the DDL number will be taken from + * the first block's specification during runtime from the first + * event (i.e. Start-of-Run event). + * Using the -lut, -zmiddle or -bfieldintegral arguments will override loading + * from CDB for a delayed setup.
+ * + *

Optional arguments:

+ * \li -lut filename
+ * A pree-built lookup table for the electronics mapping and calibration + * information can be loaded with this argument. The file should have been + * generated with the GenerateLookupTable method. The location of the file + * is given by the parameter filename
+ * \li -cdb
+ * Indicates that the component should load from CDB. This option is implicit + * if the -cdbpath is given. It will also override the -lut option.
+ * \li -cdbpath path
+ * Specifies the CDB path to use, given by path. This option will override + * the CDB path automatically set by the HLT framework.
+ * \li -run number
+ * Specifies the run number to use, given by number. This option will + * override the current run number automatically set by the HLT framework.
+ * \li -zmiddle position
+ * This indicates the Z coordinate position of the middle of the dipole magnetic + * field. position is a floating point value in centimeters. Specifying + * this argument on the will override the value loaded from CDB.
+ * \li -bfieldintegral field
+ * This indicates the magnetic field integral for the dipole magnetic field. + * field must be a floating point value in Tesla meters (T.m). + * The sign of the value will indicate the polarity setting of the dipole magnet. + * Specifying this argument on the will override the value loaded from CDB.
+ * \li -warn_on_unexpected_block
+ * This will cause the component to generate warnings when it receives data block + * types it does not know how to handle. Without this option the component only + * generates debug messages when they are compiled in.
+ * \li -suppress_partial_triggers
+ * This option forces all trigger records that have less than 3 hits in them + * to be removed from the output. This is the default setting.
+ * \li -generate_partial_triggers
+ * With this option all trigger records, even partial ones with just one or two + * hits is written to the output.
+ * \li -stop_on_buffer_overflow
+ * If this option is specified then the component will stop processing and generate + * an error code in the DoEvent method as soon as the output buffer has been filled. + * Otherwise the component normally just keeps processing but some data might be lost + * due to full buffers.
+ * \li -tryrecover
+ * This is a special option to the raw data decoder to turn on logic which will + * try and recover from corrupt raw DDL data. This is off by default.
+ * \li -dont_use_crateid
+ * This option indicates that the crate ID values found in the regional structures + * in the raw DDL data should not be used to identify the channels in the offline + * mapping. Rather the position of the raw data structure instead.
+ * \li -dont_use_localid
+ * This option indicates that the local structure ID values found in the raw DDL + * data should not be used to identify the channels in the offline mapping, but + * rather the position of the local structure in the DDL should be used instead.
+ * \li -dumponerror
+ * This flag will cause the component to dump the data blocks it received if + * an error occurs during the processing of an event.
+ * \li -dumppath path
+ * Allows one to specify the path in which to dump the received data blocks + * if an error occurs.
+ * + *

Standard configuration:

+ * The configuration is taken from the CDB by default. It can be overridden with + * the command line arguments. + * + *

Default CDB entries:

+ * HLT/ConfigHLT/HLTGlobalTrigger - Contains the global trigger menu. + * + *

Performance:

+ * This is a linear function of the number of input triggers (AliHLTTrigger) that + * need to be processed. + * For a modest trigger menu configurations the processing time per event should + * be on the order of a few milliseconds. + * + *

Memory consumption:

+ * This is a linear function of the input data size, but only a fraction. Thus the + * memory usage is minimal. It should be under 1 MBytes. + * + *

Output size:

+ * This will depend linearly on the number of tracks found. But for nominal multiplicities + * this should be less than 16 kBytes. + * + * @ingroup alihlt_dimuon_component */ class AliHLTMUONTriggerReconstructorComponent : public AliHLTMUONProcessor { @@ -88,7 +208,22 @@ private: /// Not implemented. AliHLTMUONTriggerReconstructorComponent& operator = (const AliHLTMUONTriggerReconstructorComponent& /*obj*/); + /** + * Read in the lookup table from file. + * \param lutpath The file to read the lookup table from. + */ int ReadLookUpTable(const char* lutpath); + + /** + * Loads the lookup table containing channel and geometrical position + * information about trigger strips from CDB. + * + * \note To override the default CDB path and/or run number the + * SetCDBPathAndRunNo(cdbPath, run) method should be called before this + * method. + * + * \return 0 on success and non zero codes for errors. + */ int ReadLutFromCDB(); /** diff --git a/HLT/MUON/macros/CreateDefaultCDBEntries.C b/HLT/MUON/macros/CreateDefaultCDBEntries.C index e7020cd41e3..7007103894c 100644 --- a/HLT/MUON/macros/CreateDefaultCDBEntries.C +++ b/HLT/MUON/macros/CreateDefaultCDBEntries.C @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id: $ */ +// $Id: $ /** * \ingroup macros @@ -28,7 +28,7 @@ * $ALICE_ROOT/HLT/MUON/macros into your current working directory, then from * the shell command prompt run the following command: * \code - * > aliroot -b -q -l $ALICE_ROOT/HLT/MUON/macros/CreateDefaultCDBEntries.C+ + * > aliroot -b -q -l $ALICE_ROOT/HLT/MUON/macros/CreateDefaultCDBEntries.C * \endcode * * \author Artur Szostak @@ -50,9 +50,36 @@ using std::endl; /** * Generates default CDB entries in the given CDB storage (local by default) * \param cdbPath The path to the local storage. + * \param version = 0, + * \param firstRun = 0, + * \param lastRun = AliCDBRunRange::Infinity() + * \param zmiddle The middle of the dipole field (cm) used by AliHLTMUONTriggerReconstructorComponent and AliHLTMUONMansoTrackerFSMComponent. + * \param bfieldintegral The dipole magnetic field integral (T.m) used by AliHLTMUONTriggerReconstructorComponent and AliHLTMUONMansoTrackerFSMComponent. + * \param dccut DC cut applied to channels by AliHLTMUONHitReconstructorComponent. + * \param roiParamAchamber7 Region of interest parameter A for chamber 7 used by AliHLTMUONMansoTrackerFSMComponent. + * \param roiParamBchamber7 Region of interest parameter B for chamber 7 used by AliHLTMUONMansoTrackerFSMComponent. + * \param roiParamAchamber8 Region of interest parameter A for chamber 8 used by AliHLTMUONMansoTrackerFSMComponent. + * \param roiParamBchamber8 Region of interest parameter B for chamber 8 used by AliHLTMUONMansoTrackerFSMComponent. + * \param roiParamAchamber9 Region of interest parameter A for chamber 9 used by AliHLTMUONMansoTrackerFSMComponent. + * \param roiParamBchamber9 Region of interest parameter B for chamber 9 used by AliHLTMUONMansoTrackerFSMComponent. + * \param roiParamAchamber10 Region of interest parameter A for chamber 10 used by AliHLTMUONMansoTrackerFSMComponent. + * \param roiParamBchamber10 Region of interest parameter B for chamber 10 used by AliHLTMUONMansoTrackerFSMComponent. + * \param lowptcut The low pT cut applied to tracks (GeV/c) used by the AliHLTMUONDecisionComponent. + * \param highptcut The hight pT cut applied to tracks (GeV/c) used by the AliHLTMUONDecisionComponent. + * \param lowmasscut The low invariant mass cut applied to track pairs (GeV/c^2) used by the AliHLTMUONDecisionComponent. + * \param highmasscut The hight invariant mass cut applied to track pairs (GeV/c^2) used by the AliHLTMUONDecisionComponent. + * \param chamber7postion Nominal position for chamber 7 used by AliHLTMUONMansoTrackerFSMComponent. + * \param chamber8postion Nominal position for chamber 8 used by AliHLTMUONMansoTrackerFSMComponent. + * \param chamber9postion Nominal position for chamber 9 used by AliHLTMUONMansoTrackerFSMComponent. + * \param chamber10postion Nominal position for chamber 10 used by AliHLTMUONMansoTrackerFSMComponent. + * \param chamber11postion Nominal position for chamber 11 used by AliHLTMUONMansoTrackerFSMComponent. + * \param chamber13postion Nominal position for chamber 13 used by AliHLTMUONMansoTrackerFSMComponent. */ void CreateDefaultCDBEntries( const char* cdbPath = "local://$ALICE_ROOT/OCDB", + Int_t version = 0, + Int_t firstRun = 0, + Int_t lastRun = AliCDBRunRange::Infinity(), float zmiddle = -975., float bfieldintegral = -3., int dccut = 50, @@ -91,10 +118,6 @@ void CreateDefaultCDBEntries( return; } - Int_t version = 0; - Int_t firstRun = 0; - Int_t lastRun = AliCDBRunRange::Infinity(); - const char* path = NULL; AliCDBMetaData* metaData = NULL; TMap* params = NULL; diff --git a/HLT/MUON/macros/CreateHitRecoLookupTables.C b/HLT/MUON/macros/CreateHitRecoLookupTables.C index f0f0bf335e6..71f979724e8 100644 --- a/HLT/MUON/macros/CreateHitRecoLookupTables.C +++ b/HLT/MUON/macros/CreateHitRecoLookupTables.C @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * \ingroup macros diff --git a/HLT/MUON/macros/CreateTriggerRecoLookupTables.C b/HLT/MUON/macros/CreateTriggerRecoLookupTables.C index cd7ce0d733b..4f6ce8b7568 100644 --- a/HLT/MUON/macros/CreateTriggerRecoLookupTables.C +++ b/HLT/MUON/macros/CreateTriggerRecoLookupTables.C @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * \ingroup macros diff --git a/HLT/MUON/macros/RunChain.C b/HLT/MUON/macros/RunChain.C index 8864346da8e..1216a5d6ee3 100644 --- a/HLT/MUON/macros/RunChain.C +++ b/HLT/MUON/macros/RunChain.C @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * \ingroup macros @@ -105,6 +105,18 @@ using std::endl; * for consistency with the AliHLTMUONDataCheckerComponent. * @param rawDataPath The path of the raw data (i.e. path to the rawXX directories) * or can be the file name if using the "rawreader" option for dataSource. + * @param runNumber Specifies the run number to use. If it is set to -1 then the + * run number is not set if the CDB manager already has a run number set, + * otherwise a default run number of 0 is used. The default value is -1. + * @param cdbPath This gives the CDB path to use. If it is set to NULL then + * the CDB path is not set if the CDB manager already has a default storage + * CDB path set, otherwise a default value of "local://$ALICE_ROOT/OCDB" is used. + * The default value is NULL. + * @param tryrecover If this is true then the "-tryrecover" flag is set in the + * raw data reconstruction components. This is useful if when running RunChain + * log messages appear indicating that there was a problem decoding the raw data. + * The "-tryrecover" flag will turn on recovery logic in the raw data decoders + * to try and overcome errors in the data. */ void RunChain( const char* chainType = "full", @@ -115,7 +127,10 @@ void RunChain( const char* logLevel = "normal", const char* lutDir = "CDB", bool checkData = false, - const char* rawDataPath = "./" + const char* rawDataPath = "./", + Int_t runNumber = -1, + const char* cdbPath = NULL, + bool tryrecover = false ) { // Setup the CDB default storage and run number if nothing was set. @@ -125,14 +140,28 @@ void RunChain( cerr << "ERROR: Global CDB manager object does not exist." << endl; return; } - if (cdbManager->GetDefaultStorage() == NULL) + if (runNumber != -1) { - cdbManager->SetDefaultStorage("local://$ALICE_ROOT/OCDB"); + cdbManager->SetRun(runNumber); } - if (cdbManager->GetRun() == -1) + else if (cdbManager->GetRun() == -1) { cdbManager->SetRun(0); } + if (cdbPath != NULL) + { + cdbManager->SetDefaultStorage(cdbPath); + } + else if (cdbManager->GetDefaultStorage() == NULL) + { + cdbManager->SetDefaultStorage("local://$ALICE_ROOT/OCDB"); + } + + if (cdbManager->GetDefaultStorage() == NULL) + { + cerr << "ERROR: There is no value for the default CDB storage, cannot continue." << endl; + return; + } // Make sure that the lastEvent is greater than firstEvent. if (lastEvent < firstEvent) @@ -388,31 +417,31 @@ void RunChain( // these components if we are are building the ddlreco or full chains. if (buildDDLRecoComps) { - if (TString(lutDir) == "CDB") + const char* recoverFlag = tryrecover ? "-tryrecover" : ""; + for (int k = 13; k <= 22; k++) { - AliHLTConfiguration recDDL13("recDDL13", "MUONHitReconstructor", "pubDDL13", TString("-ddl 13 -cdbpath local://$ALICE_ROOT/OCDB -run 0")); - AliHLTConfiguration recDDL14("recDDL14", "MUONHitReconstructor", "pubDDL14", TString("-ddl 14 -cdbpath local://$ALICE_ROOT/OCDB -run 0")); - AliHLTConfiguration recDDL15("recDDL15", "MUONHitReconstructor", "pubDDL15", TString("-ddl 15 -cdbpath local://$ALICE_ROOT/OCDB -run 0")); - AliHLTConfiguration recDDL16("recDDL16", "MUONHitReconstructor", "pubDDL16", TString("-ddl 16 -cdbpath local://$ALICE_ROOT/OCDB -run 0")); - AliHLTConfiguration recDDL17("recDDL17", "MUONHitReconstructor", "pubDDL17", TString("-ddl 17 -cdbpath local://$ALICE_ROOT/OCDB -run 0")); - AliHLTConfiguration recDDL18("recDDL18", "MUONHitReconstructor", "pubDDL18", TString("-ddl 18 -cdbpath local://$ALICE_ROOT/OCDB -run 0")); - AliHLTConfiguration recDDL19("recDDL19", "MUONHitReconstructor", "pubDDL19", TString("-ddl 19 -cdbpath local://$ALICE_ROOT/OCDB -run 0")); - AliHLTConfiguration recDDL20("recDDL20", "MUONHitReconstructor", "pubDDL20", TString("-ddl 20 -cdbpath local://$ALICE_ROOT/OCDB -run 0")); - AliHLTConfiguration recDDL21("recDDL21", "MUONTriggerReconstructor", "pubDDL21", TString("-ddl 21 -cdbpath local://$ALICE_ROOT/OCDB -run 0 -suppress_partial_triggers")); - AliHLTConfiguration recDDL22("recDDL22", "MUONTriggerReconstructor", "pubDDL22", TString("-ddl 22 -cdbpath local://$ALICE_ROOT/OCDB -run 0 -suppress_partial_triggers")); - } - else - { - AliHLTConfiguration recDDL13("recDDL13", "MUONHitReconstructor", "pubDDL13", TString("-ddl 13 -lut ") + lutDir + TString("/Lut13.dat")); - AliHLTConfiguration recDDL14("recDDL14", "MUONHitReconstructor", "pubDDL14", TString("-ddl 14 -lut ") + lutDir + TString("/Lut14.dat")); - AliHLTConfiguration recDDL15("recDDL15", "MUONHitReconstructor", "pubDDL15", TString("-ddl 15 -lut ") + lutDir + TString("/Lut15.dat")); - AliHLTConfiguration recDDL16("recDDL16", "MUONHitReconstructor", "pubDDL16", TString("-ddl 16 -lut ") + lutDir + TString("/Lut16.dat")); - AliHLTConfiguration recDDL17("recDDL17", "MUONHitReconstructor", "pubDDL17", TString("-ddl 17 -lut ") + lutDir + TString("/Lut17.dat")); - AliHLTConfiguration recDDL18("recDDL18", "MUONHitReconstructor", "pubDDL18", TString("-ddl 18 -lut ") + lutDir + TString("/Lut18.dat")); - AliHLTConfiguration recDDL19("recDDL19", "MUONHitReconstructor", "pubDDL19", TString("-ddl 19 -lut ") + lutDir + TString("/Lut19.dat")); - AliHLTConfiguration recDDL20("recDDL20", "MUONHitReconstructor", "pubDDL20", TString("-ddl 20 -lut ") + lutDir + TString("/Lut20.dat")); - AliHLTConfiguration recDDL21("recDDL21", "MUONTriggerReconstructor", "pubDDL21", TString("-ddl 21 -lut ") + lutDir + TString("/Lut21.dat -suppress_partial_triggers")); - AliHLTConfiguration recDDL22("recDDL22", "MUONTriggerReconstructor", "pubDDL22", TString("-ddl 22 -lut ") + lutDir + TString("/Lut22.dat -suppress_partial_triggers")); + string compId = Form("recDDL%d", k); + string name = (k <= 20) ? "MUONHitReconstructor" : "MUONTriggerReconstructor"; + string parent = Form("pubDDL%d", k); + string cmd; + if (TString(lutDir) == "CDB") + { + const char* path = cdbManager->GetDefaultStorage()->GetURI().Data(); + cmd = Form("-ddl %d -cdbpath %s -run %d %s", + k, path, cdbManager->GetRun(), recoverFlag + ); + } + else + { + cmd = Form("-ddl %d -lut %s/Lut%d.dat %s", + k, lutDir, k, recoverFlag + ); + } + if (k >= 21) + { + cmd += " -suppress_partial_triggers -dont_use_crateid -dont_use_localid"; + } + AliHLTConfiguration recDDL(compId.c_str(), name.c_str(), parent.c_str(), cmd.c_str()); } } @@ -521,6 +550,7 @@ void RunChain( return; } AliHLTOfflineInterface::SetParamsToComponents(NULL, rawReader); + rawReader->NextEvent(); // Need to call this once here or we will start at the wrong event. // Now step through the events. for (int i = 0; i < firstEvent; i++) rawReader->NextEvent(); for (int i = firstEvent; i <= lastEvent; i++) diff --git a/HLT/MUON/macros/rootlogon.C b/HLT/MUON/macros/rootlogon.C index 7f449559542..204e0c408f5 100644 --- a/HLT/MUON/macros/rootlogon.C +++ b/HLT/MUON/macros/rootlogon.C @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id: $ */ +// $Id: $ /** * \ingroup macros diff --git a/HLT/MUON/utils/AliHLTMUONDataCheckerComponent.cxx b/HLT/MUON/utils/AliHLTMUONDataCheckerComponent.cxx index ae9d87c92b2..3bad6d596ae 100644 --- a/HLT/MUON/utils/AliHLTMUONDataCheckerComponent.cxx +++ b/HLT/MUON/utils/AliHLTMUONDataCheckerComponent.cxx @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id: AliHLTMUONDataCheckerComponent.cxx 26179 2008-05-29 22:27:27Z aszostak $ */ +// $Id: AliHLTMUONDataCheckerComponent.cxx 26179 2008-05-29 22:27:27Z aszostak $ /// /// @file AliHLTMUONDataCheckerComponent.cxx @@ -157,6 +157,22 @@ AliHLTComponent* AliHLTMUONDataCheckerComponent::Spawn() } +bool AliHLTMUONDataCheckerComponent::IgnoreArgument(const char* arg) const +{ + /// Return true if the argument is -delaysetup + /// to prevent the parent class from parsing these arguments in DoInit. + + if (strcmp(arg, "-delaysetup") == 0) + { + return true; + } + else + { + return false; + } +} + + int AliHLTMUONDataCheckerComponent::DoInit(int argc, const char** argv) { /// Inherited from AliHLTComponent. diff --git a/HLT/MUON/utils/AliHLTMUONDataCheckerComponent.h b/HLT/MUON/utils/AliHLTMUONDataCheckerComponent.h index aaa38ba32e3..53a5e772c53 100644 --- a/HLT/MUON/utils/AliHLTMUONDataCheckerComponent.h +++ b/HLT/MUON/utils/AliHLTMUONDataCheckerComponent.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id: AliHLTMUONDataCheckerComponent.h 26179 2008-05-29 22:27:27Z aszostak $ */ +// $Id: AliHLTMUONDataCheckerComponent.h 26179 2008-05-29 22:27:27Z aszostak $ /// /// @file AliHLTMUONDataCheckerComponent.h @@ -67,6 +67,20 @@ extern "C" struct AliHLTMUONMansoTrackStruct; * would tell the framework that processing of the event failed. Otherwise * errors are just logged but the data is considered to be processed successfully. * (default behaviour is not to return errors)
+ * \li -cdbpath path
+ * This allows one to override the path to use for the CDB location. + * path must be a valid CDB URI. By default the HLT system framework + * sets the CDB path.
+ * \li -run number
+ * This allows one to override the run number to use. number must be + * a positive integer number. By default the HLT system framework sets the + * run number.
+ * \li -dumponerror
+ * This flag will cause the component to dump the data blocks it received if + * an error occurs during the processing of an event.
+ * \li -dumppath path
+ * Allows one to specify the path in which to dump the received data blocks + * if an error occurs.
* * @ingroup alihlt_dimuon_component */ @@ -101,6 +115,7 @@ protected: AliHLTUInt32_t& size, AliHLTComponentBlockDataList& outputBlocks ); + virtual bool IgnoreArgument(const char* arg) const; using AliHLTProcessor::DoEvent; diff --git a/HLT/MUON/utils/AliHLTMUONEmptyEventFilterComponent.cxx b/HLT/MUON/utils/AliHLTMUONEmptyEventFilterComponent.cxx index 6f3ebf4cceb..751fbcb577d 100644 --- a/HLT/MUON/utils/AliHLTMUONEmptyEventFilterComponent.cxx +++ b/HLT/MUON/utils/AliHLTMUONEmptyEventFilterComponent.cxx @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONEmptyEventFilterComponent.cxx diff --git a/HLT/MUON/utils/AliHLTMUONEmptyEventFilterComponent.h b/HLT/MUON/utils/AliHLTMUONEmptyEventFilterComponent.h index 937f66a907e..6267ad086f9 100644 --- a/HLT/MUON/utils/AliHLTMUONEmptyEventFilterComponent.h +++ b/HLT/MUON/utils/AliHLTMUONEmptyEventFilterComponent.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id$ */ +// $Id$ /// /// @file AliHLTMUONEmptyEventFilterComponent.h @@ -21,6 +21,7 @@ /** * @class AliHLTMUONEmptyEventFilterComponent + * \brief Component for filtering on empty events. * This component class is a utility component for debugging. It is used to filter * empty dHLT events. (Specifically built for the Dec 2007 Cosmic tests where the * muon spectrometer should not see any hits. Therefor we would be interested to @@ -36,11 +37,45 @@ * A dump subscriber can then connect to the empty event filter component to * make sure it only receives events that are not empty. * - * command line parameters: - * -sendempty This parameter causes the component to behave like an anti-filter - * meaning that it will send all events for which the dHLT results data - * blocks were empty. This is useful for collecting those events where dHLT - * is not finding anything but perhaps it should. + *

General properties:

+ * + * Component ID: \b MUONEmptyEventFilter
+ * Library: \b libAliHLTMUON.so
+ * Input Data Types: kAliHLTAnyDataType = "*******:***"
+ * Output Data Types: kAliHLTAnyDataType|kAliHLTDataOriginMUON = "*******:MUON"
+ * + *

Mandatory arguments:

+ * None. + * + *

Optional arguments:

+ * \li -sendempty
+ * This parameter causes the component to behave like an anti-filter + * meaning that it will send all events for which the dHLT results data + * blocks were empty. This is useful for collecting those events where dHLT + * is not finding anything but perhaps it should.
+ * \li -dumponerror
+ * This flag will cause the component to dump the data blocks it received if + * an error occurs during the processing of an event.
+ * \li -dumppath path
+ * Allows one to specify the path in which to dump the received data blocks + * if an error occurs.
+ * + *

Standard configuration:

+ * There is no special configuration for this component. + * + *

Default CDB entries:

+ * None. + * + *

Performance:

+ * Less than a milliseconds per event. + * + *

Memory consumption:

+ * Minimal, under 1 MBytes. + * + *

Output size:

+ * The maximum is the same size as the input data size. + * + * @ingroup alihlt_dimuon_component */ class AliHLTMUONEmptyEventFilterComponent : public AliHLTMUONProcessor { diff --git a/HLT/MUON/utils/AliHLTMUONRawDataHistoComponent.cxx b/HLT/MUON/utils/AliHLTMUONRawDataHistoComponent.cxx index 06616179178..75ee3b29b4f 100644 --- a/HLT/MUON/utils/AliHLTMUONRawDataHistoComponent.cxx +++ b/HLT/MUON/utils/AliHLTMUONRawDataHistoComponent.cxx @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id: $ */ +// $Id: $ /// /// @file AliHLTMUONRawDataHistoComponent.cxx @@ -22,7 +22,8 @@ /// @date 30 April 2008 /// @brief Implementation of the raw data histogramming component for dHLT. /// -/// The class implements +/// The class implements a component for checking basic statistics and errors in +/// raw data from the muon spectrometer. It is useful for basic monitoring. #include "AliHLTMUONRawDataHistoComponent.h" #include "AliHLTMUONConstants.h" @@ -290,8 +291,8 @@ int AliHLTMUONRawDataHistoComponent::DoDeinit() int AliHLTMUONRawDataHistoComponent::DoEvent( - const AliHLTComponentEventData& /*evtData*/, - AliHLTComponentTriggerData& /*trigData*/ + const AliHLTComponentEventData& evtData, + AliHLTComponentTriggerData& trigData ) { /// Inherited from AliHLTProcessor. @@ -312,11 +313,21 @@ int AliHLTMUONRawDataHistoComponent::DoEvent( if (AliHLTMUONUtils::IsTrackerDDL(block->fSpecification)) { - ProcessTrackerDDL(block); + bool decodeOk = ProcessTrackerDDL(block); + if (not decodeOk and DumpDataOnError()) + { + DumpEvent(evtData, trigData); + return -EIO; + } } else if (AliHLTMUONUtils::IsTriggerDDL(block->fSpecification)) { - ProcessTriggerDDL(block); + bool decodeOk = ProcessTriggerDDL(block); + if (not decodeOk and DumpDataOnError()) + { + DumpEvent(evtData, trigData); + return -EIO; + } } else { @@ -364,7 +375,7 @@ int AliHLTMUONRawDataHistoComponent::DoEvent( } -void AliHLTMUONRawDataHistoComponent::ProcessTrackerDDL(const AliHLTComponentBlockData* block) +bool AliHLTMUONRawDataHistoComponent::ProcessTrackerDDL(const AliHLTComponentBlockData* block) { /// Processes a raw data block from the tracker stations. @@ -380,7 +391,7 @@ void AliHLTMUONRawDataHistoComponent::ProcessTrackerDDL(const AliHLTComponentBlo AliHLTUInt8_t* payload = reinterpret_cast(block->fPtr) + sizeof(AliRawDataHeader); UInt_t payloadSize = UInt_t(block->fSize) - sizeof(AliRawDataHeader); - fTrackerDecoder.Decode(payload, payloadSize); + return fTrackerDecoder.Decode(payload, payloadSize); } else { @@ -390,10 +401,11 @@ void AliHLTMUONRawDataHistoComponent::ProcessTrackerDDL(const AliHLTComponentBlo ); fErrorHist[ddl]->Fill(40); } + return false; } -void AliHLTMUONRawDataHistoComponent::ProcessTriggerDDL(const AliHLTComponentBlockData* block) +bool AliHLTMUONRawDataHistoComponent::ProcessTriggerDDL(const AliHLTComponentBlockData* block) { /// Processes a raw data block from the trigger stations. @@ -408,7 +420,7 @@ void AliHLTMUONRawDataHistoComponent::ProcessTriggerDDL(const AliHLTComponentBlo AliHLTUInt8_t* payload = reinterpret_cast(header+1); UInt_t payloadSize = UInt_t(block->fSize) - sizeof(AliRawDataHeader); bool scalarEvent = ((header->GetL1TriggerMessage() & 0x1) == 0x1); - fTriggerDecoder.Decode(payload, payloadSize, scalarEvent); + return fTriggerDecoder.Decode(payload, payloadSize, scalarEvent); } else { @@ -418,6 +430,7 @@ void AliHLTMUONRawDataHistoComponent::ProcessTriggerDDL(const AliHLTComponentBlo ); fErrorHist[ddl]->Fill(40); } + return false; } diff --git a/HLT/MUON/utils/AliHLTMUONRawDataHistoComponent.h b/HLT/MUON/utils/AliHLTMUONRawDataHistoComponent.h index 845f798bdc4..1364b4f4995 100644 --- a/HLT/MUON/utils/AliHLTMUONRawDataHistoComponent.h +++ b/HLT/MUON/utils/AliHLTMUONRawDataHistoComponent.h @@ -4,7 +4,7 @@ * ALICE Experiment at CERN, All rights reserved. * * See cxx source for full Copyright notice */ -/* $Id: $ */ +// $Id: $ /// /// @file AliHLTMUONRawDataHistoComponent.h @@ -22,6 +22,59 @@ /** * @class AliHLTMUONRawDataHistoComponent * @brief Dimuon HLT component for generating basic monitoring histograms for raw data. + * + * This component is useful for performing basic monitoring tasks on the raw data + * from the muon spectrometer. It will try and decode the data and histogram the + * following information: + * \li The distribution of signals per DDL. + * \li The number of ADC values found per MANU for each DDL. + * \li The error codes found by the decoders while trying to decode the data for each DDL. + * + *

General properties:

+ * + * Component ID: \b MUONRawDataHistogrammer
+ * Library: \b libAliHLTMUON.so
+ * Input Data Types: AliHLTMUONConstants::DDLRawDataType() = "DDL_RAW :MUON"
+ * Output Data Types: AliHLTMUONConstants::HistogramDataType() = "ROOTHIST:MUON"
+ * + *

Mandatory arguments:

+ * None. + * + *

Optional arguments:

+ * \li -pubdelay delay
+ * Indicates the number of seconds to wait between publishing the histograms. + * The default is zero seconds. delay must be a positive floating point + * number.
+ * \li -noemptyhists
+ * If indicated then any histograms that are empty will not be published. + * By default all events are processed.
+ * \li -onlydataevents
+ * If indicated then only data events are processed. + * By default all events are processed.
+ * \li -clearafterpub
+ * If specified then all the internal histograms are cleared after they are + * published, so they will not accumilate statistics over the whole run. + * This is off by default.
+ * \li -tryrecover
+ * This is a special option to the raw data decoder to turn on logic which will + * try and recover from corrupt raw DDL data. This is off by default.
+ * + *

Standard configuration:

+ * There is no special configuration for this component. + * + *

Default CDB entries:

+ * None. + * + *

Performance:

+ * A few milliseconds per event. + * + *

Memory consumption:

+ * Minimal, under 1 MBytes. + * + *

Output size:

+ * A few kBytes. + * + * @ingroup alihlt_dimuon_component */ class AliHLTMUONRawDataHistoComponent : public AliHLTMUONProcessor { @@ -157,8 +210,23 @@ private: AliHLTMUONRawDataHistoComponent(const AliHLTMUONRawDataHistoComponent& /*obj*/); AliHLTMUONRawDataHistoComponent& operator = (const AliHLTMUONRawDataHistoComponent& /*obj*/); - void ProcessTrackerDDL(const AliHLTComponentBlockData* block); - void ProcessTriggerDDL(const AliHLTComponentBlockData* block); + /** + * Decodes the tracker DDL data block and fills the histograms. + * \param block The data block to decode. + * \returns true if the block could be decoded and false if there was an error in the data. + */ + bool ProcessTrackerDDL(const AliHLTComponentBlockData* block); + + /** + * Decodes the trigger DDL data block and fills the histograms. + * \param block The data block to decode. + * \returns true if the block could be decoded and false if there was an error in the data. + */ + bool ProcessTriggerDDL(const AliHLTComponentBlockData* block); + + /** + * Deletes all the histograms and resets the pointers. + */ void FreeObjects(); AliMUONTrackerDDLDecoder fTrackerDecoder; // Raw data decoder for the tracker data. diff --git a/HLT/MUON/utils/dHLTdumpraw.cxx b/HLT/MUON/utils/dHLTdumpraw.cxx index 2fb8a5d7ac8..83ac71697ee 100644 --- a/HLT/MUON/utils/dHLTdumpraw.cxx +++ b/HLT/MUON/utils/dHLTdumpraw.cxx @@ -13,7 +13,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id$ */ +// $Id$ /** * @file dHLTdumpraw.cxx diff --git a/HLT/MUON/utils/dHLTrootify.cxx b/HLT/MUON/utils/dHLTrootify.cxx index 1cd5c342031..9e23d6c4996 100644 --- a/HLT/MUON/utils/dHLTrootify.cxx +++ b/HLT/MUON/utils/dHLTrootify.cxx @@ -14,7 +14,7 @@ * provided "as is" without express or implied warranty. * **************************************************************************/ -/* $Id: $ */ +// $Id: $ /** * @file dHLTrootify.cxx diff --git a/HLT/trigger/AliHLTGlobalTriggerComponent.h b/HLT/trigger/AliHLTGlobalTriggerComponent.h index 6fb958d258d..3864b792b59 100644 --- a/HLT/trigger/AliHLTGlobalTriggerComponent.h +++ b/HLT/trigger/AliHLTGlobalTriggerComponent.h @@ -31,9 +31,10 @@ class AliHLTGlobalTrigger; * Component ID: \b HLTGlobalTrigger
* Library: \b libAliHLTTrigger.so
* Input Data Types: ::kAliHLTAnyDataType
- * Output Data Types: kAliHLTDataTypeTObject|kAliHLTDataOriginOut
+ * Output Data Types: kAliHLTDataTypeGlobalTrigger and kAliHLTDataTypeReadoutList
* *

Mandatory arguments:

+ * None. * *

Optional arguments:

* @@ -59,8 +60,7 @@ class AliHLTGlobalTrigger; * Indicates that the CTP data should not be added to the global HLT trigger decision. * *

Configuration:

- * - * Configuration by component arguments. + * Configured from CDB but can be overridden with the -config argument. * *

Default CDB entries:

* HLT/ConfigHLT/HLTGlobalTrigger - Contains the global trigger menu.