/* ======================================================================== *\ ! ! * ! * This file is part of MARS, the MAGIC Analysis and Reconstruction ! * Software. It is distributed to you in the hope that it can be a useful ! * and timesaving tool in analysing Data of imaging Cerenkov telescopes. ! * It is distributed WITHOUT ANY WARRANTY. ! * ! * Permission to use, copy, modify and distribute this software and its ! * documentation for any purpose is hereby granted without fee, ! * provided that the above copyright notice appear in all copies and ! * that both that copyright notice and this permission notice appear ! * in supporting documentation. It is provided "as is" without express ! * or implied warranty. ! * ! ! ! Author(s): Markus Gaug 02/2004 ! ! Copyright: MAGIC Software Development, 2000-2004 ! ! \* ======================================================================== */ ///////////////////////////////////////////////////////////////////////////// // // MHCalibrationChargeCam // // Fills the extracted signals of MExtractedSignalCam into the MH-classes: // // MHCalibrationChargeHiGainPix, MHCalibrationChargeLoGainPix for each pixel // and additionally for an average of the inner and the outer pixels, respectively. // // By default, subsequently the hi-gain classes are treated unless // more than fNumHiGainSaturationLimit (default: 1%) of the overall FADC // slices show saturation. In that case, the low-gain classes are treated. // If more than fNumLoGainSaturationLimit (default: 1%) of the overall // low-gain FADC slices saturate, the pixel is declared not valid and no further // treatment is pursued. // // The filled histograms are fitted to a Gaussian and the mean and sigma with // its errors and the fit probability are extracted. If none of these values are // NaN's and if the probability is bigger than fProbLimit (default: 0.5%), the fit // is declared valid. Otherwise, the fit is repeated within ranges of the previous mean // +- 5 sigma. In case that this does not help, the histogram means and RMS's are taken directly, // but the flag kFitValid is set to FALSE. Outliers of more than fPickUpLimit (default: 5) sigmas // from the mean are counted as PickUp events. // // Additionally, the slice number with the highest value is stored and a corresponding // histogram is filled. This histogram serves only for a rough cross-check if the // signal does not lie at the edges of chose extraction window. // // The class also fills arrays with the signal vs. event number, creates a fourier // spectrum out of it and investigates if the projected frequencies follow an exponential // distribution. In case that the probability of the exponential fit is less than // fProbLimit, the pixel is declared HiGainOscillating or LoGainOscillating, respectively. // // The results are written into MCalibrationChargeCam. // ///////////////////////////////////////////////////////////////////////////// #include "MHCalibrationChargeCam.h" #include #include #include #include "MLog.h" #include "MLogManip.h" #include "MParList.h" #include "MHCalibrationChargeHiGainPix.h" #include "MHCalibrationChargeLoGainPix.h" #include "MHCalibrationChargePix.h" #include "MCalibrationChargeCam.h" #include "MCalibrationChargePix.h" #include "MGeomCam.h" #include "MGeomPix.h" #include "MBadPixelsCam.h" #include "MBadPixelsPix.h" #include "MRawEvtData.h" #include "MRawEvtPixelIter.h" #include "MExtractedSignalCam.h" #include "MExtractedSignalPix.h" ClassImp(MHCalibrationChargeCam); using namespace std; const Float_t MHCalibrationChargeCam::fgNumHiGainSaturationLimit = 0.005; const Float_t MHCalibrationChargeCam::fgNumLoGainSaturationLimit = 0.005; // // // MHCalibrationChargeCam::MHCalibrationChargeCam(const char *name, const char *title) : fRawEvt(NULL), fGeom(NULL), fBadPixels(NULL) { fName = name ? name : "MHCalibrationChargeCam"; fTitle = title ? title : "Class to fill the calibration histograms "; fHiGainArray = new TObjArray; fHiGainArray->SetOwner(); fLoGainArray = new TObjArray; fLoGainArray->SetOwner(); fAverageHiGainInnerPix = new MHCalibrationChargeHiGainPix("AverageHiGainInnerPix","Average HiGain FADC sums of inner pixels"); fAverageLoGainInnerPix = new MHCalibrationChargeLoGainPix("AverageLoGainInnerPix","Average LoGain FADC sums of inner pixels"); fAverageHiGainOuterPix = new MHCalibrationChargeHiGainPix("AverageHiGainOuterPix","Average HiGain FADC sums of outer pixels"); fAverageLoGainOuterPix = new MHCalibrationChargeLoGainPix("AverageLoGainOuterPix","Average LoGain FADC sums of outer pixels"); /* fAverageHiGainInnerPix->GetHGausHist()->SetName("HCalibrationChargeAverageInnerHiGainPix"); fAverageHiGainOuterPix->GetHGausHist()->SetName("HCalibrationChargeAverageOuterHiGainPix"); fAverageLoGainInnerPix->GetHGausHist()->SetName("HCalibrationChargeAverageInnerLoGainPix"); fAverageLoGainOuterPix->GetHGausHist()->SetName("HCalibrationChargeAverageOuterLoGainPix"); */ fAverageHiGainInnerPix->GetHGausHist()->SetTitle("Summed FADC slices average Inner pixels HiGain"); fAverageLoGainInnerPix->GetHGausHist()->SetTitle("Summed FADC slices average Inner pixels LoGain"); fAverageHiGainOuterPix->GetHGausHist()->SetTitle("Summed FADC slices average Outer pixels HiGain"); fAverageLoGainOuterPix->GetHGausHist()->SetTitle("Summed FADC slices average Outer pixels LoGain"); fAverageHiGainInnerPix->GetHAbsTime()->SetTitle("Absolute Arrival Time average Inner pixels HiGain"); fAverageLoGainInnerPix->GetHAbsTime()->SetTitle("Absolute Arrival Time average Inner pixels LoGain"); fAverageHiGainOuterPix->GetHAbsTime()->SetTitle("Absolute Arrival Time average Outer pixels HiGain"); fAverageLoGainOuterPix->GetHAbsTime()->SetTitle("Absolute Arrival Time average Outer pixels LoGain"); fAverageHiGainInnerPix->SetChargeFirst(-1000.); fAverageHiGainOuterPix->SetChargeFirst(-1000.); fAverageHiGainInnerPix->SetChargeLast(4000.); fAverageLoGainInnerPix->SetChargeLast(4000.); fAverageHiGainOuterPix->SetChargeLast(4000.); fAverageLoGainOuterPix->SetChargeLast(4000.); fAverageHiGainInnerPix->SetChargeNbins(4000); fAverageLoGainInnerPix->SetChargeNbins(4000); fAverageHiGainOuterPix->SetChargeNbins(4000); fAverageLoGainOuterPix->SetChargeNbins(4000); SetNumHiGainSaturationLimit(); SetNumLoGainSaturationLimit(); fNumInnerPixels = 0; fNumOuterPixels = 0; fNumExcluded = 0; } // -------------------------------------------------------------------------- // // Delete the TClonesArray of MHCalibrationChargePix containers // Delete the MHCalibrationPINDiode and the MHCalibrationBlindPix // // Delete the histograms if they exist // MHCalibrationChargeCam::~MHCalibrationChargeCam() { delete fHiGainArray; delete fLoGainArray; delete fAverageHiGainInnerPix; delete fAverageLoGainInnerPix; delete fAverageHiGainOuterPix; delete fAverageLoGainOuterPix; } // -------------------------------------------------------------------------- // // Get i-th pixel (pixel number) // MHCalibrationChargeHiGainPix &MHCalibrationChargeCam::operator[](UInt_t i) { return *static_cast(fHiGainArray->UncheckedAt(i)); } // -------------------------------------------------------------------------- // // Get i-th pixel (pixel number) // const MHCalibrationChargeHiGainPix &MHCalibrationChargeCam::operator[](UInt_t i) const { return *static_cast(fHiGainArray->UncheckedAt(i)); } // -------------------------------------------------------------------------- // // Get i-th pixel (pixel number) // MHCalibrationChargeLoGainPix &MHCalibrationChargeCam::operator()(UInt_t i) { return *static_cast(fLoGainArray->UncheckedAt(i)); } // -------------------------------------------------------------------------- // // Get i-th pixel (pixel number) // const MHCalibrationChargeLoGainPix &MHCalibrationChargeCam::operator()(UInt_t i) const { return *static_cast(fLoGainArray->UncheckedAt(i)); } #if 0 // -------------------------------------------------------------------------- // // Our own clone function is necessary since root 3.01/06 or Mars 0.4 // I don't know the reason // TObject *MHCalibrationChargeCam::Clone(const char *) const { const Int_t nhi = fHiGainArray->GetSize(); const Int_t nlo = fLoGainArray->GetSize(); // // FIXME, this might be done faster and more elegant, by direct copy. // MHCalibrationChargeCam *cam = (MHCalibrationChargeCam*)(this)->Clone(""); // MHCalibrationChargeCam cam; // Copy(*cam); /* cam->fHiGainArray->Delete(); cam->fLoGainArray->Delete(); cam->fHiGainArray->Expand(nhi); cam->fLoGainArray->Expand(nlo); for (int i=0; ifHiGainArray)[i]; (*cam->fHiGainArray)[i] = (*fHiGainArray)[i]->Clone(); } for (int i=0; ifLoGainArray)[i]; (*cam->fLoGainArray)[i] = (*fLoGainArray)[i]->Clone(); } */ /* delete cam->fAverageHiGainInnerPix; delete cam->fAverageLoGainInnerPix; delete cam->fAverageHiGainOuterPix; delete cam->fAverageLoGainOuterPix; cam->GetAverageHiGainInnerPix() = *(MHCalibrationChargeHiGainPix*)fAverageHiGainInnerPix->Clone(); cam->GetAverageLoGainInnerPix() = *(MHCalibrationChargeLoGainPix*)fAverageLoGainInnerPix->Clone(); cam->GetAverageHiGainOuterPix() = *(MHCalibrationChargeHiGainPix*)fAverageHiGainOuterPix->Clone(); cam->GetAverageLoGainOuterPix() = *(MHCalibrationChargeLoGainPix*)fAverageLoGainOuterPix->Clone(); fAverageHiGainInnerPix->Copy(cam->GetAverageHiGainInnerPix()); fAverageLoGainInnerPix->Copy(cam->GetAverageLoGainInnerPix()); fAverageHiGainOuterPix->Copy(cam->GetAverageHiGainOuterPix()); fAverageLoGainOuterPix->Copy(cam->GetAverageLoGainOuterPix()); */ return cam; } #endif // -------------------------------------------------------------------------- // // To setup the object we get the number of pixels from a MGeomCam object // in the Parameter list. // Bool_t MHCalibrationChargeCam::SetupFill(const MParList *pList) { fRawEvt = (MRawEvtData*)pList->FindObject("MRawEvtData"); if (!fRawEvt) { *fLog << err << dbginf << "MRawEvtData not found... aborting." << endl; return kFALSE; } fGeom = (MGeomCam*)pList->FindObject("MGeomCam"); if (!fGeom) { *fLog << err << "MGeomCam not found... aborting." << endl; return kFALSE; } fHiGainArray->Delete(); fLoGainArray->Delete(); fAverageHiGainInnerPix->Init(); fAverageLoGainInnerPix->Init(); fAverageHiGainOuterPix->Init(); fAverageLoGainOuterPix->Init(); return kTRUE; } Bool_t MHCalibrationChargeCam::ReInit(MParList *pList) { fBadPixels = (MBadPixelsCam*)pList->FindCreateObj("MBadPixelsCam"); if (!fBadPixels) return kFALSE; fCam = (MCalibrationChargeCam*)pList->FindCreateObj("MCalibrationChargeCam"); if (!fCam) return kFALSE; MExtractedSignalCam *signal = (MExtractedSignalCam*)pList->FindObject("MExtractedSignalCam"); if (!signal) { *fLog << err << "MExtractedSignalCam not found... abort." << endl; return kFALSE; } const Int_t n = signal->GetSize(); if (fHiGainArray->GetEntries()==0) { fHiGainArray->Expand(n); for (Int_t i=0; iGetEntries()==0) { fLoGainArray->Expand(n); for (Int_t i=0; iGetSize(); Int_t lofirst = signal->GetFirstUsedSliceLoGain(); if (fHiGainArray->GetEntries() != n) { *fLog << err << "ERROR - Size mismatch... abort." << endl; return kFALSE; } if (fLoGainArray->GetEntries() != n) { *fLog << err << "ERROR - Size mismatch... abort." << endl; return kFALSE; } // // First the extracted signal // Float_t sumhiinnertot = 0.; Float_t sumloinnertot = 0.; Float_t sumhioutertot = 0.; Float_t sumlooutertot = 0.; Int_t sumhiinnersat = 0; Int_t sumloinnersat = 0; Int_t sumhioutersat = 0; Int_t sumlooutersat = 0; fNumInnerPixels = fNumOuterPixels = 0; for (int i=0; iGetPixRatio(i) == 1.) { sumhiinnertot += sumhi; sumloinnertot += sumlo; sumhiinnersat += sathi; sumloinnersat += satlo; fNumInnerPixels++; } else { sumhioutertot += sumhi; sumlooutertot += sumlo; sumhioutersat += sathi; sumlooutersat += satlo; fNumOuterPixels++; } } fAverageHiGainInnerPix->FillHistAndArray(sumhiinnertot/fNumInnerPixels); fAverageLoGainInnerPix->FillHistAndArray(sumloinnertot/fNumInnerPixels); fAverageHiGainOuterPix->FillHistAndArray(sumhioutertot/fNumOuterPixels); fAverageLoGainOuterPix->FillHistAndArray(sumlooutertot/fNumOuterPixels); fAverageHiGainInnerPix->SetSaturated((Float_t)sumhiinnersat/fNumInnerPixels); fAverageLoGainInnerPix->SetSaturated((Float_t)sumloinnersat/fNumInnerPixels); fAverageHiGainOuterPix->SetSaturated((Float_t)sumhioutersat/fNumOuterPixels); fAverageLoGainOuterPix->SetSaturated((Float_t)sumlooutersat/fNumOuterPixels); // // Now the times // sumhiinnertot = sumloinnertot = sumhioutertot = sumlooutertot = 0.; fNumInnerPixels = fNumOuterPixels = 0; MRawEvtPixelIter pixel(fRawEvt); while (pixel.Next()) { const UInt_t pixid = pixel.GetPixelId(); if ((*this)[pixid].IsExcluded()) continue; const Float_t timehi = (Float_t)pixel.GetIdxMaxHiGainSample(); const Float_t timelo = (Float_t)pixel.GetIdxMaxLoGainSample(lofirst); (*this)[pixid].FillAbsTime(timehi); (*this)(pixid).FillAbsTime(timelo); if (fGeom->GetPixRatio(pixel.GetPixelId()) == 1.) { sumhiinnertot += timehi; sumloinnertot += timelo; fNumInnerPixels++; } else { sumhioutertot += timehi; sumlooutertot += timelo; fNumOuterPixels++; } } fAverageHiGainInnerPix-> FillAbsTime(sumhiinnertot/fNumInnerPixels); fAverageLoGainInnerPix-> FillAbsTime(sumloinnertot/fNumInnerPixels); fAverageHiGainOuterPix-> FillAbsTime(sumhioutertot/fNumOuterPixels); fAverageLoGainOuterPix-> FillAbsTime(sumlooutertot/fNumOuterPixels); return kTRUE; } // -------------------------------------------------------------------------- // // 1) Return if the charge distribution is already succesfully fitted // or if the histogram is empty // 2) Fit the histograms with a Gaussian // 3) In case of failure set the bit kFitted to false and take histogram means and RMS // 4) Check for pickup noise // 5) Check the fourier spectrum // 5) Retrieve the results and store them in this class // Bool_t MHCalibrationChargeCam::Finalize() { for (int i=0; iGetSize(); i++) { MCalibrationChargePix &pix = (*fCam)[i]; MHCalibrationChargeHiGainPix &histhi = (*this)[i]; MBadPixelsPix &bad = (*fBadPixels)[i]; FinalizeHiGainHists(histhi,pix,bad); } for (int i=0; iGetSize(); i++) { if ((*this)(i).IsExcluded()) continue; MHCalibrationChargeLoGainPix &histlo = (*this)(i); MCalibrationChargePix &pix = (*fCam)[i]; MBadPixelsPix &bad = (*fBadPixels)[i]; FinalizeLoGainHists(histlo,pix,bad); } FinalizeHiGainHists(*fAverageHiGainInnerPix,*fCam->GetAverageInnerPix(),*fCam->GetAverageInnerBadPix()); FinalizeLoGainHists(*fAverageLoGainInnerPix,*fCam->GetAverageInnerPix(),*fCam->GetAverageInnerBadPix()); FinalizeHiGainHists(*fAverageHiGainOuterPix,*fCam->GetAverageOuterPix(),*fCam->GetAverageOuterBadPix()); FinalizeLoGainHists(*fAverageLoGainOuterPix,*fCam->GetAverageOuterPix(),*fCam->GetAverageOuterBadPix()); fCam->GetAverageInnerPix()->SetSigmaCharge (fCam->GetAverageInnerPix()->GetSigmaCharge() *TMath::Sqrt((Float_t)fNumInnerPixels)); fCam->GetAverageOuterPix()->SetSigmaCharge (fCam->GetAverageOuterPix()->GetSigmaCharge() *TMath::Sqrt((Float_t)fNumOuterPixels)); fCam->GetAverageInnerPix()->SetSigmaChargeErr(fCam->GetAverageInnerPix()->GetSigmaChargeErr() *TMath::Sqrt((Float_t)fNumInnerPixels)); fCam->GetAverageOuterPix()->SetSigmaChargeErr(fCam->GetAverageOuterPix()->GetSigmaChargeErr() *TMath::Sqrt((Float_t)fNumOuterPixels)); return kTRUE; } void MHCalibrationChargeCam::FinalizeHiGainHists(MHCalibrationChargeHiGainPix &hist, MCalibrationChargePix &pix, MBadPixelsPix &bad) { if (hist.IsEmpty()) { bad.SetUnsuitable(MBadPixelsPix::kUnsuitableRun); return; } if (hist.GetSaturated() > fNumHiGainSaturationLimit*hist.GetHGausHist()->GetEntries()) { pix.SetHiGainSaturation(); bad.SetHiGainSaturation(); return; } // // 2) Fit the Hi Gain histograms with a Gaussian // pix.SetHiGainFitted(); if (!hist.FitGaus()) // // 3) In case of failure set the bit Fitted to false and take histogram means and RMS // if (!hist.RepeatFit()) { hist.BypassFit(); pix.SetHiGainFitted(kFALSE); bad.SetHiGainNotFitted(); bad.SetUnsuitable(MBadPixelsPix::kUnreliableRun); } else pix.SetHiGainFitted(); // // 4) Check for pickup // hist.CountPickup(); // // 5) Check for oscillations // hist.CreateFourierSpectrum(); // // 6) Retrieve the results and store them in this class // pix.SetHiGainMeanCharge( hist.GetMean() ); pix.SetHiGainMeanChargeErr( hist.GetMeanErr() ); pix.SetHiGainSigmaCharge( hist.GetSigma() ); pix.SetHiGainSigmaChargeErr( hist.GetSigmaErr() ); pix.SetHiGainChargeProb ( hist.GetProb() ); pix.SetAbsTimeMean ( hist.GetAbsTimeMean()); pix.SetAbsTimeRms ( hist.GetAbsTimeRms() ); pix.SetHiGainNumPickup ( hist.GetPickup() ); if (!hist.IsFourierSpectrumOK()) { bad.SetHiGainOscillating(); bad.SetUnsuitable(MBadPixelsPix::kUnreliableRun); } } void MHCalibrationChargeCam::FinalizeLoGainHists(MHCalibrationChargeLoGainPix &hist, MCalibrationChargePix &pix, MBadPixelsPix &bad) { if (hist.IsEmpty()) { if (pix.IsHiGainSaturation()) bad.SetUnsuitable(MBadPixelsPix::kUnsuitableRun); return; } if (hist.GetSaturated() > fNumLoGainSaturationLimit*hist.GetHGausHist()->GetEntries()) { pix.SetLoGainSaturation(); bad.SetLoGainSaturation(); bad.SetUnsuitable(MBadPixelsPix::kUnsuitableRun); return; } // // 2) Fit the Lo Gain histograms with a Gaussian // pix.SetLoGainFitted(); if (!hist.FitGaus()) // // 3) In case of failure set the bit kFitted to false and take histogram means and RMS // if (!hist.RepeatFit()) { hist.BypassFit(); pix.SetLoGainFitted(kFALSE); bad.SetLoGainNotFitted(); if (pix.IsHiGainSaturation()) bad.SetUnsuitable(MBadPixelsPix::kUnreliableRun); } // // 4) Check for pickup // hist.CountPickup(); // // 5) Check for oscillations // hist.CreateFourierSpectrum(); // // 6) Retrieve the results and store them in this class // pix.SetLoGainMeanCharge( hist.GetMean() ); pix.SetLoGainMeanChargeErr( hist.GetMeanErr() ); pix.SetLoGainSigmaCharge( hist.GetSigma() ); pix.SetLoGainSigmaChargeErr( hist.GetSigmaErr() ); pix.SetLoGainChargeProb ( hist.GetProb() ); if (pix.IsHiGainSaturation()) { pix.SetAbsTimeMean ( hist.GetAbsTimeMean()); pix.SetAbsTimeRms ( hist.GetAbsTimeRms() ); } pix.SetLoGainNumPickup ( hist.GetPickup() ); if (!hist.IsFourierSpectrumOK()) { bad.SetLoGainOscillating(); if (pix.IsHiGainSaturation()) bad.SetUnsuitable(MBadPixelsPix::kUnreliableRun); } } Bool_t MHCalibrationChargeCam::GetPixelContent(Double_t &val, Int_t idx, const MGeomCam &cam, Int_t type) const { return kTRUE; } // -------------------------------------------------------------------------- // // What MHCamera needs in order to draw an individual pixel in the camera // void MHCalibrationChargeCam::DrawPixelContent(Int_t idx) const { if (idx == -1) fAverageHiGainInnerPix->DrawClone(); if (idx == -2) fAverageHiGainOuterPix->DrawClone(); if (idx == -3) fAverageLoGainInnerPix->DrawClone(); if (idx == -4) fAverageLoGainOuterPix->DrawClone(); (*this)[idx].DrawClone(); } void MHCalibrationChargeCam::Draw(const Option_t *opt) { TVirtualPad *pad = gPad ? gPad : MH::MakeDefCanvas(this); pad->SetBorderMode(0); pad->Divide(2,2); pad->cd(1); if (!fAverageHiGainInnerPix->IsEmpty()) gPad->SetLogy(); fAverageHiGainInnerPix->Draw(opt); pad->cd(2); if (!fAverageLoGainInnerPix->IsEmpty()) gPad->SetLogy(); fAverageLoGainInnerPix->Draw(opt); pad->cd(3); if (!fAverageHiGainOuterPix->IsEmpty()) gPad->SetLogy(); fAverageHiGainOuterPix->Draw(opt); pad->cd(4); if (!fAverageLoGainOuterPix->IsEmpty()) gPad->SetLogy(); fAverageLoGainOuterPix->Draw(opt); }