Project
Loading...
Searching...
No Matches
ClustererTask.cxx
Go to the documentation of this file.
1// Copyright 2019-2020 CERN and copyright holders of ALICE O2.
2// See https://alice-o2.web.cern.ch/copyright for details of the copyright holders.
3// All rights not expressly granted are reserved.
4//
5// This software is distributed under the terms of the GNU General Public
6// License v3 (GPL Version 3), copied verbatim in the file "COPYING".
7//
8// In applying this license CERN does not waive the privileges and immunities
9// granted to it by virtue of its status as an Intergovernmental Organization
10// or submit itself to any jurisdiction.
11
14
16
17#include <fairlogger/Logger.h> // for LOG
18#include "FairRootManager.h" // for FairRootManager
19
21
22using namespace o2::tpc;
23using namespace o2::dataformats;
24
25//_____________________________________________________________________
27 : FairTask("TPCClustererTask"),
28 mClusterSector(sectorid),
29 mHwClusterer(),
30 mDigitsArray(),
31 mDigitMCTruthArray(),
32 mHwClustersArray(),
33 mHwClustersMCTruthArray()
34{
35}
36
37//_____________________________________________________________________
41{
42 LOG(debug) << "Enter Initializer of ClustererTask";
43
45 if (!mgr) {
46 LOG(error) << "Could not instantiate FairRootManager. Exiting ...";
47 return kERROR;
48 }
49
50 if (mClusterSector < 0 || mClusterSector >= Sector::MAXSECTOR) {
51 LOG(error) << "Sector ID " << mClusterSector << " is not supported. Exiting ...";
52 return kERROR;
53 }
54
55 // Register input container
56 std::stringstream sectornamestr;
57 sectornamestr << "TPCDigit" << mClusterSector;
58 LOG(info) << "FETCHING DIGITS FOR SECTOR " << mClusterSector << "\n";
59 mDigitsArray = std::unique_ptr<const std::vector<Digit>>(
60 mgr->InitObjectAs<const std::vector<Digit>*>(sectornamestr.str().c_str()));
61 if (!mDigitsArray) {
62 LOG(error) << "TPC points not registered in the FairRootManager. Exiting ...";
63 return kERROR;
64 }
65 std::stringstream mcsectornamestr;
66 mcsectornamestr << "TPCDigitMCTruth" << mClusterSector;
67 mDigitMCTruthArray = std::unique_ptr<const ConstMCLabelContainerView>(
68 mgr->InitObjectAs<const ConstMCLabelContainerView*>(mcsectornamestr.str().c_str()));
69 if (!mDigitMCTruthArray) {
70 LOG(error) << "TPC MC Truth not registered in the FairRootManager. Exiting ...";
71 return kERROR;
72 }
73
74 // Register output container
75 mHwClustersArray = std::make_unique<std::vector<OutputType>>();
76 // a trick to register the unique pointer with FairRootManager
77 static auto clusterArrayTmpPtr = mHwClustersArray.get();
78 mgr->RegisterAny(Form("TPCClusterHW%i", mClusterSector), clusterArrayTmpPtr, kTRUE);
79
80 // Register MC Truth output container
81 mHwClustersMCTruthArray = std::make_unique<MCLabelContainer>();
82 // a trick to register the unique pointer with FairRootManager
83 static auto clusterMcTruthTmpPtr = mHwClustersMCTruthArray.get();
84 mgr->RegisterAny(Form("TPCClusterHWMCTruth%i", mClusterSector), clusterMcTruthTmpPtr, kTRUE);
85
86 // create clusterer and pass output pointer
87 mHwClusterer = std::make_unique<HwClusterer>(mHwClustersArray.get(), mClusterSector, mHwClustersMCTruthArray.get());
88 mHwClusterer->setContinuousReadout(mIsContinuousReadout);
89
90 // TODO: implement noise/pedestal objects
91 // mHwClusterer->setNoiseObject(...);
92 // mHwClusterer->setPedestalObject(...);
93
94 return kSUCCESS;
95}
96
97//_____________________________________________________________________
99{
100 LOG(debug) << "Running clusterization on event " << mEventCount << " with " << mDigitsArray->size() << " digits.";
101
102 if (mHwClustersArray) {
103 mHwClustersArray->clear();
104 }
105 if (mHwClustersMCTruthArray) {
106 mHwClustersMCTruthArray->clear();
107 }
108
109 mHwClusterer->process(gsl::span<o2::tpc::Digit const>(mDigitsArray->data(), mDigitsArray->size()), *mDigitMCTruthArray.get());
110 LOG(debug) << "Hw clusterer delivered " << mHwClustersArray->size() << " cluster container";
111
112 ++mEventCount;
113}
114
115//_____________________________________________________________________
117{
118 LOG(debug) << "Finish clusterization";
119
120 if (mHwClustersArray) {
121 mHwClustersArray->clear();
122 }
123 if (mHwClustersMCTruthArray) {
124 mHwClustersMCTruthArray->clear();
125 }
126
127 mHwClusterer->finishProcess(*mDigitsArray.get(), *mDigitMCTruthArray.get());
128 LOG(debug) << "Hw clusterer delivered " << mHwClustersArray->size() << " cluster container";
129
130 ++mEventCount;
131}
std::ostringstream debug
InitStatus
Definition FairTask.h:34
@ kERROR
Definition FairTask.h:36
@ kSUCCESS
Definition FairTask.h:35
configStandalone Reconstruction rec_tpc multiplier for the combined cluster track error during track following area in cm for the search of for z only used if decrease removal by when above this local occupancy rowx Shift of TPC revert cluster flag edge bit distance to edge exceeds this ZOffset for secondary multiple of radius max P of electron K BB bands crossing max P of electron p BB bands crossing max P of electron d BB bands crossing max P of electron t BB bands crossing min accepted dEdxMaxTPC of the track Additive extra cluster error for Y2 if edge flag set Additive extra cluster error for Y2 if single set Additive extra cluster error for Y2 if or single set Additive extra cluster error for Z2 if or single set Extra errors to add to track when crossing depending on addErrorsCECrossing Inner portion of y range in sector that is not used in searching for extrapolated track candidates factor2YS for track merging factor2K for track merging Margin in cm of Y position when rejecting edge clusters based on uncorrected track Y Max fraction of shared clusters for tracklet Except pad from cluster finding if total number of charges in a fragment is above this Except pad from cluster finding if number of consecutive charges in a fragment is above this Threshold where a timebin is considered disabling the noisy pad check for that pad Treat signal above this minimum as saturated Smoothing factor for the exponential Highly Ionising Particle tail filter Number of timebins to use for the averaging Add additional custom track errors when crossing relative as fraction of Do N fit passes in final fit of< 0:reject at max -n hits") AddOptionRTC(rejectIFCLowRadiusCluster, uint8_t, 1, "", 0, "Reject clusters that get the IFC mask error during refit") AddOptionRTC(dEdxTruncLow, uint8_t, 2, "", 0, "Low truncation threshold, fraction of 128") AddOptionRTC(dEdxTruncHigh, uint8_t, 77, "", 0, "High truncation threshold, fraction of 128") AddOptionRTC(extrapolationTracking, int8_t, 1, "", 0, "Enable Extrapolation Tracking(prolong tracks to adjacent sectors to find short segments)") AddOptionRTC(disableRefitAttachment, uint8_t, 0, "", 0, "Bitmask to disable certain attachment steps during refit(1:attachment, 2:propagation, 4:loop following, 8:mirroring)") AddOptionRTC(rejectionStrategy, uint8_t, o2::gpu::GPUSettings::RejectionStrategyA, "", 0, "Enable rejection of TPC clusters for compression(0=no, 1=strategy A, 2=strategy B)") AddOptionRTC(mergeLoopersAfterburner, uint8_t, 1, "", 0, "Run afterburner for additional looper merging") AddOptionRTC(compressionTypeMask, uint8_t, o2::gpu::GPUSettings::CompressionFull, "", 0, "TPC Compression mode bits(1=truncate charge/width LSB, 2=differences, 4=track-model)") AddOptionRTC(compressionSortOrder, uint8_t, o2::gpu::GPUSettings::SortTime, "", 0, "Sort order of TPC compression(0=time, 1=pad, 2=Z-time-pad, 3=Z-pad-time, 4=no sorting(use incoming order))") AddOptionRTC(sigBitsCharge, uint8_t, 4, "", 0, "Number of significant bits for TPC cluster charge in compression mode 1") AddOptionRTC(sigBitsWidth, uint8_t, 3, "", 0, "Number of significant bits for TPC cluster width in compression mode 1") AddOptionRTC(dropLoopers, uint8_t, 0, "", 0, "Drop looping tracks starting from second loop") AddOptionRTC(mergerInterpolateErrors, uint8_t, 1, "", 0, "Use interpolation instead of extrapolation for chi2 based cluster rejection") AddOptionRTC(mergerInterpolateRejectAlsoOnCurrentPosition, uint8_t, 1, "", 0, "When using mergerInterpolateErrors, reject based on chi2 twice computed with interpolated and current track position starting from NDF > mergerNonInterpolateRejectMinNDF Merge tracks accross the central electrode Enable PID response Add sub threshold clusters in TPC dEdx computation OR mask of TPC flags that will reject the cluster in alternative dEdx Reject edge clusters based on uncorrected track Y during track fit Increase decrease removal by when on this number of pads from the edge h configStandalone Reconstruction rec_trd Max chi2 for TRD tracklets to be matched to a track Chi2 cut for strict matching mode Number of sigmas for ITS TPC track time error estimate Addition to search road around track prolongation along Y in cm Optimal tracklet rphi resolution in maximum chi2 per attached tracklet for TRD tracks take into account the full likelihood of the slope including exponential tails Tracks with less attached tracklets are discarded after the tracking Post trigger Pile up integration time in BCs fits all iterations but the last one in projections Use material lookup table for TPC refit Apply workarounds to avoid cyclic merge should not be needed tpc dyn configStandalone Processing proc_rtc Replace constant variables static by constexpr expressions Compile RTC in deterministic with NO_FAST_MATH flags and GPUCA_DETERMINISTIC_MODE define Use RTC to optimize GPU code h configStandalone Processing proc_rtctech Use a file lock to serialize access to the cache folder Print launch bounds used for RTC code as debugging option
char error[CURL_ERROR_SIZE]
TPC Clusterer Task.
ClassImp(o2::tpc::ClustererTask)
T InitObjectAs(const char *BrName)
void RegisterAny(const char *name, T *&obj, Bool_t toFile)
static FairRootManager * Instance()
void Exec(Option_t *option) override
Clusterization.
ClustererTask(int sectorid=-1)
InitStatus Init() override
Initializes the clusterer and connects input and output container.
void FinishTask() override
Complete Clusterization.
static constexpr int MAXSECTOR
Definition Sector.h:44
Definition of a container to keep/associate and arbitrary number of labels associated to an index wit...
Global TPC definitions and constants.
LOG(info)<< "Compressed in "<< sw.CpuTime()<< " s"