The Run Scripts

All the scripts needed to steer the Athena-Atlfast jobs should be situated in the run directory. There are only two scripts that should be altered by the user if they wish to to change the run-time properties of the Athena-Atlfast job. The jobOptions.txt file, used to steer the athena job, and the StandardAtlfastOptions.txt file, which contains the specific Atlfast options. The structure and main features of these files are described in this chapter.

1) jobOptions.txt

When the command athena is typed any file can be defined as the run file, for example: athena myOptions.txt. The default run file is the jobOptions.txt file, and if no other file is defined, this file is used. If there is no jobOptions.txt file and no other file is defined as the run file, then the job will fail to run. Athena-Atlfast comes with a default jobOptions.txt and this will be described in this section.

The jobOptions.txt contains a number of important lines that can be changed to give different behavior of the Athena-Atlfast job. Any of the lines within the standard jobOptions.txt file that are not discussed in this section should only be changed by an experienced user who is confident with what they are doing. Firstly of the lines of interest to all users are lines that change the name of the output histograms and/or ntuple files.:

HistogramPersistencySvc.OutputFile = "atlfast.hbook";
NtupleSvc.Output = {"FILE1 DATAFILE='atlfast.ntup' TYP='HBOOK' OPT='NEW'"};

The first line above sets the file name where any histograms will be put and the second line sets the file name where any ntuples will be put. These files do not need to exist before the job is run and any existing files with the same name will be overwritten.

Next in the jobOptions.txt is the line that sets the number of events the job will run over. If the following line is omitted the default number of events is 10:

ApplicationMgr.EvtMax = 100;

The level at which messages are printed out can also be set. The level of message ranges from 2=DEBUG to 6=FATAL:

MessageSvc.OutputLevel = 3;

The type of Monte Carlo generator used is also set in the jobOptions.txt. Athena-Atlfast supports two generators, Pythia and Isajet. More information on setting the physics processes for these generators can be found here. The following line is used to select a particular generator:

Generator.Members = {"PythiaModule"};

Finally, at the end of the jobOptions.txt, the StandardAtlfastOptions.txt file is included. This is described in the following section.

#include "StandardAtlfastOptions.txt"

2) StandardAtlfastOptions.txt

The StandardAtlfastOptions.txt contains all the Atlfast options that may be changed. At the top of this file we see the command

#include "AtlfastDoNotTouch.txt"

this included file should never need to be changed by the user.

Next are the command lines which give the names of the Atlfast analysis algorithms that will be run when the job is executed. For example:

Atlfast.members +={"Atlfast::StandardNtupleMaker/StandardNtupleMaker"};

Athena-Atlfast comes with a number of standard analysis algorithms. These are StandardNtupleMaker, TrackNtupleMaker and ExampleAnalysis, these are described in more detail inChapter 3: Standard Atlfast Analysis Algorithms. A users own analysis algorithm may also be specified here. Writing your own analysis algorithms will be discussed in Chapter 5: Writing an Analysis Algorithm.

Next come the default settings for the individual Athena-Atlfast algorithms. Firstly there are the Reconstructed Particle Makers, there are three of these, ElectronMaker, Muon Maker and PhotonMaker. The variables that can be set for these particles are shown in Table 2-1, Table 2-2 and Table 2-3 respectively. Also shown in the tables are the equivalent variable names that were used in the Fortran Atlfast-2.0. An example of setting the Athena-Atlfast variables in the StandardAtlfastOptions.txt is shown below:

ElectronMaker.MinimumPt = 5.0;

After the Reconstructed Particle Makers come the CellMaker (Table 2-4), ClusterMaker (Table 2-5), JetMaker (Table 2-6), TrackMaker (Table 2-7), EventHeaderMaker (Table 2-8), and CommonDataMaker (Table 2-9). Care should be taken when changing any of these values from their defaults. Next in the StandardAtlfastOptions.txt the identifiers of some Histograms and output files are set. These are used for debugging and the user should not change these. Finally there are examples of setting the message output level of various individual algorithms:

PythiaModule.OutputLevel = 4;

At the end of the script are a number of commented-out lines that are used by debugging programs and should be of no interest to the user.

IMPORTANT NOTES
1) ParticleTypes should never be changed by the user.
2) MuonIsolator.rClusterMatch should never be changed from zero.
3) Cone is the only available ClusterMaker.Strategy at the moment.
4) CommonDataMaker.BarrelForwardEta only available for change in Atlfast-00-00-19.
5) Track Smearing is only available for Atlfast-00-00-19 and later. Thus it is not in release 2.x.x.
6) The neutrinos are hardwired into CommonDataMaker as invisibles.

Prev	home	Next