Types of Offline Calibrations
On the ground we run these types of offline calibration
- Pedestal. Use B/13 (non zero-suppressed) run or periodic/solicited triggers from flight mode runs.
- Caculate mean/rms of pedestal values. Check for skewness?
- HV on or off?
- Outlier rejection if HV on.
- How to treat NA tiles.
- MIP peak. Use any muon runs.
- Fit smooth curve to MIP peak.
- Select fit range avoid pathologies
- Select tracks near normal incidence.
- Correct for pathlength in the tiles. (This requires pedestal subrataction first).
- Veto turn-on. Use any muon runs.
- Estimate 50% point of veto turn on curve.
calibGenACD Package Executables and Options
The package calibGenACD has the following executable to run calibrations
- runPedestal.exe
- runMuonCalib_Roi.exe
- runMuonCalib_Tkr.exe
- runVetoCalib.exe
- runMeritCalib.exe
You can specify the input (not all jobs require all types of input files) and output files for all of these exectuable on the command line with these options:
- -d <digiFiles> : comma seperated list of digi ROOT files
- -r <reconFiles> : comma seperated list of recon ROOT files
- -m <meritFiles> : comma seperated list of merit ROOT files
- <output> : prefix (path/filename) to add to output files
In addition to this all these executable take the following options [defaultValues] :
- -h : print help message
- -c <configFile> : name of xml file with job configuration (see below)
-I <Instrument> : specify instument being calibrated, this is a tag in the output files [LAT]
-n <nEvents> : run over <nEvents> (0 for all events) [0]
-s <startEvent> : start with event <startEvent> [0]
Finally, if the calibration jobs requires other calibration files as input, these can be specified with the following options:
- -p <pedFile> : specify the file with the pedestals
- -g <gainFile> : specify the file with the gains (AKA mip peaks)
Xml job configuration file
The xml job configuration file should have the following format
<?xml version="1.0" ?>
<!-- job optin file for runMuonCalib.exe --><!DOCTYPE ifile SYSTEM "$(CALIBGENACDROOT)/xml/ifile.dtd" >
<ifile cvs_Header="$Header: $" cvs_Revision="$Revision: $" >
<section name="parameters"> input parameters for ACD pedestal and gain calibration
<item name="instrument" value="LAT">instrument type to be calibrated </item>
<item name="<parameterName>"value="<parameterValue>"> Various Job Parameter settings, one per item</item>
</section>
</ifile>
The following parameter names mirror the command line arguments give above:
instrument (same as -I) : specify instument being calibrated, this is a tag in the output files [LAT]
- digiFileList (same as -d) : blank-delimited list of input digi root files
- reconFileList (same as -r) : blank-delimited list of input recon root files
- meritFileList (same as -m) : blank-delimited list of input merit root files
- outputPrefix (same as -o) : output file prefix
- pedestalFile (same as -p) : Name of text file with pedestal values
- gainFile (same as -g) : Name of text file with gain (AKA mip peak) values