zesLite

Options and Examples

Usage

The (slightly simplified) call sequence of the query commands are

1. For run range:

zesQuery [-h] [-o output_file][-l] [-n N] [-m M ] [-k] [-p] [-v] <firstRun> <lastRun> < SELECTION >

2. For run list:

zesQuery [-h] [-o output_file][-l] [-n N] [-m M] [-k] [-p] [-v] [-r file] <SELECTION>

By default, the output file name is the.z . The full calling sequence is shown with

zesQuery -h

Options and examples

SELECTION

1. SELECTION STRING (without line break!!!)

The following operations are supported:
a) ALL Fortran77 operators.
b) Equivalence operators:
------------------------------------------------------------

FORTRAN:	.and.	.or.	.lt.	.le.	.gt.	.ge.	.eq.	.ne.	.not.
C:	&&	\|\|	<	<=	>	>=	==	!=	!
ZES:	and	or	<	<=	>	>=	.eq.	.ne.	not
OTHER:	&	\|

------------------------------------------------------------

             Examples:
             zesQuery 48703 48713 'abs(Zvtx)<50 .and. Q2el_si>1000'
             zesQuery 48703 48703 '-50 < Zvtx & (Zvtx >= 50) and not (Q2el_si<1000) or DST34'
             zesQuery 48703 48713 ' Ntrks==2 && Ntrkvtx != 2 && (DST34 || !DST35) '
             zesQuery 48703 48703 all

2. SELECTION FILE: ( FORTRAN syntax !!!!)

             Examples:

cat > eotw3.sel << EOF
C-----------------------------------------------------------
C Event Of The Week Preselection 3: (upcoming) High Pt W
C-----------------------------------------------------------
     + (((Pt.gt.15.0).and.((Mupt1.gt.5.0)
     + .and.(Muth1.lt.2.0))).or. ((Pt.gt.15.0)
     + .and. (((Theta_em.lt.2.0).and.(Pt_em.gt.4.0)
     + .and.(ENin_em.lt.3.0)).or.((Theta_si.lt.2.0)
     + .and.(Pt_si.gt.4.0).and.(ENin_si.lt.3.0)))))
     + .and.((Zvtx.lt.50.0).and.(Zvtx.gt.-50.0))
C--------------------- end selection -----------------------
EOF
             zesQuery 44070 54685 eotw3.sel

[-r file] - Run List

             Examples:
cat > myruns.txt << EOF
48703
48708
48710
EOF
             zesQuery -r myruns.txt eotw3.sel
             zesQuery -r myruns.txt 'Q2el_si>1000'

[-l] - List of ZES variables: (for first run in run range/list)

             Examples:
             zesQuery -l 48703 48713
             zesQuery -l -r myruns.txt

[-o file] - output file name (the.z by default)
If output file (the.z) will be greater then 1 000 000 events next output files are produced : the.z_001, the.z_002 ...

Examples:
zesQuery -o /data/my.z 48703 48703 'Q2el_si>1000'

[-n N] - Maximum number of events to scan (default=unlimited)

Examples:
zesQuery -n 2 -o my.z 48703 48703 'Q2el_si>1000'

[-m M] - event limit for one output file (default=1000000)

Examples:
zesQuery -m 10000 -o my.z 48703 48703 'Q2el_si>1000'

[-b] - use current working directory (useful in BATCH)
Examples:
zesQuery -b -o my.z 48703 48703 'Q2el_si>1000'

[-v] - for verbose output
Examples:
zesQuery -v 48703 48703 all

[-p] - do NOT use PIPE (create intermediate files)
[-k] - keep intermediate files

[-p][-k] options will keep all temporary files in /tmp/zesquery_XXXXXX/

Examples:
zesQuery -p -k 48703 48703 'Q2el_si>1000'

Temporary Files:
zesquery.inc - file with selection.
sorted0.list - Text file (RunNr,EventNr).

[-w MC.list mcdir] - options for Monte Carlo files only

MC.list - list of Monte Carlo files

cat > MC.list << EOF
ZEUSIO-INFI ZEUSMC.HCZH424.E11911.NC.DJA.MPS.50K.01.Z00
ZEUSIO-INFI ZEUSMC.HCZH424.E11911.NC.DJA.MPS.50K.01.Z01
ZEUSIO-INFI ZEUSMC.HCZH424.E11911.NC.DJA.MPS.50K.01.Z02
ZEUSIO-INFI ZEUSMC.HCZH424.E11911.NC.DJA.MPS.50K.01.Z03
ZEUSIO-INFI ZEUSMC.HCZH424.E11911.NC.DJA.MPS.50K.01.Z04
ZEUSIO-INFI ZEUSMC.HCZH424.E11911.NC.DJA.MPS.50K.01.Z05
EOF

mcdir - full path to directory with ZesLite ntuples for Monte Carlo files selected in MC.list (See: zesLite for Monte Carlo files ) (with [-b] option path to mc directory can be set to local or curent directory, example: mctst or ./ ).

             Examples:
             zesQuery -w MC.list /data/mctst 'Q2el_si>1000'
             zesQuery -b -w MC.list mctst 'Q2el_si>1000'
             zesQuery -b -w MC.list ./ 'Q2el_si>1000'

[-c FULLPATH/conf.file] - to access other directory (not default) with zesLite ntuples for DATA

conf.file - configuration file

             Example:
cat > conf.file << EOF
* Runbeg Runend fpp_vers path
11539     14397         1         /zeus/data/zesLite/95tst
52244     57230         2        /zeus/data/zesLite/05
EOF

* comment - use '*' in first position to comment line
fpp version - is described a set of variables which are filled into ntuples:
1 for HERA1 data,
2 for HERA-II data
path-Full path to directory with zesLite ntuples of the certain range

Examples:
zesQuery -c /data/tst/my.conf 52244 52244 'Q2el_si>1000'

[-h] - Help

             Examples:
             zesQuery
             zesQuery -h

Julia Fourletova 10-Apr-2006