]> git.uio.no Git - u/mrichter/AliRoot.git/commitdiff
Improving documentation and macros.
authoraszostak <aszostak@f7af4fe6-9843-0410-8265-dc069ae4e863>
Tue, 10 Nov 2009 19:21:49 +0000 (19:21 +0000)
committeraszostak <aszostak@f7af4fe6-9843-0410-8265-dc069ae4e863>
Tue, 10 Nov 2009 19:21:49 +0000 (19:21 +0000)
Fixing up svn Id log tags.
Removing obsolete files.

87 files changed:
HLT/MUON/AliHLTMUONChannelsBlockStruct.cxx
HLT/MUON/AliHLTMUONChannelsBlockStruct.h
HLT/MUON/AliHLTMUONClustersBlockStruct.cxx
HLT/MUON/AliHLTMUONClustersBlockStruct.h
HLT/MUON/AliHLTMUONConstants.cxx
HLT/MUON/AliHLTMUONConstants.h
HLT/MUON/AliHLTMUONCountedList.h
HLT/MUON/AliHLTMUONDataBlockReader.h
HLT/MUON/AliHLTMUONDataBlockWriter.h
HLT/MUON/AliHLTMUONDataTypes.h
HLT/MUON/AliHLTMUONDecision.cxx
HLT/MUON/AliHLTMUONDecision.h
HLT/MUON/AliHLTMUONEvent.cxx
HLT/MUON/AliHLTMUONEvent.h
HLT/MUON/AliHLTMUONLinkDef.h
HLT/MUON/AliHLTMUONList.h
HLT/MUON/AliHLTMUONMansoCandidatesBlockStruct.cxx
HLT/MUON/AliHLTMUONMansoCandidatesBlockStruct.h
HLT/MUON/AliHLTMUONMansoTrack.cxx
HLT/MUON/AliHLTMUONMansoTrack.h
HLT/MUON/AliHLTMUONMansoTracksBlockStruct.cxx
HLT/MUON/AliHLTMUONMansoTracksBlockStruct.h
HLT/MUON/AliHLTMUONPairsDecisionBlockStruct.cxx
HLT/MUON/AliHLTMUONPairsDecisionBlockStruct.h
HLT/MUON/AliHLTMUONProcessor.cxx
HLT/MUON/AliHLTMUONProcessor.h
HLT/MUON/AliHLTMUONRecHit.cxx
HLT/MUON/AliHLTMUONRecHit.h
HLT/MUON/AliHLTMUONRecHitsBlockStruct.cxx
HLT/MUON/AliHLTMUONRecHitsBlockStruct.h
HLT/MUON/AliHLTMUONSinglesDecisionBlockStruct.cxx
HLT/MUON/AliHLTMUONSinglesDecisionBlockStruct.h
HLT/MUON/AliHLTMUONTrigRecsDebugBlockStruct.cxx
HLT/MUON/AliHLTMUONTrigRecsDebugBlockStruct.h
HLT/MUON/AliHLTMUONTriggerRecord.cxx
HLT/MUON/AliHLTMUONTriggerRecord.h
HLT/MUON/AliHLTMUONTriggerRecordsBlockStruct.cxx
HLT/MUON/AliHLTMUONTriggerRecordsBlockStruct.h
HLT/MUON/AliHLTMUONUtils.cxx
HLT/MUON/AliHLTMUONUtils.h
HLT/MUON/OfflineInterface/AliHLTMUONAgent.cxx
HLT/MUON/OfflineInterface/AliHLTMUONAgent.h
HLT/MUON/OfflineInterface/AliHLTMUONDigitPublisherComponent.cxx
HLT/MUON/OfflineInterface/AliHLTMUONDigitPublisherComponent.h
HLT/MUON/OfflineInterface/AliHLTMUONESDMaker.cxx
HLT/MUON/OfflineInterface/AliHLTMUONESDMaker.h
HLT/MUON/OfflineInterface/AliHLTMUONRecHitsSource.cxx
HLT/MUON/OfflineInterface/AliHLTMUONRecHitsSource.h
HLT/MUON/OfflineInterface/AliHLTMUONRootifierComponent.cxx
HLT/MUON/OfflineInterface/AliHLTMUONRootifierComponent.h
HLT/MUON/OfflineInterface/AliHLTMUONTriggerRecordsSource.cxx
HLT/MUON/OfflineInterface/AliHLTMUONTriggerRecordsSource.h
HLT/MUON/OnlineAnalysis/AliHLTMUONCalculations.cxx
HLT/MUON/OnlineAnalysis/AliHLTMUONCalculations.h
HLT/MUON/OnlineAnalysis/AliHLTMUONClusterFinderComponent.cxx
HLT/MUON/OnlineAnalysis/AliHLTMUONClusterFinderComponent.h
HLT/MUON/OnlineAnalysis/AliHLTMUONDecisionComponent.cxx
HLT/MUON/OnlineAnalysis/AliHLTMUONDecisionComponent.h
HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructor.cxx
HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructor.h
HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructorComponent.cxx
HLT/MUON/OnlineAnalysis/AliHLTMUONHitReconstructorComponent.h
HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerComponent.cxx [deleted file]
HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerComponent.h [deleted file]
HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSM.cxx
HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSM.h
HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSMCallback.h
HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSMComponent.cxx
HLT/MUON/OnlineAnalysis/AliHLTMUONMansoTrackerFSMComponent.h
HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructor.cxx
HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructor.h
HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructorComponent.cxx
HLT/MUON/OnlineAnalysis/AliHLTMUONTriggerReconstructorComponent.h
HLT/MUON/macros/CreateDefaultCDBEntries.C
HLT/MUON/macros/CreateHitRecoLookupTables.C
HLT/MUON/macros/CreateTriggerRecoLookupTables.C
HLT/MUON/macros/RunChain.C
HLT/MUON/macros/rootlogon.C
HLT/MUON/utils/AliHLTMUONDataCheckerComponent.cxx
HLT/MUON/utils/AliHLTMUONDataCheckerComponent.h
HLT/MUON/utils/AliHLTMUONEmptyEventFilterComponent.cxx
HLT/MUON/utils/AliHLTMUONEmptyEventFilterComponent.h
HLT/MUON/utils/AliHLTMUONRawDataHistoComponent.cxx
HLT/MUON/utils/AliHLTMUONRawDataHistoComponent.h
HLT/MUON/utils/dHLTdumpraw.cxx
HLT/MUON/utils/dHLTrootify.cxx
HLT/trigger/AliHLTGlobalTriggerComponent.h

index 46248858bbb58357e58e923106f02a60bac5be27..c2ef4ad726c07f90803d2c62b766a9c8a5271289 100644 (file)
@@ -13,7 +13,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 ///
 /// @file   AliHLTMUONChannelsBlockStruct.cxx
index 7a4303f4b5fe191b3a366832a2ce64e8d70161b4..eaba97165e6651988575d7c12848066ddd3aedfc 100644 (file)
@@ -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
index 8ee629eb2178742b616a7358da5d14ccc3562e40..f61f61d37fe5ae6889d97942b29968b4fa93ca99 100644 (file)
@@ -13,7 +13,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  * @file   AliHLTMUONClustersBlockStruct.cxx
index 35266e1ea82e1e647455ad493d419af569e96fba..cc61b544338a7c31de87fb1e2c08f22ad6cc4d71 100644 (file)
@@ -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
index 722f7493e21ee349721dada2c19d4d1255f86837..ca4eaaf2298c0f76caf91122232e4e8431a339bc 100644 (file)
@@ -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:                                                       *
  * 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
index 08f283131f10f760a1b688f5cb755ee3e1e82ba3..215a6d3ee6501b074df49e9a642650efcbd94919 100644 (file)
@@ -17,7 +17,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  * @file   AliHLTMUONConstants.h
index 55e0ca5f1d3fe4364dc07c8ff8b62d0a1dfd76c7..71b0b4d25fda02ead2d36f59257d451e5c327f46 100644 (file)
@@ -15,7 +15,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  * @file   AliHLTMUONCountedList.h
index ef39b66d9f09d985b90c719377aebdbe2674e861..418acea1b3861197905c0e173798b724575b28a0 100644 (file)
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  * @file   AliHLTMUONDataBlockReader.h
  * @author Artur Szostak <artursz@iafrica.com>
- * @date   
+ * @date   19 May 2007
  * @brief  Definition of a reader class for internal dimuon HLT raw data blocks.
  */
 
index c83050231d2ace9d669d26c739032bfed29bb600..d3f49cad64a6eeab6a6adf923eb871533146eb67 100644 (file)
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  * @file   AliHLTMUONDataBlockWriter.h
  * @author Artur Szostak <artursz@iafrica.com>
- * @date   
+ * @date   19 May 2007
  * @brief  Definition of a writer class for internal dimuon HLT raw data blocks.
  */
 
index 1e90e1e768e7ad6f84715a629552d57ba425a37e..8fae57b9e358adcfe33e5c42f542ceac5fbd4fed 100644 (file)
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  * @file   AliHLTMUONDataTypes.h
  * @author Artur Szostak <artursz@iafrica.com>
- * @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
index 0b6e6e71490c27840287b8f85420ba288d1db2f6..351ccd1c5192b363500d7a2d06029016b3660f1a 100644 (file)
@@ -14,7 +14,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id: $ */
+// $Id: $
 
 ///
 /// @file   AliHLTMUONDecision.cxx
index ad883d33ad3b4a11d6e0e830bd1bcd1a91c23a19..36ec21a9f6054fdf6cb7c895732c2507f45111a7 100644 (file)
@@ -4,7 +4,7 @@
  * ALICE Experiment at CERN, All rights reserved.                         *
  * See cxx source for full Copyright notice                               */
 
-/* $Id: $ */
+// $Id: $
 
 ///
 /// @file   AliHLTMUONDecision.h
index 106fbb66e31a081e677f252c30d56fa1e7030351..fe5b61b975b52f92de93b2ecdde0928612f8d868 100644 (file)
@@ -14,7 +14,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id: $ */
+// $Id: $
 
 ///
 /// @file   AliHLTMUONEvent.cxx
index 640464599e7fc6c6d581257c980e001a2bebd3fe..cb35c8c5f9d25dd127e034f02f5ecb2c5349d910 100644 (file)
@@ -4,7 +4,7 @@
  * ALICE Experiment at CERN, All rights reserved.                         *
  * See cxx source for full Copyright notice                               */
 
-/* $Id: $ */
+// $Id: $
 
 ///
 /// @file   AliHLTMUONRootifierComponent.h
index 94b6ac472ffda82bf302f8ae14cf2fed7c3e00a1..f552d096e00d6198759356e62a89bdcd9f76ec8b 100644 (file)
@@ -14,7 +14,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 ///
 /// @file   HLTMUONLinkDef.h
index d5e34bb4e9739938f20d7a3436e4789ec9bd2e2c..6cfa855927cfff75b3fa89d6b9606e470956ce2e 100644 (file)
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  * @file   AliHLTMUONList.h
  * @author Artur Szostak <artursz@iafrica.com>
- * @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"
index 8dee54a85000ca3051790a53c8bebb7e392d81a4..5319264dbe52b90daefb562afe90862ba6c13082 100644 (file)
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  * @file   AliHLTMUONMansoCandidatesBlockStruct.cxx
  * @author Artur Szostak <artursz@iafrica.com>
- * @date   
+ * @date   21 May 2007
  * @brief  Implementation of useful stream and comparison operators.
  */
 
index 5da8e0bd15cba445eeb22693b8703dd9c3dcf570..46cdaf4b522bda40fadbd34e1f7a84bd02c5aadd 100644 (file)
@@ -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 <artursz@iafrica.com>
- * @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.
  */
index 73ec3bef404ace3069add3d7e6d5e161e55be5f4..e3259fd51b77e19c254439b506f0738f648456b1 100644 (file)
@@ -14,7 +14,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 ///
 /// @file   AliHLTMUONMansoTrack.cxx
index 29749d51d83e92426f8e4d1498758a74b8d34be8..65587d4e6d71e68403e849d40cd6189253f3f19c 100644 (file)
@@ -4,7 +4,7 @@
  * ALICE Experiment at CERN, All rights reserved.                         *
  * See cxx source for full Copyright notice                               */
 
-/* $Id$ */
+// $Id$
 
 ///
 /// @file   AliHLTMUONMansoTrack.h
index c90938c1274bbd312e062cc373d8995640982b18..53b03cbcdf090decd4254aadc1090c835b860092 100644 (file)
@@ -13,7 +13,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 ///
 /// @file   AliHLTMUONMansoTracksBlockStruct.cxx
index e5f4a7dfb6b8808f6feb1be7958f0016a65566e7..d3485684d534745f3cb55eae5fc8496c8daae9c6 100644 (file)
@@ -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
index 9e75cbec984c9541ab53cb76d755e36f84b37181..8cdb794c23e097bb70acd768ef9a0a3089cd3c04 100644 (file)
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  * @file   AliHLTMUONPairsDecisionBlockStruct.cxx
  * @author Artur Szostak <artursz@iafrica.com>
- * @date   
+ * @date   21 May 2007
  * @brief  Implementation of useful stream and comparison operators.
  */
 
index a14d928ff8e760d225e6d7b29bb1bc905a2e8051..f3f9dad84594421e5c866487e9ecf43ce92b6f32 100644 (file)
@@ -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 <artursz@iafrica.com>
- * @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.
  */
index 5c34fc6451fa7cadc8490db50330b62491f15d26..f3281426de57a9e8fefd7a1e1b62927ccb731def 100644 (file)
@@ -14,7 +14,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id: $ */
+// $Id: $
 
 ///
 /// @file   AliHLTMUONProcessor.cxx
index 97125a1d2aca489f54807c6973ce2306387e1874..d788f108d35ecc245f3d5bb3a3828286d39b6f5b 100644 (file)
@@ -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 <i>path</i> <br>
+ *      This allows one to override the path to use for the CDB location.
+ *      <i>path</i> must be a valid CDB URI. By default the HLT system framework
+ *      sets the CDB path. <br>
+ * \li -run <i>number</i> <br>
+ *      This allows one to override the run number to use. <i>number</i> must be
+ *      a positive integer number. By default the HLT system framework sets the
+ *      run number. <br>
+ * \li -delaysetup <br>
+ *      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. <br>
+ * \li -dumponerror <br>
+ *      This flag will cause the component to dump the data blocks it received if
+ *      an error occurs during the processing of an event. <br>
+ * \li -dumppath <i>path</i> <br>
+ *      Allows one to specify the path in which to dump the received data blocks
+ *      if an error occurs. <br>
+ *
  * @ingroup alihlt_dimuon_component
  */
 class AliHLTMUONProcessor : public AliHLTProcessor
index d9d61c1a5c34e85926701946ebe493e08033de0d..a4fe521c472d78b00fc25d7a4512aac378eb5624 100644 (file)
@@ -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:                                                       *
  * 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
index a421331134b701af2fe67710debd891a2c6fef4c..e249d93422abf35610fc11f46d0975991e1072b4 100644 (file)
@@ -4,7 +4,7 @@
  * ALICE Experiment at CERN, All rights reserved.                         *
  * See cxx source for full Copyright notice                               */
 
-/* $Id$ */
+// $Id$
 
 ///
 /// @file   AliHLTMUONRecHit.h
index 78dc1f9c63c692ddd28eb095560ac7e028a2dd7e..71f17c373680c0fb662d2cade3a9617e7cba634b 100644 (file)
@@ -13,7 +13,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  * @file   AliHLTMUONRecHitsBlockStruct.h
index b7edcb4875fff8a76d001bc62bfaff000c6b38d3..a3a263a3d0e780f99c7df664eb51e48c3f8ff678 100644 (file)
@@ -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 <artursz@iafrica.com>
  * @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.
  */
index 4df793b3d7d0e0134ea4b52a4c81c43390f86d36..4e1cf2c378fad5c74fb630482f0f6811159fa7d2 100644 (file)
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  * @file   AliHLTMUONSinglesDecisionBlockStruct.cxx
  * @author Artur Szostak <artursz@iafrica.com>
- * @date   
+ * @date   21 May 2007
  * @brief  Implementation of useful stream and comparison operators.
  */
 
index 82a93a39b129a737b4c37126ba7a52b4245a0c09..4bb1db11ee328c7749efb625053b4a85cd429bb8 100644 (file)
@@ -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 <artursz@iafrica.com>
- * @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.
  */
index 3b96b9240916d8599adbdc1810c86955202ced13..880c9569171c18ba28d2be42b328879a323fb5f9 100644 (file)
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  * @file   AliHLTMUONTrigRecsDebugBlockStruct.cxx
  * @author Artur Szostak <artursz@iafrica.com>
- * @date   
+ * @date   19 May 2007
  * @brief  Implementation of useful stream and comparison operators.
  */
 
index 97c0bbef34bc6953f9b237fb4847fd4bb745734b..c4a779a6dec10075eacfae31cca089d568eda510 100644 (file)
@@ -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 <artursz@iafrica.com>
- * @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.
  */
index 4ebd945ec46481ae173908d092640e8b3b5ce0fb..126b29305b5fac7ca00221fad16650e149c9b8d4 100644 (file)
@@ -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:                                                       *
  * 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
index d5514e3fd4784b463bbbdf3efc011444d722daf9..500d944eade01aea76f2029d1b1762f99a5746a7 100644 (file)
@@ -4,7 +4,7 @@
  * ALICE Experiment at CERN, All rights reserved.                         *
  * See cxx source for full Copyright notice                               */
 
-/* $Id$ */
+// $Id$
 
 ///
 /// @file   AliHLTMUONTriggerRecord.h
index bd1f6af660504dcbb74ac4a129ec8d974de8c5a2..394ae71d5f9341136a1ef6238106249b7c0fd4ed 100644 (file)
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  * @file   AliHLTMUONTriggerRecordsBlockStruct.cxx
  * @author Artur Szostak <artursz@iafrica.com>
- * @date   
+ * @date   18 May 2007
  * @brief  Implementation of useful stream and comparison operators.
  */
 
index ee1a019c3033c842f0757faba8788b2aff645ac6..601ec28e10562fd6adf46992eae79aa0b49c6787 100644 (file)
@@ -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 <artursz@iafrica.com>
- * @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.
  */
index 1fb7c59bba558518d6f1ce4b4637d7489185184e..aa371137c6aace4efae8b0a7c4289c6089581906 100644 (file)
@@ -13,7 +13,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 ///
 /// @file   AliHLTMUONUtils.cxx
index ee93a424b40b7c16f145dc852a9e0e2170bf5d08..366e5280255cfff612ce41e1b62eec47c1a131eb 100644 (file)
@@ -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
index abe5853388d23de50fbb322a71730da04d8e42a8..82f3147b71d753f40aecf1246d601abc5ffe6f0a 100644 (file)
@@ -13,7 +13,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 ///
 /// @file   AliHLTMUONAgent.cxx
index 5b77b9fefd5ac9ac90c96208aa422de2b0b416af..8b699eb116dcd8b1ef6fd37096c0273366ff7ed7 100644 (file)
@@ -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 <artursz@iafrica.com>
 /// @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"
index d180e10725741ed3c82d77dbd52076dcbba58de3..6548383886456082dd31428c15073e6352f6596c 100644 (file)
@@ -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
index cdfcd6f408e7d08fa6efcf48ac159a013a3189f1..59db0f2eb302f7e6900e6c2683bfd59f79089936 100644 (file)
@@ -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
index 83feee336a5c9f3cbb2f75d7092c4e7780b97acf..e674377e524ee44280fcef44cdcde98a4f8ad124 100644 (file)
@@ -14,7 +14,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id: $ */
+// $Id: $
 
 ///
 /// @file   AliHLTMUONESDMaker.cxx
index 8e5fe7bd81fecc6ac9ad883192d3c6758ad6591f..b65c185d5a7b0064e4a2c02d5850de258da9ba0c 100644 (file)
@@ -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.
  * \li -make_minimal_esd <br>
  *       Indicates that AliESDEvent objects should be created with only the TClonesArray
  *       for the muon tracks created. (default is to generate all standard ESD objects)<br>
+ * \li -add_rootified_objects <br>
+ *       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.<br>
  * \li -warn_on_unexpected_block <br>
  *       If set, then warning messages are generated for any data block types that
  *       were not expected. (default is to generate only debug messages)<br>
+ * \li -dumponerror <br>
+ *      This flag will cause the component to dump the data blocks it received if
+ *      an error occurs during the processing of an event. <br>
+ * \li -dumppath <i>path</i> <br>
+ *      Allows one to specify the path in which to dump the received data blocks
+ *      if an error occurs. <br>
  *
  * @ingroup alihlt_dimuon_component
  */
index a65e47cb568a0c60de582e8ffd67adb40aab97e5..9fa31dd0637dd0aef760b0629ce513a75898d0ff 100644 (file)
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 ///
 /// @file   AliHLTMUONRecHitsSource.cxx
 /// @author Artur Szostak <artursz@iafrica.com>
-/// @date   
+/// @date   28 May 2007
 /// @brief  Implementation of the AliHLTMUONRecHitsSource component.
 ///
 
index c43b228c755edc02534b9057c5224ed4374c4de0..b0e4d00280052df1d251a79fb3d4531a165ebbe0 100644 (file)
@@ -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:                                                       *
  * 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 <artursz@iafrica.com>
-/// @date   
+/// @date   28 May 2007
 /// @brief  Class for generating reconstructed hits data blocks from AliRoot data.
 ///
 
index 674c1a3fd94db3967d768443f563f0ac97e43a8a..1b22e6383ed72f2fb79807bbe1ebc000b94c79e1 100644 (file)
@@ -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:                                                       *
  * 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();
 }
 
index 6bca3dc2858507d44b803b6cb70958236f33f228..326985143802af23fc26e3e9b716f44c1b74e800 100644 (file)
@@ -4,7 +4,7 @@
  * ALICE Experiment at CERN, All rights reserved.                         *
  * See cxx source for full Copyright notice                               */
 
-/* $Id$ */
+// $Id$
 
 ///
 /// @file   AliHLTMUONRootifierComponent.h
 #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.
+ *
+ * <h2>General properties:</h2>
+ *
+ * Component ID: \b MUONRootifier <br>
+ * Library: \b libAliHLTMUON.so <br>
+ * Input Data Types:  kAliHLTAnyDataType = "*******:***" <br>
+ * Output Data Types: AliHLTMUONConstants::RootifiedEventDataType() = "ROOTEVNT:MUON" <br>
+ *
+ * <h2>Mandatory arguments:</h2>
+ * None.
+ *
+ * <h2>Optional arguments:</h2>
+ * \li -warn_on_unexpected_block <br>
+ *      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. <br>
+ * \li -dumponerror <br>
+ *      This flag will cause the component to dump the data blocks it received if
+ *      an error occurs during the processing of an event. <br>
+ * \li -dumppath <i>path</i> <br>
+ *      Allows one to specify the path in which to dump the received data blocks
+ *      if an error occurs. <br>
+ *
+ * <h2>Standard configuration:</h2>
+ * There is no special configuration for this component.
+ *
+ * <h2>Default CDB entries:</h2>
+ * None.
+ *
+ * <h2>Performance:</h2>
+ * A few milliseconds per event.
+ *
+ * <h2>Memory consumption:</h2>
+ * A few MBytes.
+ *
+ * <h2>Output size:</h2>
+ * A few kBytes.
+ *
+ * @ingroup alihlt_dimuon_component
  */
 class AliHLTMUONRootifierComponent : public AliHLTMUONProcessor
 {
index aa6163dc31ed70286482bf4420b3ee24d4f6528d..bfe48b338292523ab338929f321d2c2bec545da9 100644 (file)
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  * @file   AliHLTMUONTriggerRecordsSource.cxx
  * @author Artur Szostak <artursz@iafrica.com>
- * @date   
+ * @date   16 Sep 2007
  * @brief  Implementation of the AliHLTMUONTriggerRecordsSource component.
  */
 
index 9bc7c4315db24b9affb1c1e529a27a656881e845..7e065eb05f1181ccbe419ea33a95c337380ec1eb 100644 (file)
@@ -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:                                                       *
  * 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 <artursz@iafrica.com>
- * @date   
+ * @date   16 Sep 2007
  * @brief  Class for generating trigger record data blocks from AliRoot data.
  */
 
index 4e32e70faca19c9db7f71396aed69c42b4d8409c..e1c1f18e0ded862b56a5acaa8cbac3fa64280a0a 100644 (file)
@@ -13,7 +13,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 ////////////////////////////////////////////////////////////////////////////////
 //
index 095a77015ddfdfe3680b80850aad92c42943f6af..f5832e3326abc3186c123b5d081e7d21be44628a 100644 (file)
@@ -3,7 +3,7 @@
 /* Copyright(c) 1998-2007, ALICE Experiment at CERN, All rights reserved. *
  * See cxx source for full Copyright notice                               */
 
-/* $Id$ */
+// $Id$
 
 ////////////////////////////////////////////////////////////////////////////////
 //
index 839669845fff2b9f27c2459498af8f0580d29dbd..d5cb8073fb043f2972e2386c67a2bc82ac8ed6cb 100644 (file)
@@ -14,7 +14,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id:  $ */
+// $Id:  $
 
 ///
 /// @file   AliHLTMUONClusterFinderComponent.cxx
index c664db44fabfa9e3e66085622e39cb66632aeb94..c077ec947c261f9afac8e7e9e41ad40282bcc96b 100644 (file)
@@ -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 <i>number</i> <br>
  *      Specifies the run number to use, given by <i>number</i>. This option will
  *      override the current run number automatically set by the HLT framework. <br>
+ * \li -dumponerror <br>
+ *      This flag will cause the component to dump the data blocks it received if
+ *      an error occurs during the processing of an event. <br>
+ * \li -dumppath <i>path</i> <br>
+ *      Allows one to specify the path in which to dump the received data blocks
+ *      if an error occurs. <br>
  * \li -tryrecover <br>
  *      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. <br>
+ * \li -nostore <br>
+ *      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. <br>
+ * \li -makehits <br>
+ *      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. <br>
  *
  * <h2>Standard configuration:</h2>
  * 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.
  *
  * <h2>Performance:</h2>
- * A few tens of Hertz.
+ * A few tens of Hertz during online running.
  *
  * <h2>Memory consumption:</h2>
  * A few MBytes.
index 89e02d8697eee08f9cec9a46e67ec0f7ceafbae5..74ce1333eb82340701ed30e2f59b564244df65bc 100644 (file)
@@ -14,7 +14,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id: $ */
+// $Id: $
 
 ///
 ///  @file   AliHLTMUONDecisionComponent.cxx
index 82cb8fd5ea6e8ae8b27a41b804d4b9d95d5b6587..d8ada98fe7d35344980cbe6c4efb8a4b7887f433 100644 (file)
@@ -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.
+ *
+ * <h2>General properties:</h2>
+ *
+ * Component ID: \b MUONDecisionComponent <br>
+ * Library: \b libAliHLTMUON.so <br>
+ * Input Data Types: AliHLTMUONConstants::MansoTracksBlockDataType() = "MANTRACK:MUON" <br>
+ * Output Data Types: \li AliHLTMUONConstants::SinglesDecisionBlockDataType() = "DECIDSIN:MUON"
+ *                    \li AliHLTMUONConstants::PairsDecisionBlockDataType() = "DECIDPAR:MUON" <br>
+ *
+ * <h2>Mandatory arguments:</h2>
+ * None.
+ *
+ * <h2>Optional arguments:</h2>
+ * <!-- NOTE: ignore the \li. <i> and </i>: it's just doxygen formatting -->
+ * \li -lowptcut <i>value</i> <br>
+ *      Sets the low pT cut value to use when applying the decision. The <i>value</i>
+ *      should be a floating point number and has units GeV/c. If this parameter is
+ *      specified then it will not be loaded from CDB. <br>
+ * \li -highptcut <i>value</i> <br>
+ *      Sets the high pT cut value to use when applying the decision. The <i>value</i>
+ *      should be a floating point number and has units GeV/c. If this parameter is
+ *      specified then it will not be loaded from CDB. <br>
+ * \li -lowmasscut <i>value</i> <br>
+ *      Sets the low invariant mass cut value to use when applying the decision.
+ *      The <i>value</i> 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. <br>
+ * \li -highmasscut <i>value</i> <br>
+ *      Sets the high invariant mass cut value to use when applying the decision.
+ *      The <i>value</i> 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. <br>
+ * \li -no_singles_detail <br>
+ *      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. <br>
+ * \li -no_pairs_detail <br>
+ *      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. <br>
+ * \li -warn_on_unexpected_block <br>
+ *      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. <br>
+ * \li -cdbpath <i>path</i> <br>
+ *      This allows one to override the path to use for the CDB location.
+ *      <i>path</i> must be a valid CDB URI. By default the HLT system framework
+ *      sets the CDB path. <br>
+ * \li -run <i>number</i> <br>
+ *      This allows one to override the run number to use. <i>number</i> must be
+ *      a positive integer number. By default the HLT system framework sets the
+ *      run number. <br>
+ * \li -delaysetup <br>
+ *      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. <br>
+ * \li -dumponerror <br>
+ *      This flag will cause the component to dump the data blocks it received if
+ *      an error occurs during the processing of an event. <br>
+ * \li -dumppath <i>path</i> <br>
+ *      Allows one to specify the path in which to dump the received data blocks
+ *      if an error occurs. <br>
+ *
+ * <h2>Standard configuration:</h2>
+ * The configuration is taken from the CDB by default. It can be overridden with
+ * the command line arguments.
+ *
+ * <h2>Default CDB entries:</h2>
+ * HLT/ConfigMUON/DecisionComponent - Contains a TMap with the cut parameters.
+ *
+ * <h2>Performance:</h2>
+ * For worst case numbers of tracks the decision component requires less than a
+ * millisecond to process an event.
+ *
+ * <h2>Memory consumption:</h2>
+ * 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.
+ *
+ * <h2>Output size:</h2>
+ * 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
 {
index fa108a5400f260d2022e90541fe32d6fe51caec3..3ba337e99d5c8631563c5c6fe6f7c05b9b4333ae 100644 (file)
@@ -14,7 +14,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 ///////////////////////////////////////////////
 //Author : Indranil Das, SINP, INDIA
index 086f2134bcc7e0b73bdaef23ec868e26bd18aa1a..9d569a567c2da650793cb2fb822ef235d756f51f 100644 (file)
@@ -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
index d667d4daa7d5077353566eb35feb99d92e3e00ed..c2d4bf1b2d2fe226ba19e6633db951a126834ffc 100644 (file)
@@ -15,7 +15,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 ///
 ///  @file   AliHLTMUONHitReconstructorComponent.cxx
index 69da25c94aa959049929a93b7adf9074559cbc11..c35ab50bb09f53e234304c436856b09b29165f95 100644 (file)
@@ -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. <br>
  *
@@ -114,6 +114,12 @@ extern "C" struct AliHLTMUONHitRecoLutRow;
  * \li -warnifpadskipped <br>
  *      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. <br>
+ * \li -dumponerror <br>
+ *      This flag will cause the component to dump the data blocks it received if
+ *      an error occurs during the processing of an event. <br>
+ * \li -dumppath <i>path</i> <br>
+ *      Allows one to specify the path in which to dump the received data blocks
+ *      if an error occurs. <br>
  *
  * <h2>Standard configuration:</h2>
  * 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 (file)
index f1753f0..0000000
+++ /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 <artursz@iafrica.com>
- *  @date   
- *  @brief  Implementation of AliHLTMUONMansoTrackerComponent class.
- */
-
-#include "AliHLTMUONMansoTrackerComponent.h"
-#include "Util/AliHLTMUONRecPoint.h"
-#include <stdlib.h>
-#include <errno.h>
-
-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<AliHLTComponentDataType>& 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<AliHLTComponentBlockData>& 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 :"<<evtData.fBlockCnt<<" size :"<<outputBlocks.size()<<endl;
-  // Loop over all input blocks in the event
-  for ( unsigned long n = 0; n < evtData.fBlockCnt; n++ )
-    {
-      // Align the beginning of this  block to the required value.
-//       if ( totalSize % kAliHLTBlockAlignment )
-//     totalSize += kAliHLTBlockAlignment-(totalSize % kAliHLTBlockAlignment);
-
-      if ( totalSize > 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 :"<<trigDataSize<<endl;
-       UInt_t trigOffSet;
-       memcpy(&trigOffSet,(UInt_t*)blocks[n].fPtr + 1,sizeof(UInt_t));
-//     cout<<"trigOffSet :"<<trigOffSet<<endl;
-       noftrigData = (trigDataSize -  sizeof(UInt_t))*sizeof(AliHLTUInt32_t)/sizeof(AliHLTMUONCoreTriggerRecord) ;
-       fTrigData = new AliHLTMUONCoreTriggerRecord[noftrigData];
-
-       for(Int_t i=0;i<noftrigData;i++){
-         AliHLTMUONCoreTriggerRecord record;
-         memcpy(&record,(UInt_t*)blocks[n].fPtr + 2 + i*(sizeof(AliHLTMUONCoreTriggerRecord))/4,sizeof(AliHLTMUONCoreTriggerRecord));
-         fTrigData[i] = record;
-
-//       cout<<" Sign : "<<fTrigData[i].fSign
-//           <<" Pt : "<<fTrigData[i].fPt
-//           <<"\t X1:"<<fTrigData[i].fStation1impact.X()<<" Y1 :"<<fTrigData[i].fStation1impact.Y()
-//           <<"\t X2:"<<fTrigData[i].fStation2impact.X()<<" Y2 :"<<fTrigData[i].fStation2impact.Y()
-//           << endl;
-       }// for
-       
-       fTracker->FindTracks(fTrigData,noftrigData);
-//     cout<<"Nof tracks found :"<<fTracker->TrackCount()<<endl;
-//     cout<<"Z7 : "<<AliHLTMUONCoreMansoTracker::GetZ7()<<endl;
-
-      }else{ // for hitrec
-       UInt_t hitDataSize;
-       memcpy(&hitDataSize,blocks[n].fPtr,sizeof(UInt_t));
-//     cout<<"hitDataSize :"<<hitDataSize<<endl;
-       nofhitData = hitDataSize*sizeof(AliHLTUInt32_t)/sizeof(AliHLTMUONCorePoint) ;
-       
-       Int_t chamber = n + 6;
-       AliHLTMUONRecPoint *recHit = new AliHLTMUONRecPoint[nofhitData];
-       for(Int_t i=0;i<nofhitData;i++){
-         AliHLTMUONCorePoint point;
-         memcpy(&point,(UInt_t*)blocks[n].fPtr + 1 + i*(sizeof(AliHLTMUONCorePoint))/4,sizeof(AliHLTMUONCorePoint));
-//       cout <<"chamber :"<<chamber<<"\tX : "<<point.X()<<"\t Y : "<<point.Y()<< endl;
-         recHit[i].fX = point.X();
-         recHit[i].fY = point.Y();
-       }// for
-       
-       fTracker->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 (file)
index 36f7f3c..0000000
+++ /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 <artursz@iafrica.com>
- *  @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<AliHLTComponentDataType>& 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<AliHLTComponentBlockData>& 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<TriggerBlock> fTriggerBlocks;  // array of trigger record blocks
-       
-       ClassDef(AliHLTMUONMansoTrackerComponent, 0);
-
-    };
-
-#endif // AliHLTMUONMANSOTRACKERCOMPONENT_H
index b3c4bcfec90f3e30833e209053d51b4dbfc13ec7..7c387a1fb86b7acad394083fc0bfc2f1a6026399 100644 (file)
@@ -14,7 +14,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 ///
 /// @file   AliHLTMUONMansoTrackerFSM.cxx
index d02fcf45a796310184d61305daf3ce655dbc975c..4a9c18402f9c9e35c7277431c83db6244cd48970 100644 (file)
@@ -16,7 +16,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 ///
 ///  @file   AliHLTMUONMansoTrackerFSM.h
index 400a74742a3fb42b4a11a3bfb9d2bb332d1c5b8e..4285ed171a2ef8ca4c871a10ace6fd0df5285cf4 100644 (file)
@@ -16,7 +16,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  *  @file   AliHLTMUONMansoTrackerFSMCallback.h
index 9ac247211640527cd24e3fd6df88f943786a542e..380df05ff1c870586ec4489bac30fc84444e3957 100644 (file)
@@ -15,7 +15,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 ///
 ///  @file   AliHLTMUONMansoTrackerFSMComponent.cxx
index 447a8d3321e40aad0b1ed9e8c2a2c8028abccabc..fed3f5f95773d90e9a4677720367668c462e605b 100644 (file)
@@ -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. <br>
+ * \li -cdbpath <i>path</i> <br>
+ *      This allows one to override the path to use for the CDB location.
+ *      <i>path</i> must be a valid CDB URI. By default the HLT system framework
+ *      sets the CDB path. <br>
+ * \li -run <i>number</i> <br>
+ *      This allows one to override the run number to use. <i>number</i> must be
+ *      a positive integer number. By default the HLT system framework sets the
+ *      run number. <br>
+ * \li -delaysetup <br>
+ *      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. <br>
+ * \li -dumponerror <br>
+ *      This flag will cause the component to dump the data blocks it received if
+ *      an error occurs during the processing of an event. <br>
+ * \li -dumppath <i>path</i> <br>
+ *      Allows one to specify the path in which to dump the received data blocks
+ *      if an error occurs. <br>
  *
  * <h2>Standard configuration:</h2>
  * This component should normally be configured with no extra options.
index 043d89443f851361fe99f2645165e3cb8da20d20..aecf98769f7f3e8a5edba483669ec78dc5132f32 100644 (file)
@@ -15,7 +15,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**********************************************************************
  Created on : 16/05/2007
index 31b65c6e117079db271bf7b0b0859a2179ba5571..93ef794e3d89e8b302b7fb9590efcc03ffdc4d8b 100644 (file)
@@ -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
index 1398d8aa158f65d50d21a365877f6a860b7800ac..ce0840bd5f0db3cbb0dcbd2fdc24a96fab7b22c7 100644 (file)
@@ -15,7 +15,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 ///
 /// @file   AliHLTMUONTriggerReconstructorComponent.cxx
index d24b218bdd78b991bcf5594e4538d65c93f40681..c43e96584b8b2979f770a26d3aaddee0630b968e 100644 (file)
@@ -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.
+ *
+ * <h2>General properties:</h2>
+ *
+ * Component ID: \b MUONTriggerReconstructor <br>
+ * Library: \b libAliHLTMUON.so   <br>
+ * Input Data Types: AliHLTMUONConstants::DDLRawDataType() = "DDL_RAW :MUON" <br>
+ * Output Data Types: AliHLTMUONConstants::TriggerRecordsBlockDataType() = "TRIGRECS:MUON" <br>
+ *
+ * <h2>Mandatory arguments:</h2>
+ * \li -ddl <i>number</i> <br>
+ *      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 <i>number</i> 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. <br>
+ * \li -ddlid <i>number</i> <br>
+ *      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 <i>number</i> should be in the range [2816..2817].
+ *      If either the -ddl, -lut or -delaysetup arguments are used, then -ddlid
+ *      becomes optional. <br>
+ * \li -delaysetup <br>
+ *      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. <br>
+ *
+ * <h2>Optional arguments:</h2>
+ * \li -lut <i>filename</i> <br>
+ *      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 <i>filename</i> <br>
+ * \li -cdb <br>
+ *      Indicates that the component should load from CDB. This option is implicit
+ *      if the -cdbpath is given. It will also override the -lut option.<br>
+ * \li -cdbpath <i>path</i> <br>
+ *      Specifies the CDB path to use, given by <i>path</i>. This option will override
+ *      the CDB path automatically set by the HLT framework. <br>
+ * \li -run <i>number</i> <br>
+ *      Specifies the run number to use, given by <i>number</i>. This option will
+ *      override the current run number automatically set by the HLT framework. <br>
+ * \li -zmiddle <i>position</i> <br>
+ *      This indicates the Z coordinate position of the middle of the dipole magnetic
+ *      field. <i>position</i> is a floating point value in centimeters. Specifying
+ *      this argument on the will override the value loaded from CDB. <br>
+ * \li -bfieldintegral <i>field</i> <br>
+ *      This indicates the magnetic field integral for the dipole magnetic field.
+ *      <i>field</i> 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. <br>
+ * \li -warn_on_unexpected_block <br>
+ *      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. <br>
+ * \li -suppress_partial_triggers <br>
+ *      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. <br>
+ * \li -generate_partial_triggers <br>
+ *      With this option all trigger records, even partial ones with just one or two
+ *      hits is written to the output. <br>
+ * \li -stop_on_buffer_overflow <br>
+ *      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. <br>
+ * \li -tryrecover <br>
+ *      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. <br>
+ * \li -dont_use_crateid <br>
+ *      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. <br>
+ * \li -dont_use_localid <br>
+ *      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. <br>
+ * \li -dumponerror <br>
+ *      This flag will cause the component to dump the data blocks it received if
+ *      an error occurs during the processing of an event. <br>
+ * \li -dumppath <i>path</i> <br>
+ *      Allows one to specify the path in which to dump the received data blocks
+ *      if an error occurs. <br>
+ *
+ * <h2>Standard configuration:</h2>
+ * The configuration is taken from the CDB by default. It can be overridden with
+ * the command line arguments.
+ *
+ * <h2>Default CDB entries:</h2>
+ * HLT/ConfigHLT/HLTGlobalTrigger - Contains the global trigger menu.
+ *
+ * <h2>Performance:</h2>
+ * 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.
+ *
+ * <h2>Memory consumption:</h2>
+ * 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.
+ *
+ * <h2>Output size:</h2>
+ * 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();
        
        /**
index e7020cd41e38fe656b6c9c0488c8e23b5bd8dae0..7007103894c69c11ec013fdfce507254e877d518 100644 (file)
@@ -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 <artursz@iafrica.com>
@@ -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;
index f0f0bf335e6c93073fafe93026a9ca45d1018b12..71f979724e8e6694e5fd174abe0546cd577994ab 100644 (file)
@@ -14,7 +14,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  * \ingroup macros
index cd7ce0d733b15d32762066c7302e1c8f4b1e9afb..4f6ce8b756874a34cd2c79c9fca306597e22f08b 100644 (file)
@@ -14,7 +14,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  * \ingroup macros
index 8864346da8eb291b96c2315d62eff68649503095..1216a5d6ee3d5d4f7a3e029c7b7223cd7bf9e6c4 100644 (file)
@@ -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++)
index 7f449559542ca0bcdab013707f0148444b402acd..204e0c408f5b43fc577d9d4bff0defc5f65ef0f5 100644 (file)
@@ -14,7 +14,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id: $ */
+// $Id: $
 
 /**
  * \ingroup macros
index ae9d87c92b27199229ee77b3779bcad354c59717..3bad6d596aeb427dc7af6e85b0805b6f84645ceb 100644 (file)
@@ -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.
index aaa38ba32e3f5dccd01a96c2e331646c17a7afbd..53a5e772c53700478e86b1aa7a6f89d4a29af9c3 100644 (file)
@@ -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)<br>
+ * \li -cdbpath <i>path</i> <br>
+ *      This allows one to override the path to use for the CDB location.
+ *      <i>path</i> must be a valid CDB URI. By default the HLT system framework
+ *      sets the CDB path. <br>
+ * \li -run <i>number</i> <br>
+ *      This allows one to override the run number to use. <i>number</i> must be
+ *      a positive integer number. By default the HLT system framework sets the
+ *      run number. <br>
+ * \li -dumponerror <br>
+ *      This flag will cause the component to dump the data blocks it received if
+ *      an error occurs during the processing of an event. <br>
+ * \li -dumppath <i>path</i> <br>
+ *      Allows one to specify the path in which to dump the received data blocks
+ *      if an error occurs. <br>
  *
  * @ingroup alihlt_dimuon_component
  */
@@ -101,6 +115,7 @@ protected:
                        AliHLTUInt32_t& size,
                        AliHLTComponentBlockDataList& outputBlocks
                );
+       virtual bool IgnoreArgument(const char* arg) const;
        
        using AliHLTProcessor::DoEvent;
        
index 6f3ebf4cceb5ae080974237f63bfb33e9c9a315a..751fbcb577d880e0b12ce8ee2c5c9848d6c1ba0b 100644 (file)
@@ -14,7 +14,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 ///
 /// @file   AliHLTMUONEmptyEventFilterComponent.cxx
index 937f66a907e374fe13d65dc3cbce105c5ce86de2..6267ad086f9a0e808bc3bfb1ac2aa80d24e1d44e 100644 (file)
@@ -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
  * 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.
+ * <h2>General properties:</h2>
+ *
+ * Component ID: \b MUONEmptyEventFilter <br>
+ * Library: \b libAliHLTMUON.so <br>
+ * Input Data Types:  kAliHLTAnyDataType = "*******:***" <br>
+ * Output Data Types: kAliHLTAnyDataType|kAliHLTDataOriginMUON = "*******:MUON" <br>
+ *
+ * <h2>Mandatory arguments:</h2>
+ * None.
+ *
+ * <h2>Optional arguments:</h2>
+ * \li -sendempty <br>
+ *      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. <br>
+ * \li -dumponerror <br>
+ *      This flag will cause the component to dump the data blocks it received if
+ *      an error occurs during the processing of an event. <br>
+ * \li -dumppath <i>path</i> <br>
+ *      Allows one to specify the path in which to dump the received data blocks
+ *      if an error occurs. <br>
+ *
+ * <h2>Standard configuration:</h2>
+ * There is no special configuration for this component.
+ *
+ * <h2>Default CDB entries:</h2>
+ * None.
+ *
+ * <h2>Performance:</h2>
+ * Less than a milliseconds per event.
+ *
+ * <h2>Memory consumption:</h2>
+ * Minimal, under 1 MBytes.
+ *
+ * <h2>Output size:</h2>
+ * The maximum is the same size as the input data size.
+ *
+ * @ingroup alihlt_dimuon_component
  */
 class AliHLTMUONEmptyEventFilterComponent : public AliHLTMUONProcessor
 {
index 0661617917850e4373c78ed103c0fd42b99eb346..75ee3b29b4fa17438580df494f779c70469d31d4 100644 (file)
@@ -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<AliHLTUInt8_t*>(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<AliHLTUInt8_t*>(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;
 }
 
 
index 845f798bdc4613932dc4d703518ec1475574606a..1364b4f49957c7bee4f884e7c5c3dbd6f9efc8de 100644 (file)
@@ -4,7 +4,7 @@
  * ALICE Experiment at CERN, All rights reserved.                         *
  * See cxx source for full Copyright notice                               */
 
-/* $Id: $ */
+// $Id: $
 
 ///
 ///  @file   AliHLTMUONRawDataHistoComponent.h
 /**
  * @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.
+ *
+ * <h2>General properties:</h2>
+ *
+ * Component ID: \b MUONRawDataHistogrammer <br>
+ * Library: \b libAliHLTMUON.so <br>
+ * Input Data Types:  AliHLTMUONConstants::DDLRawDataType() = "DDL_RAW :MUON" <br>
+ * Output Data Types: AliHLTMUONConstants::HistogramDataType() = "ROOTHIST:MUON" <br>
+ *
+ * <h2>Mandatory arguments:</h2>
+ * None.
+ *
+ * <h2>Optional arguments:</h2>
+ * \li -pubdelay <i>delay</i> <br>
+ *      Indicates the number of seconds to wait between publishing the histograms.
+ *      The default is zero seconds. <i>delay</i> must be a positive floating point
+ *      number. <br>
+ * \li -noemptyhists <br>
+ *      If indicated then any histograms that are empty will not be published.
+ *      By default all events are processed. <br>
+ * \li -onlydataevents <br>
+ *      If indicated then only data events are processed.
+ *      By default all events are processed. <br>
+ * \li -clearafterpub <br>
+ *      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. <br>
+ * \li -tryrecover <br>
+ *      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. <br>
+ *
+ * <h2>Standard configuration:</h2>
+ * There is no special configuration for this component.
+ *
+ * <h2>Default CDB entries:</h2>
+ * None.
+ *
+ * <h2>Performance:</h2>
+ * A few milliseconds per event.
+ *
+ * <h2>Memory consumption:</h2>
+ * Minimal, under 1 MBytes.
+ *
+ * <h2>Output size:</h2>
+ * 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<AliTrackerDecoderHandler> fTrackerDecoder;  // Raw data decoder for the tracker data.
index 2fb8a5d7ac86dce32c4ad0dfee5ca1ff2cc8dc3e..83ac71697ee66c392a6a0ffdbfc38fd420a4d967 100644 (file)
@@ -13,7 +13,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id$ */
+// $Id$
 
 /**
  * @file   dHLTdumpraw.cxx
index 1cd5c342031b4b83e64cb2b566d5e1dde468a5d9..9e23d6c499631e29ea3d7edd746a39dd59b94aee 100644 (file)
@@ -14,7 +14,7 @@
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
 
-/* $Id: $ */
+// $Id: $
 
 /**
  * @file   dHLTrootify.cxx
index 6fb958d258da1ea4b2ae6ba61c87a847bf7fd98d..3864b792b59a476492d62283c845238d06090950 100644 (file)
@@ -31,9 +31,10 @@ class AliHLTGlobalTrigger;
  * Component ID: \b HLTGlobalTrigger <br>
  * Library: \b libAliHLTTrigger.so   <br>
  * Input Data Types: ::kAliHLTAnyDataType <br>
- * Output Data Types: kAliHLTDataTypeTObject|kAliHLTDataOriginOut <br>
+ * Output Data Types: kAliHLTDataTypeGlobalTrigger and kAliHLTDataTypeReadoutList <br>
  *
  * <h2>Mandatory arguments:</h2>
+ * None.
  *
  * <h2>Optional arguments:</h2>
  * <!-- NOTE: ignore the \li. <i> and </i>: it's just doxygen formatting -->
@@ -59,8 +60,7 @@ class AliHLTGlobalTrigger;
  *      Indicates that the CTP data should not be added to the global HLT trigger decision.
  *
  * <h2>Configuration:</h2>
- * <!-- NOTE: ignore the \li. <i> and </i>: it's just doxygen formatting -->
- * Configuration by component arguments.
+ * Configured from CDB but can be overridden with the -config argument.
  *
  * <h2>Default CDB entries:</h2>
  * HLT/ConfigHLT/HLTGlobalTrigger - Contains the global trigger menu.