running simulations
The revised DELPHI production scheme has been run mostly on Linux, but
it has been set up to be as much platform independent as possible. The central script is runsim.
This script is centraly available to all DELPHI users, and can be used for private productions.
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
These commands will process 10 events QQPS or 10 events from lund file myfile.dat through delsim,
process them with delana in version a0e and run the corresponding xshortdst (currently a0e1) on it. Output
files will be stored in the execution directory,
- 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
NOTE: Use this only if you really know what you are doing !
- 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
runsim was written by J.v.Eldik and is currently maintained by U.Schwickerath
If you have questions or comments send them to delphi-core@cern.ch
Click here for a description of the Linux production stream