Documentation for portia module

1.0

Author:
Aya Ishihara <aya @ icecube.wisc.edu>

Overview

I3Portia filles classes of I3PortiaPulse and I3PortiaEvent

[What Portia does]
Portia loops over all the DOM launches and integrate ATWD and FADC waveform divided by a single charge. Output pulse information is stored in I3PortiaPulse class. I3PortiaPulse has a member of I3RecoPulse and basic information is filled in the class. Output NPEs from ATWD and FADC are compared dom-by-dom basis and whichever gives a larger value is summed up for the event-sum NPE value. These event-wise information is stored in I3PortiaEvent class. Main members are NPE from ATWD and FADC whichever gives larger value, ATWD based NPE sum, and FADC based NPE sum.

[Making the best pulse]
There is an option to make best pulse. The best pulse means that in addition to the ATWD based NPE, FADC based NPE obtaind after the ATWD time-window size is added. This is effective because ATWD time window is narrow but saturation point is high, while FADC time window is wide but saturation point is low.

If this option is chosen, the event-wise best NPE value is also calculated based on the sum of ATWD plus after-window FADC based NPEs.

[Baseline estimation]
PortiaBaseline3.png
Parameters:
 All the parameters are in the standard IceTray units with I3Units.
DataReadoutName: Input raw data I3DOMLaunch name (default CleanInIceRawData)
OutPortiaEventName: Out (default "PortiaEvent")
PMTGain: default PMT gain value (default 1.e7)
ATWDPulseSeriesName: Output name for reco pulse from ATWD (default "ATWDPulseSeries")
ATWDPortiaPulseName: Output name for portia pulse from ATWD (default "ATWDPortiaPulse")
ATWDWaveformName: Input calibrated ATWD waveform name (default "CalibratedATWD")
ATWDBaseLineOption: Baseline option, currently first,last,lower,first_or_last,iteration or eheoptimized are available (default "eheoptimized")
ATWDThresholdCharge: Threshold charge above which an waveform is considered to be a pulse(default 0.1pC)
ATWDLEThresholdAmplitude: the time the waveform crosses this value is considered to be LE time (default 0.5mV)
UseFADC: if both ATWD and FADC are used (default True)
FADCPulseSeriesName: Output name for reco pulse from FADC (default "FADCPulseSereis")
FADCPortiaPulseName: Output name for portia pulse from FADC (default "FADCPortiaPulse")
FADCWaveformName: Input calibrated FADC waveform name (default FADC)
FADCBaseLineOption: Baseline option, currently first,last,lower,first_or_last,iteration or eheoptimized are available (default "eheoptimized")
FADCThresholdCharge: Threshold charge above which an waveform is considered to be a pulse(default 0.1pC)
FADCLEThresholdAmplitude: the time the waveform crosses this value is considered to be LE time (default 0.5mV)
MakeBestPulseSeries: Select to do if best pulse is from both ATWD and FADC (default False)
BestPortiaPulseName: output best portia pulse in case MakeBestPulseSeries is true (default "BestPortiaPulse")
MakeIceTopPulse: Select to make IceTop pulses(default False)
TopDataReadoutName:IceTop DomLaunch name (default "CleanIceTopRawData")
inTopATWDWaveformName:Input IceTop waveform name (default "CalibratedIceTopATWD")

structure

PortiaDiagram.png

portia event class diagram


Generated on Fri Feb 22 13:29:40 2008 for Portia by  doxygen 1.4.7