]> git.uio.no Git - u/mrichter/AliRoot.git/blobdiff - RALICE/AliTrack.cxx
22-jun-2006 NvE Linear track storage facility introduced in AliSignal to enable
[u/mrichter/AliRoot.git] / RALICE / AliTrack.cxx
index 7ba7a349a345d220ebf457bc5be4e2fbe59506a1..a3d112a9c9b08ed7db0f35accc5d8d27a837a022 100644 (file)
@@ -117,19 +117,19 @@ void AliTrack::Init()
  fClosest=0;
  fParent=0;
  fFit=0;
+ fTstamp=0;
 }
 ///////////////////////////////////////////////////////////////////////////
 AliTrack::~AliTrack()
 {
 // Destructor to delete memory allocated for decay tracks array.
-// This destructor automatically cleares the pointer of this AliTrack
-// from all the link slots of the related AliSignal objects.
-
+// This destructor automatically cleares all references to this AliTrack
+// from all the related AliSignal objects.
  Int_t nsig=GetNsignals();
  for (Int_t i=1; i<=nsig; i++)
  {
   AliSignal* s=GetSignal(i);
-  if (s) s->ResetLinks(this);
+  if (s) s->RemoveTrack(*this,0);
  }
  
  if (fDecays)
@@ -139,7 +139,6 @@ AliTrack::~AliTrack()
  }
  if (fSignals)
  {
-  fSignals->Clear();
   delete fSignals;
   fSignals=0;
  }
@@ -188,6 +187,11 @@ AliTrack::~AliTrack()
   delete fFit;
   fFit=0;
  }
+ if (fTstamp)
+ {
+  delete fTstamp;
+  fTstamp=0;
+ }
 }
 ///////////////////////////////////////////////////////////////////////////
 AliTrack::AliTrack(const AliTrack& t) : TNamed(t),Ali4Vector(t)
@@ -205,6 +209,7 @@ AliTrack::AliTrack(const AliTrack& t) : TNamed(t),Ali4Vector(t)
  if (t.fImpactYZ) fImpactYZ=new AliPositionObj(*(t.fImpactYZ));
  if (t.fClosest) fClosest=new AliPositionObj(*(t.fClosest));
  if (t.fFit) fFit=t.fFit->Clone();
+ if (t.fTstamp) fTstamp=new AliTimestamp(*(t.fTstamp));
  fUserId=t.fUserId;
  fChi2=t.fChi2;
  fNdf=t.fNdf;
@@ -266,7 +271,6 @@ void AliTrack::Reset()
  }
  if (fSignals)
  {
-  fSignals->Clear();
   delete fSignals;
   fSignals=0;
  }
@@ -315,6 +319,11 @@ void AliTrack::Reset()
   delete fFit;
   fFit=0;
  }
+ if (fTstamp)
+ {
+  delete fTstamp;
+  fTstamp=0;
+ }
 }
 ///////////////////////////////////////////////////////////////////////////
 void AliTrack::Set3Momentum(Ali3Vector& p)
@@ -351,9 +360,17 @@ void AliTrack::SetCharge(Float_t q)
  fQ=q;
 }
 ///////////////////////////////////////////////////////////////////////////
-void AliTrack::Data(TString f)
+void AliTrack::Data(TString f,TString u)
 {
 // Provide track information within the coordinate frame f
+//
+// The string argument "u" allows to choose between different angular units
+// in case e.g. a spherical frame is selected.
+// u = "rad" : angles provided in radians
+//     "deg" : angles provided in degrees
+//
+// The defaults are f="car" and u="rad".
+
  Double_t m=GetMass();
  Double_t dm=GetResultError();
  const char* name=GetName();
@@ -363,6 +380,7 @@ void AliTrack::Data(TString f)
  if (strlen(name))  cout << " Name : " << name;
  if (strlen(title)) cout << " Title : " << title;
  cout << endl;
+ if (fTstamp) fTstamp->Date(1);
  cout << " Id : " << fUserId << " Code : " << fCode
       << " m : " << m << " dm : " << dm << " Charge : " << fQ
       << " p : " << GetMomentum() << endl;
@@ -384,14 +402,24 @@ void AliTrack::Data(TString f)
   cout << " Fit details present in object of class " << fFit->ClassName() << endl; 
   if (fFit->InheritsFrom("AliSignal")) ((AliSignal*)fFit)->List(-1);
  }
- Ali4Vector::Data(f); 
+ Ali4Vector::Data(f,u); 
 } 
 ///////////////////////////////////////////////////////////////////////////
-void AliTrack::List(TString f)
+void AliTrack::List(TString f,TString u)
 {
 // Provide current track and decay level 1 information within coordinate frame f
+//
+// The string argument "u" allows to choose between different angular units
+// in case e.g. a spherical frame is selected.
+// u = "rad" : angles provided in radians
+//     "deg" : angles provided in degrees
+//
+// The defaults are f="car" and u="rad".
 
- Data(f); // Information of the current track
+ Data(f,u); // Information of the current track
+ if (fBegin) { cout << " Begin-point :"; fBegin->Data(f,u); }
+ if (fEnd)   { cout << " End-point   :"; fEnd->Data(f,u); }
+ if (fRef)   { cout << " Ref-point   :"; fRef->Data(f,u); }
 
  // Decay products of this track
  AliTrack* td; 
@@ -401,7 +429,7 @@ void AliTrack::List(TString f)
   if (td)
   {
    cout << "  ---Level 1 sec. track no. " << id << endl;
-   td->Data(f); 
+   td->Data(f,u); 
   }
   else
   {
@@ -410,14 +438,21 @@ void AliTrack::List(TString f)
  }
 } 
 ///////////////////////////////////////////////////////////////////////////
-void AliTrack::ListAll(TString f)
+void AliTrack::ListAll(TString f,TString u)
 {
 // Provide complete track and decay information within the coordinate frame f
+//
+// The string argument "u" allows to choose between different angular units
+// in case e.g. a spherical frame is selected.
+// u = "rad" : angles provided in radians
+//     "deg" : angles provided in degrees
+//
+// The defaults are f="car" and u="rad".
 
- Data(f); // Information of the current track
- if (fBegin) { cout << " Begin-point :"; fBegin->Data(f); }
- if (fEnd)   { cout << " End-point   :"; fEnd->Data(f); }
- if (fRef)   { cout << " Ref-point   :"; fRef->Data(f); }
+ Data(f,u); // Information of the current track
+ if (fBegin) { cout << " Begin-point :"; fBegin->Data(f,u); }
+ if (fEnd)   { cout << " End-point   :"; fEnd->Data(f,u); }
+ if (fRef)   { cout << " Ref-point   :"; fRef->Data(f,u); }
 
  Int_t nhyp=GetNhypotheses();
  if (nhyp)
@@ -426,7 +461,7 @@ void AliTrack::ListAll(TString f)
   for (Int_t ih=1; ih<=nhyp; ih++)
   {
    AliTrack* tx=GetTrackHypothesis(ih);
-   if (tx) tx->Data(f);
+   if (tx) tx->Data(f,u);
   }
  }
 
@@ -451,16 +486,16 @@ void AliTrack::ListAll(TString f)
     }
     r=sx->GetPosition();
     cout << "   Position";
-    r.Data(f);
+    r.Data(f,u);
    }
   }
  }
 
  AliTrack* t=this;
- Dumps(t,1,f); // Information of all decay products
+ Dumps(t,1,f,u); // Information of all decay products
 }
 //////////////////////////////////////////////////////////////////////////
-void AliTrack::Dumps(AliTrack* t,Int_t n,TString f)
+void AliTrack::Dumps(AliTrack* t,Int_t n,TString f,TString u)
 {
 // Recursively provide the info of all decay levels of this track
  AliTrack* td; 
@@ -470,7 +505,7 @@ void AliTrack::Dumps(AliTrack* t,Int_t n,TString f)
   if (td)
   {
    cout << "  ---Level " << n << " sec. track no. " << id << endl;
-   td->Data(f); 
+   td->Data(f,u); 
 
    Int_t nhyp=td->GetNhypotheses();
    if (nhyp)
@@ -479,7 +514,7 @@ void AliTrack::Dumps(AliTrack* t,Int_t n,TString f)
     for (Int_t ih=1; ih<=nhyp; ih++)
     {
      AliTrack* tx=td->GetTrackHypothesis(ih);
-     if (tx) tx->Data(f);
+     if (tx) tx->Data(f,u);
     }
    }
 
@@ -490,12 +525,12 @@ void AliTrack::Dumps(AliTrack* t,Int_t n,TString f)
     for (Int_t is=1; is<=nsig; is++)
     {
      AliSignal* sx=td->GetSignal(is);
-     if (sx) sx->Data(f);
+     if (sx) sx->Data(f,u);
     }
    }
 
    // Go for next decay level of this decay track recursively
-   Dumps(td,n+1,f);
+   Dumps(td,n+1,f,u);
   }
   else
   {
@@ -681,9 +716,19 @@ void AliTrack::RemoveDecays()
  }
 }
 ///////////////////////////////////////////////////////////////////////////
-void AliTrack::AddSignal(AliSignal& s)
+void AliTrack::AddSignal(AliSignal& s,Int_t mode)
 {
 // Relate an AliSignal object to this track.
+//
+// mode = 0 : Only the reference to the specified signal is stored in
+//            the current track, without storing the (backward) reference
+//            to this track into the AliSignal structure. 
+//        1 : The (backward) reference to the current track is also automatically
+//            stored into the AliSignal (or derived) object specified in the
+//            input argument.
+//
+// The default is mode=0.
+
  if (!fSignals) fSignals=new TObjArray(1);
 
  // Check if this signal is already stored for this track
@@ -694,27 +739,53 @@ void AliTrack::AddSignal(AliSignal& s)
  }
 
  fSignals->Add(&s);
+ if (mode==1) s.AddTrack(*this,0);
 }
 ///////////////////////////////////////////////////////////////////////////
-void AliTrack::RemoveSignal(AliSignal& s)
+void AliTrack::RemoveSignal(AliSignal& s,Int_t mode)
 {
 // Remove related AliSignal object from this track.
+//
+// mode = 0 : Only the reference to the specified signal is removed from
+//            the current track, without removing the (backward) reference(s)
+//            to this track from the AliSignal structure. 
+//        1 : The (backward) reference(s) to the current track are also automatically
+//            removed from the AliSignal (or derived) object specified in the
+//            input argument.
+//
+// The default is mode=1.
+
  if (fSignals)
  {
   AliSignal* test=(AliSignal*)fSignals->Remove(&s);
   if (test) fSignals->Compress();
  }
+ if (mode==1) s.RemoveTrack(*this,0);
 }
 ///////////////////////////////////////////////////////////////////////////
-void AliTrack::RemoveSignals()
+void AliTrack::RemoveSignals(Int_t mode)
 {
 // Remove all related AliSignal objects from this track.
- if (fSignals)
+//
+// mode = 0 : All signal references are removed from the current track,
+//            without removing the (backward) references to this track from
+//            the corresponding AliSignal objects.
+//        1 : The (backward) references to the current track are also automatically
+//            removed from the corresponding AliSignal (or derived) objects.
+//
+// The default is mode=1.
+
+ if (!fSignals) return;
+
+ Int_t ns=GetNsignals();
+ for (Int_t i=0; i<ns; i++)
  {
-  fSignals->Clear();
-  delete fSignals;
-  fSignals=0;
+  AliSignal* sx=(AliSignal*)fSignals->At(i);
+  if (sx && mode==1) sx->RemoveTrack(*this,0);
  }
+
+ delete fSignals;
+ fSignals=0;
 }
 ///////////////////////////////////////////////////////////////////////////
 Int_t AliTrack::GetNsignals() const
@@ -857,14 +928,8 @@ AliTrack* AliTrack::GetTrackHypothesis(Int_t j) const
 void AliTrack::SetBeginPoint(AliPosition& p)
 {
 // Store the position of the track begin-point.
- if (!fBegin)
- {
-  fBegin=new AliPositionObj(p);
- }
- else
- {
-  fBegin->Load(p);
- }
+ if (fBegin) delete fBegin;
+ fBegin=new AliPositionObj(p);
 }
 ///////////////////////////////////////////////////////////////////////////
 AliPosition* AliTrack::GetBeginPoint()
@@ -876,14 +941,8 @@ AliPosition* AliTrack::GetBeginPoint()
 void AliTrack::SetEndPoint(AliPosition& p)
 {
 // Store the position of the track end-point.
- if (!fEnd)
- {
-  fEnd=new AliPositionObj(p);
- }
- else
- {
-  fEnd->Load(p);
- }
+ if (fEnd) delete fEnd;
+ fEnd=new AliPositionObj(p);
 }
 ///////////////////////////////////////////////////////////////////////////
 AliPosition* AliTrack::GetEndPoint()
@@ -899,14 +958,8 @@ void AliTrack::SetReferencePoint(AliPosition& p)
 // 3-momentum vector components have been defined.
 // This reference point is the preferable point to start track extrapolations
 // etc... which are sensitive to the components of the 3-momentum vector.
- if (!fRef)
- {
-  fRef=new AliPositionObj(p);
- }
- else
- {
-  fRef->Load(p);
- }
+ if (fRef) delete fRef;
+ fRef=new AliPositionObj(p);
 }
 ///////////////////////////////////////////////////////////////////////////
 AliPosition* AliTrack::GetReferencePoint()
@@ -1047,36 +1100,18 @@ void AliTrack::SetImpactPoint(AliPosition& p,TString q)
  switch (axis)
  {
   case 1: // Impact-point in the plane X=0
-   if (!fImpactYZ)
-   {
-    fImpactYZ=new AliPositionObj(p);
-   }
-   else
-   {
-    fImpactYZ->Load(p);
-   }
+   if (fImpactYZ) delete fImpactYZ;
+   fImpactYZ=new AliPositionObj(p);
    break;
 
   case 2: // Impact-point in the plane Y=0
-   if (!fImpactXZ)
-   {
-    fImpactXZ=new AliPositionObj(p);
-   }
-   else
-   {
-    fImpactXZ->Load(p);
-   }
+   if (fImpactXZ) delete fImpactXZ;
+   fImpactXZ=new AliPositionObj(p);
    break;
 
   case 3: // Impact-point in the plane Z=0
-   if (!fImpactXY)
-   {
-    fImpactXY=new AliPositionObj(p);
-   }
-   else
-   {
-    fImpactXY->Load(p);
-   }
+   if (fImpactXY) delete fImpactXY;
+   fImpactXY=new AliPositionObj(p);
    break;
 
   default: // Unsupported axis
@@ -1130,14 +1165,8 @@ Int_t AliTrack::GetId() const
 void AliTrack::SetClosestPoint(AliPosition& p)
 {
 // Set position p as the point of closest approach w.r.t. some reference
- if (!fClosest)
- {
-  fClosest=new AliPositionObj(p);
- }
- else
- {
-  fClosest->Load(p);
- }
+ if (fClosest) delete fClosest;
+ fClosest=new AliPositionObj(p);
 }
 ///////////////////////////////////////////////////////////////////////////
 AliPosition* AliTrack::GetClosestPoint()
@@ -1262,6 +1291,155 @@ TObject* AliTrack::GetFitDetails()
  return fFit;
 }
 ///////////////////////////////////////////////////////////////////////////
+void AliTrack::SetTimestamp(AliTimestamp& t)
+{
+// Store the timestamp for this track.
+ if (fTstamp) delete fTstamp;
+ fTstamp=new AliTimestamp(t);
+}
+///////////////////////////////////////////////////////////////////////////
+AliTimestamp* AliTrack::GetTimestamp()
+{
+// Provide the timestamp of this track.
+ return fTstamp;
+}
+///////////////////////////////////////////////////////////////////////////
+void AliTrack::RemoveTimestamp()
+{
+// Remove the timestamp from this track.
+ if (fTstamp)
+ {
+  delete fTstamp;
+  fTstamp=0;
+ }
+}
+///////////////////////////////////////////////////////////////////////////
+Double_t AliTrack::GetDistance(AliPosition* p)
+{
+// Provide distance of the current track to the position p.
+// The error on the result can be obtained as usual by invoking
+// GetResultError() afterwards. 
+//
+// The distance will be provided in the unit scale of the AliPosition p.
+// As such it is possible to obtain a correctly computed distance even in case
+// the track parameters have a different unit scale.
+// However, it is recommended to work always with one single unit scale.
+//
+// Note : In case of incomplete information, a distance value of -1 is
+//        returned.
+ Double_t dist=-1.;
+ fDresult=0.;
+
+ if (!p) return dist;
+
+ // Obtain a defined position on this track
+ AliPosition* rx=fRef;
+ if (!rx) rx=fBegin;
+ if (!rx) rx=fEnd;
+
+ if (!rx) return dist;
+
+ Ali3Vector p1=Get3Momentum();
+
+ if (p1.GetNorm() <= 0.) return dist;
+
+ Ali3Vector r0=(Ali3Vector)(*rx);
+
+ Float_t tscale=rx->GetUnitScale();
+ Float_t pscale=p->GetUnitScale();
+ if ((tscale/pscale > 1.1) || (pscale/tscale > 1.1)) r0=r0*(tscale/pscale);
+ // Obtain the direction unit vector of this track
+ Double_t vec[3];
+ Double_t err[3];
+ p1.GetVector(vec,"sph");
+ p1.GetErrors(err,"sph");
+ vec[0]=1.;
+ err[0]=0.;
+ p1.SetVector(vec,"sph");
+ p1.SetErrors(err,"sph");
+
+ Ali3Vector q=(Ali3Vector)(*p);
+ Ali3Vector r=q-r0;
+ Ali3Vector d=r.Cross(p1);
+ dist=d.GetNorm();
+ fDresult=d.GetResultError();
+ return dist;
+}
+///////////////////////////////////////////////////////////////////////////
+Double_t AliTrack::GetDistance(AliTrack* t)
+{
+// Provide distance of the current track to the track t.
+// The error on the result can be obtained as usual by invoking
+// GetResultError() afterwards. 
+//
+// The distance will be provided in the unit scale of the current track.
+// As such it is possible to obtain a correctly computed distance even in case
+// the track parameters have a different unit scale.
+// This implies that in such cases the results of t1.GetDistance(t2) and
+// t2.GetDistance(t1) will be numerically different.
+// However, it is recommended to work always with one single unit scale.
+//
+// Note : In case of incomplete information, a distance value of -1 is
+//        returned.
+ Double_t dist=-1.;
+ fDresult=0.;
+
+ if (!t) return dist;
+
+ // Obtain a defined position on this track
+ AliPosition* rx=fRef;
+ if (!rx) rx=fBegin;
+ if (!rx) rx=fEnd;
+
+ if (!rx) return dist;
+
+ // Obtain a defined position on track t
+ AliPosition* ry=t->GetReferencePoint();
+ if (!ry) ry=t->GetBeginPoint();
+ if (!ry) ry=t->GetEndPoint();
+
+ if (!ry) return dist;
+ Ali3Vector p1=Get3Momentum();
+ Ali3Vector p2=t->Get3Momentum();
+
+ if (p1.GetNorm() <= 0. || p2.GetNorm() <= 0.) return dist;
+
+ // The vector normal to both track directions
+ Ali3Vector n=p1.Cross(p2);
+
+ if (n.GetNorm() > 1.e-10)
+ {
+  // Normalise n to a unit vector
+  Double_t vec[3];
+  Double_t err[3];
+  n.GetVector(vec,"sph");
+  n.GetErrors(err,"sph");
+  vec[0]=1.;
+  err[0]=0.;
+  n.SetVector(vec,"sph");
+  n.SetErrors(err,"sph");
+  Ali3Vector r1=(Ali3Vector)(*rx);
+  Ali3Vector r2=(Ali3Vector)(*ry);
+  // Correct components of r2 in case of different unit scales
+  Float_t scale=rx->GetUnitScale();
+  Float_t tscale=ry->GetUnitScale();
+  if ((tscale/scale > 1.1) || (scale/tscale > 1.1)) r2=r2*(tscale/scale);
+  Ali3Vector r=r1-r2;
+  dist=fabs(r.Dot(n));
+  fDresult=r.GetResultError();
+ }
+ else // Parallel tracks
+ {
+  dist=t->GetDistance(rx);
+  fDresult=t->GetResultError();
+ }
+ return dist;
+}
+///////////////////////////////////////////////////////////////////////////
 TObject* AliTrack::Clone(const char* name) const
 {
 // Make a deep copy of the current object and provide the pointer to the copy.