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 ///////////////////////////////////////////////////////////////////////////////
20 // Particles stack class //
21 // Implements the TMCVirtualStack of the Virtual Monte Carlo //
22 // Holds the particles transported during simulation //
23 // Is used to compare results of reconstruction with simulation //
26 ///////////////////////////////////////////////////////////////////////////////
29 #include <TObjArray.h>
30 #include <TParticle.h>
31 #include <TParticlePDG.h>
36 #include "AliModule.h"
39 #include "AliRunLoader.h"
44 //_______________________________________________________________________
58 fEventFolderName(AliConfig::GetDefaultEventFolderName())
61 // Default constructor
65 //_______________________________________________________________________
66 AliStack::AliStack(Int_t size, const char* evfoldname):
67 fParticles(new TClonesArray("TParticle",1000)),
68 fParticleMap(new TObjArray(size)),
79 fEventFolderName(evfoldname)
86 //_______________________________________________________________________
87 AliStack::AliStack(const AliStack& st):
109 //_______________________________________________________________________
110 void AliStack::Copy(TObject&) const
112 AliFatal("Not implemented!");
115 //_______________________________________________________________________
116 AliStack::~AliStack()
123 fParticles->Delete();
127 //PH??? delete fTreeK;
134 //_____________________________________________________________________________
135 void AliStack::PushTrack(Int_t done, Int_t parent, Int_t pdg, Float_t *pmom,
136 Float_t *vpos, Float_t *polar, Float_t tof,
137 TMCProcess mech, Int_t &ntr, Float_t weight, Int_t is)
140 // Load a track on the stack
142 // done 0 if the track has to be transported
144 // parent identifier of the parent track. -1 for a primary
146 // pmom momentum GeV/c
148 // polar polarisation
149 // tof time of flight in seconds
150 // mecha production mechanism
151 // ntr on output the number of the track stored
154 // const Float_t tlife=0;
157 // Here we get the static mass
158 // For MC is ok, but a more sophisticated method could be necessary
159 // if the calculated mass is required
160 // also, this method is potentially dangerous if the mass
161 // used in the MC is not the same of the PDG database
163 TParticlePDG* pmc = TDatabasePDG::Instance()->GetParticle(pdg);
165 Float_t mass = TDatabasePDG::Instance()->GetParticle(pdg)->Mass();
166 Float_t e=TMath::Sqrt(mass*mass+pmom[0]*pmom[0]+
167 pmom[1]*pmom[1]+pmom[2]*pmom[2]);
169 // printf("Loading mass %f ene %f No %d ip %d parent %d done %d pos %f %f %f mom %f %f %f kS %d m \n",
170 // mass,e,fNtrack,pdg,parent,done,vpos[0],vpos[1],vpos[2],pmom[0],pmom[1],pmom[2],kS);
173 PushTrack(done, parent, pdg, pmom[0], pmom[1], pmom[2], e,
174 vpos[0], vpos[1], vpos[2], tof, polar[0], polar[1], polar[2],
175 mech, ntr, weight, is);
177 AliWarning(Form("Particle type %d not defined in PDG Database !", pdg));
178 AliWarning("Particle skipped !");
182 //_____________________________________________________________________________
183 void AliStack::PushTrack(Int_t done, Int_t parent, Int_t pdg,
184 Double_t px, Double_t py, Double_t pz, Double_t e,
185 Double_t vx, Double_t vy, Double_t vz, Double_t tof,
186 Double_t polx, Double_t poly, Double_t polz,
187 TMCProcess mech, Int_t &ntr, Double_t weight, Int_t is)
190 // Load a track on the stack
192 // done 0 if the track has to be transported
194 // parent identifier of the parent track. -1 for a primary
196 // kS generation status code
197 // px, py, pz momentum GeV/c
198 // vx, vy, vz position
199 // polar polarisation
200 // tof time of flight in seconds
201 // mech production mechanism
202 // ntr on output the number of the track stored
204 // New method interface:
205 // arguments were changed to be in correspondence with TParticle
207 // Note: the energy is not calculated from the static mass but
208 // it is passed by argument e.
211 const Int_t kFirstDaughter=-1;
212 const Int_t kLastDaughter=-1;
215 TClonesArray &particles = *fParticles;
217 = new(particles[fLoadPoint++])
218 TParticle(pdg, is, parent, -1, kFirstDaughter, kLastDaughter,
219 px, py, pz, e, vx, vy, vz, tof);
221 particle->SetPolarisation(polx, poly, polz);
222 particle->SetWeight(weight);
223 particle->SetUniqueID(mech);
225 if(!done) particle->SetBit(kDoneBit);
227 // Declare that the daughter information is valid
228 particle->SetBit(kDaughtersBit);
229 // Add the particle to the stack
232 fParticleMap->AddAtAndExpand(particle, fNtrack);//CHECK!!
235 particle = dynamic_cast<TParticle*>(fParticleMap->At(parent));
237 particle->SetLastDaughter(fNtrack);
238 if(particle->GetFirstDaughter()<0) particle->SetFirstDaughter(fNtrack);
241 AliError(Form("Parent %d does not exist",parent));
246 // This is a primary track. Set high water mark for this event
249 // Set also number if primary tracks
250 fNprimary = fHgwmk+1;
256 //_____________________________________________________________________________
257 TParticle* AliStack::PopNextTrack(Int_t& itrack)
260 // Returns next track from stack of particles
264 TParticle* track = GetNextParticle();
268 track->SetBit(kDoneBit);
273 fCurrentTrack = track;
277 //_____________________________________________________________________________
278 TParticle* AliStack::PopPrimaryForTracking(Int_t i)
281 // Returns i-th primary particle if it is flagged to be tracked,
285 TParticle* particle = Particle(i);
287 if (!particle->TestBit(kDoneBit))
293 //_____________________________________________________________________________
294 void AliStack::PurifyKine()
297 // Compress kinematic tree keeping only flagged particles
298 // and renaming the particle id's in all the hits
301 TObjArray &particles = *fParticleMap;
302 int nkeep=fHgwmk+1, parent, i;
303 TParticle *part, *father;
304 TArrayI map(particles.GetLast()+1);
306 // Save in Header total number of tracks before compression
307 // If no tracks generated return now
308 if(fHgwmk+1 == fNtrack) return;
310 // First pass, invalid Daughter information
312 for(i=0; i<fNtrack; i++) {
313 // Preset map, to be removed later
314 if(i<=fHgwmk) map[i]=i ;
317 if((part=dynamic_cast<TParticle*>(particles.At(i)))) {
319 // Check of this track should be kept for physics reasons
320 if (KeepPhysics(part)) KeepTrack(i);
322 part->ResetBit(kDaughtersBit);
323 part->SetFirstDaughter(-1);
324 part->SetLastDaughter(-1);
328 // Invalid daughter information for the parent of the first particle
329 // generated. This may or may not be the current primary according to
330 // whether decays have been recorded among the primaries
331 part = dynamic_cast<TParticle*>(particles.At(fHgwmk+1));
332 particles.At(part->GetFirstMother())->ResetBit(kDaughtersBit);
333 // Second pass, build map between old and new numbering
334 for(i=fHgwmk+1; i<fNtrack; i++) {
335 if(particles.At(i)->TestBit(kKeepBit)) {
337 // This particle has to be kept
339 // If old and new are different, have to move the pointer
340 if(i!=nkeep) particles[nkeep]=particles.At(i);
341 part = dynamic_cast<TParticle*>(particles.At(nkeep));
343 // as the parent is always *before*, it must be already
344 // in place. This is what we are checking anyway!
345 if((parent=part->GetFirstMother())>fHgwmk)
346 if(map[parent]==-99) Fatal("PurifyKine","map[%d] = -99!\n",parent);
347 else part->SetFirstMother(map[parent]);
353 // Fix daughters information
354 for (i=fHgwmk+1; i<nkeep; i++) {
355 part = dynamic_cast<TParticle*>(particles.At(i));
356 parent = part->GetFirstMother();
358 father = dynamic_cast<TParticle*>(particles.At(parent));
359 if(father->TestBit(kDaughtersBit)) {
361 if(i<father->GetFirstDaughter()) father->SetFirstDaughter(i);
362 if(i>father->GetLastDaughter()) father->SetLastDaughter(i);
364 // Initialise daughters info for first pass
365 father->SetFirstDaughter(i);
366 father->SetLastDaughter(i);
367 father->SetBit(kDaughtersBit);
372 // Now loop on all registered hit lists
373 TList* hitLists = gAlice->GetMCApp()->GetHitLists();
374 TIter next(hitLists);
375 TCollection *hitList;
377 while((hitList = dynamic_cast<TCollection*>(next()))) {
378 TIter nexthit(hitList);
380 while((hit = dynamic_cast<AliHit*>(nexthit()))) {
381 hit->SetTrack(map[hit->GetTrack()]);
386 // This for detectors which have a special mapping mechanism
387 // for hits, such as TPC and TRD
390 TObjArray* modules = gAlice->Modules();
391 TIter nextmod(modules);
393 while((detector = dynamic_cast<AliModule*>(nextmod()))) {
394 detector->RemapTrackHitIDs(map.GetArray());
395 detector->RemapTrackReferencesIDs(map.GetArray());
398 gAlice->GetMCApp()->RemapTrackReferencesIDs(map.GetArray());
400 // Now the output bit, from fHgwmk to nkeep we write everything and we erase
401 if(nkeep>fParticleFileMap.GetSize()) fParticleFileMap.Set(Int_t (nkeep*1.5));
403 for (i=fHgwmk+1; i<nkeep; ++i) {
404 fParticleBuffer = dynamic_cast<TParticle*>(particles.At(i));
405 fParticleFileMap[i]=static_cast<Int_t>(TreeK()->GetEntries());
407 particles[i]=fParticleBuffer=0;
410 for (i=nkeep; i<fNtrack; ++i) particles[i]=0;
412 Int_t toshrink = fNtrack-fHgwmk-1;
413 fLoadPoint-=toshrink;
416 for(i=fLoadPoint; i<fLoadPoint+toshrink; ++i) fParticles->RemoveAt(i);
422 void AliStack::ReorderKine()
425 // In some transport code children might not come in a continuous sequence.
426 // In this case the stack has to be reordered in order to establish the
427 // mother daughter relation using index ranges.
429 if(fHgwmk+1 == fNtrack) return;
432 // Howmany secondaries have been produced ?
433 Int_t nNew = fNtrack - fHgwmk - 1;
437 TObjArray &particles = *fParticleMap;
440 // Copy pointers to temporary array
441 TParticle** tmp = new TParticle*[nNew];
443 for (i = 0; i < nNew; i++) {
444 if (particles.At(fHgwmk + 1 + i)) {
445 // tmp[i] = (TParticle*) (particles.At(fHgwmk + 1 + i))->Clone();
446 tmp[i] = (TParticle*) (particles.At(fHgwmk + 1 + i));
448 // if (((TParticle*) (particles.At(fHgwmk + 1 + i)))->TestBit(kKeepBit))
449 // tmp[i]->SetBit(kKeepBit);
450 // if (((TParticle*) (particles.At(fHgwmk + 1 + i)))->TestBit(kDoneBit))
451 // tmp[i]->SetBit(kDoneBit);
462 fLoadPoint = fHgwmk + 1;
464 // Re-Push particles into stack
465 // The outer loop is over parents, the inner over children.
466 // -1 refers to the primary particle
468 for (i = -1; i < nNew - 1; i++) {
472 ipa = tmp[0]->GetFirstMother();
473 parP =dynamic_cast<TParticle*>(particles.At(ipa));
475 ipa = (fHgwmk + 1 + i);
476 // Skip deleted particles
477 if (!tmp[i]) continue;
478 // Skip particles without children
479 if (tmp[i]->GetFirstDaughter() == -1) continue;
482 // Reset daughter information
483 parP->SetFirstDaughter(-1);
484 parP->SetLastDaughter(-1);
485 for (j = i + 1; j < nNew; j++) {
486 // Skip deleted particles
487 if (!tmp[j]) continue;
488 // Skip particles already handled
489 if (map1[j] != -99) continue;
490 Int_t jpa = tmp[j]->GetFirstMother();
491 // Check if daughter of current parent
493 particles[fLoadPoint] = tmp[j];
494 // Re-establish daughter information
495 parP->SetLastDaughter(fLoadPoint);
496 if (parP->GetFirstDaughter() == -1) parP->SetFirstDaughter(fLoadPoint);
497 // Set Mother information
499 tmp[j]->SetFirstMother(map1[i]);
502 map1[j] = fLoadPoint;
503 // Increase load point
512 // Build map for remapping of hits
514 TArrayI map(fNtrack);
515 for (i = 0; i < fNtrack; i ++) {
519 map[i] = map1[i - fHgwmk -1];
523 // Now loop on all registered hit lists
525 TList* hitLists = gAlice->GetMCApp()->GetHitLists();
526 TIter next(hitLists);
527 TCollection *hitList;
529 while((hitList = dynamic_cast<TCollection*>(next()))) {
530 TIter nexthit(hitList);
532 while((hit = dynamic_cast<AliHit*>(nexthit()))) {
533 hit->SetTrack(map[hit->GetTrack()]);
538 // This for detectors which have a special mapping mechanism
539 // for hits, such as TPC and TRD
542 TObjArray* modules = gAlice->Modules();
543 TIter nextmod(modules);
545 while((detector = dynamic_cast<AliModule*>(nextmod()))) {
546 detector->RemapTrackHitIDs(map.GetArray());
547 detector->RemapTrackReferencesIDs(map.GetArray());
549 gAlice->GetMCApp()->RemapTrackReferencesIDs(map.GetArray());
550 } // new particles poduced
553 Bool_t AliStack::KeepPhysics(TParticle* part)
556 // Some particles have to kept on the stack for reasons motivated
557 // by physics analysis. Decision is put here.
559 Bool_t keep = kFALSE;
561 // Keep first-generation daughter from primaries with heavy flavor
563 Int_t parent = part->GetFirstMother();
564 if (parent >= 0 && parent <= fHgwmk) {
565 TParticle* father = dynamic_cast<TParticle*>(Particles()->At(parent));
566 Int_t kf = father->GetPdgCode();
570 if (kfl > 10) kfl/=100;
572 if (kfl > 10) kfl/=10;
573 if (kfl > 10) kfl/=10;
581 //_____________________________________________________________________________
582 void AliStack::FinishEvent()
585 // Write out the kinematics that was not yet filled
588 // Update event header
592 // Fatal("FinishEvent", "No kinematics tree is defined.");
593 // Don't panic this is a probably a lego run
598 if(TreeK()->GetEntries() ==0) {
599 // set the fParticleFileMap size for the first time
600 fParticleFileMap.Set(fHgwmk+1);
603 Bool_t allFilled = kFALSE;
605 for(Int_t i=0; i<fHgwmk+1; ++i)
606 if((part=fParticleMap->At(i))) {
607 fParticleBuffer = dynamic_cast<TParticle*>(part);
608 fParticleFileMap[i]= static_cast<Int_t>(TreeK()->GetEntries());
610 //PH (*fParticleMap)[i]=fParticleBuffer=0;
612 fParticleMap->AddAt(0,i);
614 // When all primaries were filled no particle!=0
615 // should be left => to be removed later.
616 if (allFilled) AliWarning(Form("Why != 0 part # %d?\n",i));
620 // // printf("Why = 0 part # %d?\n",i); => We know.
622 // we don't break now in order to be sure there is no
623 // particle !=0 left.
624 // To be removed later and replaced with break.
625 if(!allFilled) allFilled = kTRUE;
628 //_____________________________________________________________________________
630 void AliStack::FlagTrack(Int_t track)
633 // Flags a track and all its family tree to be kept
640 particle=dynamic_cast<TParticle*>(fParticleMap->At(curr));
642 // If the particle is flagged the three from here upward is saved already
643 if(particle->TestBit(kKeepBit)) return;
645 // Save this particle
646 particle->SetBit(kKeepBit);
648 // Move to father if any
649 if((curr=particle->GetFirstMother())==-1) return;
653 //_____________________________________________________________________________
654 void AliStack::KeepTrack(Int_t track)
657 // Flags a track to be kept
660 fParticleMap->At(track)->SetBit(kKeepBit);
663 //_____________________________________________________________________________
664 void AliStack::Reset(Int_t size)
679 //_____________________________________________________________________________
680 void AliStack::ResetArrays(Int_t size)
683 // Resets stack arrays
689 fParticles = new TClonesArray("TParticle",1000);
691 fParticleMap->Clear();
692 if (size>0) fParticleMap->Expand(size);}
694 fParticleMap = new TObjArray(size);
697 //_____________________________________________________________________________
698 void AliStack::SetHighWaterMark(Int_t)
701 // Set high water mark for last track in event
706 fCurrentPrimary=fHgwmk;
707 // Set also number of primary tracks
708 fNprimary = fHgwmk+1;
712 //_____________________________________________________________________________
713 TParticle* AliStack::Particle(Int_t i)
716 // Return particle with specified ID
718 //PH if(!(*fParticleMap)[i]) {
719 if(!fParticleMap->At(i)) {
720 Int_t nentries = fParticles->GetEntriesFast();
721 // algorithmic way of getting entry index
722 // (primary particles are filled after secondaries)
723 Int_t entry = TreeKEntry(i);
724 // check whether algorithmic way and
725 // and the fParticleFileMap[i] give the same;
726 // give the fatal error if not
727 if (entry != fParticleFileMap[i]) {
729 "!! The algorithmic way and map are different: !!\n entry: %d map: %d",
730 entry, fParticleFileMap[i]));
733 TreeK()->GetEntry(entry);
734 new ((*fParticles)[nentries]) TParticle(*fParticleBuffer);
735 fParticleMap->AddAt((*fParticles)[nentries],i);
737 //PH return dynamic_cast<TParticle *>((*fParticleMap)[i]);
738 return dynamic_cast<TParticle*>(fParticleMap->At(i));
741 //_____________________________________________________________________________
742 TParticle* AliStack::ParticleFromTreeK(Int_t id) const
745 // return pointer to TParticle with label id
748 if ((entry = TreeKEntry(id)) < 0) return 0;
749 if (fTreeK->GetEntry(entry)<=0) return 0;
750 return fParticleBuffer;
753 //_____________________________________________________________________________
754 Int_t AliStack::TreeKEntry(Int_t id) const
757 // return entry number in the TreeK for particle with label id
758 // return negative number if label>fNtrack
762 entry = id+fNtrack-fNprimary;
764 entry = id-fNprimary;
768 //_____________________________________________________________________________
769 Int_t AliStack::GetCurrentParentTrackNumber() const
772 // Return number of the parent of the current track
775 TParticle* current = (TParticle*)fParticleMap->At(fCurrent);
778 return current->GetFirstMother();
780 AliWarning("Current track not found in the stack");
785 //_____________________________________________________________________________
786 Int_t AliStack::GetPrimary(Int_t id)
789 // Return number of primary that has generated track
797 parent=Particle(current)->GetFirstMother();
798 if(parent<0) return current;
802 //_____________________________________________________________________________
803 void AliStack::DumpPart (Int_t i) const
806 // Dumps particle i in the stack
809 //PH dynamic_cast<TParticle*>((*fParticleMap)[i])->Print();
810 dynamic_cast<TParticle*>(fParticleMap->At(i))->Print();
813 //_____________________________________________________________________________
814 void AliStack::DumpPStack ()
817 // Dumps the particle stack
822 printf("\n\n=======================================================================\n");
823 for (i=0;i<fNtrack;i++)
825 TParticle* particle = Particle(i);
827 printf("-> %d ",i); particle->Print();
828 printf("--------------------------------------------------------------\n");
831 Warning("DumpPStack", "No particle with id %d.", i);
834 printf("\n=======================================================================\n\n");
836 // print particle file map
837 printf("\nParticle file map: \n");
838 for (i=0; i<fNtrack; i++)
839 printf(" %d th entry: %d \n",i,fParticleFileMap[i]);
843 //_____________________________________________________________________________
844 void AliStack::DumpLoadedStack() const
847 // Dumps the particle in the stack
848 // that are loaded in memory.
851 TObjArray &particles = *fParticleMap;
853 "\n\n=======================================================================\n");
854 for (Int_t i=0;i<fNtrack;i++)
856 TParticle* particle = dynamic_cast<TParticle*>(particles[i]);
858 printf("-> %d ",i); particle->Print();
859 printf("--------------------------------------------------------------\n");
862 printf("-> %d Particle not loaded.\n",i);
863 printf("--------------------------------------------------------------\n");
867 "\n=======================================================================\n\n");
874 //_____________________________________________________________________________
875 void AliStack::CleanParents()
878 // Clean particles stack
879 // Set parent/daughter relations
882 TObjArray &particles = *fParticleMap;
885 for(i=0; i<fHgwmk+1; i++) {
886 part = dynamic_cast<TParticle*>(particles.At(i));
887 if(part) if(!part->TestBit(kDaughtersBit)) {
888 part->SetFirstDaughter(-1);
889 part->SetLastDaughter(-1);
894 //_____________________________________________________________________________
895 TParticle* AliStack::GetNextParticle()
898 // Return next particle from stack of particles
901 TParticle* particle = 0;
903 // search secondaries
904 //for(Int_t i=fNtrack-1; i>=0; i--) {
905 for(Int_t i=fNtrack-1; i>fHgwmk; i--) {
906 particle = dynamic_cast<TParticle*>(fParticleMap->At(i));
907 if ((particle) && (!particle->TestBit(kDoneBit))) {
913 // take next primary if all secondaries were done
914 while (fCurrentPrimary>=0) {
915 fCurrent = fCurrentPrimary;
916 particle = dynamic_cast<TParticle*>(fParticleMap->At(fCurrentPrimary--));
917 if ((particle) && (!particle->TestBit(kDoneBit))) {
922 // nothing to be tracked
928 //__________________________________________________________________________________________
930 TTree* AliStack::TreeK()
939 AliRunLoader *rl = AliRunLoader::GetRunLoader(fEventFolderName);
942 AliFatal(Form("Can not get RunLoader from event folder named %s",fEventFolderName.Data()));
943 return 0x0;//pro forma
945 fTreeK = rl->TreeK();
952 //don't panic - could be Lego
953 AliWarning(Form("Can not get TreeK from RL. Ev. Folder is %s",fEventFolderName.Data()));
956 return fTreeK;//never reached
958 //__________________________________________________________________________________________
960 void AliStack::ConnectTree()
963 // Creates branch for writing particles
965 AliDebug(1, "Connecting TreeK");
970 AliFatal("Parameter is NULL");//we don't like such a jokes
973 return;//in this case TreeK() calls back this method (ConnectTree)
974 //tree after setting fTreeK, the rest was already executed
975 //it is safe to return now
978 // Create a branch for particles
980 AliDebug(2, Form("Tree name is %s",fTreeK->GetName()));
982 if (fTreeK->GetDirectory())
984 AliDebug(2, Form("and dir is %s",fTreeK->GetDirectory()->GetName()));
987 AliWarning("DIR IS NOT SET !!!");
989 TBranch *branch=fTreeK->GetBranch(AliRunLoader::GetKineBranchName());
992 branch = fTreeK->Branch(AliRunLoader::GetKineBranchName(), "TParticle", &fParticleBuffer, 4000);
993 AliDebug(2, "Creating Branch in Tree");
997 AliDebug(2, "Branch Found in Tree");
998 branch->SetAddress(&fParticleBuffer);
1000 if (branch->GetDirectory())
1002 AliDebug(1, Form("Branch Dir Name is %s",branch->GetDirectory()->GetName()));
1005 AliWarning("Branch Dir is NOT SET");
1007 //__________________________________________________________________________________________
1010 void AliStack::BeginEvent()
1012 // start a new event
1016 //_____________________________________________________________________________
1017 void AliStack::FinishRun()
1019 // Clean TreeK information
1021 //_____________________________________________________________________________
1023 Bool_t AliStack::GetEvent()
1026 // Get new event from TreeK
1028 // Reset/Create the particle stack
1031 if (TreeK() == 0x0) //forces connecting
1033 AliError("cannot find Kine Tree for current event");
1037 Int_t size = (Int_t)TreeK()->GetEntries();
1041 //_____________________________________________________________________________
1043 void AliStack::SetEventFolderName(const char* foldname)
1045 //Sets event folder name
1046 fEventFolderName = foldname;