04-Nov-97 JEC

FD Data Quality monitoring

The FD data monitoring job should be run on all Rope passes, to ensure that the detector is functioning properly and that the calibrations are adequate. There are two stages to the operation -

  1. A shift job is run to fill a set of histograms, reading FDET DST data
  2. A PAW kumac is run which generates

Running the shift job

The shift job is a standard FD script stored in ~jec/rope416/od416/rodfd. It accesses only the OD banks and so may be run on any type of data ( DDST, CSDST etc ). Since histograms are filled for FD, FE and SW subdetectors, both for events triggered by these subdetectors and for all TKMH events, it is necessary to process all FYZ1 events for a complete set of plots. However, if for example only the FK energy was to be investigated, it would be possible to run using the Luminosity DADlist

The following PAM files are required by rodfd.cra :-

~/car/us427.car
Contains USBAT, USINIT etc, for selecting FD events
~/rope416/car/odfd416.car
Contains FD versions of ODBOOH, ODANAL to book and fill the FD histograms

Here is an example of how to submit the Data Quality script.

The data quality job produces two files -

where XX is the period number, Y the pass number.

Analysing the results

Accessing the data

First examine the listing file odfdXX_Y.lis. Check that enough events have been accepted. Look at summary of REPORT messages.

Transfer the HBOOK file from ~jec/hist/odfdXX_Y.hrz to the opal work area /local4/opal_data/fd/odNN where NN=97,98.. the appropriate year. ( Use FTP from shift6.cern.ch ) 

8 ftp shift6.cern.ch
Connected to shift6.cern.ch.
220 shift6.cern.ch FTP server ready.
Name (shift6.cern.ch:jec):
331 Password required for jec.
Password:
230 User jec logged in.
Remote system type is UNIX.
Using binary mode to transfer files.
ftp ls hist
200 PORT command successful.
150 Opening ASCII mode data connection for 'file list'.
hist/odfd83_4.hrz
226 Transfer complete.
ftp get hist/odfd83_4.hrz od97/odfd83_4.hrz
200 PORT command successful.
150 Opening BINARY mode data connection for 'hist/odfd83_4.hrz' (339968 bytes).
226 Transfer complete.
339968 bytes received in 0.7 seconds (4.8e+02 Kbytes/s)
ftp bye
221 Goodbye.

NB od97 is a link from ~jec/paw/fd/od to opal_data/fd/od97

Analyse the data

The analysis kumac is stored in ~jec/paw/fd/od. To execute, start PAW from ~jec/paw ( to ensure pawlogon is executed ), select display type 3 ( A4 horizontal ), then execute goto_od to set the correct subdirectory and command path :- 

 1.  1: Macro goto_od
 1.  2: *=      Set directory & command path for od analysis
 1.  3: *
 1.  4:   lcdir fd/od
 Local directory is /local1/users/jec/paw/fd/od
 1.  5:   def  .,../..
 Macro search order is Command
 1.  6: *
 1.  7:   shell ls od97/*
od97/odfd83_4.hrz  od97/odfd84_4.hrz  od97/res83p4.html
 1.  8:   trace off

The file odplot.kumac analyses the histogram file, reading data from /odYY, producing postscript and .html files in /wwwYY, where YY is the year. ( These subdirectories of fd/od are links - 

        od97  - /local4/opal_data/fd/od97/
        www97 - /user1/jec/www/fd/rope/97/

There is a 'help' facility, of sorts :- 

PAW  exec odplot#?
 Local directory is DISK$U1:[USERACT.JEC.PAW.FDOD]

Macro go
*=     Run the complete analysis
*-     [1] is the period number
*-     [2] is the pass number
*-     Data is read from $scr:odfd[1]_[2].hrz into //pawc/od[1]_[2]

Macro read
*=    Read //pawc/[1]/.. from [2], create directories as required

Macro reread
*=    Read //pawc/[1]/.. from [2], into existing directories

Macro rep
*=      Construct Data Quality report
*-      [1] = Period
*-      [2] = Pass
*-

Macro odplot
*=      Extended/Full set of FD plots

Macro reprint  1=SCR$WORK:ODPLOT.REP
*=              Print parameters for report to file [1]

Macro odsum
*=        Plots for a 1 page Summary .ps file

Macro reswrt
*=    write  vector res to res[1]p[2].dat in current directory

read
reads data from OD/FDET, OD/GNRL and OD/HEAD into PAW directories ODnn_m/FDET, /GNRL.. where nn is the period number, m the pass number
reread
reads as for read, but into directories which already exist.
rep
plots the standard data quality plots, and fills the PAW vector RES
odplot
plots a more complete set of plots
reprint
writes a .html ( type ) file giving the results
odsum
produces a one page summary plot
reswrt
saves the vector RES in the current subdirectory

Provided only standard filenames are to be used, odplot#go will run the entire analysis. It requires the file ps#kumac to switch on ( ps#lmon ) and to print ( ps#mof ) postscript files.

Compare the distributions with the checklist. A copy of the .html file should be added to the reRope status page