------------------------------------------------ My Data Samples ------------------------------------------------

Notes

The first two digits of the 6 digit code after mc08 (for example) implies the COM energy of the sample:

10 = 10 TeV 00 = 14 TeV

Z'

mc08.105603.Pythia_Zprime_ee_SSM1000.recon.AOD.e352_s462_r541
mc08.105624.Pythia_Zprime_ee_SSM1500.recon.AOD.e357_s462_r541

Graviton

@ 10 TeV

mc08.105616.Pythia_Gee_300.recon.AOD.e355_s462_r541

Release E CM G* Mass k/Mpl N Evts xsec x BR
14.1.0 10 TeV 300 GeV 0.01 5 000 834 fb
14.1.0 10 TeV 500 GeV 0.01 5 000 79 fb
14.1.0 10 TeV 750 GeV 0.05 5 000 257 fb
14.1.0 10 TeV 1000 GeV 0.05 5 000 54.4 fb
14.1.0 10 TeV 1400 GeV 0.05 5 000 7.7 fb

@ 7 TeV

Release E CM G* Mass k/Mpl N Evts xsec x BR
15.6.1.7 7 TeV 300 GeV 0.01 5 000 521.6 fb
15.6.1.7 7 TeV 500 GeV 0.01 5 000 40.46 fb
15.6.1.7 7 TeV 800 GeV 0.01 5 000 2.996 fb
15.6.1.7 7 TeV 1000 GeV 0.01 5 000 0.7839 fb
15.6.1.7 7 TeV 500 GeV 0.03 5 000 369.5 fb
15.6.1.7 7 TeV 800 GeV 0.03 5 000 26.98 fb
15.6.1.7 7 TeV 1000 GeV 0.03 5 000 6.925 fb
15.6.1.7 7 TeV 700 GeV 0.05 5 000 163.7 fb
15.6.1.7 7 TeV 1000 GeV 0.05 5 000 19.42 fb
15.6.1.7 7 TeV 1250 GeV 0.05 5 000 4.567 fb
15.6.1.7 7 TeV 1500 GeV 0.05 5 000 1.324 fb
15.6.1.7 7 TeV 800 GeV 0.1 5 000 298.2 fb
15.6.1.7 7 TeV 1000 GeV 0.1 5 000 77.34 fb
15.6.1.7 7 TeV 1250 GeV 0.1 5 000 18.38 fb
15.6.1.7 7 TeV 1500 GeV 0.1 5 000 5.288 fb

Z Boson

mc08.005144.PythiaZee.recon.AOD.e323_s400_d99_r474_tid023534

Drell-Yan

mc08.105417.Pythia_DYee_75M120.recon.AOD.e447_s495_r635_tid078079
mc08.105418.Pythia_DYee_120M250.recon.AOD.e447_s495_r635_tid078080
mc08.105419.Pythia_DYee_250M400.recon.AOD.e447_s495_r635_tid078081
mc08.105420.Pythia_DYee_400M600.merge.AOD.e447_s495_r635_t53_tid078870
mc08.105421.Pythia_DYee_600M800.recon.AOD.e447_s495_r635_tid078083
mc08.105422.Pythia_DYee_800M1000.recon.AOD.e447_s495_r635_tid078084
mc08.105423.Pythia_DYee_1000M1250.recon.AOD.e447_s495_r635_tid078085

--------------------------------- How To Make a MC Production Request ---------------------------------

To Start & Overview

This might vary slightly depending what group you are in. But having gone through the process now, I think a guide would be very useful, hope it helps!

On your groups home Twiki page, there should be a page dedicated to how to make Monte Carlo requests, but in general you can go to the Monte Carlo Working Group page, where they list the relevant contacts for every group:

The General List of Pre-requisites for a MC Production Request are:

Note, before any of the below steps, you should contact your group convenors, and the MC Production Contact for your group, to let them know of your intentions, and ask if it would be okay to go ahead and start making the request.

• Provide a joboptions file
• Provide relevant cross-sections, evgen efficiencies, and number of events requested, along with centre of mass energy, and code version you are setup in, also the event generator version you are using.
• Make Validation Plots, from a small sample you make with your joboptions file. I.e. Provide relevant plots that show the joboptions file produces what you would expect.
• Put the Joboptions files, Validation plots, and all information so far on your groups relevant "Validation Plot" page under the process for which you are asking for samples, if there isn't one, create a new twiki page that is for your process.
• Contact your groups Monte Carlo Production Contact, sending them the link to the Twiki page, along with the joboptions files attached to the e-mail, and all the information so far requested (even though it is already on the Twiki). They will take the request from here, and let you know the outcome.

Setup Area

First of all, you need to setup your work area, this is best done on lxplus. Make your cmthome area and download a package to work in such as UserAnalysis. This is explained how to do so on the coding tips and tricks page. I am writing here assuming the use of 15.6.1, with the setup -tag=AtlasProduction,15.6.1.7,setup,runtime,opt,32.

Get joboptions files to use/modify

You can find the joboptions files for all of the Official Monte Carlo Samples here:

Or more importantly for MC9 now, here:

All I did, was find the Particle and Decay I was interested in, take the joboptions file, and modify it for my own needs. Most of the time this just involves changing the Mass or some Coupling, that is well documented in the joboptions file itself. If you want to do something more drastic however, like make a new sample that has not even been roughly coded before, then I have not done this, but I would suggest you start by looking at multiple joboptions files, such as if you wanted to simulate G->ee and G->mumu, where currently there are only seperate files that do this; Take the two seperate files, and copy the lines which correspond to the decaying of each process into a new file, start building your joboptions that way, and after testing with a well known joboptions to see what you would expect, test yours and see if it makes sense.

Making a Test Sample

Go to your run directory such as:

> cd testarea/15.6.1
> cd PhysicsAnalysis/AnalysisCommon/UserAnalysis/run

You need to obtain the following four files via, although the latter most is really just an example file:

> get_files PDGTABLE.!MeV
> get_files csc_genAtlfastTwoStep08_trf.py (Only for MC8)
> get_files csc_evgenTruthJetMet08_trf.py (Only for MC8)
> get_files jobOptions.pythia.py
> get_files Evgen_trf.py (Importantly for MC9)

Then you are ready to make your first sample, but first you have a choice. If you want truth, jet, and missing et information in your sample you should use:

> csc_evgenTruthJetMet08_trf.py 1 1 5000 1 MC8.000001.template.py evgen.pool.root sampleB.AOD.pool.root

However if you only need the normal information (which is all that is generally needed for validation plots, and I recommend), use:

> csc_genAtlfastTwoStep08_trf.py 1 1 5000 1 MC8.000001.template.py evgen.pool.root atlfast.AOD.pool.root genfast.NTUP.pool.root

Most importantly for MC9, you should use Evgen_trf.py, you can type this with the -h command after to see what the following tags mean, but to summarise in order they are; CentreOfMassE / RunNumber (Has to match your jobOption) / Starting Event / Number of Events / Random 10 Digit Seed / JobOptions / Output Filename.

In Reality if you ONLY want the Electron Container information etc without Jet Info and other things, then you only need to run the EvgenCorrAtlfast_trf.py.

> Evgen_trf.py 7000 0700000 1 5000 1234567812 MC9.0700000.Pythia_Gee01_1000.py Output.pool.root

> EvgenCorrAtlfast_trf.py 7000 0700000 1 5000 1234567812 MC9.0700000.Pythia_Gee01_1000.py Output.pool.root AOD.pool.root ntuple.pool.root

Note here, that MC8.000001.template.py is your joboptions file, and 5000, is the number of events you are going to make in your sample. The other file names are your output. I would recommend redirecting these to your tmp directory on lxplus as they can be 100mb big or so. Just remember to send them to linappserv1 or somewhere before you next log off so they don't disappear!

Making Validation Plots & Collecting Information

The next step is to take one of your no doubt already existing analysis programs, and strip it down so all it does it create plots of basic things like the, et spectrum, eta spectrum, and invariant mass, as an example. Apply no cuts, as you just want to see what the sample looks like. Save these plots, and include them with all the other information that you will eventually upload.

Important! When the job finishes running, you will be left with a number of log files, namely csc_evgen08.log and csc_genAtlfast.log, or EvgenCorrAtlfast_trf.log for MC09, you will want to keep these files as they contain all of your cross section information!!! Also remember to take note of the event generator efficiency, which is usually set to about 0.90, and can be found on the last line of your joboptions file usually. You will also want to look through them to see exactly what version of Pythia you are using, if you haven't taken note of it before now.

Finishing up

Now you have all your relevant information, go to the Validation Plot Twiki Page, and upload all of your information, this looks best in a table, you can just do what I did and look at a previous request, and take their format. The basic format you want though would be something like this:

Validation

Joboption for generation under Pythia 6.420 :
MC8.0000001.Pythia_Gee001_500.py
MC8.0000001.Pythia_Gee001_1000.py
MC8.0000001.Pythia_Gee01_1000.py

Release E CM G* Mass k/Mpl N Evts xsec x BR Validation plots
15.2.0 10 TeV 500 GeV 0.01 5 000 79.5 fb Electron pt, electron eta, G Mass
15.2.0 10 TeV 1000 GeV 0.01 5 000 2.17 fb Electron pt, electron eta, G Mass
15.2.0 10 TeV 1000 GeV 0.1 5 000 214.2 fb Electron pt, electron eta, G Mass

Generator Efficiency = 0.90

Now all that's left to do is send all of this information, along with the joboptions file(s), and a link to the Twiki page along to your MC Production representative, and everything should be taken out of your hands from there!

Automated Process

First of all I want to thank Peter Waller for his coding expertise which enabled me to realise this Process. I was faced with having to do all of the above, for 15 samples, and I thought there must be a simpler way of doing things, which led me to come up with this idea.

First of all you have to have set up most of the above steps, i.e. you need to:

• Install your work area to make test samples (15.6.1).
• Install an area to run over your test sample and make validation plots, i.e. Pt, Eta, and InvMass Histograms.
• Copy this Macro to the run directory of the above.

Now you will need to make a folder (I put it on my Desktop) and inside the folder do two things; Make a folder for every sample (Named Accordingly), and download the files below into the main folder.

You will have to change the paths in these files (namely joblist.txt and run_one_job.sh) to match and make sense for your own setup, but the files are self explanatory and I have added comments where necessary to make it a fairly trivial process.

Note the final step is to put a JobOptions File into each respective folder, and then simply open a terminal, navigate to the folder and run with ./run_all.sh.

The result should be that each sample folder is filled with the needed validation plots, and cross-section text file, thus simplifying and automating the whole process to the nth degree!