Belle II Software development
RecoTrackUtil Struct Reference

Structure to summarize utility function to output a list of hits into a RecoTrack. More...

#include <RecoTrackUtil.h>

Static Public Member Functions

static RecoTrackstoreInto (const TrackingUtilities::CDCTrack &track, StoreArray< RecoTrack > &recoTracks, const double momentumSeedMagnitude)
 For magnetic monopoles; estimates charge sign from all stereo hits, momentum direction from hits in closest superlayer, fixing magnitude with given value. Ignores building CDCTrajectory3D since it is based on a helix.
 
static RecoTrackstoreInto (const TrackingUtilities::CDCTrack &track, StoreArray< RecoTrack > &recoTracks)
 Copies the track information to the RecoTrack.
 
static RecoTrackstoreInto (const TrackingUtilities::CDCTrajectory3D &traj3D, StoreArray< RecoTrack > &recoTracks)
 Copies the trajectory information to the RecoTrack.
 
static RecoTrackstoreInto (const TrackingUtilities::CDCTrajectory3D &traj3D, const double bZ, StoreArray< RecoTrack > &recoTracks)
 Copies the trajectory information to the RecoTrack.
 
template<class ARLHitHolderRange>
static void fill (const ARLHitHolderRange &rlWireHitHolders, RecoTrack &recoTrack)
 Translates a range of hits and inserts them in the reco track.
 

Detailed Description

Structure to summarize utility function to output a list of hits into a RecoTrack.

Definition at line 26 of file RecoTrackUtil.h.

Member Function Documentation

◆ fill()

template<class ARLHitHolderRange>
void fill ( const ARLHitHolderRange & rlWireHitHolders,
RecoTrack & recoTrack )
static

Translates a range of hits and inserts them in the reco track.

fill() specialisation for a class that holds right-left wire-hit information

List of explicit specialisations - at the moment only CDCTrack.

Currently only instantiated for RecoTrack.

Parameters
rlWireHitHoldersA range of hits, which elements support ->getRLWireHit() to access a wire hit including a right left passage hypotheses.
[out]recoTrackRecoTrack to be filled.

Definition at line 135 of file RecoTrackUtil.cc.

136{
137 int sortingParameter = -1;
138 for (const auto& rlWireHitHolder : rlWireHitHolders) {
139 ++sortingParameter;
140
141 const CDCRLWireHit rlWireHit = rlWireHitHolder.getRLWireHit();
142 const CDCWireHit& wireHit = rlWireHit.getWireHit();
143 const CDCHit* cdcHit = wireHit.getHit();
144
145 // Right left ambiguity resolution
146 ERightLeft rlInfo = rlWireHit.getRLInfo();
147 using RightLeftInformation = RecoHitInformation::RightLeftInformation;
148 if (rlInfo == ERightLeft::c_Left) {
149 recoTrack.addCDCHit(cdcHit,
150 sortingParameter,
151 RightLeftInformation::c_left,
152 RecoHitInformation::c_CDCTrackFinder);
153 } else if (rlInfo == ERightLeft::c_Right) {
154 recoTrack.addCDCHit(cdcHit,
155 sortingParameter,
156 RightLeftInformation::c_right,
157 RecoHitInformation::c_CDCTrackFinder);
158 } else if (rlInfo == ERightLeft::c_Invalid) {
159 recoTrack.addCDCHit(cdcHit,
160 sortingParameter,
161 RightLeftInformation::c_invalidRightLeftInformation,
162 RecoHitInformation::c_CDCTrackFinder);
163 } else {
164 recoTrack.addCDCHit(cdcHit,
165 sortingParameter,
166 RightLeftInformation::c_undefinedRightLeftInformation,
167 RecoHitInformation::c_CDCTrackFinder);
168 }
169 }
170}
RightLeftInformation
The RightLeft information of the hit which is only valid for CDC hits.
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
const CDCWireHit & getWireHit() const
Getter for the wire hit associated with the oriented hit.
ERightLeft getRLInfo() const
Getter for the right left passage information.
const CDCHit * getHit() const
Getter for the CDCHit pointer into the StoreArray.
Definition CDCWireHit.h:160
ERightLeft
Enumeration to represent the distinct possibilities of the right left passage.
Definition ERightLeft.h:25

◆ storeInto() [1/4]

RecoTrack * storeInto ( const TrackingUtilities::CDCTrack & track,
StoreArray< RecoTrack > & recoTracks )
static

Copies the track information to the RecoTrack.

Definition at line 87 of file RecoTrackUtil.cc.

88{
89 const CDCTrajectory3D& traj3D = track.getStartTrajectory3D();
90 RecoTrack* newRecoTrack = storeInto(traj3D, recoTracks);
91 if (not newRecoTrack) return nullptr;
92
93 RecoTrackUtil::fill(track, *newRecoTrack);
94 return newRecoTrack;
95}
static void fill(const ARLHitHolderRange &rlWireHitHolders, RecoTrack &recoTrack)
Translates a range of hits and inserts them in the reco track.
static RecoTrack * storeInto(const TrackingUtilities::CDCTrack &track, StoreArray< RecoTrack > &recoTracks, const double momentumSeedMagnitude)
For magnetic monopoles; estimates charge sign from all stereo hits, momentum direction from hits in c...

◆ storeInto() [2/4]

RecoTrack * storeInto ( const TrackingUtilities::CDCTrack & track,
StoreArray< RecoTrack > & recoTracks,
const double momentumSeedMagnitude )
static

For magnetic monopoles; estimates charge sign from all stereo hits, momentum direction from hits in closest superlayer, fixing magnitude with given value. Ignores building CDCTrajectory3D since it is based on a helix.

Definition at line 42 of file RecoTrackUtil.cc.

43{
44 CDCTrack firstHits;
45 ISuperLayer closestLayer = track.getStartISuperLayer();
46 if (ISuperLayerUtil::isAxial(closestLayer)) closestLayer = ISuperLayerUtil::getNextOutwards(closestLayer);
47
48 for (const CDCRecoHit3D& hit : track) {
49 if (hit.isAxial()) continue;
50 firstHits.push_back(hit);
51 if ((hit.getISuperLayer() != closestLayer) and (firstHits.size() > 3)) break;
52 }
53
54 const CDCSZFitter& szFitter = CDCSZFitter::getFitter();
55 const CDCTrajectorySZ& szTrajectory = szFitter.fitWithStereoHits(firstHits);
56
57 ROOT::Math::XYZVector position(track.getStartTrajectory3D().getSupport().x(),
58 track.getStartTrajectory3D().getSupport().y(),
59 szTrajectory.getZ0());
60
61 ROOT::Math::XYZVector momentum(track.getStartTrajectory3D().getFlightDirection3DAtSupport());
62 const double z0 = szTrajectory.getZ0();
63 const double lambda = std::atan(szTrajectory.getTanLambda());
64 momentum *= (std::cos(lambda));
65 momentum.SetZ(std::sin(lambda));
66 momentum *= momentumSeedMagnitude;
67
68 ESign charge;
69 double votes(0);
70 int nHits(0);
71 closestLayer = track.getEndISuperLayer();
72 if (ISuperLayerUtil::isAxial(closestLayer)) closestLayer = ISuperLayerUtil::getNextInwards(closestLayer);
73 for (auto it = track.rbegin(); it != track.rend(); it++) {
74 CDCRecoHit3D hit = *it;
75 if (hit.isAxial()) continue;
76 votes += (hit.getRecoZ() - z0 - std::tan(lambda) * hit.getArcLength2D());
77 nHits++;
78 if ((hit.getISuperLayer() != closestLayer) and (nHits > 3)) break;
79 }
80 votes > 0 ? charge = ESign::c_Plus : charge = ESign::c_Minus;
81
82 RecoTrack* newRecoTrack = recoTracks.appendNew(position, momentum, charge);
83 RecoTrackUtil::fill(track, *newRecoTrack);
84 return newRecoTrack;
85}
T * appendNew()
Construct a new T object at the end of the array.
Definition StoreArray.h:246
TrackingUtilities::CDCTrajectorySZ fitWithStereoHits(const TrackingUtilities::CDCTrack &track) const
Returns the fitted sz trajectory of the track with the z-information of all stereo hits of the number...
static const CDCSZFitter & getFitter()
Getter for a standard sz line fitter instance.
bool isAxial() const
Indicator if the underlying wire is axial.
CDC::ISuperLayer getISuperLayer() const
Getter for the superlayer id.
double getRecoZ() const
Getter for the z coordinate of the reconstructed position.
double getArcLength2D() const
Getter for the travel distance in the xy projection.
double getTanLambda() const
Getter for the slope over the travel distance coordinate.
double getZ0() const
Getter for the z coordinate at zero travel distance.
signed short ISuperLayer
The type of the layer and superlayer ids.
Definition ISuperLayer.h:24
ESign
Enumeration for the distinct sign values of floating point variables.
Definition ESign.h:27
static bool isAxial(ISuperLayer iSuperLayer)
Returns if the super layer with the given id is axial.
static ISuperLayer getNextInwards(ISuperLayer iSuperLayer)
Returns the super layer that is inside of the given super layer.
static ISuperLayer getNextOutwards(ISuperLayer iSuperLayer)
Returns the super layer that is outside of the given super layer.

◆ storeInto() [3/4]

RecoTrack * storeInto ( const TrackingUtilities::CDCTrajectory3D & traj3D,
const double bZ,
StoreArray< RecoTrack > & recoTracks )
static

Copies the trajectory information to the RecoTrack.

Definition at line 104 of file RecoTrackUtil.cc.

107{
108 // Set the start parameters
109 ROOT::Math::XYZVector position = traj3D.getSupport();
110 ROOT::Math::XYZVector momentum =
111 bZ == 0 ? traj3D.getFlightDirection3DAtSupport() : traj3D.getMom3DAtSupport(bZ);
112 ESign charge = traj3D.getChargeSign();
113
114 // Do not propagate invalid fits, signal that the fit is invalid to the caller.
115 if (not ESignUtil::isValid(charge) or VectorUtil::hasNAN(momentum) or VectorUtil::hasNAN(position)) {
116 return nullptr;
117 }
118
119 RecoTrack* newRecoTrack = recoTracks.appendNew(position, momentum, charge);
120 if (std::isfinite(traj3D.getFlightTime())) {
121 newRecoTrack->setTimeSeed(traj3D.getFlightTime());
122 }
123
124 const CovarianceMatrix<6>& cov6 = traj3D.getCartesianCovariance(bZ);
125 TMatrixDSym covSeed = TMatrixConversion::toTMatrix(cov6);
126 newRecoTrack->setSeedCovariance(covSeed);
127 return newRecoTrack;
128}
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
bool isValid(ESign s)
Returns true if sign is ESign::c_Plus, ESign::c_Minus or ESign::c_Zero.
Definition ESign.h:46
static TMatrixDSym toTMatrix(const CovarianceMatrix< N > &cov)
Translate the covariance matrix to the TMatrix representation.

◆ storeInto() [4/4]

RecoTrack * storeInto ( const TrackingUtilities::CDCTrajectory3D & traj3D,
StoreArray< RecoTrack > & recoTracks )
static

Copies the trajectory information to the RecoTrack.

Definition at line 98 of file RecoTrackUtil.cc.

99{
100 ROOT::Math::XYZVector position = traj3D.getSupport();
101 return storeInto(traj3D, CDCBFieldUtil::getBFieldZ(position), recoTracks);
102}
static double getBFieldZ()
Getter for the signed magnetic field strength in z direction at the origin ( in Tesla )

The documentation for this struct was generated from the following files: