Monitoring and Calibration

Calibration programs generally read a RAW or COOKED data file of BOS banks and produce some calibration constants typically in ASCII text format. The user must then place these calibration constants into the proper map. Monitoring programs produce ASCII reports and histograms which can be archived in the off-line database. However, it must be emphasized that the distinction between monitoring and calibration programs is artificial, nothing prevents some of the information from an ASCII report produced by a monitoring program from being put into the map database. Likewise, nothing prevents a calibration program from being run on every processed data file and using the values of the constants produced as a monitor for a particular system. Since both types of programs are used for complimentary purposes, both of these types of executables are listed together in this section.

• ccmon: Produces a file of histograms and a text report that contains the T0 offsests for each Cerenkov counter detector element, which can be directly imported into the calibration map.
• elastic_mon: elastic_mon produces a single file of hbook histograms that can be used to obtain the elastic cross-section.
• inelastic_mon: Produces an hbook file containing plots of physics related quantities for the reactions $e^\prime \pi^+ n$, $e^\prime \pi^0 p$, $e^\prime K^+ X$, and $e^\prime p \pi^+ \pi^-$. It also produces a text report of the number of events of each topology observed, the contents of this report are placed in the off-line database and listed in Table 9.
• pdu: pdu finds hot and dead drift chamber wires. pdu produces three files the first of which is a list of all dead wires which can be used to update the DC_STATUS.map to provide a more accurate model of the acceptance. It also produces an executive summary of the number of dead and hot wires in each sector and region, as well as the change in status of the number of dead and hot wires compared to the map. The information from this data file is deposited in the off-line database and is listed in Table 8 of this note. pdu also produces a file containing several hbook histograms that graphically display the hot and dead wires for each run.
• photon_mon: Produces an hbook file and a text report. The hbook file contains several tagger and start counter related calibration and monitoring histograms, as well as physics related histograms for the $\pi^+ n$, $\pi^0 p$, K⁺ X and $p \pi^+ \pi^-$ final states. The contents of the text report is stored in the off-line database and contains yields for various topologies and $\pi^+ n$ and $\pi^0 p$ yields by sector. photon_mon related database entries are listed in Table 10
• pid_mon: pid_mon monitors the quality of particle id and can be used to examine both pid and seb banks. pid_mon produces two files, a file of hbook histograms and a text file containing a table of particle yields by sector as well as fiqures of merit for the quality of particle id. The information from this text file are deposited into the off-line database during data processing. This contents of the off-line database stored for pid_mon are located in Tables 5 and 6.
• rfmon: rf_mon calculates the corrections that must be made in the rf time to determine an accurate mass and therefore an accurate particle identification.
• sc_mon: Creates a histogram file which contains scintillator occupancy plots, reconstructed occupancy plots, and performs rudimentary TOF efficiency calculations.
• trk_mon: Produces a file of hbook histograms and a report to stdout which can be piped into a text file. This text file contains tracking figures of merit such as the ratio of hit based tracks to time based tracks per sector, number of hits per time based track and the residuals by superlayer and sector. In addition quantites such as the beam position as determined by tracking are recorded, which can be used to update the map. The hbook file allows for a more detailed diagnosis of the tracking, in particular the time-to-distance calibration. A web page describing trk_mon in greater detail is accessable from the off-line web pages.