Changeset 3639 for trunk/MagicSoft/Mars/mcalib/MHCalibrationChargeCam.cc

Timestamp:

04/04/04 14:28:25 (21 years ago)

Author:

gaug

Message:

*** empty log message ***

File:

• trunk/MagicSoft/Mars/mcalib/MHCalibrationChargeCam.cc (modified) (8 diffs)

trunk/MagicSoft/Mars/mcalib/MHCalibrationChargeCam.cc

@@ -29 +29 @@
 // MHCalibrationChargeHiGainPix and MHCalibrationChargeLoGainPix for every:
 //
-// - pixel, stored in the TObjArray's MHCalibrationCam::fHiGainArray and 
+// - Pixel, stored in the TObjArray's MHCalibrationCam::fHiGainArray and 
 //   MHCalibrationCam::fLoGainArray
 //
-// - average pixel per area index (e.g. inner and outer for the MAGIC camera), 
+// - Average pixel per AREA index (e.g. inner and outer for the MAGIC camera), 
 //   stored in the TObjArray's MHCalibrationCam::fAverageHiGainAreas and 
 //   MHCalibrationCam::fAverageLoGainAreas
 //
-// - average pixel per camera sector (e.g. sectors 1-6 for the MAGIC camera), 
+// - Average pixel per camera SECTOR (e.g. sectors 1-6 for the MAGIC camera), 
 //   stored in the TObjArray's MHCalibrationCam::fAverageHiGainSectors and 
 //   MHCalibrationCam::fAverageLoGainSectors
 // 
-// Every signal is filled into a Charge histogram and an array, in order to perform 
-// a Fourier analysis (see MHGausEvents). The signals are moreover averaged on an 
-// event-by-event basis and written into the corresponding average pixels
+// Every signal is taken from MExtractedSignalCam and filled into a histogram and 
+// an array, in order to perform a Fourier analysis (see MHGausEvents). 
+// The signals are moreover averaged on an event-by-event basis and written into 
+// the corresponding average pixels.
 //
 // Additionally, the (FADC slice) position of the maximum is stored in an Absolute 
@@ -50 +51 @@
 // The Charge histograms are fitted to a Gaussian, 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 valid.
-// Otherwise, the fit is repeated within ranges of the previous mean +- 5 sigma. 
+// if the probability is bigger than MHGausEvents::fProbLimit (default: 0.5%), 
+// the fit is declared valid.
+// Otherwise, the fit is repeated within ranges of the previous mean 
+// +- MHGausEvents::fPickupLimit (default: 5) sigma (see MHGausEvents::RepeatFit())
 // In case this does not make the fit valid, the histogram means and RMS's are 
-// taken directly and the following flags are set:
+// taken directly (see MHGausEvents::BypassFit()) and the following flags are set:
 // - MBadPixelsPix::SetUncalibrated( MBadPixelsPix::kHiGainNotFitted ) or  
 // - MBadPixelsPix::SetUncalibrated( MBadPixelsPix::kLoGainNotFitted ) and 
 // - MBadPixelsPix::SetUnsuitable(   MBadPixelsPix::kUnreliableRun   ) 
 // 
-// Outliers of more than MHCalibrationChargePix::fPickupLimit (default: 5) sigmas 
-// from the mean are counted as PickUp events (stored in MHCalibrationChargePix::fPickup) 
+// Outliers of more than MHGausEvents::fPickupLimit (default: 5) sigmas 
+// from the mean are counted as Pickup events (stored in MHGausEvents::fPickup) 
 //
 // Unless more than fNumHiGainSaturationLimit (default: 1%) of the overall FADC 
@@ -74 +77 @@
 // spectrum and investigates if the projected fourier components follow an exponential 
 // distribution. In case that the probability of the exponential fit is less than 
-// fProbLimit (default: 0.5%), the following flags are set:
+// MHGausEvents::fProbLimit (default: 0.5%), the following flags are set:
 // - MBadPixelsPix::SetUncalibrated( MBadPixelsPix::kHiGainOscillating ) or
 // - MBadPixelsPix::SetUncalibrated( MBadPixelsPix::kLoGainOscillating ) and
@@ -83 +86 @@
 // The following results are written into MCalibrationChargeCam:
 //
-// - MCalibrationChargePix::SetHiGainSaturation(Bool_t b) 
-// - MCalibrationChargePix::SetHiGainMeanCharge()
-// - MCalibrationChargePix::SetHiGainMeanChargeErr()
-// - MCalibrationChargePix::SetHiGainSigmaCharge()
-// - MCalibrationChargePix::SetHiGainSigmaChargeErr()
-// - MCalibrationChargePix::SetHiGainChargeProb()
-// - MCalibrationChargePix::SetHiGainNumPickup()
-//
-// - MCalibrationChargePix::SetLoGainMeanCharge()
-// - MCalibrationChargePix::SetLoGainMeanChargeErr()
-// - MCalibrationChargePix::SetLoGainSigmaCharge()
-// - MCalibrationChargePix::SetLoGainSigmaChargeErr()
-// - MCalibrationChargePix::SetLoGainChargeProb()
-// - MCalibrationChargePix::SetLoGainNumPickup()
+// - MCalibrationPix::SetHiGainSaturation() 
+// - MCalibrationPix::SetHiGainMean()
+// - MCalibrationPix::SetHiGainMeanErr()
+// - MCalibrationPix::SetHiGainSigma()
+// - MCalibrationPix::SetHiGainSigmaErr()
+// - MCalibrationPix::SetHiGainProb()
+// - MCalibrationPix::SetHiGainNumPickup()
+//
+// - MCalibrationPix::SetLoGainMean()
+// - MCalibrationPix::SetLoGainMeanErr()
+// - MCalibrationPix::SetLoGainSigma()
+// - MCalibrationPix::SetLoGainSigmaErr()
+// - MCalibrationPix::SetLoGainProb()
+// - MCalibrationPix::SetLoGainNumPickup()
 //
 // - MCalibrationChargePix::SetAbsTimeMean()
 // - MCalibrationChargePix::SetAbsTimeRms()
-//
-// The last two items are filled with the Hi-Gain or Lo-Gain result, depending on 
-// the saturation status. 
 //
 // For all averaged areas, the fitted sigma is multiplied with the square root of 
@@ -191 +191 @@
 // - MExtractedSignalCam
 //
-// Calls InitializeHists() for every entry in:
+// Initializes, if empty to MGeomCam::GetNumPixels():
+// - MHCalibrationCam::fHiGainArray, MHCalibrationCam::fLoGainArray
+//
+// Initializes, if empty to MGeomCam::GetNumAreas() for:
+// - MHCalibrationCam::fAverageHiGainAreas, MHCalibrationCam::fAverageLoGainAreas
+//
+// Initializes, if empty to MGeomCam::GetNumSectors() for:
+// - MHCalibrationCam::fAverageHiGainSectors, MHCalibrationCam::fAverageLoGainSectors
+//
+// Calls MHCalibrationCam::InitHists() for every entry in:
 // - MHCalibrationCam::fHiGainArray, MHCalibrationCam::fLoGainArray
 // - MHCalibrationCam::fAverageHiGainAreas, MHCalibrationCam::fAverageLoGainAreas
 // - MHCalibrationCam::fAverageHiGainSectors, MHCalibrationCam::fAverageLoGainSectors
 //
-// Sets Titles and Names for the Charge Histograms and 
+// Sets Titles and Names for the Charge Histograms:
+// - MHCalibrationCam::fAverageHiGainAreas
+// - MHCalibrationCam::fAverageHiGainSectors
+// 
 // Sets number of bins to MHCalibrationCam::fAverageNbins for:
 // - MHCalibrationCam::fAverageHiGainAreas, MHCalibrationCam::fAverageLoGainAreas
@@ -502 +514 @@
 //    otherwise the Hi-Gain ones.
 // 4) Calls to MHCalibrationCam::FitHiGainArrays() and MCalibrationCam::FitLoGainArrays() 
-//    and sets the flags (if  occurring):
+//    with the flags:
 //    - MBadPixelsPix::SetUncalibrated( MBadPixelsPix::kHiGainNotFitted )
 //    - MBadPixelsPix::SetUncalibrated( MBadPixelsPix::kLoGainNotFitted )
 //    - MBadPixelsPix::SetUncalibrated( MBadPixelsPix::kHiGainOscillating )
 //    - MBadPixelsPix::SetUncalibrated( MBadPixelsPix::kLoGainOscillating )
-// 5) Retrieves the results and store them in MCalibrationChargePix
 //
 Bool_t MHCalibrationChargeCam::FinalizeHists()
@@ -652 +663 @@
 // --------------------------------------------------------------------------
 //
-// Takes the decisions under which conditions a pixel is declared:
-// MBadPixelsPix::kUnsuitableRun  or MBadPixelsPix::kUnreliableRun, namely:
-// * if MBadPixelsPix::kHiGainNotFitted   and !MCalibrationPix::IsHiGainSaturation()
-//   sets MBadPixelsPix::kUnreliableRun 
-// * if MBadPixelsPix::kHiGainOscillating and !MCalibrationPix::IsHiGainSaturation()
-//   sets MBadPixelsPix::kUnreliableRun 
-// * if MBadPixelsPix::kLoGainNotFitted   and  MCalibrationPix::IsLoGainSaturation()
-//   sets MBadPixelsPix::kUnreliableRun 
-// * if MBadPixelsPix::kLoGainOscillating and  MCalibrationPix::IsLoGainSaturation()
-//   sets MBadPixelsPix::kUnreliableRun 
-// * if MBadPixelsPix::kLoGainSaturation
-//   sets MBadPixelsPix::kUnsuitableRun 
+// Sets all pixels to MBadPixelsPix::kUnsuitableRun, if following flags are set:
+// - MBadPixelsPix::kLoGainSaturation
+//
+// Sets all pixels to MBadPixelsPix::kUnreliableRun, if following flags are set:
+// - if MBadPixelsPix::kHiGainNotFitted   and !MCalibrationPix::IsHiGainSaturation()
+// - if MBadPixelsPix::kHiGainOscillating and !MCalibrationPix::IsHiGainSaturation()
+// - if MBadPixelsPix::kLoGainNotFitted   and  MCalibrationPix::IsLoGainSaturation()
+// - if MBadPixelsPix::kLoGainOscillating and  MCalibrationPix::IsLoGainSaturation()
 //
 void MHCalibrationChargeCam::FinalizeBadPixels()
@@ -705 +712 @@
 // --------------------------------------------------------------------------
 //
-// What MHCamera needs in order to draw an individual pixel in the camera
+// Calls MHGausEvents::DrawClone() for pixel idx
 //
 void MHCalibrationChargeCam::DrawPixelContent(Int_t idx) const