L2simu: software and documentation

L2simu: software and documentation

L2simu is the package containing the software of the second level trigger (see here too) plus some interface to work in ARTE environment. Its natural input comes from the first level trigger, which within ARTE is provided by l1simu. Anyway, in order to perform realistic studies of physics in 1998, a ee trigger configuration where the slt is feeded by care has been implemented too.
We hope the detector scenarios provided to work with l2simu and the interface to l2simu are satisfying the user. Improvement will continue. Please, contact us in case of problems/requests.
Since l2simu is not part of the default distributed ARTE software, you will have to refer to this page for software and documentation.

l2simu package

L2SIMU . Release date: 18.08.98
Remarks on release 18.08.98 : The version distributed here has been compiled and tested on the hera-b machine (Hamburg), with the arte version arte-01-08-r3. We have tried to compile and run with command : gmake run_l2si, and this seems to work fine. Do not worry about the several warnings you will see.
Until now it has been tested for TDR geometry for ee/mumu trigger, and for 1998 geometry for ee trigger (using l1simu and care). kumac and makefiles are provided in the tar file, and the use of them is briefly explained below.
L2simu can also perform for other partial detector geometries, extending the 1998 trigger operation mode to include full ecal and/or full/parts of svd. We are working on making the use of l2simu more friendly and flexible to further geometry changes. You'll hear from us soon.
L2SIMU for ARTE-02-04. Release date: 19.11.98


Here is a recent note, describing the expected performances of the trigger in the 1998 scenario using l2simu. L2simu has been used to perform physics studies for 1998 ( Hera-B 98-132). For performances with the TDR (full detector, magnet on) geometry look here.

How to get started

To run l2simu, you will use l2si.kumac, and copy Makel1sim00/Makel1sim98 or Makecare to Makefile. In the first case the l1 software package is feeding l2 (for 2000 or 1998 setup), while in the second case care is doing that. If you only intend to use care a version with a library l2simu_care is available for execution the Hera-B machine. Please note that at the moment calls for MC/MS/OT setup, for care/l1si use and for magneton/off are still done through the same command (see l2set mtdY below).


* Example kumac
HBOOK myhistos.his -O
IOFILE GEOMIN -I /hb/mc2/gean-01-08-r3/det99b/geo-08-02_99b.geo
IOFILE EVIN1 -I /hb/mc2/gean-01-08-r3/det99b/bjpk.g0802.geo99b.elec.001.dst
*** command to set pt/ktrig and mass cut (only when using care for flt)
trig ptcut masscut
*** command to set svd scenario
l2set svdX
*** command to set tracker+mag+l1 scenario
l2set mtdY
*** command to ready ecal setup (98 or full, only when using care for flt)
ecboard ecal98/ecalboard98_l1.dat
*ecboard ecal98/ecalboard.dat
* run 1

If one wants to use l1simu, then right after the specification of the IO files, one should add to l2si.kumac the following lines (with opportune modifications to l1simu parameters, see l1simu documentation) :

* specify this l1simu.dat for running l1simu in 1998 setup
* L1INI l1simu_98.dat
L1SET ektrig 1000.
L1SET calong on
L1TRIG MU+ MU- 2.75 9999. 0.5 10. 0.5 10. 0.0 500. 0.0 500. 1.0
L1TRIG E+ E- 2.75 9999. 0.5 10. 0.5 10. 0.0 200. 0.0 200. 1.0

Commands in l2si.kumac

The commands used in the kumac to set the pretrig-flt cuts and the detector scenario are
trig ptcut masscut
l2set svdX
l2set mtdY
where ptcut,masscut,X,Y to be supplied depend on the scenario chosen.
X can assume value f for TDR(full) setup, l for SI03,4,5,6, s for SI03,4,5,6, sectors 1,2 , r for 1998 setup.
For magnet off case, Y can assume value f for TDR setup and l1si, t for no chambers and l1si, s for only MC01+MS01+SI08 and care, u for no chambers and care. For magnet on case, Y can assume value o for no chambers and care.

l2set svd l2set mtd ptcut masscut
TDR f,s,r,l f - -
98 mag OFF (care) f,s,r,l s,u 1. 2.
98 mag OFF (l1si) f,s,r,l t - -
98 mag ON (care) f,s,r,l o 1. 0.01

User private routines

The initialization and run of l1-l2 is in usinit.C and usevnt.C (C++ routines). To call your analysis routines on l1+l2 accepted events, you should go into usevnt.C and look for the line:
// insert user routines call here
To use your private user src/include directories, you will go into the Makefile, and add them to the srcdirs and incdirs options.
Authors: M.Medinnis, S.Schmidt, S.Xella
Date: 18.08.98