DØ Trigger Simulator Manual
Getting Started
( The Cookbook Method )
The first thing you need to run TrigSim is a set of events to run it over. These can be either Monte Carlo (MC) generated or data taken online. The only requirement is that it be in "raw" form (i.e. <filename>.raw). If you do not have a .raw data file, you can link to a file TrigSim managers use for debugging (the path is in the example filelist below). The debug .raw file has 500 MC t-tbar events created with MC version p10.11.00.
Choose a production release number to use. In p14 versions and eariler TrigSim runs as a single executable. In p15 (t03.08.00) and later, it runs as two executables: one which does the trigger simulation and a second which creates the rootuple output.
Let's start with a newer version, say p15.01.00. Get your run environment setup by typing:
setup D0RunII p15.01.00
setup d0tools -t
Create a text file that will contain the absolute path and file name(s)
of your .raw file(s), one file per line. If you wish to use
our MC sample, copy the platform-appropriate example filelist:
d0mino_default_mc_filelist.txt
or
clued0_default_mc_filelist.txt.
The simulation part of TrigSim requires at least two arguements: what file(s) to run on, and what format the events are. The valid format choices are mc and data. In this example, we will use mc. To run TrigSim, just type:
runD0TrigSim -filelist=default_mc_filelist.txt -format=mc
The outputs from this command will appear in a newly created directory
whose name starts with D0TrigSim_x-.
Now, if you want to look at a ROOT file of information about the trigger simulation, you need to run the TrigAnalyze executable. Create a second text file (this example will call it output_filelist.txt) that will contain the absolute path and file name(s) of the output files from running TrigSim. These files will be located in the D0TrigSim_x-... directory and will be called outputfile_nn where nn are two digits. TrigSim starts with 00 and writes as many files as needed, up to 25. To run the TrigSim analysis, just type:
runTrigAnalyze -filelist=output_filelist.txt -format=mc
The outputs from this command will appear in a newly created directory
whose name starts with TrigSimAna_x-. The analsis root file is
by default called trigsim.root.
To run a version of TrigSim from before p15, for example p13.06.01, you need only execute the runD0TrigSim portion of these instructions:
setup D0RunII p13.06.01
setup d0tools -t
runD0TrigSim -filelist=default_mc_filelist.txt -format=mc
A ROOT file called L1L2L3Global.root will appear in the
D0TrigSim_x-... directory.
Other command line options can be examined by issuing the command:
runD0TrigSim -h
| Next section: Inputs and Configuration | Previous section: Introduction to TrigSim | Back to Table of contents |