Instructions for running QOD
The Quality of Data monitoring program is called qod. It contains no
tracking code. Its job is to make some histograms to look for hardware
problems. An up-to-date version of this code can be found in
~e614/e614soft/triumf/mofia/devel/source/qod. Automatic
qod runs are done in
/twist/data7/auto/full_qod/current/data for every few
runs. These histograms can be inspected there with paw for problems. Just
execute qod.kumac and input the requested run number. More
details are in the Monitoring changes with respect to a reference
run section. Or you can make a version from CVS on your own
account or twistonl. Please do not run it on midtwist.
Monitoring changes in a single run:
Start up qod using qod.kcm. This defines the monitored histograms. You
may modify the qod namelist variables for different event samples,
confidence levels, etc. Specify an inputfile to analyze with MTIN. The
analysis writes text files QODmonxxxxxx.dat, qodshapexxxxxx.dat and
qodwirexxxxxx.dat, where xxxxxx is the run number. QOD histograms will
be saved to the same directory. In particular the QODmon file contains
information on possible dead or hot wires, having occupancies much
different from their neighbours.
Run paw in the directory containing the histogram and qod .dat files
and examine the differences using the paw macro "qod.kumac". When
prompted type in a 6 digit run number string corresponding to one of
the QOD hbooks in this directory. (You don't need to open the hbook
file first.) You then can view sequentially all the changing
histograms listed in qodshape.dat and qodwire.dat. The red lines drawn
for the shape comparisons shows the position from the beginning of the
graph where the difference is maximized. This may be of limited
use. The lines drawn for the wire comparisons are more reliable.
Monitoring changes with respect to a reference run:
Analyze the reference run with qod as above using qodr.kcm and saving
the histogram file. You need to analyze enough events to produce
reference histograms: 42000 are sufficient for qod_buffer_length =
40000. Then set the qod namelist variable qodfile or the enviroment
variable QOD_REF to this histogram file. Analyze 44000 or more events
from each comparison file. The results of each comparison should be
inspected with paw as above.
Changing an automatic reference tune
Current validated reference tunes are stored in
/twist/data7/auto/full_qod/referencetunes. Modify the
namelist variable qod_file in the
/twist/data7/auto/full_qod/current/auto-qod.kcm file.
Grep the .log files to see when the change came into effect.
Documentation
QOD Reference