/************************************************************************** * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. * * * * Author: The ALICE Off-line Project. * * Contributors are mentioned in the code where appropriate. * * * * Permission to use, copy, modify and distribute this software and its * * documentation strictly for non-commercial purposes is hereby granted * * without fee, provided that the above copyright notice appears in all * * copies and that both the copyright notice and this permission notice * * appear in the supporting documentation. The authors make no claims * * about the suitability of this software for any purpose. It is * * provided "as is" without express or implied warranty. * **************************************************************************/ //Root includes #include #include #include #include #include #include #include #include #include #include #include //AliRoot includes #include "AliRawReader.h" #include "AliRawReaderRoot.h" #include "AliRawReaderDate.h" #include "AliTPCRawStream.h" #include "AliTPCCalROC.h" #include "AliTPCCalPad.h" #include "AliTPCROC.h" #include "AliMathBase.h" #include "TTreeStream.h" #include "AliTPCRawStreamFast.h" //date #include "event.h" //header file #include "AliTPCCalibKr.h" //---------------------------------------------------------------------------- // The AliTPCCalibKr class description (TPC Kr calibration). // // // The AliTPCCalibKr fills the array of TH3F histograms (TPC_max_padraw,TPC_max_pad,TPC_ADC_cluster), // its data memebers. // // As the input it requires the tree with reconstructed Kr clusters (AliTPCclusterKr objects). // The AliTPCCalibKr objects containing an array of TH3F histograms are stored (by default) in the // ouptut (outHistFile.root) file. // // The ouput TH3F histograms are later used to determine the calibration parameters of TPC chambers. // These calculations are done by using AliTPCCalibKr::Analyse() function. The ouput calibration // parameters (details in AliTPCCalibKr::Analyse()) are stored in the calibKr.root file for each TPC pad. // In addition the debugCalibKr.root file with debug information is created. // // Usage example: // // 1. Create outHistFile.root histogram file: // // -- Load libXrdClient.so if data on Xrd cluster e.g. (GSI) // gSystem->Load("/usr/local/grid/XRootd/GSI/lib64/libXrdClient.so"); // // -- Load toolkit // gSystem->AddIncludePath("-I$ALICE_ROOT/TPC/macros"); // gROOT->LoadMacro("$ALICE_ROOT/TPC/macros/AliXRDPROOFtoolkit.cxx+"); // AliXRDPROOFtoolkit tool; // // -- Make chain of files // TChain * chain = tool.MakeChain("KrClusters.txt","Kr","",1000,0); // // -- Run AliTPCCalibKr task (Only TPC C side) // AliTPCCalibKr *task = new AliTPCCalibKr; // task->SetInputChain(chain); // task->SetASide(kFALSE); // // task->Process(); // // 2. Analyse output histograms: // // TFile f("outHistFile.root"); // AliTPCCalibKr.Analyse(); // // 3. See calibration parameters e.g.: // // TFile f("calibKr.root"); // spectrMean->GetCalROC(70)->GetValue(40,40); // fitMean->GetCalROC(70)->GetValue(40,40); // // 4. See debug information e.g.: // // TFile f("debugCalibKr.root"); // .ls; // // -- Print calibKr TTree content // calibKr->Print(); // // -- Draw calibKr TTree variables // calibKr.Draw("fitMean"); // // // Author: Jacek Otwinowski (J.Otwinowski@gsi.de) and Stafan Geartner (S.Gaertner@gsi.de) //----------------------------------------------------------------------------- ClassImp(AliTPCCalibKr) AliTPCCalibKr::AliTPCCalibKr() : TObject(), bOutputHisto(kTRUE), bASide(kTRUE), bCSide(kTRUE), fClusters(0), fClustKr(0), fTree(0), fHistoKrArray(72) { // // default constructor // } //_____________________________________________________________________ AliTPCCalibKr::AliTPCCalibKr(const AliTPCCalibKr& pad) : TObject(pad), bOutputHisto(pad.bOutputHisto), bASide(pad.bASide), bCSide(pad.bCSide), fClusters(pad.fClusters), fClustKr(pad.fClustKr), fTree(pad.fTree), fHistoKrArray(72) { // copy constructor for (Int_t iSec = 0; iSec < 72; ++iSec) { TH3F *hOld = pad.GetHistoKr(iSec); if(hOld) { TH3F *hNew = new TH3F( *pad.GetHistoKr(iSec) ); fHistoKrArray.AddAt(hNew,iSec); } } } //_____________________________________________________________________ AliTPCCalibKr::~AliTPCCalibKr() { // // destructor // if(fClustKr) delete fClustKr; fClustKr = 0; if(fClusters) delete fClusters; fClusters = 0; if(fTree) delete fTree; fTree = 0; fHistoKrArray.Delete(); } //_____________________________________________________________________ AliTPCCalibKr& AliTPCCalibKr::operator = (const AliTPCCalibKr &source) { // assignment operator if (&source == this) return *this; new (this) AliTPCCalibKr(source); return *this; } //_____________________________________________________________________ void AliTPCCalibKr::Init() { // // init input tree and output histograms // // set input tree if(!fTree) { Printf("ERROR: Could not read chain from input"); } else { fTree->SetBranchStatus("*",1); } // set branch address fClusters = new TClonesArray("AliTPCclusterKr"); if(!fTree->GetBranch("fClusters")) { Printf("ERROR: Could not get fClusters branch from input"); } else { fTree->GetBranch("fClusters")->SetAddress(&fClusters); } // create output TObjArray fHistoKrArray.Clear(); // add histograms to the TObjArray for(Int_t i=0; i<72; ++i) { // C - side if( IsCSide(i) == kTRUE && bCSide == kTRUE) { TH3F *hist = CreateHisto(i); if(hist) fHistoKrArray.AddAt(hist,i); } // A - side if(IsCSide(i) == kFALSE && bASide == kTRUE) { TH3F *hist = CreateHisto(i); if(hist) fHistoKrArray.AddAt(hist,i); } } } //_____________________________________________________________________ Bool_t AliTPCCalibKr::ReadEntry(Int_t evt) { // // read entry from the tree // Long64_t centry = fTree->LoadTree(evt); if(centry < 0) return kFALSE; if(!fTree->GetBranch("fClusters")) { Printf("ERROR: Could not get fClusters branch from input"); return kFALSE; } else { fTree->GetBranch("fClusters")->SetAddress(&fClusters); } fTree->GetEntry(evt); return kTRUE; } //_____________________________________________________________________ Bool_t AliTPCCalibKr::Process() { // // process events // call event by event // // init tree Init(); // get events if(!fTree) return kFALSE; Int_t nEvents = fTree->GetEntries(); // fill histograms for(Int_t i=0; iGetEntries(); for(Int_t j=0; j < entries; ++j) { fClustKr = (AliTPCclusterKr*)fClusters->At(j); if(fClustKr) Update(fClustKr); else return kFALSE; } } // write output return Terminate(); } //_____________________________________________________________________ TH3F* AliTPCCalibKr::CreateHisto(Int_t chamber) { // // create new histogram // char name[256]; TH3F *h; sprintf(name,"ADCcluster_ch%d",chamber); if( IsIROC(chamber) == kTRUE ) { h = new TH3F(name,name,63,0,63,100,0,100,150,100,3000); } else { h = new TH3F(name,name,96,0,96,100,0,100,150,100,3000); } h->SetXTitle("padrow"); h->SetYTitle("pad"); h->SetZTitle("fADC"); return h; } //_____________________________________________________________________ Bool_t AliTPCCalibKr::IsIROC(Int_t chamber) { // check if IROCs // returns kTRUE if IROCs and kFALSE if OROCs if(chamber>=0 && chamber<36) return kTRUE; return kFALSE; } //_____________________________________________________________________ Bool_t AliTPCCalibKr::IsCSide(Int_t chamber) { // check if C side // returns kTRUE if C side and kFALSE if A side if((chamber>=18 && chamber<36) || (chamber>=54 && chamber<72)) return kTRUE; return kFALSE; } //_____________________________________________________________________ Bool_t AliTPCCalibKr::Update(AliTPCclusterKr *cl) { // // fill existing histograms // TH3F *h = (TH3F*)fHistoKrArray.At(cl->GetSec()); if(!h) return kFALSE; if(cl->GetSize()>20) h->Fill(cl->GetMax().GetRow(),cl->GetMax().GetPad(),cl->GetADCcluster()); return kTRUE; } //_____________________________________________________________________ TH3F* AliTPCCalibKr::GetHistoKr(Int_t chamber) const { // get histograms from fHistoKrArray return (TH3F*) fHistoKrArray.At(chamber); } //_____________________________________________________________________ Bool_t AliTPCCalibKr::Terminate() { // // store AliTPCCalibKr in the output file // if(bOutputHisto) { TFile *outFile = new TFile("outHistFile.root","RECREATE"); if(outFile) { outFile->cd(); for(int i=0; i<72; ++i) { if( IsCSide(i) == kTRUE && bCSide == kTRUE) printf("C side chamber: %d, 3D histo entries: %10.f \n",i,((TH3F*)fHistoKrArray.At(i))->GetEntries()); if( IsCSide(i) == kFALSE && bASide == kTRUE) printf("A side chamber: %d, 3D histo entries: %10.f \n",i,((TH3F*)fHistoKrArray.At(i))->GetEntries()); } this->Write(); outFile->Close(); return kTRUE; } else return kFALSE; } return kFALSE; } //_____________________________________________________________________ void AliTPCCalibKr::Analyse() { // // analyse the histograms and extract krypton calibration parameters // // AliTPCCalPads that will contain the calibration parameters AliTPCCalPad* spectrMeanCalPad = new AliTPCCalPad("spectrMean", "spectrMean"); AliTPCCalPad* spectrRMSCalPad = new AliTPCCalPad("spectrRMS", "spectrRMS"); AliTPCCalPad* fitMeanCalPad = new AliTPCCalPad("fitMean", "fitMean"); AliTPCCalPad* fitRMSCalPad = new AliTPCCalPad("fitRMS", "fitRMS"); AliTPCCalPad* fitNormChi2CalPad = new AliTPCCalPad("fitNormChi2", "fitNormChi2"); AliTPCCalPad* entriesCalPad = new AliTPCCalPad("entries", "entries"); // file stream for debugging purposes TTreeSRedirector* debugStream = new TTreeSRedirector("debugCalibKr.root"); // if entries in spectrum less than minEntries, then the fit won't be performed Int_t minEntries = 1; //300; Double_t windowFrac = 0.12; // the 3d histogram will be projected on the pads given by the following window size // set the numbers to 0 if you want to do a pad-by-pad calibration UInt_t rowRadius = 5; UInt_t padRadius = 10; // the step size by which pad and row are incremented is given by the following numbers // set them to 1 if you want the finest granularity UInt_t rowStep = 1; // formerly: 2*rowRadius UInt_t padStep = 1; // formerly: 2*padRadius for (Int_t chamber = 0; chamber < 72; chamber++) { //if (chamber != 71) continue; AliTPCCalROC roc(chamber); // I need this only for GetNrows() and GetNPads() // Usually I would traverse each pad, take the spectrum for its neighbourhood and // obtain the calibration parameters. This takes very long, so instead I assign the same // calibration values to the whole neighbourhood and then go on to the next neighbourhood. UInt_t nRows = roc.GetNrows(); for (UInt_t iRow = 0; iRow < nRows; iRow += rowStep) { UInt_t nPads = roc.GetNPads(iRow); //if (iRow >= 10) break; for (UInt_t iPad = 0; iPad < nPads; iPad += padStep) { //if (iPad >= 20) break; TH3F* h = GetHistoKr(chamber); if (!h) continue; // the 3d histogram will be projected on the pads given by the following bounds // for rows and pads Int_t rowLow = iRow - rowRadius; UInt_t rowUp = iRow + rowRadius; Int_t padLow = iPad - padRadius; UInt_t padUp = iPad + padRadius; // if window goes out of chamber if (rowLow < 0) rowLow = 0; if (rowUp >= nRows) rowUp = nRows - 1; if (padLow < 0) padLow = 0; if (padUp >= nPads) padUp = nPads - 1; // project the histogram //TH1D* projH = h->ProjectionZ("projH", rowLow, rowUp, padLow, padUp); // SLOW TH1D* projH = ProjectHisto(h, "projH", rowLow, rowUp, padLow, padUp); // get the number of entries in the spectrum Double_t entries = projH->GetEntries(); if (entries < minEntries) { delete projH; continue; } // get the two calibration parameters mean of spectrum and RMS of spectrum Double_t histMean = projH->GetMean(); Double_t histRMS = (histMean != 0) ? projH->GetRMS() / histMean : 0.; // find maximum in spectrum to define a range (given by windowFrac) for which a Gauss is fitted Double_t maxEntries = projH->GetBinCenter(projH->GetMaximumBin()); Int_t fitResult = projH->Fit("gaus", "Q0", "", (1.-windowFrac) * maxEntries, (1.+windowFrac) * maxEntries); if (fitResult != 0) { Error("Analyse", "Error while fitting spectrum for chamber %i, rows %i - %i, pads %i - %i.", chamber, rowLow, rowUp, padLow, padUp); delete projH; continue; } // get the two calibration parameters mean of gauss fit and sigma of gauss fit TF1* gausFit = projH->GetFunction("gaus"); Double_t fitMean = gausFit->GetParameter(1); Double_t fitRMS = gausFit->GetParameter(2); Int_t numberFitPoints = gausFit->GetNumberFitPoints(); if (numberFitPoints == 0) continue; Double_t fitNormChi2 = gausFit->GetChisquare() / numberFitPoints; delete gausFit; delete projH; if (fitMean <= 0) continue; printf("[ch%i r%i, p%i] entries = %f, maxEntries = %f, fitMean = %f, fitRMS = %f\n", chamber, iRow, iPad, entries, maxEntries, fitMean, fitRMS); // write the calibration parameters for each pad that the 3d histogram was projected onto // (with considering the step size) to the CalPads // rowStep (padStep) odd: round down s/2 and fill this # of rows (pads) in both directions // rowStep (padStep) even: fill s/2 rows (pads) in ascending direction, s/2-1 in descending direction for (Int_t r = iRow - (rowStep/2 - (rowStep+1)%2); r <= (Int_t)(iRow + rowStep/2); r++) { if (r < 0 || r >= (Int_t)nRows) continue; UInt_t nPads = roc.GetNPads(r); for (Int_t p = iPad - (padStep/2 - (padStep+1)%2); p <= (Int_t)(iPad + padStep/2); p++) { if (p < 0 || p >= (Int_t)nPads) continue; spectrMeanCalPad->GetCalROC(chamber)->SetValue(r, p, histMean); spectrRMSCalPad->GetCalROC(chamber)->SetValue(r, p, histRMS); fitMeanCalPad->GetCalROC(chamber)->SetValue(r, p, fitMean); fitRMSCalPad->GetCalROC(chamber)->SetValue(r, p, fitRMS); fitNormChi2CalPad->GetCalROC(chamber)->SetValue(r, p, fitNormChi2); entriesCalPad->GetCalROC(chamber)->SetValue(r, p, entries); (*debugStream) << "calibKr" << "sector=" << chamber << // chamber number "row=" << r << // row number "pad=" << p << // pad number "histMean=" << histMean << // mean of the spectrum "histRMS=" << histRMS << // RMS of the spectrum divided by the mean "fitMean=" << fitMean << // Gauss fitted mean of the 41.6 keV Kr peak "fitRMS=" << fitRMS << // Gauss fitted sigma of the 41.6 keV Kr peak "fitNormChi2" << fitNormChi2 << // normalized chi square of the Gauss fit "entries=" << entries << // number of entries for the spectrum "\n"; } } } } } TFile f("calibKr.root", "recreate"); spectrMeanCalPad->Write(); spectrRMSCalPad->Write(); fitMeanCalPad->Write(); fitRMSCalPad->Write(); fitNormChi2CalPad->Write(); entriesCalPad->Write(); f.Close(); delete spectrMeanCalPad; delete spectrRMSCalPad; delete fitMeanCalPad; delete fitRMSCalPad; delete fitNormChi2CalPad; delete entriesCalPad; delete debugStream; } //_____________________________________________________________________ TH1D* AliTPCCalibKr::ProjectHisto(TH3F* histo3D, const char* name, Int_t xMin, Int_t xMax, Int_t yMin, Int_t yMax) { // project the z-axis of a 3d histo to a specific range of the x- and y-axes, // replaces TH3F::ProjectZ() to gain more speed TAxis* xAxis = histo3D->GetXaxis(); TAxis* yAxis = histo3D->GetYaxis(); TAxis* zAxis = histo3D->GetZaxis(); Double_t zMinVal = zAxis->GetXmin(); Double_t zMaxVal = zAxis->GetXmax(); Int_t nBinsZ = zAxis->GetNbins(); TH1D* projH = new TH1D(name, name, nBinsZ, zMinVal, zMaxVal); Int_t nx = xAxis->GetNbins()+2; Int_t ny = yAxis->GetNbins()+2; Int_t bin = 0; Double_t entries = 0.; for (Int_t x = xMin; x <= xMax; x++) { for (Int_t y = yMin; y <= yMax; y++) { for (Int_t z = 0; z <= nBinsZ+1; z++) { bin = x + nx * (y + ny * z); Double_t val = histo3D->GetBinContent(bin); projH->Fill(zAxis->GetBinCenter(z), val); entries += val; } } } projH->SetEntries((Long64_t)entries); return projH; }