The script surf.pl


This perl-script must be called with the string number as option. It searches for "Surf","data" and "st[string number]" in the directory "$indir" (please edit in the beginning of the script). It will pipe all found data files (zipped or not) through the reader "reader" and book large ntuples with "bookcwn". The hbook-files will be stored in the directory "$outdir" (please edit in the script). Afterwards, PAW will be started and the script "bookhists.kumac" called. This short kumac loops through all events and stores the following histogram-files:

  • [filename].le: LE distributions of all affected OMs
  • [filename].adc: ADC distributions of all affected OMs
  • [filename].d[OM]: time difference distributions between all affected OMs and the reference OMs.

This is done with the help of three FORTRAN functions:

  • fillle.f: LE distributions of all affected OMs
  • filladc.f: ADC distributions of all affected OMs
  • fillref.f: time difference distributions between all affected OMs and the reference OMs.

All histograms are first filled in the working directory (/net/amanda/surft0/) and then moved to the directory "$histdir" (please edit in the script), with subdirectories for each string number. Because of HBOOK restrictions in the length of a file name (only 32 characters), all useless characters will be stripped off the file name.

Booked histogram-files can be easily accessed in PAW with the command:
hi/file [lun] [filename]
One histogram-file contains 680 histograms.

The reference OMs are stored in the array "@refoms". A change of this array is sufficient to have reference OMs modified throughout the whole booking process.

At the end, "surf.pl" will give you some run statistics, e.g.:
Skipped files:



Treated files:

SurfT0cal0_TDC_10ns_500mV_st18-o_d0_2000_334_1877_000.data.gz
SurfT0cal0_opt_30ns_2.4V_st18-o_d0_2000_335_1912_000.data.gz

Booked hbk-files:

SurfT0cal0_TDC_10ns_500mV_st18-o_d0_2000_334_1877_000.hbk
SurfT0cal0_opt_30ns_2.4V_st18-o_d0_2000_335_1912_000.hbk

Booked ADC-files:

tdc_10_500_18-o_0_1877_0.adc
opt_30_2.4v_18-o_0_1912_0.adc

Booked LE-files:

tdc_10_500_18-o_0_1877_0.le
opt_30_2.4v_18-o_0_1912_0.le

Booked DIFF-files:

tdc_10_500_18-o_0_1877_0.d186
tdc_10_500_18-o_0_1877_0.d197
tdc_10_500_18-o_0_1877_0.d227
tdc_10_500_18-o_0_1877_0.d39
tdc_10_500_18-o_0_1877_0.d543
tdc_10_500_18-o_0_1877_0.d78
tdc_10_500_18-o_0_1877_0.d96
opt_30_2.4v_18-o_0_1912_0.d186
opt_30_2.4v_18-o_0_1912_0.d197
opt_30_2.4v_18-o_0_1912_0.d227
opt_30_2.4v_18-o_0_1912_0.d39
opt_30_2.4v_18-o_0_1912_0.d543
opt_30_2.4v_18-o_0_1912_0.d78
opt_30_2.4v_18-o_0_1912_0.d96

--------------------------------------------------------------
examined files:  2
skipped files:   0
treated files:   2
ADC files:       2
LE files:        2
DIFF files:      14

files ready:     2

total size hbk-files:  526824000
total size hist-files: 31473664
--------------------------------------------------------------
Skipped files occur whenever the hbook-files exists already with non-zero file size.
You should delete the hbook-files, now.

HAVE A LOT OF FUN!!!


Markus Gaug
Last modified: Mon Dec 4 15:23:53 UTC 2000