Belle II Software development
AxialTrackCreatorMCTruth.cc
1/**************************************************************************
2 * basf2 (Belle II Analysis Software Framework) *
3 * Author: The Belle II Collaboration *
4 * *
5 * See git log for contributors and copyright holders. *
6 * This file is licensed under LGPL-3.0, see LICENSE.md. *
7 **************************************************************************/
8#include <tracking/trackFindingCDC/findlets/minimal/AxialTrackCreatorMCTruth.h>
9
10#include <tracking/trackFindingCDC/mclookup/CDCMCManager.h>
11#include <tracking/trackFindingCDC/mclookup/CDCMCTrackStore.h>
12#include <tracking/trackFindingCDC/mclookup/CDCSimHitLookUp.h>
13#include <tracking/trackFindingCDC/mclookup/CDCMCTrackLookUp.h>
14
15#include <tracking/trackFindingCDC/processing/AxialTrackUtil.h>
16#include <tracking/trackFindingCDC/fitting/CDCKarimakiFitter.h>
17
18#include <tracking/trackingUtilities/eventdata/tracks/CDCTrack.h>
19#include <tracking/trackingUtilities/eventdata/hits/CDCRecoHit3D.h>
20#include <tracking/trackingUtilities/eventdata/hits/CDCRecoHit2D.h>
21#include <tracking/trackingUtilities/eventdata/hits/CDCWireHit.h>
22#include <tracking/trackingUtilities/eventdata/trajectories/CDCTrajectorySZ.h>
23#include <tracking/trackingUtilities/eventdata/trajectories/CDCTrajectory2D.h>
24
25#include <tracking/trackFindingCDC/eventdata/utils/FlightTimeEstimator.h>
26
27#include <cdc/topology/CDCWire.h>
28
29#include <tracking/trackingUtilities/utilities/StringManipulation.h>
30
31#include <cdc/translators/RealisticTDCCountTranslator.h>
32#include <cdc/dataobjects/CDCHit.h>
33
34#include <framework/core/ModuleParamList.templateDetails.h>
35
36#include <TRandom.h>
37
38using namespace Belle2;
39using namespace CDC;
40using namespace TrackFindingCDC;
41using namespace TrackingUtilities;
42
43void AxialTrackCreatorMCTruth::exposeParameters(ModuleParamList* moduleParamList, const std::string& prefix)
44{
45 moduleParamList->addParameter(prefixed(prefix, "reconstructedDriftLength"),
47 "Switch to assign the reconstructed drift length to each hit, "
48 "as it can be estimated from two dimensional information only.",
50
51 moduleParamList->addParameter(prefixed(prefix, "reconstructedPositions"),
53 "Switch to reconstruct the positions in the tracks "
54 "imitating the Legendre finder.",
56
57 moduleParamList->addParameter(prefixed(prefix, "fit"),
59 "Fit the track instead of forwarding the mc truth fit information",
61
62 moduleParamList->addParameter(prefixed(prefix, "useOnlyBeforeTOP"),
64 "Cut tracks after the last layer of the CDC has been reached, "
65 "assuming the tracks left the CDC.",
67}
68
70{
71 return "Constructs tracks from wire hits using the MC truth information.";
72}
73
74
80
81
87
88void AxialTrackCreatorMCTruth::apply(const std::vector<CDCWireHit>& inputWireHits,
89 std::vector<CDCTrack>& outputAxialTracks)
90{
91 const CDCMCTrackStore& mcTrackStore = CDCMCTrackStore::getInstance();
92 const CDCSimHitLookUp& simHitLookUp = CDCSimHitLookUp::getInstance();
93
94 using CDCHitVector = CDCMCTrackStore::CDCHitVector;
95
96 const std::map<ITrackType, CDCHitVector>& mcTracksByMCParticleIdx =
97 mcTrackStore.getMCTracksByMCParticleIdx();
98
99 std::size_t nAxialTracks = mcTracksByMCParticleIdx.size();
100 outputAxialTracks.reserve(outputAxialTracks.size() + nAxialTracks);
101
102 for (const std::pair<ITrackType, CDCHitVector> mcTracksAndMCParticleIdx : mcTracksByMCParticleIdx) {
103
104 const CDCHitVector& mcTrack = mcTracksAndMCParticleIdx.second;
105
106 outputAxialTracks.push_back(CDCTrack());
107 CDCTrack& axialTrack = outputAxialTracks.back();
108 bool reachedOuterMostLayer = false;
109 for (const CDCHit* ptrHit : mcTrack) {
110
112 // Cut tracks after the outermost layer has been reached and
113 // the track starts to go inwards again.
114 // But let all hits in the outermost layer survive.
115 if (ptrHit->getISuperLayer() == 8 and ptrHit->getILayer() == 5) {
116 reachedOuterMostLayer = true;
117 }
118 if (reachedOuterMostLayer and ptrHit->getILayer() != 5) {
119 break;
120 }
121 }
122
123 const CDCWireHit* wireHit = simHitLookUp.getWireHit(ptrHit, inputWireHits);
124 if (not wireHit) continue;
125
126 CDCRecoHit2D recoHit2D = simHitLookUp.getClosestPrimaryRecoHit2D(ptrHit, inputWireHits);
127 if (not recoHit2D.isAxial()) continue;
128
129 CDCRecoHit3D recoHit3D(recoHit2D.getRLWireHit(), {recoHit2D.getRecoPos2D(), 0}, NAN);
130 axialTrack.push_back(recoHit3D);
131 }
132
133 // Discard short tracks
134 if (axialTrack.size() < 5) outputAxialTracks.pop_back();
135 }
136
137 CDC::RealisticTDCCountTranslator tdcCountTranslator;
138 for (CDCTrack& track : outputAxialTracks) {
139 for (CDCRecoHit3D& recoHit3D : track) {
140 Vector2D recoPos2D = recoHit3D.getRecoPos2D();
141 Vector2D flightDirection = recoHit3D.getFlightDirection2D();
142 double alpha = recoPos2D.angleWith(flightDirection);
143
144 const CDCWire& wire = recoHit3D.getWire();
145 const bool rl = recoHit3D.getRLInfo() == ERightLeft::c_Right;
146
147 double driftLength = std::fabs(recoHit3D.getSignedRecoDriftLength());
149 // Setup the drift length such that only information
150 // that would be present in two dimensional reconstruction is used
151 const double beta = 1;
152 FlightTimeEstimator::instance().getFlightTime2D(recoPos2D, alpha, beta);
153
154 //TODO: for now this seems to be unused, (see following comment)
155 /*
156 double flightTimeEstimate = 0;
157 const CDCHit* hit = recoHit3D.getWireHit().getHit();
158 driftLength =
159 tdcCountTranslator.getDriftLength(hit->getTDCCount(),
160 wire.getWireID(),
161 flightTimeEstimate,
162 rl,
163 wire.getRefZ(),
164 alpha);
165 */
166
167 // As the legendre finder does not reestimate the drift length
168 // We simply set it to the reference drift length for now.
169 // Use version above once the reestimation comes along.
170 driftLength = recoHit3D.getWireHit().getRefDriftLength();
171
172 } else {
173 // In case the true drift length should be kept at least smear it with its variance.
174 double driftLengthVariance = tdcCountTranslator.getDriftLengthResolution(driftLength,
175 wire.getWireID(),
176 rl,
177 wire.getRefZ(),
178 alpha);
179
180 driftLength += gRandom->Gaus(0, std::sqrt(driftLengthVariance));
181 }
182 bool snapRecoPos = true;
183 recoHit3D.setRecoDriftLength(driftLength, snapRecoPos);
184 }
185 }
186
187 if (m_param_fit) {
188 CDCKarimakiFitter fitter;
189 for (CDCTrack& track : outputAxialTracks) {
190 CDCTrajectory2D trajectory2D = fitter.fit(track);
191 trajectory2D.setLocalOrigin(Vector2D(0.0, 0.0));
192 track.setStartTrajectory3D({trajectory2D, CDCTrajectorySZ::basicAssumption()});
193 }
194 } else {
195 const CDCMCTrackLookUp& mcTrackLookUp = CDCMCTrackLookUp::getInstance();
196 for (CDCTrack& track : outputAxialTracks) {
197 CDCTrajectory3D trajectory3D = mcTrackLookUp.getTrajectory3D(&track);
198 CDCTrajectory2D trajectory2D = trajectory3D.getTrajectory2D();
199 track.setStartTrajectory3D({trajectory2D, CDCTrajectorySZ::basicAssumption()});
200 }
201 }
202
204 for (CDCTrack& track : outputAxialTracks) {
206 }
207 }
208}
Class containing the result of the unpacker in raw data and the result of the digitizer in simulation...
Definition CDCHit.h:40
Class representing a sense wire in the central drift chamber.
Definition CDCWire.h:50
const WireID & getWireID() const
Getter for the wire id.
Definition CDCWire.h:114
double getRefZ() const
Getter for the wire reference z coordinate Gives the wire's reference z coordinate.
Definition CDCWire.h:228
Translator mirroring the realistic Digitization.
double getDriftLengthResolution(double driftLength, const WireID &wireID=WireID(), bool leftRight=false, double z=0, double alpha=0, double=static_cast< double >(TMath::Pi()/2.)) override
Get position resolution^2 corresponding to the drift length from getDriftLength of this class.
The Module parameter list class.
void initialize() final
Initialize the Module before event processing.
bool m_param_reconstructedDriftLength
Parameter : Setup the drift length as it can be estimated from two dimensional information.
void beginEvent() final
Start processing the current event.
void apply(const std::vector< TrackingUtilities::CDCWireHit > &inputWireHits, std::vector< TrackingUtilities::CDCTrack > &outputAxialTracks) final
Main function of the track finding by the cellular automaton.
std::string getDescription() final
Short description of the findlet.
void exposeParameters(ModuleParamList *moduleParamList, const std::string &prefix) final
Expose the parameters to a module.
bool m_param_reconstructedPositions
Parameter : Switch to reconstruct the positions in the tracks imitating the Legendre finder.
bool m_param_fit
Parameter : Fit the track instead of forwarding the MC truth information.
bool m_param_useOnlyBeforeTOP
Parameter : Cut tracks after the last layer of the CDC has been reached, assuming the tracks left the...
Class implementing the fitter using Karimakis method.
TrackingUtilities::CDCTrajectory3D getTrajectory3D(const ACDCHitCollection *ptrHits) const
Returns the trajectory of the collection of hits.
void requireTruthInformation()
Require the MC information store arrays.
void fill()
Fill Monte Carlo look up maps from the DataStore.
static CDCMCManager & getInstance()
Getter for the singleton instance.
Specialisation of the lookup for the truth values of reconstructed tracks.
static const CDCMCTrackLookUp & getInstance()
Getter for the singletone instance.
Class to organize and present the monte carlo hit information.
static const CDCMCTrackStore & getInstance()
Getter for the singletone instance.
std::vector< const CDCHit * > CDCHitVector
Type for an ordered sequence of pointers to the CDCHit.
const std::map< ITrackType, Belle2::TrackFindingCDC::CDCMCTrackStore::CDCHitVector > & getMCTracksByMCParticleIdx() const
Getter for the stored Monte Carlo tracks ordered by their Monte Carlo Id.
Singletone class to gather local information about the hits.
static const CDCSimHitLookUp & getInstance()
Getter for the singletone instance.
TrackingUtilities::CDCRecoHit2D getClosestPrimaryRecoHit2D(const CDCHit *ptrHit, const std::vector< TrackingUtilities::CDCWireHit > &wireHits) const
Construct an TrackingUtilities::CDCRecoHit2D from the closest primary CDCSimHit information related t...
const TrackingUtilities::CDCWireHit * getWireHit(const CDCHit *ptrHit, const std::vector< TrackingUtilities::CDCWireHit > &wireHits) const
Retrieve the wire hit the given CDCHit form the given wire hits.
virtual double getFlightTime2D(const TrackingUtilities::Vector2D &, double, double=1) const
Default estimator for the flight time.
static const FlightTimeEstimator & instance(std::unique_ptr< FlightTimeEstimator > replacement=nullptr)
Getter for the instance.
Class representing a two dimensional reconstructed hit in the central drift chamber.
const CDCRLWireHit & getRLWireHit() const
Getter for the oriented wire hit associated with the reconstructed hit.
bool isAxial() const
Indicator if the underlying wire is axial.
Class representing a three dimensional reconstructed hit.
Class representing a sequence of three dimensional reconstructed hits.
Definition CDCTrack.h:39
Particle trajectory as it is seen in xy projection represented as a circle.
double setLocalOrigin(const Vector2D &localOrigin)
Setter for the origin of the local coordinate system.
Particle full three dimensional trajectory.
CDCTrajectory2D getTrajectory2D() const
Getter for the two dimensional trajectory.
static CDCTrajectorySZ basicAssumption()
Constructs a basic assumption, what the z0 start position and the sz slope are, including some broad ...
Class representing a hit wire in the central drift chamber.
Definition CDCWireHit.h:58
A two dimensional vector which is equipped with functions for correct handling of orientation relate...
Definition Vector2D.h:36
double angleWith(const Vector2D &rhs) const
The angle between this and rhs.
Definition Vector2D.h:228
void addParameter(const std::string &name, T &paramVariable, const std::string &description, const T &defaultValue)
Adds a new parameter to the module list.
Abstract base class for different kinds of events.
static void normalizeTrack(TrackingUtilities::CDCTrack &track)
Refit and resort the track. Unmask all hits.