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 ntData = (TNtuple*) ( nextFile->Get("NTtracks") ) ;
209 entries = ntData->GetEntriesFast() ;
210 Int_t columns = ntData->GetNvar() ;
213 cout << "Error in reading Ntuple file: no. columns != 15" << endl ;
217 cout << "Start New File " << FileCounter << endl ;
220 return false ; // Failure: Error or EOF
223 //______________________________________________________________________________
224 Bool_t AliStarEventReader::AcceptEvent( AliStarEvent* event )
226 // Cut parameters for each event
228 const Float_t VertexXMin = -1.0 ; // cm
229 const Float_t VertexXMax = 1.0 ; // cm
230 const Float_t VertexYMin = -1.0 ; // cm
231 const Float_t VertexYMax = 1.0 ; // cm
232 const Float_t VertexZMin = -30.0 ; // cm
233 const Float_t VertexZMax = 30.0 ; // cm
234 const Int_t MultMin = 10 ; // Note: this is a cut on refMult which is not your ordinary multiplicity.
235 const Int_t MultMax = 1000 ; // Refmult corresponds to Zhangbu's ascii table of cuts for centrality bins.
236 const Int_t BlackEvent = 3000 ; // Maximum number of primary tracks allowed in one event (more is an error)
238 Int_t refMult = event->GetRefMult(); // Reference Multiplicity for Centrality determination
239 Int_t NumberOfPrimaryTracks = event->GetNumberOfPrimaryTracks(); // Number of primary tracks in full event (not just those in main TPC)
241 if ( refMult < MultMin || refMult > MultMax ) return false ;
242 if ( NumberOfPrimaryTracks <= 0 || NumberOfPrimaryTracks > BlackEvent ) return false ;
244 // Cut on Vertex location
245 Float_t vertex[3] = { event->GetVtxX(),
249 if ( vertex[0] < VertexXMin || vertex[0] > VertexXMax ) return false ; // Skip events that fall outside Vtx cuts
250 if ( vertex[1] < VertexYMin || vertex[1] > VertexYMax ) return false ;
251 if ( vertex[2] < VertexZMin || vertex[2] > VertexZMax ) return false ;
256 //______________________________________________________________________________
257 Bool_t AliStarEventReader::AcceptTrack( AliStarTrack* track )
259 // Cut Parameters for individual tracks
261 const Float_t dcaCut = 3.0 ; // cm
262 const Float_t PtMin = 0.15 ; // GeV
263 const Float_t PtMax = 2.0 ; // GeV
264 const Float_t EtaMin = -1.1 ;
265 const Float_t EtaMax = 1.1 ;
266 const Float_t FitRatio = 0.52 ; // Number of hits over number of hits possible
267 const Int_t nHitMin = 15 ; // 15 is typical but sometimes goes as high as 25
268 const Int_t nHitMax = 100 ; // 45 pad rows in the TPC and so anything bigger than 45+Silicon is infinite
269 const Int_t nHitPossMin = 5 ; // Don't bother to fit tracks if # possible hits is too low, also protect / 0
271 if ( track->GetDCA() > dcaCut ) return false ; // magnitude of 3D DCA for global tracks
272 if ( track->GetNHitsPoss() < nHitPossMin ||
273 track->GetNHitsPoss() > nHitMax ) return false ; // Minimum number of Possible hits, see above.
274 if ( track->GetEta() < EtaMin || track->GetEta() > EtaMax ) return false ;
275 if ( track->GetPt() < PtMin || track->GetEta() > PtMax ) return false ;
276 if ( track->GetNHitsFit() < nHitMin || track->GetNHitsFit() > nHitMax ) return false ;
277 if ( ((1.0*track->GetNHitsFit()) /
278 (1.0*track->GetNHitsPoss())) < FitRatio ) return false ;
283 //______________________________________________________________________________
284 Int_t AliStarEventReader::ParticleID( AliStarTrack* track )
286 // Note: This is a very simple PID selection scheme. More elaborate methods (with multiple cuts) may be required.
287 // When you *are* using dEdx information, you must chose a finite number of good Dedx hits ... but the limit should
288 // be about 2/3 of nHitsMin. This is because some clusters do not form good dEdx hits due to track
289 // merging, etc., and so nHitsDedx is always less than nHitsFit. A rule of thumb says ~2/3 ratio.
293 const Int_t nHitDedxMin = 15 ; // 10 to 20 is typical. nHitDedxMin is often chosen to be about 2/3 of nHitMin.
294 const Float_t nSigmaPID = 2.0 ; // Number of Sigma cut to apply to PID bands
296 // Test on Number of dE/dx hits required, return 0 if not enough hits
297 if ( track->GetNHitsDedx() < nHitDedxMin ) return ID;
301 if ( TMath::Abs( track->GetNSigElect() ) >= nSigmaPID )
303 if ( TMath::Abs( track->GetNSigK() ) <= nSigmaPID )
307 if ( TMath::Abs( track->GetNSigProton() ) <= nSigmaPID )
311 if ( TMath::Abs( track->GetNSigPi() ) <= nSigmaPID )
317 // Pion is the default in case of ambiguity because it is most abundent. Don't re-arrange order, above.
322 //______________________________________________________________________________
323 Int_t AliStarEventReader::Centrality( Int_t referenceMultiplicity )
326 // Note Carefully: Centrality is based on refMult. This is the 'reference' multiplicity that is measured
327 // independpently from the TPC. Selecting the centrality bins according to the refMult is something that
328 // is calibrated for each year and each run. You can get the basic information off the web:
329 // For Example .... http://www.star.bnl.gov/protected/common/common2004/trigger2004/200gev/200gevFaq.html
330 // An index pointing to FAQs, Trigger and Centrality data, for all years, is available at:
331 // http://www.star.bnl.gov/public/all
333 // Note: Add 0.5 to the (int) that is returned by centrality() when using it as an argument for a histogram
334 // that expects (float) or (double) as input parameters. This will place the data point in the center of
335 // the bin, avoids ambiguities, and is best for plotting scatter plots and contour plots.
336 // For example histogram2D[1] -> Fill ( (float)CentralityID + 0.5 , SumData ) ;
338 // The refMult quoted in the Centrality bins array is the lower limit on refMult
341 Int_t CentralityBins [] = { 14 , 31 , 57 , 96 , 150 , 222 , 319 , 441 , 520 , 1000 } ; // Run4 200 GeV
342 Int_t MiddleBinID [] = { 0 , 1 , 2 , 3 , 4 , 5 , 6 , 7 , 8 , 9 } ; // ID Number
343 //Info MiddleBinPercent[] = { 85., 75., 65., 55., 45., 35., 25., 15., 7.5 , 2.5 } ; // Percent
346 if ( referenceMultiplicity < CentralityBins[0] )
348 myCentrality = MiddleBinID[0] ;
350 else if ( referenceMultiplicity < CentralityBins[1] )
352 myCentrality = MiddleBinID[1] ;
354 else if ( referenceMultiplicity < CentralityBins[2] )
356 myCentrality = MiddleBinID[2] ;
358 else if ( referenceMultiplicity < CentralityBins[3] )
360 myCentrality = MiddleBinID[3] ;
362 else if ( referenceMultiplicity < CentralityBins[4] )
364 myCentrality = MiddleBinID[4] ;
366 else if ( referenceMultiplicity < CentralityBins[5] )
368 myCentrality = MiddleBinID[5] ;
370 else if ( referenceMultiplicity < CentralityBins[6] )
372 myCentrality = MiddleBinID[6] ;
374 else if ( referenceMultiplicity < CentralityBins[7] )
376 myCentrality = MiddleBinID[7] ;
378 else if ( referenceMultiplicity < CentralityBins[8] )
380 myCentrality = MiddleBinID[8] ;
384 myCentrality = MiddleBinID[9] ;
387 return myCentrality ;
390 //______________________________________________________________________________
391 void AliStarEventReader::PrintEventHeader ( )
393 // TNtuple* event: names are documented in the next 2 lines
394 // event = new TNtuple("event","event",
395 // "runId:eventNumber:VtxX:VtxY:VtxZ:BField:refMult:centralityId:numberOfPrimaryTracks:numberOfParticles:h0:h1:h2:h3:h4" ) ;
398 eventhd = fEventHeader->GetArgs() ;
400 Int_t runId = (int) eventhd[0] ;
401 Int_t eventNumber = (int) eventhd[1] ;
402 Float_t primaryVertexPosition[3] = { (float) eventhd[2], // (cm)
403 (float) eventhd[3], // (cm)
404 (float) eventhd[4] }; // (cm)
405 Float_t magneticField = (float) eventhd[5] ; // kilogauss
406 Int_t refMult = (int) eventhd[6] ; // Raw Mult into 0.5 unit: a relative number, not total Mult.
407 Int_t centralityId = (int) eventhd[7] ; // STAR centrality bin # based on refMult
408 Int_t numberOfPrimaryTracks = (int) eventhd[8] ; // # of primaries, including FTPC tracks which are not in ntuple
409 Int_t numberOfParticles = (int) eventhd[9] ; // # of particles passing track cuts, thus in ntuple
411 printf("\n runId eventNo VtxX VtxY VtxZ MagFld refMult CentBin #PrimeTrak #Tracks \n") ;
412 printf("%7d %6d %7.4f %7.4f %7.3f %6.3f %6d %6d %6d %6d \n\n",
413 runId, eventNumber, primaryVertexPosition[0], primaryVertexPosition[1], primaryVertexPosition[2],
414 magneticField, refMult, centralityId, numberOfPrimaryTracks, numberOfParticles ) ;
416 //Int_t newCentralityID ;
417 //newCentralityID = Centrality( refMult) ; // Should be the same as "centralityID" from tape
418 //cout << "Test: should be the same " << newCentralityID << " " << centralityId << endl ; // JT test
421 //______________________________________________________________________________
422 void AliStarEventReader::PrintTrack ( Int_t counter )
424 // TNtuple* track: names are documented in the next 2 lines
425 // tracks = new TNtuple("tracks","tracks",
426 // "ID:Charge:Eta:Phi:Pt:Dca:nHits:nHitsFit:nHitsPoss:nHitsDedx:dEdx:nSigElect:nSigPi:nSigK:nSigProton" ) ;
431 " id charge eta phi pt dca nHits nFit nPoss ndEdx dEdx nSigElec nSigPi nSigK nSigPr\n") ;
433 Float_t* data = fTracks -> GetArgs() ; // Extract data from the track
434 Int_t id = (int) data[0] ; // id - a unique integer for each track in this event
435 Int_t charge = (int) data[1] ; // +1 or -1
436 Float_t eta = (float) data[2] ; // Pseudo-rapidity at the vertex
437 Float_t phi = (float) data[3] ; // Phi emission angle at the vertexcd
438 Float_t pt = (float) data[4] ; // Pt of the track at the vertex
439 Float_t dca = (float) data[5] ; // Magnitude of 3D DCA to vertex
440 Int_t nHits = (int) data[6] ; // Number of clusters available to the Kalman Filter
441 Int_t nHitsFit = (int) data[7] ; // Number of clusters used in the fit (after cuts)
442 Int_t nHitsPoss = (int) data[8] ; // Number of possible cluster on track (theoretical max)
443 Int_t nHitsDedx = (int) data[9] ; // Number of clusters used in the fit (after dEdx cuts)
444 Float_t dEdx = 1.e6*(float)data[10] ; // Measured dEdx (Note: GeV/cm so convert to keV/cm!!)
445 Float_t nSigmaElectron = (float) data[11] ; // Number of sigma from electron Bethe-Bloch curve
446 Float_t nSigmaPion = (float) data[12] ; // Number of sigma from pion Bethe-Bloch curve
447 Float_t nSigmaKaon = (float) data[13] ; // Number of sigma from kaon Bethe-Bloch curve
448 Float_t nSigmaProton = (float) data[14] ; // Number of sigma from proton Bethe-Bloch curve
450 // Alternative way to access the data
451 nHitsPoss = (int) ( fTracks->GetLeaf("nHitsPoss")->GetValue() ) ; // Note alternative method to retrieve data
452 // Using the definition of the original NTuple
453 // TrackTuple = new TNtuple("NTtracks","NTtracks",
454 // "ID:Charge:Eta:Phi:Pt:Dca:nHits:nHitsFit:nHitsPoss:nHitsDedx:dEdx:nSigElect:nSigPi:nSigK:nSigProton" )
456 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",
457 id, charge, eta, phi, pt, dca, nHits, nHitsFit, nHitsPoss, nHitsDedx, dEdx,
458 nSigmaElectron, nSigmaPion, nSigmaKaon, nSigmaProton ) ;
461 //______________________________________________________________________________
462 Bool_t AliStarEventReader::MakeFileList ( const char* inputFileDirectory )
464 //get the files to process
466 static Int_t DoOnce = 0 ;
467 fFileList = new TList() ;
468 void* directory = gSystem->OpenDirectory(inputFileDirectory) ;
469 const char* entry = gSystem->GetDirEntry(directory) ;
473 cout << endl << "Error: \"" << inputFileDirectory << "\" does not exist" << endl << endl ;
480 int len = strlen(entry);
481 if( len >= 5 && strcmp( &entry[len - 5], ".root" ) == 0 )
484 fileName = inputFileDirectory ;
485 if( !fileName.EndsWith("/") ) fileName += "/" ;
487 fFileList->Add ( TFile::Open(fileName) ) ;
490 cout << "Add: " << fileName << endl ;
495 entry = gSystem->GetDirEntry(directory) ;
498 cout << "Add: " << Count-1 << " more file(s) from this directory for a total of " << Count << " files." << endl ;
499 cout << "Finished creating file list ... preparing to open first file." << endl << endl ;