Belle II Software development
RecoTrackUtil.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/eventdata/utils/RecoTrackUtil.h>
9
10#include <tracking/trackFindingCDC/eventdata/tracks/CDCTrack.h>
11
12#include <tracking/trackFindingCDC/eventdata/hits/CDCRLWireHit.h>
13#include <tracking/trackFindingCDC/eventdata/hits/CDCWireHit.h>
14
15#include <tracking/trackFindingCDC/topology/ISuperLayer.h>
16#include <tracking/trackFindingCDC/fitting/CDCSZFitter.h>
17#include <tracking/trackFindingCDC/eventdata/trajectories/CDCTrajectorySZ.h>
18
19#include <tracking/trackFindingCDC/eventdata/trajectories/CDCTrajectory3D.h>
20#include <tracking/trackFindingCDC/eventdata/trajectories/CDCBFieldUtil.h>
21
22#include <tracking/trackFindingCDC/numerics/TMatrixConversion.h>
23#include <tracking/trackFindingCDC/geometry/Vector3D.h>
24#include <tracking/trackFindingCDC/numerics/ERightLeft.h>
25#include <tracking/trackFindingCDC/numerics/ESign.h>
26
27#include <tracking/dataobjects/RecoTrack.h>
28#include <tracking/dataobjects/RecoHitInformation.h>
29
30#include <framework/datastore/StoreArray.h>
31
32#include <TMatrixDSymfwd.h>
33#include <TMatrixTSym.h>
34#include <cmath>
35
36using namespace Belle2;
37using namespace TrackFindingCDC;
38
39RecoTrack* RecoTrackUtil::storeInto(const CDCTrack& track, StoreArray<RecoTrack>& recoTracks, const double momentumSeedMagnitude)
40{
41 CDCTrack firstHits;
42 ISuperLayer closestLayer = track.getStartISuperLayer();
43 if (ISuperLayerUtil::isAxial(closestLayer)) closestLayer = ISuperLayerUtil::getNextOutwards(closestLayer);
44
45 for (const CDCRecoHit3D hit : track) {
46 if (hit.isAxial()) continue;
47 firstHits.push_back(hit);
48 if ((hit.getISuperLayer() != closestLayer) and (firstHits.size() > 3)) break;
49 }
50
51 const CDCSZFitter& szFitter = CDCSZFitter::getFitter();
52 const CDCTrajectorySZ& szTrajectory = szFitter.fitWithStereoHits(firstHits);
53
54 Vector3D position(track.getStartTrajectory3D().getSupport().x(),
55 track.getStartTrajectory3D().getSupport().y(),
56 szTrajectory.getZ0());
57
58 Vector3D momentum(track.getStartTrajectory3D().getFlightDirection3DAtSupport());
59 const double z0 = szTrajectory.getZ0();
60 const double lambda = std::atan(szTrajectory.getTanLambda());
61 momentum.scale(std::cos(lambda));
62 momentum.setZ(std::sin(lambda));
63 momentum *= momentumSeedMagnitude;
64
65 ESign charge;
66 double votes(0);
67 int nHits(0);
68 closestLayer = track.getEndISuperLayer();
69 if (ISuperLayerUtil::isAxial(closestLayer)) closestLayer = ISuperLayerUtil::getNextInwards(closestLayer);
70 for (auto it = track.rbegin(); it != track.rend(); it++) {
71 CDCRecoHit3D hit = *it;
72 if (hit.isAxial()) continue;
73 votes += (hit.getRecoZ() - z0 - std::tan(lambda) * hit.getArcLength2D());
74 nHits++;
75 if ((hit.getISuperLayer() != closestLayer) and (nHits > 3)) break;
76 }
77 votes > 0 ? charge = ESign::c_Plus : charge = ESign::c_Minus;
78
79 RecoTrack* newRecoTrack = recoTracks.appendNew(position, momentum, charge);
80 RecoTrackUtil::fill(track, *newRecoTrack);
81 return newRecoTrack;
82}
83
85{
86 const CDCTrajectory3D& traj3D = track.getStartTrajectory3D();
87 RecoTrack* newRecoTrack = storeInto(traj3D, recoTracks);
88 if (not newRecoTrack) return nullptr;
89
90 RecoTrackUtil::fill(track, *newRecoTrack);
91 return newRecoTrack;
92}
93
96{
97 Vector3D position = traj3D.getSupport();
98 return storeInto(traj3D, CDCBFieldUtil::getBFieldZ(position), recoTracks);
99}
100
102 const double bZ,
103 StoreArray<RecoTrack>& recoTracks)
104{
105 // Set the start parameters
106 Vector3D position = traj3D.getSupport();
107 Vector3D momentum =
108 bZ == 0 ? traj3D.getFlightDirection3DAtSupport() : traj3D.getMom3DAtSupport(bZ);
109 ESign charge = traj3D.getChargeSign();
110
111 // Do not propagate invalid fits, signal that the fit is invalid to the caller.
112 if (not ESignUtil::isValid(charge) or momentum.hasNAN() or position.hasNAN()) {
113 return nullptr;
114 }
115
116 RecoTrack* newRecoTrack = recoTracks.appendNew(position, momentum, charge);
117 if (std::isfinite(traj3D.getFlightTime())) {
118 newRecoTrack->setTimeSeed(traj3D.getFlightTime());
119 }
120
121 const CovarianceMatrix<6>& cov6 = traj3D.getCartesianCovariance(bZ);
122 TMatrixDSym covSeed = TMatrixConversion::toTMatrix(cov6);
123 newRecoTrack->setSeedCovariance(covSeed);
124 return newRecoTrack;
125}
126
128template void RecoTrackUtil::fill<CDCTrack>(const CDCTrack&, RecoTrack&);
129
131template <class ARLHitHolderRange>
132void RecoTrackUtil::fill(const ARLHitHolderRange& rlWireHitHolders, RecoTrack& recoTrack)
133{
134 int sortingParameter = -1;
135 for (const auto& rlWireHitHolder : rlWireHitHolders) {
136 ++sortingParameter;
137
138 const CDCRLWireHit rlWireHit = rlWireHitHolder.getRLWireHit();
139 const CDCWireHit& wireHit = rlWireHit.getWireHit();
140 const CDCHit* cdcHit = wireHit.getHit();
141
142 // Right left ambiguity resolution
143 ERightLeft rlInfo = rlWireHit.getRLInfo();
144 using RightLeftInformation = RecoHitInformation::RightLeftInformation;
145 if (rlInfo == ERightLeft::c_Left) {
146 recoTrack.addCDCHit(cdcHit,
147 sortingParameter,
148 RightLeftInformation::c_left,
149 RecoHitInformation::c_CDCTrackFinder);
150 } else if (rlInfo == ERightLeft::c_Right) {
151 recoTrack.addCDCHit(cdcHit,
152 sortingParameter,
153 RightLeftInformation::c_right,
154 RecoHitInformation::c_CDCTrackFinder);
155 } else if (rlInfo == ERightLeft::c_Invalid) {
156 recoTrack.addCDCHit(cdcHit,
157 sortingParameter,
158 RightLeftInformation::c_invalidRightLeftInformation,
159 RecoHitInformation::c_CDCTrackFinder);
160 } else {
161 recoTrack.addCDCHit(cdcHit,
162 sortingParameter,
163 RightLeftInformation::c_undefinedRightLeftInformation,
164 RecoHitInformation::c_CDCTrackFinder);
165 }
166 }
167}
Class containing the result of the unpacker in raw data and the result of the digitizer in simulation...
Definition: CDCHit.h:40
RightLeftInformation
The RightLeft information of the hit which is only valid for CDC hits.
This is the Reconstruction Event-Data Model Track.
Definition: RecoTrack.h:79
bool addCDCHit(const UsedCDCHit *cdcHit, const unsigned int sortingParameter, RightLeftInformation rightLeftInformation=RightLeftInformation::c_undefinedRightLeftInformation, OriginTrackFinder foundByTrackFinder=OriginTrackFinder::c_undefinedTrackFinder)
Adds a cdc hit with the given information to the reco track.
Definition: RecoTrack.h:243
void setTimeSeed(const double timeSeed)
Set the time seed. ATTENTION: This is not the fitted time.
Definition: RecoTrack.h:604
void setSeedCovariance(const TMatrixDSym &seedCovariance)
Set the covariance of the seed. ATTENTION: This is not the fitted covariance.
Definition: RecoTrack.h:614
Accessor to arrays stored in the data store.
Definition: StoreArray.h:113
T * appendNew()
Construct a new T object at the end of the array.
Definition: StoreArray.h:246
static double getBFieldZ()
Getter for the signed magnetic field stength in z direction at the origin ( in Tesla )
Class representing an oriented hit wire including a hypotheses whether the causing track passes left ...
Definition: CDCRLWireHit.h:41
const CDCWireHit & getWireHit() const
Getter for the wire hit associated with the oriented hit.
Definition: CDCRLWireHit.h:192
ERightLeft getRLInfo() const
Getter for the right left passage information.
Definition: CDCRLWireHit.h:234
Class representing a three dimensional reconstructed hit.
Definition: CDCRecoHit3D.h:52
Class implementing the z coordinate over travel distance line fit.
Definition: CDCSZFitter.h:27
static const CDCSZFitter & getFitter()
Getter for a standard sz line fitter instance.
Definition: CDCSZFitter.cc:36
CDCTrajectorySZ fitWithStereoHits(const CDCTrack &track) const
Returns the fitted sz trajectory of the track with the z-information of all stereo hits of the number...
Definition: CDCSZFitter.cc:125
Class representing a sequence of three dimensional reconstructed hits.
Definition: CDCTrack.h:41
Particle full three dimensional trajectory.
Vector3D getMom3DAtSupport(const double bZ) const
Get the momentum at the start point of the trajectory.
CovarianceMatrix< 6 > getCartesianCovariance(double bZ) const
Convert the helix parameters to the cartesian coordinates x,y,z,px,py,pz.
double getFlightTime() const
Getter for the time when the particle reached the support point position.
ESign getChargeSign() const
Gets the charge sign of the trajectory.
Vector3D getFlightDirection3DAtSupport() const
Get the unit momentum at the start point of the trajectory.
Vector3D getSupport() const
Getter for the support point of the trajectory in global coordinates, where arcLength2D = 0.
Linear trajectory in sz space.
double getTanLambda() const
Getter for the slope over the travel distance coordinate.
double getZ0() const
Getter for the z coordinate at zero travel distance.
Class representing a hit wire in the central drift chamber.
Definition: CDCWireHit.h:55
const CDCHit * getHit() const
Getter for the CDCHit pointer into the StoreArray.
Definition: CDCWireHit.h:159
A matrix implementation to be used as an interface typ through out the track finder.
Definition: PlainMatrix.h:40
A three dimensional vector.
Definition: Vector3D.h:33
bool hasNAN() const
Checks if one of the coordinates is NAN.
Definition: Vector3D.h:165
ESign
Enumeration for the distinct sign values of floating point variables.
Definition: ESign.h:27
bool isValid(ESign s)
Returns true if sign is ESign::c_Plus, ESign::c_Minus or ESign::c_Zero.
Definition: ESign.h:46
ERightLeft
Enumeration to represent the distinct possibilities of the right left passage.
Definition: ERightLeft.h:25
Abstract base class for different kinds of events.
static bool isAxial(ISuperLayer iSuperLayer)
Returns if the super layer with the given id is axial.
Definition: ISuperLayer.cc:21
static ISuperLayer getNextInwards(ISuperLayer iSuperLayer)
Returns the super layer that is inside of the given super layer.
Definition: ISuperLayer.cc:63
static ISuperLayer getNextOutwards(ISuperLayer iSuperLayer)
Returns the super layer that is outside of the given super layer.
Definition: ISuperLayer.cc:72
static void fill(const ARLHitHolderRange &rlWireHitHolders, RecoTrack &recoTrack)
Translates a range of hits and inserts them in the reco track.
static RecoTrack * storeInto(const CDCTrack &track, StoreArray< RecoTrack > &recoTracks, const double momentumSeedMagnitude)
For magnetic monopoles; estimates charge sign from all stereo hits, momentum direction from hits in c...
static TMatrixDSym toTMatrix(const CovarianceMatrix< N > &cov)
Translate the covariance matrix to the TMatrix representation.