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 **************************************************************************/
16 // Title: Class for ccessing data from STAR NTuples
17 // produces data encapsulated in AliStarEvent and AliStarTrack classes
19 // Origin: Jim Thomas, jhthomas@lbl.gov
20 // Mikolaj Krzewicki, mikolaj.krzewicki@cern.ch
22 #include <Riostream.h>
31 #include "AliStarEventReader.h"
32 #include "AliStarEvent.h"
33 #include "AliStarTrack.h"
35 ClassImp(AliStarEventReader)
37 //______________________________________________________________________________
38 AliStarEventReader::AliStarEventReader():
47 //______________________________________________________________________________
48 AliStarEventReader::AliStarEventReader( const char* inputFileDirectory ):
51 fEventHeader( new TNtuple("event","event",
52 "runId:eventNumber:VtxX:VtxY:VtxZ:BField:refMult:centralityId:numberOfPrimaryTracks:numberOfParticles:h0:h1:h2:h3:h4" )),
53 fTracks( new TNtuple("tracks","tracks",
54 "ID:Charge:Eta:Phi:Pt:Dca:nHits:nHitsFit:nHitsPoss:nHitsDedx:dEdx:nSigElect:nSigPi:nSigK:nSigProton" )),
55 fEvent(new AliStarEvent(1024))
58 MakeFileList ( inputFileDirectory ) ;
61 //______________________________________________________________________________
62 AliStarEventReader::~AliStarEventReader()
74 //______________________________________________________________________________
75 Bool_t AliStarEventReader::GetNextEvent( )
78 static TFile* nextFile = NULL ;
79 static TNtuple* ntData = NULL ;
80 static Int_t DoOnce = 0 ;
81 static Long64_t NextEntry = 0 ;
82 static Long64_t entries = 0 ;
83 static Long64_t FileCounter = 0 ;
88 nextFile = (TFile*) fFileList->First() ;
89 if ( nextFile == 0 ) return false ;
90 ntData = (TNtuple*) ( nextFile->Get("NTtracks") ) ;
91 entries = ntData->GetEntriesFast() ;
92 Int_t columns = ntData->GetNvar() ;
95 cout << "Error in reading Ntuple file: no. columns != 15" << endl ;
99 cout << "Start New File " << FileCounter << endl ;
104 while ( NextEntry < entries )
106 Float_t* header = NULL;
107 Int_t numberOfParticles = 0 ; // Number of particle tracks in the next event
108 Long64_t HeaderEntry = 0 ; // Store position of Header and Set Flag in case of EOF or error
109 Long64_t SkipEvent = 0 ; // Flag in case of wrong number of tracks in this event
111 ////////////////////////////////////////////
112 fEvent->Reset(); //reset the event
113 ////////////////////////////////////////////
115 // Search for the first "Event" record
117 delete fEventHeader ;
118 fEventHeader = NULL ; // Note that a first 'event' ntuple was created in constructor
119 fEventHeader = new TNtuple("event","event",
120 "runId:eventNumber:VtxX:VtxY:VtxZ:BField:refMult:centralityId:numberOfPrimaryTracks:numberOfParticles:h0:h1:h2:h3:h4" ) ;
122 for ( Long64_t j = NextEntry ; j < entries ; j++ )
124 Long64_t BytesRead = ntData->GetEntry(j) ;
125 if ( BytesRead < 60 )
127 cout << "Warning: error in file or EOF " << endl ;
131 header = ntData->GetArgs() ;
132 if ( (int) header[10] == -1 && (int) header[11] == -1 && (int) header[12] == -1 &&
133 (int) header[13] == -1 && (int) header[14] == -1 )
135 fEventHeader->Fill(header) ;
137 //////////////////////////////////////////////////
138 fEvent->SetParams(header); //set the event params
139 //////////////////////////////////////////////////
141 numberOfParticles = (int) header[9] ; // # of particles passing track cuts, thus in ntuple
145 cout << "Warning: no header entries found in this file" << endl ;
149 if ( HeaderEntry == -1 ) break ; // Break out of main loop if I/O error
151 // Get subsequent "track" data
154 fTracks = NULL ; // Note that a first 'tracks' ntuple was created in constructor
155 fTracks = new TNtuple("tracks","tracks",
156 "ID:Charge:Eta:Phi:Pt:Dca:nHits:nHitsFit:nHitsPoss:nHitsDedx:dEdx:nSigElect:nSigPi:nSigK:nSigProton" ) ;
158 for ( Long64_t j = HeaderEntry + 1 ; j < HeaderEntry + 1 + numberOfParticles ; j++ )
160 Long64_t BytesRead = ntData->GetEntry(j) ;
161 if ( BytesRead < 60 )
163 cout << "Warning: error in file sequence or EOF" << endl ;
167 header = ntData->GetArgs() ;
169 if ( TMath::IsNaN(header[10]) == 1 )
171 cout << "IsNan ... dEdx will be zeroed out" << endl ;
177 cout << header[0] << " " << header[1] << " " << header[2] << " " << header[3] << " "
178 << header[4] << " " << header[5] << " " << header[6] << " " << header[7] << " "
179 << header[8] << " " << header[9] << " " << header[10] << " " << header[11] << " "
180 << header[12] << " " << header[13] << " " << header[14] << endl ; // JT test
183 if ( (int) header[10] == -1 && (int) header[11] == -1 && (int) header[12] == -1 &&
184 (int) header[13] == -1 && (int) header[14] == -1 )
186 cout << "Warning: Header in the wrong place, skipping event" << endl ;
188 NextEntry = j ; // Skip event and freeze NextEntry counter
192 fTracks->Fill(header) ;
194 ////////////////////////////////////////////////////////////////////
195 fEvent->AddTrack( new AliStarTrack(header) ); //add the new track
196 ////////////////////////////////////////////////////////////////////
200 if ( NextEntry == -1 ) break ; // Bad record in file, go to next file in fFileList
201 if ( SkipEvent == 1 ) continue ; // Bad event, go to next event in this file
202 return true ; // Success: Event read OK, note unusual location for a successful return
205 NextEntry = 0 ; // this entry goes before nextFile
206 nextFile = (TFile*) fFileList->After(nextFile) ;
207 if ( nextFile == 0 ) break ;
208 if (ntData) delete ntData;
209 ntData = (TNtuple*) ( nextFile->Get("NTtracks") ) ;
210 entries = ntData->GetEntriesFast() ;
211 Int_t columns = ntData->GetNvar() ;
214 cout << "Error in reading Ntuple file: no. columns != 15" << endl ;
218 cout << "Start New File " << FileCounter << endl ;
221 return false ; // Failure: Error or EOF
224 //______________________________________________________________________________
225 Bool_t AliStarEventReader::AcceptEvent( AliStarEvent* event )
227 // Cut parameters for each event
229 const Float_t VertexXMin = -1.0 ; // cm
230 const Float_t VertexXMax = 1.0 ; // cm
231 const Float_t VertexYMin = -1.0 ; // cm
232 const Float_t VertexYMax = 1.0 ; // cm
233 const Float_t VertexZMin = -30.0 ; // cm
234 const Float_t VertexZMax = 30.0 ; // cm
235 const Int_t MultMin = 10 ; // Note: this is a cut on refMult which is not your ordinary multiplicity.
236 const Int_t MultMax = 1000 ; // Refmult corresponds to Zhangbu's ascii table of cuts for centrality bins.
237 const Int_t BlackEvent = 3000 ; // Maximum number of primary tracks allowed in one event (more is an error)
239 Int_t refMult = event->GetRefMult(); // Reference Multiplicity for Centrality determination
240 Int_t NumberOfPrimaryTracks = event->GetNumberOfPrimaryTracks(); // Number of primary tracks in full event (not just those in main TPC)
242 if ( refMult < MultMin || refMult > MultMax ) return false ;
243 if ( NumberOfPrimaryTracks <= 0 || NumberOfPrimaryTracks > BlackEvent ) return false ;
245 // Cut on Vertex location
246 Float_t vertex[3] = { event->GetVtxX(),
250 if ( vertex[0] < VertexXMin || vertex[0] > VertexXMax ) return false ; // Skip events that fall outside Vtx cuts
251 if ( vertex[1] < VertexYMin || vertex[1] > VertexYMax ) return false ;
252 if ( vertex[2] < VertexZMin || vertex[2] > VertexZMax ) return false ;
257 //______________________________________________________________________________
258 Bool_t AliStarEventReader::AcceptTrack( AliStarTrack* track )
260 // Cut Parameters for individual tracks
262 const Float_t dcaCut = 3.0 ; // cm
263 const Float_t PtMin = 0.15 ; // GeV
264 const Float_t PtMax = 2.0 ; // GeV
265 const Float_t EtaMin = -1.1 ;
266 const Float_t EtaMax = 1.1 ;
267 const Float_t FitRatio = 0.52 ; // Number of hits over number of hits possible
268 const Int_t nHitMin = 15 ; // 15 is typical but sometimes goes as high as 25
269 const Int_t nHitMax = 100 ; // 45 pad rows in the TPC and so anything bigger than 45+Silicon is infinite
270 const Int_t nHitPossMin = 5 ; // Don't bother to fit tracks if # possible hits is too low, also protect / 0
272 if ( track->GetDCA() > dcaCut ) return false ; // magnitude of 3D DCA for global tracks
273 if ( track->GetNHitsPoss() < nHitPossMin ||
274 track->GetNHitsPoss() > nHitMax ) return false ; // Minimum number of Possible hits, see above.
275 if ( track->GetEta() < EtaMin || track->GetEta() > EtaMax ) return false ;
276 if ( track->GetPt() < PtMin || track->GetEta() > PtMax ) return false ;
277 if ( track->GetNHitsFit() < nHitMin || track->GetNHitsFit() > nHitMax ) return false ;
278 if ( ((1.0*track->GetNHitsFit()) /
279 (1.0*track->GetNHitsPoss())) < FitRatio ) return false ;
284 //______________________________________________________________________________
285 Int_t AliStarEventReader::ParticleID( AliStarTrack* track )
287 // Note: This is a very simple PID selection scheme. More elaborate methods (with multiple cuts) may be required.
288 // When you *are* using dEdx information, you must chose a finite number of good Dedx hits ... but the limit should
289 // be about 2/3 of nHitsMin. This is because some clusters do not form good dEdx hits due to track
290 // merging, etc., and so nHitsDedx is always less than nHitsFit. A rule of thumb says ~2/3 ratio.
294 const Int_t nHitDedxMin = 15 ; // 10 to 20 is typical. nHitDedxMin is often chosen to be about 2/3 of nHitMin.
295 const Float_t nSigmaPID = 2.0 ; // Number of Sigma cut to apply to PID bands
297 // Test on Number of dE/dx hits required, return 0 if not enough hits
298 if ( track->GetNHitsDedx() < nHitDedxMin ) return ID;
302 if ( TMath::Abs( track->GetNSigElect() ) >= nSigmaPID )
304 if ( TMath::Abs( track->GetNSigK() ) <= nSigmaPID )
308 if ( TMath::Abs( track->GetNSigProton() ) <= nSigmaPID )
312 if ( TMath::Abs( track->GetNSigPi() ) <= nSigmaPID )
318 // Pion is the default in case of ambiguity because it is most abundent. Don't re-arrange order, above.
323 //______________________________________________________________________________
324 Int_t AliStarEventReader::Centrality( Int_t referenceMultiplicity )
327 // Note Carefully: Centrality is based on refMult. This is the 'reference' multiplicity that is measured
328 // independpently from the TPC. Selecting the centrality bins according to the refMult is something that
329 // is calibrated for each year and each run. You can get the basic information off the web:
330 // For Example .... http://www.star.bnl.gov/protected/common/common2004/trigger2004/200gev/200gevFaq.html
331 // An index pointing to FAQs, Trigger and Centrality data, for all years, is available at:
332 // http://www.star.bnl.gov/public/all
334 // Note: Add 0.5 to the (int) that is returned by centrality() when using it as an argument for a histogram
335 // that expects (float) or (double) as input parameters. This will place the data point in the center of
336 // the bin, avoids ambiguities, and is best for plotting scatter plots and contour plots.
337 // For example histogram2D[1] -> Fill ( (float)CentralityID + 0.5 , SumData ) ;
339 // The refMult quoted in the Centrality bins array is the lower limit on refMult
342 Int_t CentralityBins [] = { 14 , 31 , 57 , 96 , 150 , 222 , 319 , 441 , 520 , 1000 } ; // Run4 200 GeV
343 Int_t MiddleBinID [] = { 0 , 1 , 2 , 3 , 4 , 5 , 6 , 7 , 8 , 9 } ; // ID Number
344 //Info MiddleBinPercent[] = { 85., 75., 65., 55., 45., 35., 25., 15., 7.5 , 2.5 } ; // Percent
347 if ( referenceMultiplicity < CentralityBins[0] )
349 myCentrality = MiddleBinID[0] ;
351 else if ( referenceMultiplicity < CentralityBins[1] )
353 myCentrality = MiddleBinID[1] ;
355 else if ( referenceMultiplicity < CentralityBins[2] )
357 myCentrality = MiddleBinID[2] ;
359 else if ( referenceMultiplicity < CentralityBins[3] )
361 myCentrality = MiddleBinID[3] ;
363 else if ( referenceMultiplicity < CentralityBins[4] )
365 myCentrality = MiddleBinID[4] ;
367 else if ( referenceMultiplicity < CentralityBins[5] )
369 myCentrality = MiddleBinID[5] ;
371 else if ( referenceMultiplicity < CentralityBins[6] )
373 myCentrality = MiddleBinID[6] ;
375 else if ( referenceMultiplicity < CentralityBins[7] )
377 myCentrality = MiddleBinID[7] ;
379 else if ( referenceMultiplicity < CentralityBins[8] )
381 myCentrality = MiddleBinID[8] ;
385 myCentrality = MiddleBinID[9] ;
388 return myCentrality ;
391 //______________________________________________________________________________
392 void AliStarEventReader::PrintEventHeader ( )
394 // TNtuple* event: names are documented in the next 2 lines
395 // event = new TNtuple("event","event",
396 // "runId:eventNumber:VtxX:VtxY:VtxZ:BField:refMult:centralityId:numberOfPrimaryTracks:numberOfParticles:h0:h1:h2:h3:h4" ) ;
399 eventhd = fEventHeader->GetArgs() ;
401 Int_t runId = (int) eventhd[0] ;
402 Int_t eventNumber = (int) eventhd[1] ;
403 Float_t primaryVertexPosition[3] = { (float) eventhd[2], // (cm)
404 (float) eventhd[3], // (cm)
405 (float) eventhd[4] }; // (cm)
406 Float_t magneticField = (float) eventhd[5] ; // kilogauss
407 Int_t refMult = (int) eventhd[6] ; // Raw Mult into 0.5 unit: a relative number, not total Mult.
408 Int_t centralityId = (int) eventhd[7] ; // STAR centrality bin # based on refMult
409 Int_t numberOfPrimaryTracks = (int) eventhd[8] ; // # of primaries, including FTPC tracks which are not in ntuple
410 Int_t numberOfParticles = (int) eventhd[9] ; // # of particles passing track cuts, thus in ntuple
412 printf("\n runId eventNo VtxX VtxY VtxZ MagFld refMult CentBin #PrimeTrak #Tracks \n") ;
413 printf("%7d %6d %7.4f %7.4f %7.3f %6.3f %6d %6d %6d %6d \n\n",
414 runId, eventNumber, primaryVertexPosition[0], primaryVertexPosition[1], primaryVertexPosition[2],
415 magneticField, refMult, centralityId, numberOfPrimaryTracks, numberOfParticles ) ;
417 //Int_t newCentralityID ;
418 //newCentralityID = Centrality( refMult) ; // Should be the same as "centralityID" from tape
419 //cout << "Test: should be the same " << newCentralityID << " " << centralityId << endl ; // JT test
422 //______________________________________________________________________________
423 void AliStarEventReader::PrintTrack ( Int_t counter )
425 // TNtuple* track: names are documented in the next 2 lines
426 // tracks = new TNtuple("tracks","tracks",
427 // "ID:Charge:Eta:Phi:Pt:Dca:nHits:nHitsFit:nHitsPoss:nHitsDedx:dEdx:nSigElect:nSigPi:nSigK:nSigProton" ) ;
432 " id charge eta phi pt dca nHits nFit nPoss ndEdx dEdx nSigElec nSigPi nSigK nSigPr\n") ;
434 Float_t* data = fTracks -> GetArgs() ; // Extract data from the track
435 Int_t id = (int) data[0] ; // id - a unique integer for each track in this event
436 Int_t charge = (int) data[1] ; // +1 or -1
437 Float_t eta = (float) data[2] ; // Pseudo-rapidity at the vertex
438 Float_t phi = (float) data[3] ; // Phi emission angle at the vertexcd
439 Float_t pt = (float) data[4] ; // Pt of the track at the vertex
440 Float_t dca = (float) data[5] ; // Magnitude of 3D DCA to vertex
441 Int_t nHits = (int) data[6] ; // Number of clusters available to the Kalman Filter
442 Int_t nHitsFit = (int) data[7] ; // Number of clusters used in the fit (after cuts)
443 Int_t nHitsPoss = (int) data[8] ; // Number of possible cluster on track (theoretical max)
444 Int_t nHitsDedx = (int) data[9] ; // Number of clusters used in the fit (after dEdx cuts)
445 Float_t dEdx = 1.e6*(float)data[10] ; // Measured dEdx (Note: GeV/cm so convert to keV/cm!!)
446 Float_t nSigmaElectron = (float) data[11] ; // Number of sigma from electron Bethe-Bloch curve
447 Float_t nSigmaPion = (float) data[12] ; // Number of sigma from pion Bethe-Bloch curve
448 Float_t nSigmaKaon = (float) data[13] ; // Number of sigma from kaon Bethe-Bloch curve
449 Float_t nSigmaProton = (float) data[14] ; // Number of sigma from proton Bethe-Bloch curve
451 // Alternative way to access the data
452 nHitsPoss = (int) ( fTracks->GetLeaf("nHitsPoss")->GetValue() ) ; // Note alternative method to retrieve data
453 // Using the definition of the original NTuple
454 // TrackTuple = new TNtuple("NTtracks","NTtracks",
455 // "ID:Charge:Eta:Phi:Pt:Dca:nHits:nHitsFit:nHitsPoss:nHitsDedx:dEdx:nSigElect:nSigPi:nSigK:nSigProton" )
457 printf("%6d %4d %7.3f %7.3f %7.3f %7.4f %6d %5d %5d %5d %6.2f %6.2f %6.2f %6.2f %6.2f \n",
458 id, charge, eta, phi, pt, dca, nHits, nHitsFit, nHitsPoss, nHitsDedx, dEdx,
459 nSigmaElectron, nSigmaPion, nSigmaKaon, nSigmaProton ) ;
462 //______________________________________________________________________________
463 Bool_t AliStarEventReader::MakeFileList ( const char* inputFileDirectory )
465 //get the files to process
467 static Int_t DoOnce = 0 ;
468 fFileList = new TList() ;
469 void* directory = gSystem->OpenDirectory(inputFileDirectory) ;
470 const char* entry = gSystem->GetDirEntry(directory) ;
474 cout << endl << "Error: \"" << inputFileDirectory << "\" does not exist" << endl << endl ;
481 int len = strlen(entry);
482 if( len >= 5 && strcmp( &entry[len - 5], ".root" ) == 0 )
485 fileName = inputFileDirectory ;
486 if( !fileName.EndsWith("/") ) fileName += "/" ;
488 fFileList->Add ( TFile::Open(fileName) ) ;
491 cout << "Add: " << fileName << endl ;
496 entry = gSystem->GetDirEntry(directory) ;
499 cout << "Add: " << Count-1 << " more file(s) from this directory for a total of " << Count << " files." << endl ;
500 cout << "Finished creating file list ... preparing to open first file." << endl << endl ;