The Run Scripts (As of Release 3.1.0) All the scripts needed to steer the Athena-Atlfast jobs should have been copied into 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 AtlfastOptions.txt file, used to steer the athena job, and the AtlfastStandardOptions.txt file, which contains the specific Atlfast options. 1) AtlfastOptions.txt When the command athena is typed any file can be defined as the run file, for example: athena AtlfastOptions.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 called AtlfastOptions.txt and this will be described in this section. The AtlfastOptions.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 AtlfastOptions.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. The first lines include the Standard Athena libraries and then tell athena which other libraries to load for a specfic job. #include "$ATHENACOMMONROOT/share/Atlas_Gen.UnixStandardJob.txt" ApplicationMgr.DLLs += { "GaudiAlg"}; ApplicationMgr.DLLs += { "AtlfastAlgs"}; ApplicationMgr.DLLs += { "GaudiAud" }; AuditorSvc.Auditors = { "ChronoAuditor" }; ApplicationMgr.DLLs += { "HbookCnv" }; ApplicationMgr.DLLs += { "PythiaGenerator"}; Here the Gaudi libraries and the AtlfastCode libraries are loaded. Also loaded in the ChronoAuditor Auditor which runs time checks on the Athena job, the HbookCnv library which if used for making ntuples and histograms (this can be replaced with RootHistCnv if Root rather than HBook is desired) and finally the Generator library is loaded, here Pythia is selected. The other options are: ApplicationMgr.DLLs += { "IsaJetGenerator"}; ApplicationMgr.DLLs += { "TauolaGenerator"}; ApplicationMgr.DLLs += { "HerwigGenerator"}; Next a persistency service is defined that should not need changing: EventPersistencySvc.CnvServices = { "McCnvSvc" }; The following lines set the Histogram (atlfast.hbook) and ntuple (atlfast.ntup) file names (the HBOOKs should be changed to ROOTs for Root users) ApplicationMgr.HistogramPersistency = "HBOOK"; HistogramPersistencySvc.OutputFile = "atlfast.hbook"; NtupleSvc.Output = {"FILE1 DATAFILE='atlfast.ntup' TYP='HBOOK' OPT='NEW'"}; These files do not need to exist before the job is run and any existing files with the same name will be overwritten. To change the number of events run over the EvtMax number has to be set. The default value is 10: ApplicationMgr.EvtMax = 100; The level at which messages from athena are printed out can also be set. The level of message ranges from 2=DEBUG to 6=FATAL: MessageSvc.OutputLevel = 3; The Sequence that the Algorithms are run is set up next. The Generator is run first, then AtlfastCode: ApplicationMgr.TopAlg = {"Sequencer/TopSequence"}; TopSequence.Members = {"Sequencer/Generator","Sequencer/Atlfast"}; The type of Monte Carlo generator used is also set in the AtlfastOptions.txt. Athena-Atlfast supports five generators, Pythia, Isajet, Tauola, Herwig and Single Particle Gun. More information on setting the physics processes for these generators can be found here, to configure Pythia PyMoGi can be used. The following line is used to select the particular generator, for example, to use Pythia (Note: the correct Generator library should have been loaded earlier): Generator.Members = {"PythiaModule"}; Finally, at the end of the jobOptions.txt, the AtlfastStandardOptions.txt file is included. This is described in the following section. #include "AtlfastStandardOptions.txt" 2) AtlfastStandardOptions.txt The AtlfastStandardOptions.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 unless they really know what they are doing. Next are a number of command lines which give the names of extra Atlfast Algorithms that will be run when the job is executed. These are: TrackMaker: Used for reconstructing tracks. This is a rather slow algorithm and should only be included if Tracks are required in the users analysis. Monitor: Prints out an update of how many events have run. TrackNtupleMaker: Makes an Ntuple with all the track information in it (TrackMaker must have been selected prior to the running of TrackNtupleMaker). StandardNtupleMaker: Makes an ntuple with all particle and event data in it. AtlfastProtoJetMaker: Makes ProtoJets from Atlfast output objects. Atlfast.members +={"Atlfast::TrackMaker/TrackMaker"}; Atlfast.members +={"Atlfast::Monitor/Monitor"}; Atlfast.members +={"Atlfast::TrackNtupleMaker/TrackNtupleMaker"}; Atlfast.members +={"Atlfast::StandardNtupleMaker/StandardNtupleMaker"}; Atlfast.members +={"Atlfast::AtlfastProtoJetMaker/AtlfastProtoJetMaker"}; The Standard analysis algorithms which come with Athena-Atlfast are StandardNtupleMaker and TrackNtupleMaker, these are described in more detail in Standard Atlfast Analysis Algorithms. After the extra Algorithms have been added, the individual Athena-Atlfast algorithms can be configured. 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-1a, Table 2-2a and Table 2-3a respectively. Each particle maker has an associated Isolator algorithm. The default values for these algorithms are shown in tables Table 2-1b, Table 2-2b and Table 2-3b respectively. . Also shown in the tables are, where appropriate, the equivalent variable names that were used in the old Fortran Atlfast-2.0. An example of setting the Athena-Atlfast variables in the AtlfastStanderdOptions.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), GlobalEventDataMaker (Table 2-9), AtlfastProtoJetMaker (Table 2-10), and AtlfastB (Table 2-11). 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. VARIABLE DEFAULT VALUE ATLFASTF EQUIVALENT ElectronMaker.ParticleType 11 - ElectronMaker.mcMinimumPt 0.000 - ElectronMaker.mcMaximumEta 100.0 - ElectronMaker.MinimumPt 5.000 YPAR(40) ElectronMaker.MaximumEta 2.500 YPAR(41) ElectronMaker.DoSmearing true LPAR(4) Table 2-1a. The ElectronMaker Default Settings VARIABLE DEFAULT VALUE ATLFASTF EQUIVALENT ElectronIsolator.rClusterMatch 0.150 YPAR(45) ElectronIsolator.rClusterIsolation 0.400 YPAR(47) ElectronIsolator.eClusterIsolation 0.000 - ElectronIsolator.rCellIsolation 0.200 YPAR(48) ElectronIsolator.eCellIsolation 10.000 YPAR(49) Table 2-1b. The ElectronIsolator Default Settings VARIABLE DEFAULT VALUE ATLFASTF EQUIVALENT MuonMaker.ParticleType 13 - MuonMaker.mcMinimumPt 0.500 YPAR(100) MuonMaker.mcMaximumEta 2.500 YPAR(21) MuonMaker.MinimumPt 6.000 YPAR(20) MuonMaker.MaximumEta 100.0 - MuonMaker.DoSmearing true LPAR(4) MuonMaker.MuonSmearKey 3 LPAR(5) Table 2-2a. The MuonMaker Default Settings VARIABLE DEFAULT VALUE ATLFASTF EQUIVALENT MuonIsolator.rClusterIsolation 0.400 YPAR(27) MuonIsolator.eClusterIsolation 0.000 - MuonIsolator.rCellIsolation 0.200 YPAR(28) MuonIsolator.eCellIsolation 10.000 YPAR(29) Table 2-2b. The MuonIsolator Default Settings VARIABLE DEFAULT VALUE ATLFASTF EQUIVALENT PhotonMaker.ParticleType 22 - PhotonMaker.mcMinimumPt 0.000 - PhotonMaker.mcMaximumEta 100.0 - PhotonMaker.MinimumPt 5.000 YPAR(30) PhotonMaker.MaximumEta 2.500 YPAR(31) PhotonMaker.DoSmearing true LPAR(4) Table 2-3a. The PhotonMaker Default Settings VARIABLE DEFAULT VALUE ATLFASTF EQUIVALENT PhotonIsolator.rClusterMatch 0.150 YPAR(35) PhotonIsolator.rClusterIsolation 0.400 YPAR(37) PhotonIsolator.eClusterIsolation 0.000 - PhotonIsolator.rCellIsolation 0.200 YPAR(38) PhotonIsolator.eCellIsolation 10.000 YPAR(39) Table 2-3b. The PhotonIsolator Default Settings VARIABLE DEFAULT VALUE ATLFASTF EQUIVALENT CellMaker.EtaCoverage 5.000 YPAR(12) CellMaker.MinETCell 0.000 YPAR(15) CellMaker.GranBarrelEta 0.100 YPAR(18) CellMaker.GranBarrelPhi 0.100 YPAR(19) CellMaker.GranForwardEta 0.200 YPAR(18)*2 CellMaker.GranForwardPhi 0.200 YPAR(19)*2 Table 2-4. The CellMaker Default Settings VARIABLE DEFAULT VALUE ATLFASTF EQUIVALENT ClusterMaker.RConeBarrel 0.401 YPAR(11) ClusterMaker.RConeForward 0.401 YPAR(16) ClusterMaker.minInitiatorET 1.500 YPAR(13) ClusterMaker.minClusterET 5.000 YPAR(10) ClusterMaker.Strategy "Cone" - ClusterMaker.MasslessJets true - Table 2-5. The ClusterMaker Default Settings VARIABLE DEFAULT VALUE ATLFASTF EQUIVALENT JetMaker.MinimumPT 10.000 YPAR(51) JetMaker.MaximumEta 5.000 YPAR(52) JetMaker.DoSmearing true LPAR(4) JetMaker.RconeB 0.401 YPAR(11) JetMaker.RconeF 0.401 YPAR(16) JetMaker.bPtMin 5.000 YPAR(63) JetMaker.bMaxDeltaR 0.200 YPAR(65) JetMaker.cPtMin 5.000 YPAR(73) JetMaker.cMaxDeltaR 0.200 YPAR(75) JetMaker.tauPtMin 10.000 YPAR(90) JetMaker.tauMaxDeltaR 0.300 YPAR(92) JetMaker.tauJetPtRatio 0.900 YPAR(93) JetMaker.etaTagMax 2.5 YPAR(64,74,91) Table 2-6. The JetMaker Default Settings VARIABLE DEFAULT VALUE ATLFASTF EQUIVALENT TrackMaker.McPtMinimum 0.500 YPAR(100) TrackMaker.McEtaMaximum 2.500 YPAR(101) TrackMaker.DoSmearing true LPAR(4) TrackMaker.BField 2.000 - TrackMaker.vlMaximum 3.000 - TrackMaker.vtMaximum 40.000 - TrackMaker.MuonConfiguration 000 LPAR(12) Table 2-7. The TrackMaker Default Settings VARIABLE DEFAULT VALUE ATLFASTF EQUIVALENT EventHeaderMaker.BeamEnergy 7000.0 - EventHeaderMaker.TestMode 0 - Table 2-8. The EventHeaderMaker Default Settings VARIABLE DEFAULT VALUE ATLFASTF EQUIVALENT GlobalEventDataMaker.Luminosity 2 LPAR(2) GlobalEventDataMaker.Invisables 12,14,16 - GlobalEventDataMaker.RandSeed 12345 - GlobalEventDataMaker.BFieldOn true LPAR(3) GlobalEventDataMaker.BarrelForwardEta 3.2 YPAR(17) Table 2-9. The GlobalEventDataMaker Default Settings VARIABLE DEFAULT VALUE ATLFASTF EQUIVALENT AtlfastProtoJetMaker.OutputTowerPJKey "/Event/AtlfastTowerProtoJets" - AtlfastProtoJetMaker.OutputClusterPJKey "/Event/AtlfastClusterProtoJets" - AtlfastProtoJetMaker.OutputFinalStatePJKey "/Event/AtlfastFinalStateProtoJets" - AtlfastProtoJetMaker.OutputTowerJetKey "/Event/AtlfastTowerJets" - AtlfastProtoJetMaker.OutputClusterJetKey "/Event/AtlfastClusterJets" - AtlfastProtoJetMaker.OutputFinalStateJetKey "/Event/AtlfastFinalStateJets" - AtlfastProtoJetMaker.TowerPJConstruct true - AtlfastProtoJetMaker.ClusterPJConstruct true - AtlfastProtoJetMaker.FinalStatePJConstruct true - AtlfastProtoJetMaker.TowerPJSmearOn false - AtlfastProtoJetMaker.ClusterPJSmearOn false - Table 2-10. The AtlfastProtoJetMaker Default Settings VARIABLE DEFAULT VALUE ATLFASTF EQUIVALENT AtlfastB.AtlfBjetSwitch true - AtlfastB.AtlfCalSwitch true - AtlfastB.AtlfTauSwitch true - AtlfastB.AtlfTauVetoSwitch false - AtlfastB.AtlfTrigMuoSwitch false - AtlfastB.JetCorrFile "./AtlfastBjet.dat" - AtlfastB.CJetCorrFile "./AtlfastBcjet.dat" - AtlfastB.AtlfBNSet 1 - AtlfastB.TauEff 0.05 - AtlfastB.TauVetoOption 1 - Table 2-11. The AtlfastB Default Settings IMPORTANT NOTES 1) ParticleTypes should never be changed by the user. 3) Cone is the only available ClusterMaker.Strategy at the moment. 4) The neutrinos are hardwired into GlobalEventDataMaker as invisibles.