1 /**************************************************************************
2 * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
4 * Author: The ALICE Off-line Project. *
5 * Contributors are mentioned in the code where appropriate. *
7 * Permission to use, copy, modify and distribute this software and its *
8 * documentation strictly for non-commercial purposes is hereby granted *
9 * without fee, provided that the above copyright notice appears in all *
10 * copies and that both the copyright notice and this permission notice *
11 * appear in the supporting documentation. The authors make no claims *
12 * about the suitability of this software for any purpose. It is *
13 * provided "as is" without express or implied warranty. *
14 **************************************************************************/
18 #include "AliMUONESDInterface.h"
19 #include "AliMUONTrack.h"
20 #include "AliMUONVTrackStore.h"
21 #include "AliMUONVCluster.h"
22 #include "AliMUONVClusterStore.h"
23 #include "AliMUONVDigit.h"
24 #include "AliMUONVDigitStore.h"
25 #include "AliMUONLocalTrigger.h"
26 #include "AliMUONTriggerTrack.h"
27 #include "AliMUONVTriggerStore.h"
28 #include "AliMUONVTriggerTrackStore.h"
29 #include "AliMUON2DMapIterator.h"
30 #include "AliMUONTrackParam.h"
31 #include "AliMUONTrackExtrap.h"
32 #include "AliMUONConstants.h"
33 #include "AliMUONTracker.h"
34 #include "AliMUONRecoParam.h"
35 #include "AliMUONVTrackReconstructor.h"
37 #include "AliMpExMapIterator.h"
38 #include "AliMpVSegmentation.h"
39 #include "AliMpSegmentation.h"
42 #include "AliESDEvent.h"
43 #include "AliESDMuonTrack.h"
44 #include "AliESDMuonCluster.h"
45 #include "AliESDMuonPad.h"
50 #include <TIterator.h>
53 #include <Riostream.h>
54 #include <TGeoGlobalMagField.h>
55 #include <TVirtualMagField.h>
57 //-----------------------------------------------------------------------------
58 /// \class AliMUONESDInterface
60 /// There are 2 way of using thid converter between MUON track/cluster/digit
61 /// and ESDMuon track/cluster/pad:
63 /// 1) using the static methods converting the objects one by one
65 /// 2) loading a whole ESDEvent and using the finders and/or the iterators
66 /// to access the corresponding MUON objects
68 /// note: You can set the recoParam used to refit the MUON track with ResetTracker(...);
69 /// By default we use Kalman filter + Smoother
71 /// \author Philippe Pillot
72 //-----------------------------------------------------------------------------
75 ClassImp(AliMUONESDInterface)
78 AliMUONRecoParam* AliMUONESDInterface::fgRecoParam = 0x0;
79 AliMUONVTrackReconstructor* AliMUONESDInterface::fgTracker = 0x0;
81 TString AliMUONESDInterface::fgTrackStoreName = "AliMUONTrackStoreV1";
82 TString AliMUONESDInterface::fgClusterStoreName = "AliMUONClusterStoreV2";
83 TString AliMUONESDInterface::fgDigitStoreName = "AliMUONDigitStoreV2R";
84 TString AliMUONESDInterface::fgTriggerStoreName = "AliMUONTriggerStoreV1";
85 TString AliMUONESDInterface::fgTriggerTrackStoreName = "AliMUONTriggerTrackStoreV1";
87 //_____________________________________________________________________________
88 AliMUONESDInterface::AliMUONESDInterface()
96 /// Default constructor
99 //_____________________________________________________________________________
100 AliMUONESDInterface::~AliMUONESDInterface()
110 //+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++//
111 // methods to play with internal objects //
112 //+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++//
114 //_____________________________________________________________________________
115 void AliMUONESDInterface::Clear(Option_t*)
118 delete fTracks; fTracks = 0x0;
119 delete fDigits; fDigits = 0x0;
120 delete fTriggers; fTriggers = 0x0;
121 delete fClusterMap; fClusterMap = 0x0;
122 delete fDigitMap; fDigitMap = 0x0;
125 //_____________________________________________________________________________
126 void AliMUONESDInterface::Reset()
128 /// reset stores and maps
130 if (fTracks) fTracks->Clear("C");
131 else fTracks = NewTrackStore();
133 if (fDigits) fDigits->Clear("C");
134 else fDigits = NewDigitStore();
136 if (fTriggers) fTriggers->Clear("C");
137 else fTriggers = NewTriggerStore();
139 if (fClusterMap) fClusterMap->Clear();
140 else fClusterMap = new AliMpExMap;
141 fClusterMap->SetOwner(kTRUE);
143 if (fDigitMap) fDigitMap->Clear();
144 else fDigitMap = new AliMpExMap;
145 fDigitMap->SetOwner(kTRUE);
148 //_____________________________________________________________________________
149 void AliMUONESDInterface::LoadEvent(AliESDEvent& esdEvent, Bool_t refit)
151 /// Extract MUON data from the given ESD event
153 // reset data members
156 // loop over ESD pads and fill the digit store
157 for (Int_t iPad = 0; iPad < esdEvent.GetNumberOfMuonPads(); iPad++)
158 Add(*(esdEvent.GetMuonPad(iPad)), *fDigits);
160 // loop over ESD tracks and fill the stores
161 for (Int_t iTrack = 0; iTrack < esdEvent.GetNumberOfMuonTracks(); iTrack++) {
164 AliESDMuonTrack* esdTrack = esdEvent.GetMuonTrack(iTrack);
166 // fill trigger store if related info are availables
167 if (esdTrack->ContainTriggerData()) Add(*esdTrack, *fTriggers);
169 // fill tracker data if availables
170 if (!esdTrack->ContainTrackerData()) continue;
172 // add it to track store
173 AliMUONTrack* track = Add(*esdTrack, *fTracks, refit);
175 // prepare cluster map
176 AliMpExMap* cMap = new AliMpExMap;
177 cMap->SetOwner(kFALSE);
178 fClusterMap->Add(esdTrack->GetUniqueID(), cMap);
180 // prepare digit maps
181 AliMpExMap* dMaps = new AliMpExMap;
182 dMaps->SetOwner(kTRUE);
183 fDigitMap->Add(esdTrack->GetUniqueID(), dMaps);
185 // loop over clusters
186 for (Int_t iCluster = 0; iCluster < track->GetNClusters(); iCluster++) {
189 AliMUONVCluster* cluster = ((AliMUONTrackParam*)track->GetTrackParamAtCluster()->UncheckedAt(iCluster))->GetClusterPtr();
192 cMap->Add(cluster->GetUniqueID(), cluster);
195 AliMpExMap* dMap =new AliMpExMap;
196 dMap->SetOwner(kFALSE);
197 dMaps->Add(cluster->GetUniqueID(), dMap);
200 for (Int_t iDigit = 0; iDigit < cluster->GetNDigits(); iDigit++) {
203 AliMUONVDigit* digit = fDigits->FindObject(cluster->GetDigitId(iDigit));
206 if (digit) dMap->Add(digit->GetUniqueID(), digit);
207 else AliError("a digit is missing");
209 } // end of loop over pads
211 } // end of loop over clusters
213 } // end of loop over tracks
217 //___________________________________________________________________________
218 Int_t AliMUONESDInterface::GetNTracks() const
220 /// return the number of tracks
221 return fTracks ? fTracks->GetSize() : 0;
224 //___________________________________________________________________________
225 Int_t AliMUONESDInterface::GetNClusters() const
227 /// return the number of clusters
230 TIter next(CreateTrackIterator());
231 while ((track = static_cast<AliMUONTrack*>(next()))) nClusters += track->GetNClusters();
235 //___________________________________________________________________________
236 Int_t AliMUONESDInterface::GetNClusters(UInt_t trackId) const
238 /// return the number of clusters in track "trackId"
239 AliMUONTrack* track = FindTrack(trackId);
240 return track ? track->GetNClusters() : 0;
243 //___________________________________________________________________________
244 Int_t AliMUONESDInterface::GetNDigits() const
246 /// return the number of digits
247 return fDigits ? fDigits->GetSize() : 0;
250 //___________________________________________________________________________
251 Int_t AliMUONESDInterface::GetNDigits(UInt_t trackId) const
253 /// return the number of digits in all clusters of track "trackId"
255 AliMUONVCluster *cluster;
256 TIter next(CreateClusterIterator(trackId));
257 while ((cluster = static_cast<AliMUONVCluster*>(next()))) nDigits += cluster->GetNDigits();
261 //___________________________________________________________________________
262 Int_t AliMUONESDInterface::GetNDigits(UInt_t trackId, UInt_t clusterId) const
264 /// return the number of digits in cluster numbered "iCluster" of track "iTrack"
265 AliMUONVCluster* cluster = FindCluster(trackId, clusterId);
266 return cluster ? cluster->GetNDigits() : 0;
269 //___________________________________________________________________________
270 Int_t AliMUONESDInterface::GetNDigitsInCluster(UInt_t clusterId) const
272 /// return the number of digits in cluster "clusterId"
273 AliMUONVCluster* cluster = FindCluster(clusterId);
274 return cluster ? cluster->GetNDigits() : 0;
277 //___________________________________________________________________________
278 Int_t AliMUONESDInterface::GetNTriggers() const
280 /// return the number of triggers
281 return fTriggers ? fTriggers->GetSize() : 0;
284 //___________________________________________________________________________
285 Bool_t AliMUONESDInterface::DigitsStored(UInt_t trackId) const
287 /// return kTRUE if digits have been stored for all clusters of track "trackId"
288 AliMUONVCluster *cluster;
289 TIter next(CreateClusterIterator(trackId));
290 while ((cluster = static_cast<AliMUONVCluster*>(next())))
291 if (cluster->GetNDigits() == 0) return kFALSE;
295 //___________________________________________________________________________
296 AliMUONTrack* AliMUONESDInterface::FindTrack(UInt_t trackId) const
298 /// return track "trackId" (0x0 if not found)
299 AliMUONTrack *track = fTracks ? static_cast<AliMUONTrack*>(fTracks->FindObject(trackId)) : 0x0;
300 if (!track) AliWarning(Form("track %d does not exist",trackId));
304 //___________________________________________________________________________
305 AliMUONVCluster* AliMUONESDInterface::FindCluster(UInt_t clusterId) const
307 /// loop over tracks and return the first cluster "clusterId" found (0x0 if not found)
309 AliMUONVCluster* cluster = 0x0;
313 TIter next(fClusterMap->CreateIterator());
314 while ((cMap = static_cast<AliMpExMap*>(next()))) {
316 cluster = static_cast<AliMUONVCluster*>(cMap->GetValue(clusterId));
317 if (cluster) return cluster;
323 if (!cluster) AliWarning(Form("cluster %d does not exist",clusterId));
327 //___________________________________________________________________________
328 AliMUONVCluster* AliMUONESDInterface::FindCluster(UInt_t trackId, UInt_t clusterId) const
330 /// return cluster "clusterId" in track "trackId" (0x0 if not found)
331 AliMpExMap *cMap = fClusterMap ? static_cast<AliMpExMap*>(fClusterMap->GetValue(trackId)) : 0x0;
332 AliMUONVCluster* cluster = cMap ? static_cast<AliMUONVCluster*>(cMap->GetValue(clusterId)) : 0x0;
333 if (!cluster) AliWarning(Form("cluster %d does not exist in track %d", clusterId, trackId));
337 //___________________________________________________________________________
338 AliMUONVDigit* AliMUONESDInterface::FindDigit(UInt_t digitId) const
340 /// return digit "digitId" (0x0 if not found)
341 AliMUONVDigit *digit = fDigits ? fDigits->FindObject(digitId) : 0x0;
342 if (!digit) AliWarning(Form("digit %d does not exist",digitId));
346 //___________________________________________________________________________
347 AliMUONLocalTrigger* AliMUONESDInterface::FindLocalTrigger(Int_t boardNumber) const
349 /// return MUON local trigger "boardNumber"
350 return (fTriggers) ? fTriggers->FindLocal(boardNumber) : 0x0;
353 //___________________________________________________________________________
354 TIterator* AliMUONESDInterface::CreateTrackIterator() const
356 /// return iterator over all tracks
357 return fTracks ? fTracks->CreateIterator() : 0x0;
360 //___________________________________________________________________________
361 TIterator* AliMUONESDInterface::CreateClusterIterator() const
363 /// return iterator over all clusters
364 return fClusterMap ? new AliMUON2DMapIterator(*fClusterMap) : 0x0;
367 //___________________________________________________________________________
368 TIterator* AliMUONESDInterface::CreateClusterIterator(UInt_t trackId) const
370 /// return iterator over clusters of track "trackId"
371 AliMpExMap *cMap = fClusterMap ? static_cast<AliMpExMap*>(fClusterMap->GetValue(trackId)) : 0x0;
372 return cMap ? cMap->CreateIterator() : 0x0;
375 //___________________________________________________________________________
376 TIterator* AliMUONESDInterface::CreateDigitIterator() const
378 /// return iterator over all digits
379 return fDigits ? fDigits->CreateIterator() : 0x0;
382 //___________________________________________________________________________
383 TIterator* AliMUONESDInterface::CreateDigitIterator(UInt_t trackId) const
385 /// return iterator over all digits of track "trackId"
386 AliMpExMap* dMaps = fDigitMap ? static_cast<AliMpExMap*>(fDigitMap->GetValue(trackId)) : 0x0;
387 return dMaps ? new AliMUON2DMapIterator(*dMaps) : 0x0;
390 //___________________________________________________________________________
391 TIterator* AliMUONESDInterface::CreateDigitIterator(UInt_t trackId, UInt_t clusterId) const
393 /// return iterator over digits of cluster "clusterId" in track "trackId"
394 AliMpExMap* dMaps = fDigitMap ? static_cast<AliMpExMap*>(fDigitMap->GetValue(trackId)) : 0x0;
395 AliMpExMap* dMap = dMaps ? static_cast<AliMpExMap*>(dMaps->GetValue(clusterId)) : 0x0;
396 return dMap ? dMap->CreateIterator() : 0x0;
399 //___________________________________________________________________________
400 TIterator* AliMUONESDInterface::CreateDigitIteratorInCluster(UInt_t clusterId) const
402 /// return iterator over digits of the first cluster "clusterId" found by looping over all tracks
404 AliMpExMap* dMap = 0x0;
408 TIter next(fDigitMap->CreateIterator());
409 while ((dMaps = static_cast<AliMpExMap*>(next()))) {
411 dMap = static_cast<AliMpExMap*>(dMaps->GetValue(clusterId));
412 if (dMap) return dMap->CreateIterator();
421 //___________________________________________________________________________
422 TIterator* AliMUONESDInterface::CreateLocalTriggerIterator() const
424 /// return iterator over all local trigger
425 return fTriggers ? fTriggers->CreateLocalIterator() : 0x0;
428 //+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++//
430 //+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++//
432 //_____________________________________________________________________________
433 void AliMUONESDInterface::ResetTracker(const AliMUONRecoParam* recoParam, Bool_t info)
435 /// Reset the MUON tracker using "recoParam" if provided.
436 /// If not provided, will use Kalman filter + Smoother
443 fgRecoParam = new AliMUONRecoParam(*recoParam);
445 if (info) cout<<"I-AliMUONESDInterface::ResetTracker: will refit tracks with provided RecoParam:"<<endl;
449 fgRecoParam = AliMUONRecoParam::GetLowFluxParam();
451 cout<<"W-AliMUONESDInterface::ResetTracker: RecoParam not provided. Will use default LowFlux parametrization:"<<endl;
455 // print useful parameters for refitting
457 cout<<" --> Tracking mode = "<<fgRecoParam->GetTrackingMode()<<endl;
458 if (fgRecoParam->UseSmoother()) cout<<" --> Use Smoother"<<endl;
459 else cout<<" --> Do not use smoother"<<endl;
460 cout<<" --> Vertex dispersion in bending direction = "
461 <<fgRecoParam->GetBendingVertexDispersion()<<" cm"<<endl;
464 if (!TGeoGlobalMagField::Instance()->GetField())
465 cout<<"W-AliMUONESDInterface::ResetTracker: Magnetic field has not been set --> assume field is OFF"<<endl;
467 fgTracker = AliMUONTracker::CreateTrackReconstructor(fgRecoParam,0x0);
471 //_____________________________________________________________________________
472 AliMUONVTrackStore* AliMUONESDInterface::NewTrackStore()
474 /// Create an empty track store of type fgTrackStoreName
475 TClass* classPtr = TClass::GetClass(fgTrackStoreName);
476 if (!classPtr || !classPtr->InheritsFrom("AliMUONVTrackStore")) {
477 cout<<"E-AliMUONESDInterface::NewTrackStore: Unable to create store of type "<<fgTrackStoreName.Data()<<endl;
480 return reinterpret_cast<AliMUONVTrackStore*>(gROOT->ProcessLineFast(Form("new %s()",fgTrackStoreName.Data())));
483 //_____________________________________________________________________________
484 AliMUONVClusterStore* AliMUONESDInterface::NewClusterStore()
486 /// Create an empty cluster store of type fgClusterStoreName
487 TClass* classPtr = TClass::GetClass(fgClusterStoreName);
488 if (!classPtr || !classPtr->InheritsFrom("AliMUONVClusterStore")) {
489 cout<<"E-AliMUONESDInterface::NewClusterStore: Unable to create store of type "<<fgClusterStoreName.Data()<<endl;
492 return reinterpret_cast<AliMUONVClusterStore*>(gROOT->ProcessLineFast(Form("new %s()",fgClusterStoreName.Data())));
495 //_____________________________________________________________________________
496 AliMUONVCluster* AliMUONESDInterface::NewCluster()
498 /// Create an empty cluster of type associated to the cluster store of type fgClusterStoreName
499 TClass* classPtr = TClass::GetClass(fgClusterStoreName);
500 if (!classPtr || !classPtr->InheritsFrom("AliMUONVClusterStore")) {
501 cout<<"E-AliMUONESDInterface::NewCluster: Unable to create store of type "<<fgClusterStoreName.Data()<<endl;
504 AliMUONVClusterStore* cStore = reinterpret_cast<AliMUONVClusterStore*>(classPtr->New());
505 AliMUONVCluster* cluster = cStore->CreateCluster(0,0,0);
510 //_____________________________________________________________________________
511 AliMUONVDigitStore* AliMUONESDInterface::NewDigitStore()
513 /// Create an empty digit store of type fgDigitStoreName
514 TClass* classPtr = TClass::GetClass(fgDigitStoreName);
515 if (!classPtr || !classPtr->InheritsFrom("AliMUONVDigitStore")) {
516 cout<<"E-AliMUONESDInterface::NewDigitStore: Unable to create store of type "<<fgDigitStoreName.Data()<<endl;
519 return reinterpret_cast<AliMUONVDigitStore*>(gROOT->ProcessLineFast(Form("new %s()",fgDigitStoreName.Data())));
522 //_____________________________________________________________________________
523 AliMUONVDigit* AliMUONESDInterface::NewDigit()
525 /// Create an empty digit of type associated to the digit store of type fgDigitStoreName
526 TClass* classPtr = TClass::GetClass(fgDigitStoreName);
527 if (!classPtr || !classPtr->InheritsFrom("AliMUONVDigitStore")) {
528 cout<<"E-AliMUONESDInterface::NewDigitStore: Unable to create store of type "<<fgDigitStoreName.Data()<<endl;
531 AliMUONVDigitStore* dStore = reinterpret_cast<AliMUONVDigitStore*>(classPtr->New());
532 AliMUONVDigit* digit = dStore->CreateDigit(0,0,0,0);
537 //_____________________________________________________________________________
538 AliMUONVTriggerStore* AliMUONESDInterface::NewTriggerStore()
540 /// Create an empty trigger store of type fgTriggerStoreName
541 TClass* classPtr = TClass::GetClass(fgTriggerStoreName);
542 if (!classPtr || !classPtr->InheritsFrom("AliMUONVTriggerStore")) {
543 cout<<"E-AliMUONESDInterface::NewTriggerStore: Unable to create store of type "<<fgTriggerStoreName.Data()<<endl;
546 return reinterpret_cast<AliMUONVTriggerStore*>(gROOT->ProcessLineFast(Form("new %s()",fgTriggerStoreName.Data())));
549 //_____________________________________________________________________________
550 AliMUONVTriggerTrackStore* AliMUONESDInterface::NewTriggerTrackStore()
552 /// Create an empty trigger track store of type fgTriggerTrackStoreName
553 TClass* classPtr = TClass::GetClass(fgTriggerTrackStoreName);
554 if (!classPtr || !classPtr->InheritsFrom("AliMUONVTriggerTrackStore")) {
555 cout<<"E-AliMUONESDInterface::NewTriggerTrackStore: Unable to create store of type "<<fgTriggerTrackStoreName.Data()<<endl;
558 return reinterpret_cast<AliMUONVTriggerTrackStore*>(gROOT->ProcessLineFast(Form("new %s()",fgTriggerTrackStoreName.Data())));
561 //_________________________________________________________________________
562 void AliMUONESDInterface::GetParamAtVertex(const AliESDMuonTrack& esdTrack, AliMUONTrackParam& trackParam)
564 /// Get parameters at vertex from ESDMuon track
565 trackParam.SetZ(esdTrack.GetZ());
566 trackParam.SetNonBendingCoor(esdTrack.GetNonBendingCoor());
567 trackParam.SetNonBendingSlope(TMath::Tan(esdTrack.GetThetaX()));
568 trackParam.SetBendingCoor(esdTrack.GetBendingCoor());
569 trackParam.SetBendingSlope(TMath::Tan(esdTrack.GetThetaY()));
570 trackParam.SetInverseBendingMomentum(esdTrack.GetInverseBendingMomentum());
573 //_________________________________________________________________________
574 void AliMUONESDInterface::GetParamAtDCA(const AliESDMuonTrack& esdTrack, AliMUONTrackParam& trackParam)
576 /// Get parameters at DCA from ESDMuon track
577 trackParam.SetZ(esdTrack.GetZ());
578 trackParam.SetNonBendingCoor(esdTrack.GetNonBendingCoorAtDCA());
579 trackParam.SetNonBendingSlope(TMath::Tan(esdTrack.GetThetaXAtDCA()));
580 trackParam.SetBendingCoor(esdTrack.GetBendingCoorAtDCA());
581 trackParam.SetBendingSlope(TMath::Tan(esdTrack.GetThetaYAtDCA()));
582 trackParam.SetInverseBendingMomentum(esdTrack.GetInverseBendingMomentumAtDCA());
585 //_________________________________________________________________________
586 void AliMUONESDInterface::GetParamAtFirstCluster(const AliESDMuonTrack& esdTrack, AliMUONTrackParam& trackParam)
588 /// Get parameters at first cluster from ESDMuon track
589 trackParam.SetZ(esdTrack.GetZUncorrected());
590 trackParam.SetNonBendingCoor(esdTrack.GetNonBendingCoorUncorrected());
591 trackParam.SetNonBendingSlope(TMath::Tan(esdTrack.GetThetaXUncorrected()));
592 trackParam.SetBendingCoor(esdTrack.GetBendingCoorUncorrected());
593 trackParam.SetBendingSlope(TMath::Tan(esdTrack.GetThetaYUncorrected()));
594 trackParam.SetInverseBendingMomentum(esdTrack.GetInverseBendingMomentumUncorrected());
597 //_________________________________________________________________________
598 void AliMUONESDInterface::GetParamCov(const AliESDMuonTrack& esdTrack, AliMUONTrackParam& trackParam)
600 /// Get parameters covariances from ESD track
602 // get ESD covariance matrix
603 TMatrixD covariances(5,5);
604 esdTrack.GetCovariances(covariances);
606 // compute Jacobian to change the coordinate system
607 // from (X,thetaX,Y,thetaY,c/pYZ) to (X,slopeX,Y,slopeY,c/pYZ)
608 Double_t cosThetaX = TMath::Cos(esdTrack.GetThetaXUncorrected());
609 Double_t cosThetaY = TMath::Cos(esdTrack.GetThetaYUncorrected());
613 jacob(1,1) = 1. / cosThetaX / cosThetaX;
615 jacob(3,3) = 1. / cosThetaY / cosThetaY;
618 // compute covariance matrix in ESD coordinate system
619 TMatrixD tmp(covariances,TMatrixD::kMultTranspose,jacob);
620 trackParam.SetCovariances(TMatrixD(jacob,TMatrixD::kMult,tmp));
624 //_________________________________________________________________________
625 void AliMUONESDInterface::SetParamAtVertex(const AliMUONTrackParam& trackParam, AliESDMuonTrack& esdTrack)
627 /// Set parameters in ESD track
628 esdTrack.SetZ(trackParam.GetZ());
629 esdTrack.SetNonBendingCoor(trackParam.GetNonBendingCoor());
630 esdTrack.SetThetaX(TMath::ATan(trackParam.GetNonBendingSlope()));
631 esdTrack.SetBendingCoor(trackParam.GetBendingCoor());
632 esdTrack.SetThetaY(TMath::ATan(trackParam.GetBendingSlope()));
633 esdTrack.SetInverseBendingMomentum(trackParam.GetInverseBendingMomentum());
636 //_________________________________________________________________________
637 void AliMUONESDInterface::SetParamAtDCA(const AliMUONTrackParam& trackParam, AliESDMuonTrack& esdTrack)
639 /// Set parameters in ESD track
640 esdTrack.SetNonBendingCoorAtDCA(trackParam.GetNonBendingCoor());
641 esdTrack.SetThetaXAtDCA(TMath::ATan(trackParam.GetNonBendingSlope()));
642 esdTrack.SetBendingCoorAtDCA(trackParam.GetBendingCoor());
643 esdTrack.SetThetaYAtDCA(TMath::ATan(trackParam.GetBendingSlope()));
644 esdTrack.SetInverseBendingMomentumAtDCA(trackParam.GetInverseBendingMomentum());
647 //_________________________________________________________________________
648 void AliMUONESDInterface::SetParamAtFirstCluster(const AliMUONTrackParam& trackParam, AliESDMuonTrack& esdTrack)
650 /// Set parameters in ESD track
651 esdTrack.SetZUncorrected(trackParam.GetZ());
652 esdTrack.SetNonBendingCoorUncorrected(trackParam.GetNonBendingCoor());
653 esdTrack.SetThetaXUncorrected(TMath::ATan(trackParam.GetNonBendingSlope()));
654 esdTrack.SetBendingCoorUncorrected(trackParam.GetBendingCoor());
655 esdTrack.SetThetaYUncorrected(TMath::ATan(trackParam.GetBendingSlope()));
656 esdTrack.SetInverseBendingMomentumUncorrected(trackParam.GetInverseBendingMomentum());
659 //_________________________________________________________________________
660 void AliMUONESDInterface::SetParamCov(const AliMUONTrackParam& trackParam, AliESDMuonTrack& esdTrack)
662 /// Set parameters covariances in ESD track
664 // set null matrix if covariances does not exist
665 if (!trackParam.CovariancesExist()) {
668 esdTrack.SetCovariances(tmp);
672 // compute Jacobian to change the coordinate system
673 // from (X,slopeX,Y,slopeY,c/pYZ) to (X,thetaX,Y,thetaY,c/pYZ)
674 Double_t cosThetaX = TMath::Cos(TMath::ATan(trackParam.GetNonBendingSlope()));
675 Double_t cosThetaY = TMath::Cos(TMath::ATan(trackParam.GetBendingSlope()));
679 jacob(1,1) = cosThetaX * cosThetaX;
681 jacob(3,3) = cosThetaY * cosThetaY;
684 // compute covariance matrix in ESD coordinate system
685 TMatrixD tmp(trackParam.GetCovariances(),TMatrixD::kMultTranspose,jacob);
686 esdTrack.SetCovariances(TMatrixD(jacob,TMatrixD::kMult,tmp));
690 //_____________________________________________________________________________
691 void AliMUONESDInterface::ESDToMUON(const AliESDMuonTrack& esdTrack, AliMUONTrack& track, Bool_t refit)
693 /// Transfert data from ESDMuon track to MUON track.
694 /// ESDMuon track must hold the pointer to the ESD event otherwise we cannot recover the clusters.
695 /// If refit = kTRUE, the track parameters at each cluster are obtained by refitting the track
696 /// or by extrapolating the parameters at the first one if the refit failed.
697 /// If refit = kFALSE, only the track parameters at first cluster are valid.
698 /// note: You can set the recoParam used to refit the MUON track with ResetTracker(...);
699 /// By default we use Kalman filter + Smoother
701 // if the ESDMuon track is a ghost then return an empty MUON track
702 if (!esdTrack.ContainTrackerData()) {
704 track.SetUniqueID(esdTrack.GetUniqueID());
711 track.SetUniqueID(esdTrack.GetUniqueID());
712 track.FitWithVertex(kFALSE);
713 track.FitWithMCS(kFALSE);
714 track.SetImproved(kFALSE);
715 track.SetVertexErrXY2(0.,0.);
716 track.SetGlobalChi2(esdTrack.GetChi2());
717 track.SetMatchTrigger(esdTrack.GetMatchTrigger());
718 track.SetChi2MatchTrigger(esdTrack.GetChi2MatchTrigger());
719 track.SetHitsPatternInTrigCh(esdTrack.GetHitsPatternInTrigCh());
720 track.SetLocalTrigger(esdTrack.LoCircuit(), esdTrack.LoStripX(), esdTrack.LoStripY(),
721 esdTrack.LoDev(), esdTrack.LoLpt(), esdTrack.LoHpt(),
722 esdTrack.GetTriggerWithoutChamber());
723 track.Connected(esdTrack.IsConnected());
725 // track parameters at vertex
726 AliMUONTrackParam paramAtVertex;
727 GetParamAtVertex(esdTrack, paramAtVertex);
728 track.SetTrackParamAtVertex(¶mAtVertex);
730 // track parameters at first cluster
731 AliMUONTrackParam param;
732 GetParamAtFirstCluster(esdTrack, param);
733 GetParamCov(esdTrack, param);
735 // create empty cluster
736 AliMUONVCluster* cluster = NewCluster();
738 // fill TrackParamAtCluster with track parameters at each cluster if available
739 Bool_t clusterFound = kFALSE;
740 if(esdTrack.GetESDEvent()) {
742 // loop over cluster Id
743 for (Int_t i = 0; i < esdTrack.GetNClusters(); i++) {
745 // recover the ESDMuon cluster
746 AliESDMuonCluster *esdCluster = esdTrack.GetESDEvent()->FindMuonCluster(esdTrack.GetClusterId(i));
747 if (esdCluster) clusterFound = kTRUE;
749 cout<<"E-AliMUONESDInterface::ESDToMUON: a cluster is missing in ESD"<<endl;
753 // copy cluster information
754 ESDToMUON(*esdCluster, *cluster);
756 // only set the Z parameter to avoid error in the AddTrackParamAtCluster(...) method
757 param.SetZ(cluster->GetZ());
759 // add common track parameters at current cluster
760 track.AddTrackParamAtCluster(param, *cluster, kTRUE);
764 // refit the track to get better parameters and covariances at each cluster (temporary disable track improvement)
765 if (clusterFound && refit) {
767 AliMUONTrackParam *firstTrackParam = (AliMUONTrackParam*) track.GetTrackParamAtCluster()->First();
768 AliMUONTrackParam paramSave(*firstTrackParam);
770 if (!fgTracker) ResetTracker();
772 if (!fgTracker->RefitTrack(track, kFALSE) && track.GetGlobalChi2() < AliMUONTrack::MaxChi2()) {
773 *firstTrackParam = paramSave;
774 track.UpdateCovTrackParamAtCluster();
781 // fill TrackParamAtCluster with only track parameters at first (fake) cluster if no cluster found in ESD
784 // get number of the first hit chamber according to the MUONClusterMap
786 while (firstCh < 10 && !esdTrack.IsInMuonClusterMap(firstCh)) firstCh++;
788 // produce fake cluster at this chamber
789 cluster->SetUniqueID(AliMUONVCluster::BuildUniqueID(firstCh, 0, 0));
790 cluster->SetXYZ(param.GetNonBendingCoor(), param.GetBendingCoor(), param.GetZ());
791 cluster->SetErrXY(0., 0.);
793 // add track parameters at first (fake) cluster
794 track.AddTrackParamAtCluster(param, *cluster, kTRUE);
798 // set the MC label from ESD track
799 track.SetMCLabel(esdTrack.GetLabel());
805 //_____________________________________________________________________________
806 void AliMUONESDInterface::ESDToMUON(const AliESDMuonTrack& esdTrack, AliMUONLocalTrigger& locTrg)
808 /// Transfert trigger data from ESDMuon track to the MUONLocalTtrigger object
810 // if the ESDMuon track is a ghost then return an empty MUON track
811 if (!esdTrack.ContainTriggerData()) {
812 AliMUONLocalTrigger emptyLocTrg;
813 locTrg = emptyLocTrg;
817 locTrg.SetUniqueID(esdTrack.GetUniqueID());
818 locTrg.SetLoCircuit(esdTrack.LoCircuit());
819 locTrg.SetLoStripX(esdTrack.LoStripX());
820 locTrg.SetLoStripY(esdTrack.LoStripY());
821 locTrg.SetDeviation(esdTrack.LoDev());
822 locTrg.SetLoLpt(esdTrack.LoLpt());
823 locTrg.SetLoHpt(esdTrack.LoHpt());
824 locTrg.SetTriggerWithoutChamber(esdTrack.GetTriggerWithoutChamber());
825 locTrg.SetLoTrigY(1);
826 locTrg.SetX1Pattern(esdTrack.GetTriggerX1Pattern());
827 locTrg.SetX2Pattern(esdTrack.GetTriggerX2Pattern());
828 locTrg.SetX3Pattern(esdTrack.GetTriggerX3Pattern());
829 locTrg.SetX4Pattern(esdTrack.GetTriggerX4Pattern());
830 locTrg.SetY1Pattern(esdTrack.GetTriggerY1Pattern());
831 locTrg.SetY2Pattern(esdTrack.GetTriggerY2Pattern());
832 locTrg.SetY3Pattern(esdTrack.GetTriggerY3Pattern());
833 locTrg.SetY4Pattern(esdTrack.GetTriggerY4Pattern());
837 //_____________________________________________________________________________
838 void AliMUONESDInterface::ESDToMUON(const AliESDMuonCluster& esdCluster, AliMUONVCluster& cluster)
840 /// Transfert data from ESDMuon cluster to MUON cluster
844 cluster.SetUniqueID(esdCluster.GetUniqueID());
845 cluster.SetXYZ(esdCluster.GetX(), esdCluster.GetY(), esdCluster.GetZ());
846 cluster.SetErrXY(esdCluster.GetErrX(),esdCluster.GetErrY());
847 cluster.SetCharge(esdCluster.GetCharge());
848 cluster.SetChi2(esdCluster.GetChi2());
849 cluster.SetMCLabel(esdCluster.GetLabel());
851 cluster.SetDigitsId(esdCluster.GetNPads(), esdCluster.GetPadsId());
855 //___________________________________________________________________________
856 void AliMUONESDInterface::ESDToMUON(const AliESDMuonPad& esdPad, AliMUONVDigit& digit)
858 /// Transfert data from ESDMuon pad to MUON digit
860 if (!AliMpSegmentation::Instance(kFALSE)) {
861 cout<<"E-AliMUONESDInterface::ESDToMUON: need mapping segmentation to convert ESD pad to MUON digit"<<endl;
865 const AliMpVSegmentation* seg = AliMpSegmentation::Instance()->GetMpSegmentationByElectronics(esdPad.GetDetElemId(), esdPad.GetManuId());
866 AliMpPad pad = seg->PadByLocation(esdPad.GetManuId(), esdPad.GetManuChannel(), kFALSE);
868 digit.Saturated(esdPad.IsSaturated());
870 digit.Calibrated(esdPad.IsCalibrated());
871 digit.SetUniqueID(esdPad.GetUniqueID());
872 digit.SetCharge(esdPad.GetCharge());
873 digit.SetADC(esdPad.GetADC());
874 digit.SetPadXY(pad.GetIx(), pad.GetIy());
878 //_____________________________________________________________________________
879 void AliMUONESDInterface::MUONToESD(const AliMUONTrack& track, AliESDEvent& esd, const Double_t vertex[3],
880 const AliMUONVDigitStore* digits, const AliMUONLocalTrigger* locTrg)
882 /// Transfert data from MUON track to ESD event (ESDTrack + ESDClusters)
883 /// Incorporate the ESDPads if the digits are provided
884 /// Add trigger info if the MUON track is matched with a trigger track
886 // transfert track info
887 AliESDMuonTrack *esdTrack = esd.NewMuonTrack();
888 MUONToESD(track, *esdTrack, vertex, locTrg);
890 // transfert cluster info if any
891 for (Int_t i = 0; i < track.GetNClusters(); i++) {
892 AliMUONTrackParam *param = static_cast<AliMUONTrackParam*>(track.GetTrackParamAtCluster()->UncheckedAt(i));
893 MUONToESD(*(param->GetClusterPtr()), esd, digits);
898 //_____________________________________________________________________________
899 void AliMUONESDInterface::MUONToESD(const AliMUONTrack& track, AliESDMuonTrack& esdTrack,
900 const Double_t vertex[3], const AliMUONLocalTrigger* locTrg)
902 /// Transfert data from MUON track to ESDMuon track (ESDMuon track only contains clusters'Id, not cluster themselves)
903 /// Add trigger info if the MUON track is matched with a trigger track
905 // empty MUON track -> produce a ghost ESDMuon track if trigger info are available otherwise produce an empty track
906 if (track.GetNClusters() == 0) {
907 if (locTrg) MUONToESD(*locTrg, esdTrack, track.GetUniqueID());
909 cout<<"W-AliMUONESDInterface::MUONToESD: will produce an empty ESDMuon track"<<endl;
911 esdTrack.SetUniqueID(0xFFFFFFFF);
919 esdTrack.SetUniqueID(track.GetUniqueID());
920 esdTrack.SetChi2(track.GetGlobalChi2());
921 esdTrack.SetLabel(track.GetMCLabel());
923 // set param at first cluster
924 AliMUONTrackParam* trackParam = static_cast<AliMUONTrackParam*>((track.GetTrackParamAtCluster())->First());
925 SetParamAtFirstCluster(*trackParam, esdTrack);
926 SetParamCov(*trackParam, esdTrack);
928 // set transverse position at the end of the absorber
929 AliMUONTrackParam trackParamAtAbsEnd(*trackParam);
930 AliMUONTrackExtrap::ExtrapToZ(&trackParamAtAbsEnd, AliMUONConstants::AbsZEnd());
931 Double_t xAbs = trackParamAtAbsEnd.GetNonBendingCoor();
932 Double_t yAbs = trackParamAtAbsEnd.GetBendingCoor();
933 esdTrack.SetRAtAbsorberEnd(TMath::Sqrt(xAbs*xAbs + yAbs*yAbs));
935 // set param at vertex
936 AliMUONTrackParam trackParamAtVtx(*trackParam);
937 AliMUONTrackExtrap::ExtrapToVertex(&trackParamAtVtx, vertex[0], vertex[1], vertex[2], 0., 0.);
938 SetParamAtVertex(trackParamAtVtx, esdTrack);
940 // set param at Distance of Closest Approach
941 AliMUONTrackParam trackParamAtDCA(*trackParam);
942 AliMUONTrackExtrap::ExtrapToVertexWithoutBranson(&trackParamAtDCA, vertex[2]);
943 SetParamAtDCA(trackParamAtDCA, esdTrack);
945 // set muon cluster info
946 esdTrack.SetMuonClusterMap(0);
948 AliMUONVCluster *cluster = trackParam->GetClusterPtr();
949 esdTrack.AddClusterId(cluster->GetUniqueID());
950 esdTrack.AddInMuonClusterMap(cluster->GetChamberId());
951 trackParam = static_cast<AliMUONTrackParam*>(track.GetTrackParamAtCluster()->After(trackParam));
954 // set connected flag
955 esdTrack.Connected(track.IsConnected());
958 esdTrack.SetLocalTrigger(track.GetLocalTrigger());
959 esdTrack.SetChi2MatchTrigger(track.GetChi2MatchTrigger());
960 esdTrack.SetHitsPatternInTrigCh(track.GetHitsPatternInTrigCh());
962 esdTrack.SetTriggerX1Pattern(locTrg->GetX1Pattern());
963 esdTrack.SetTriggerY1Pattern(locTrg->GetY1Pattern());
964 esdTrack.SetTriggerX2Pattern(locTrg->GetX2Pattern());
965 esdTrack.SetTriggerY2Pattern(locTrg->GetY2Pattern());
966 esdTrack.SetTriggerX3Pattern(locTrg->GetX3Pattern());
967 esdTrack.SetTriggerY3Pattern(locTrg->GetY3Pattern());
968 esdTrack.SetTriggerX4Pattern(locTrg->GetX4Pattern());
969 esdTrack.SetTriggerY4Pattern(locTrg->GetY4Pattern());
971 esdTrack.SetTriggerX1Pattern(0);
972 esdTrack.SetTriggerY1Pattern(0);
973 esdTrack.SetTriggerX2Pattern(0);
974 esdTrack.SetTriggerY2Pattern(0);
975 esdTrack.SetTriggerX3Pattern(0);
976 esdTrack.SetTriggerY3Pattern(0);
977 esdTrack.SetTriggerX4Pattern(0);
978 esdTrack.SetTriggerY4Pattern(0);
983 //_____________________________________________________________________________
984 void AliMUONESDInterface::MUONToESD(const AliMUONLocalTrigger& locTrg, AliESDEvent& esd,
985 UInt_t trackId, const AliMUONTriggerTrack* triggerTrack)
987 /// Add in ESD event a ghost ESDMuon track containing only informations about trigger track
988 AliESDMuonTrack *esdTrack = esd.NewMuonTrack();
989 MUONToESD(locTrg, *esdTrack, trackId, triggerTrack);
992 //_____________________________________________________________________________
993 void AliMUONESDInterface::MUONToESD(const AliMUONLocalTrigger& locTrg, AliESDMuonTrack& esdTrack,
994 UInt_t trackId, const AliMUONTriggerTrack* triggerTrack)
996 /// Build ghost ESDMuon track containing only informations about trigger track
999 esdTrack.SetUniqueID(trackId);
1002 AliMUONTrack muonTrack;
1003 muonTrack.SetLocalTrigger(locTrg.LoCircuit(),
1006 locTrg.GetDeviation(),
1009 locTrg.GetTriggerWithoutChamber());
1010 esdTrack.SetLocalTrigger(muonTrack.GetLocalTrigger());
1011 esdTrack.SetChi2MatchTrigger(0.);
1012 esdTrack.SetTriggerX1Pattern(locTrg.GetX1Pattern());
1013 esdTrack.SetTriggerY1Pattern(locTrg.GetY1Pattern());
1014 esdTrack.SetTriggerX2Pattern(locTrg.GetX2Pattern());
1015 esdTrack.SetTriggerY2Pattern(locTrg.GetY2Pattern());
1016 esdTrack.SetTriggerX3Pattern(locTrg.GetX3Pattern());
1017 esdTrack.SetTriggerY3Pattern(locTrg.GetY3Pattern());
1018 esdTrack.SetTriggerX4Pattern(locTrg.GetX4Pattern());
1019 esdTrack.SetTriggerY4Pattern(locTrg.GetY4Pattern());
1020 UShort_t hitPattern = 0;
1022 hitPattern = triggerTrack->GetHitsPatternInTrigCh();
1023 esdTrack.SetHitsPatternInTrigCh(hitPattern);
1024 esdTrack.SetThetaXUncorrected(triggerTrack->GetThetax());
1025 esdTrack.SetThetaYUncorrected(triggerTrack->GetThetay());
1026 esdTrack.SetNonBendingCoorUncorrected(triggerTrack->GetX11());
1027 esdTrack.SetBendingCoorUncorrected(triggerTrack->GetY11());
1028 esdTrack.SetZUncorrected(triggerTrack->GetZ11());
1032 //_____________________________________________________________________________
1033 void AliMUONESDInterface::MUONToESD(const AliMUONVCluster& cluster, AliESDEvent& esd, const AliMUONVDigitStore* digits)
1035 /// Transfert data from MUON cluster to ESD event if it does not already exist
1036 /// Also transfert digits'Id to cluster and digits to ESD if they are provided
1038 AliESDMuonCluster *esdCluster = esd.FindMuonCluster(cluster.GetUniqueID());
1039 if (!esdCluster) esdCluster = esd.NewMuonCluster();
1040 else if (!digits || esdCluster->GetNPads() > 0) return;
1044 MUONToESD(cluster, *esdCluster, kTRUE);
1046 for (Int_t i=0; i<cluster.GetNDigits(); i++) {
1047 AliMUONVDigit* digit = digits->FindObject(cluster.GetDigitId(i));
1049 cout<<"E-AliMUONESDInterface::MUONToESD: digit "<<cluster.GetDigitId(i)<<" not found"<<endl;
1052 MUONToESD(*digit, esd);
1057 MUONToESD(cluster, *esdCluster, kFALSE);
1063 //_____________________________________________________________________________
1064 void AliMUONESDInterface::MUONToESD(const AliMUONVCluster& cluster, AliESDMuonCluster& esdCluster, Bool_t copyPadsId)
1066 /// Transfert data from MUON cluster to ESDMuon cluster
1067 /// Also transfert digits'Is if required
1069 esdCluster.Clear("C");
1071 esdCluster.SetUniqueID(cluster.GetUniqueID());
1072 esdCluster.SetXYZ(cluster.GetX(), cluster.GetY(), cluster.GetZ());
1073 esdCluster.SetErrXY(cluster.GetErrX(), cluster.GetErrY());
1074 esdCluster.SetCharge(cluster.GetCharge());
1075 esdCluster.SetChi2(cluster.GetChi2());
1076 esdCluster.SetLabel(cluster.GetMCLabel());
1078 if (copyPadsId) esdCluster.SetPadsId(cluster.GetNDigits(), cluster.GetDigitsId());
1082 //_____________________________________________________________________________
1083 void AliMUONESDInterface::MUONToESD(const AliMUONVDigit& digit, AliESDEvent& esd)
1085 /// Transfert data from MUON digit to ESD event if it does not already exist
1086 if (esd.FindMuonPad(digit.GetUniqueID())) return;
1087 AliESDMuonPad *esdPad = esd.NewMuonPad();
1088 MUONToESD(digit, *esdPad);
1091 //_____________________________________________________________________________
1092 void AliMUONESDInterface::MUONToESD(const AliMUONVDigit& digit, AliESDMuonPad& esdPad)
1094 /// Transfert data from MUON digit to ESDMuon pad
1095 esdPad.SetUniqueID(digit.GetUniqueID());
1096 esdPad.SetADC(digit.ADC());
1097 esdPad.SetCharge(digit.Charge());
1098 esdPad.SetCalibrated(digit.IsCalibrated());
1099 esdPad.SetSaturated(digit.IsSaturated());
1102 //___________________________________________________________________________
1103 AliMUONTrack* AliMUONESDInterface::Add(const AliESDMuonTrack& esdTrack, AliMUONVTrackStore& trackStore, Bool_t refit)
1105 /// Create MUON track from ESDMuon track and add it to the store
1106 /// Track parameters at each clusters are recomputed or not depending on the flag "refit"
1107 /// return a pointer to the track into the store (0x0 if the track already exist)
1108 if(trackStore.FindObject(esdTrack.GetUniqueID())) return 0x0;
1109 AliMUONTrack* track = trackStore.Add(AliMUONTrack());
1110 ESDToMUON(esdTrack, *track, refit);
1114 //___________________________________________________________________________
1115 void AliMUONESDInterface::Add(const AliESDMuonTrack& esdTrack, AliMUONVTriggerStore& triggerStore)
1117 /// Create MUON local trigger from ESDMuon track and add it to the store if not already there
1118 if (!triggerStore.FindLocal(esdTrack.LoCircuit())->IsNull()) return;
1119 AliMUONLocalTrigger locTrg;
1120 ESDToMUON(esdTrack, locTrg);
1121 triggerStore.Add(locTrg);
1124 //___________________________________________________________________________
1125 AliMUONVCluster* AliMUONESDInterface::Add(const AliESDMuonCluster& esdCluster, AliMUONVClusterStore& clusterStore)
1127 /// Create MUON cluster from ESDMuon cluster and add it to the store
1128 /// return a pointer to the cluster into the store (0x0 if the cluster already exist)
1129 AliMUONVCluster* cluster = clusterStore.Add(esdCluster.GetChamberId(), esdCluster.GetDetElemId(), esdCluster.GetClusterIndex());
1130 if (cluster) ESDToMUON(esdCluster, *cluster);
1134 //___________________________________________________________________________
1135 AliMUONVDigit* AliMUONESDInterface::Add(const AliESDMuonPad& esdPad, AliMUONVDigitStore& digitStore)
1137 /// Create MUON digit from ESDMuon digit and add it to the store
1138 /// return a pointer to the digit into the store (0x0 if the digit already exist)
1139 AliMUONVDigit* digit = digitStore.Add(esdPad.GetDetElemId(), esdPad.GetManuId(), esdPad.GetManuChannel(), esdPad.GetCathode(), AliMUONVDigitStore::kDeny);
1140 if (digit) ESDToMUON(esdPad, *digit);