The purpose of this document is to provide some information on how to run it:

Examples:

• running an internal generator:
  runsim -VERSION va0e -LABO CERN -NRUN 1000 -EBEAM 45.625 -IGEN qqps -NEVMAX 10
• running an external file:
  runsim -VERSION va0e -LABO CERN -NRUN 1000 -EBEAM 45.625 -GEXT myfile.dat -NEVMAX 10

• simana.fadsim is the delsim output file, raw data
• simana.fadana is the delana output file, full dst data
• simana.xsdst is the dstana output file, xshort dst output file (LEP2 case)
• simana.sdst is the dstana output file, short dst output file (LEP1 case)
• simana.ldst is the dstana output file, long dst output file (LEP1 case)

Notes:

• in future, only Linux will be supported. Other platforms are phased out.
• execution is started in the current directory
• you may want to write a small wrapper which saves your files after execution, and run in batch mode

mandatory options:

• VERSION, the simana version to be used.
• LABO, the laboratory identifier.
• NRUN, the run number.
• EBEAM, the beam energy.
• GEXT if option ANA and no IGEN is given. Needed also if one of SDST, LDST or XSDST is given.

currently supported versions (VERSION option):

LEP2

va0u:
year 2000, TPC S6 dead

va0e:
year 2000, TPC S6 ok

v99e:
year 1999

v98e:
year 1998

v97g:
year 1997

v99_4:
year 1999-2000, old processing

LEP1

v94c: year 1994, other versions are in preparation

currently supported internal generators (IGEN option):

qqps:
(igener 15), e⁺e^- -> Z/gamma ->qqbar, using LUND lueevt JETSET 7.3 DELPHI

bbps:
(igener 15), e⁺e^- -> Z/gamma ->bbbar, using LUND lueevt JETSET 7.3 DELPHI

baba:
(igener 14), e⁺e^- -> Z/gamma ->ffbar, using BKJ generator MUSTRAAL

bafo:
(igener 14), e⁺e^- -> Z/gamma ->ffbar, using BKJ generator MUSTRAAL

nunu:
(igener 14), e⁺e^- -> Z/gamma ->ffbar, using BKJ generator MUSTRAAL

mumu:
(igener 14), e⁺e^- -> Z/gamma ->ffbar, using BKJ generator MUSTRAAL

toto:
(igener 14), e⁺e^- -> Z/gamma ->ffbar, using BKJ generator MUSTRAAL

global options:

LABO lab:
laboratory identifier, eg. CERN, RAL, SNAK, KARL ...

NRUN run:
run number, for random seeds

EBEAM ebea:
beam energy in GeV

NEVMAX nevt:
maximum number of events to be processed, default 1000000

GEXT filename:
external file to be processed

SIM:
delsim simulation only

ANA:
delana reconstruction, raw data input file to be provided via GEXT

running options:

SETUP setup:
"liq" or "gas", v93d and v92e only, default is "liq"

VIRT file:
virtual ddb file, default none

XMH mass:
Higgs boson mass, default 10.

TAUB time/1e-12:
(common) B lifetime, default is 1.6

FLIMOU size:
maximal delsim output file size (default 5000). Note that on ext2 partitions on Linux the maximal file size is limited to 2GB.

STITL title:
delsim title file to be used, defaults can be found in /afs/cern.ch/group/xx/delsim/${version}/dat
Note that for 93 and 92 the delsim default title file depends on the SETUP (liq or gas)

ATITL title:
delana title file to be used, defaults can be found in /afs/cern.ch/group/xx/delsim/${version}/dat

dstana processing

LONG:
if given, long dst will be produced instead of short dst, default is short dst. This option is only available for LEP1 versions

XSDST:
run xshort dst only, requires -GEXT fulldstfile

SDST:
run short dst only (LEP1 only), requires -GEXT fulldstfile

LDST:
run long dst only (LEP1 only), requires -GEXT fulldstfile

build options: not recommended

ACRA cradle:
delana cradle file to be used. The default is that no new executables are build. The complete code used can be found can be found in the source tree /afs/cern.ch/group/xx/delsim/${version}/src/car

SCRA cradle:
delsim cradle file to be used. The default is that no new executables are build. The complete code used can be found can be found in the source tree /afs/cern.ch/group/xx/delsim/${version}/src/car