FD Calibration

The FD calibrations should be calculated using the initial Z-peak calibration data taken at the beginning of each year. The Gamma catcher pedestals and the dead tube map should be checked, and updated if necessary. The Forward calorimeter ( FK ) calibration is currently calculated online. Offline calibration code is available, but should only be used if the online system fails ( This may happen if a complete quadrant of tubes fails for an extended period )

There are two stages to the operation -

1. A shift job is run to reRope the FD data and fill a set of histograms
2. PAW kumacs analyse the histogramsand produce new calibration constants
3. An updated version of the calibration file is produced
4. The calibration ( cards ) file is converted to RZ format on shift
5. The RZ file is transferred to hpplus, and ( automatically ) triggers an update of OPCAL

Running the shift job

The shift job is a standard FD script stored in ~jec/rope416/fd429/rfdm429.It requires FD dense data as input ( ie DDST ) It uses a private version of the FD library compiled using the *MONI switch, which includes the FxMONI routines.

Events are selected by FFEAD cards

USELEFE 20.

Select FE ( Gamma Catcher ) energy > 20 Gev

USELNFEC 2

Select events with 2 or more FE clusters

USELFDBH

Select any FD Bhabha event type

USELEFD

Select if FD energy > 1 Gev

USELFDTR

Selected if any FD trigger bit

USELFDST 2 0

Rejected if FD status not good

USELDDRQ

Rejected if FD detector status not good

The calibration histogram file is transferred to ~jec/hist when the job finishes.

The following files are required by rfdm429.cra :-

rope416/lib/us416.a

Contains USBAT, USINIT etc, for selecting FD events

rope416/lib/fd429.a

Contains FD production code + FBMONI, FEMONI to book and fill the FD histograms

Here is an example of how to submit the calibration script.

The data quality job produces two files -

• ~jec/hist/fdm429_XX_Y.hrz, a HBOOK histogram file
• ~jec/list/fdm429XX_Y.lis, a listing file

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

Analysing the results

Accessing the data

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

Transfer the HBOOK file from ~jec/hist/fdm429_XX_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 calibration data is analysed using PAW; the analysis macros are stored on ax8, in ~opal/offline_paw/fd/calibration. To perform the analysis, log in as opal, then

op> cd offline_paw
op> paw
 ******************************************************
 *                                                    *
 *            W E L C O M E    to   P A W             *
 *                                                    *
 *       Version 2.09/18      19 March 1998           *
 *                                                    *
 ******************************************************
Workstation type (?=HELP) <CR>=1 : 5
 Version 1.23/09 of HIGZ started
  pawlogon.kumac  27-Feb-98, U**x
 1. 15: return
PAW > exec goto_cal
 1.  1: Macro goto_cal
 1.  2: *=      Set directory & command path for od analysis
 1.  3: *
 1.  4:   lcdir fd/cal
 Local directory is /local1/users/opal/offline_paw/fd/cal
 1.  5:   def  .,../..
 Macro search order is Command
 1.  6: *
 1.  7:   trace off

This sets the correct directory, and starts a Panel mode ( Style GP ) dialog in the graphics window. This is designed to be self explanitory , but anyway…

Panel 1 - Input file

Click on one of the left hand boxes labelled File1, File2, File3… to select the file listed in the ajacent box in the right hand column. Do not click in the column headre boxes, silly..

Panel 2 - Data description

If the file name is standard ( xxxx_yy_z ), then the period number yy and pass number z will be automatically set, and displayed as the panel heading. If the heading is wrong, or you perversely want to change them anyway, click the boxes 'Period' or 'Pass' to be prompted for a new value. Click OK to continue

Panel 3 - Select a subdetector

Do just that. The calorimeter analysis has not been used for some time, but might be useful in emergency

Tube Chamber options

Summary

To be explained, sometime

Dead Tube

Superimposes the current dead tube map over tube plane profiles, enabling new dead tubes to be identified

MetaSwitch

Enables/disables duplicating screen output on the ( postscript ) Metafile

Return

Terminates tube analysis

Gamma Catcher options

Peds

Plots the pedestal value vs run number for all 32 ADCs

Write Title

Writes the pedestal values to the file caldat/fepyy_z.yyl, where yy is the period, z the pass. The experiment, first and last run number may be changed before writing the file

MetaSwitch

Enables/disables duplicating screen output on the ( postscript ) Metafile

Return

Terminates gamma catcher analysis

Update the title files

The TZ ( title ) package is part of Zebra. It reads cards and places the data in Zebra banks of the specified length, which can then be copied to the calibration data structure.

The comment cards at the beginning of the deck should be updated when it is changed; the first bank 'FDUP' passes the name of the updater and a brief ( 20-character ) comment to the OPCAL database, and must be present.

Tube chamber titles

There are 3 types of tube chamber bank :-

FBCS

Defines the side number & period of validity array :-

*DO  FBCS  1  -iI  -n6
10  9000 1  10 9999 99999999

Note that the bank ordering is significant; the quadrant and side number of a plane bank are determined by the preceeding FBCQ, FBCS banks.

To update the tube map, change the appropriate 1.0 to 0.0. In general, tubes deemed to be dead should not be resurrected, since they tend to fail again later.

If an entire plane or quadrant is dead, the map shold NOT be updated. No purpose is served, since no clusters can be reconstructed, and the problem ( gas or HT ) will hopefully be fixed.

Gamma Catcher titles

There are 3 types of Gamma catcher title bank :-

FECS

Identifies the side ( Cf FBCS above )

FEPE

Defines the 16 pedestal values for a side, followed by the error ( = SD ) of the pedestal

FECA

Defines the 16 gains & errors for a side. There is no automated method of determining these, but fortunately they don’t change ( much ). The FECA banks written by the FE calibration proceedure contain only zeros, & should be replaced by the gain banks from the previous calibration. ( The existing kumacs for FE gain may be found in offline_paw/fd/fe )

Summary

• Update the comments
• Update the FDUP bank
• Update the dead tube ( FBCP ) banks
• Include new FEPE banks
• Retain old FECA banks

Update OPCAL

There is a shift job ~/rope416/opcal_updt which converts the title ( cards ) file into an RZ file, which can be submittted to the automatic update proceedure.

1. Copy ( FTP ) the title file to ~jec/ttl/$Ttlname.ttl on shift6
2. Run fdocup to produce the RZ file ( see Example ).
3. Transfer the rz file from ~rz/$Ttlname.rzdata to ~jec/opcal/rzdata on hpplus
4. Check it can be read using OCMAN ( linked from ~jec/opcal )
5. Copy the file to ~jec/opcal/updates ( a link to the update proceedure intray )
6. Wait a few hours; hpplus file should disappear & OPCAL will be updated.