CMS Wiki Pages

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Phase 2 Upgrade Studies ======

===== Phase 2 Workshop January 26-27 =====

A two day workshop ([[https://indico.cern.ch/event/363441/|Indico]]) will be held at the end of January with the aim of exploring what can be achieved with a better CMS detector for Phase 2 LHC. For these studies we will be using the [[https://cp3.irmp.ucl.ac.be/projects/delphes|Delphes]] fast simulation framework overlaid with [[http://iopscience.iop.org/1748-0221/9/03/C03054/pdf/1748-0221_9_03_C03054.pdf|tkLayout]] for the tracker geometry.

===== Prerequisites =====

Instructions are based on the setup at the Tier3 at PSI, but should generally also work on any other SLC6 machine such as lxplus (the CMS environment might have to be set up differently). To get an account at the Tier3, follow the instructions at https://wiki.chipp.ch/twiki/bin/view/CmsTier3/HowToGetAccount.

The following instructions assume that you are set up to clone packages from github.
There is an FAQ for CMSSW (http://cms-sw.github.io/faq.html), which is not needed for this tutorial, but you should make sure that you added your private ssh key to your github account as detailed here: https://help.github.com/articles/generating-ssh-keys/

If you don't have a wiki account (it should be your standard username e.g. like the one at PSI) yet, please send Clemens a mail so he can create one for you.

===== Delphes ===== 
==== Getting the software ==== 
  * There exists a CMS "short-version" and an official version of Delphes. We are going to use the CMS version as this contains Detector Cards for the Phase 2 detector layout with 140 PU.
  * Instrucions on how to set up the CMS Delphes version can be found [[https://twiki.cern.ch/twiki/bin/viewauth/CMS/HiggsWG/Phase2UpgradeStudies#Recommended_tag_and_version|here]]. A summary is given below. 
Fork the code from Git, which is browsable [[https://github.com/UZHCMS/Delphes|here]] or [[https://github.com/delphes/delphes|here]] for the official version) by just following the steps [[https://github.com/UZHCMS/Delphes/fork|here]] before cloning it to your local directory.

Log into an SLC6 computer (t3ui12). Do yourself a favour and be organized:

  mkdir $HOME/Phase2UpgradeStudies
  cd $HOME/Phase2UpgradeStudies
  source /cvmfs/cms.cern.ch/cmsset_default.sh
  cmsrel CMSSW_5_3_24
  cd CMSSW_5_3_24/src
  cmsenv
  cd ../..

Clone a copy of the repository:
  git clone git@github.com:`git config user.github`/Delphes.git
Build
  cd Delphes/
  ./configure
Follow the instructions (i.e. remember to export PYTHIA8), and compile:
  export PYTHIA8=$HOME/Phase2UpgradeStudies/CMSSW_5_3_24/src/Delphes/external/pythia8201
  make
Congratulations, you are now ready to run Delphes!

Each time you start a new session (but not now, since you just set everything up), you need to do:
  cd $HOME/Phase2UpgradeStudies/CMSSW_5_3_24/src
  source /cvmfs/cms.cern.ch/cmsset_default.sh
  cmsenv
  export PYTHIA8=$HOME/Phase2UpgradeStudies/CMSSW_5_3_24/src/Delphes/external/pythia8201
  cd ../../Delphes

Depending on what type of input files you want to use, different readers are used. For CMS ROOT files the syntax is
  ./DelphesCMSFWLite Datacard.tcl output.root input.hepmc
Three arguments must be passed: the data card containing the detector configuration, the output file and the input file.\\
You can for instance run on data cards for the CMS Phase 2 detector with pileup. Get a minimum bias file:
  wget http://uaf-2.t2.ucsd.edu/~spadhi/Snowmass/data/MinBias100K_14TeV.pileup
  mv MinBias100K_14TeV.pileup MinBias.pileup   
Use a CMS Phase 2 data card with pileup
  Cards/JetStudies_Phase_II_140PileUp_conf4.tcl
Run on a GenSIM file
  ./DelphesCMSFWLite Cards/JetStudies_Phase_II_140PileUp_conf4.tcl Output.root /shome/thaarres/Data/Phase2UpgradeStudies/TTH_HToBB_M-125_14TeV-pythia6_GENSIM.root   
 Examine the output:
  root -l
  gSystem->Load("libDelphes");
  TFile::Open("Output.root");
  Delphes->Draw("Electron.PT");
  TBrowser browser;      
The different branches of the "Delphes" tree are listed [[ https://cp3.irmp.ucl.ac.be/projects/delphes/wiki/WorkBook/RootTreeDescription|here]]. For macro based analysis look in the [[https://cp3.irmp.ucl.ac.be/projects/delphes/browser/examples|examples/]] directory. Example1.C gives a simple example of histogram booking, event loop and histogram display. Check the [[https://cp3.irmp.ucl.ac.be/projects/delphes/wiki/WorkBook|WorkBook]] for more advanced examples. \\

An analysis macro is already available:
   cp /shome/thaarres/Share/Phase2/Analysis.C ~Delphes/examples
   cp /shome/thaarres/Share/Phase2/Analysis.cpp ~Delphes/examples

Do
   ./configure
   make


===== tKLayout =====
tKLayout is a design tool for tracking detectors. It allows for rapid modeling and comparison of many different architectural variations, where new performance estimates and support for different detector geometries can be added quickly. We will use it to create 3D models of the design of the CMS tracker and to evaluate its fundamental performance figures to help in the choice of a viable detector layout for Phase 2 LHC.

===tkLayout with Delphize ===
In order to convert the tkLayout output to a format compatible with Delphes, Delphize is used. This tool only exists in the version used for the CUPS school and is not in the official release of tkLayout. To obtain the version containing Delphize please fork the repository by clicking [[https://github.com/UZHCMS/tkgeometry/fork|here]] and then do:
  cd $HOME/Phase2UpgradeStudies
  git clone git@github.com:`git config user.github`/tkgeometry.git
  cd tkgeometry
and do 
  source setup_slc6.sh
  mkdir lib
  make
  mkdir -p www/layouts
You will then have to adjust the tklayout.config file, simply replace the username. It contains the following info, where the default is:
  * Executables: $HOME/Phase2UpgradeStudies/tkgeometry/bin
  * Web server directory: $HOME/Phase2UpgradeStudies/tkgeometry/www/layouts
  * Standard output directory: $HOME/Phase2UpgradeStudies/tkgeometry
  * List of transverse momenta to be used for tracking performance test: 1.00, 10.00, 100.00, 500.00, 1000.00
  * List of transverse momenta to be used for trigger efficiency performance test: 1.00, 10.00, 100.00, 500.00, 1000.00
  * List of trigger efficiency to be used: 1,50,90,95
Then type:
  make install
Try running tkLayout:
  cd geometries/BarrelEndcap_Nick2013/Traditional/
  tklayout -r TechnicalProposal2014.cfg
The output is stored in $HOME/Phase2UpgradeStudies/tkgeometry/www/layouts (if this is what you set as your web server directory). For a "visual impression", open the file index.html
  firefox index.html
You can now do
  delphize
This will list the available resolution files produced by tkLayout that can be converted to Delphes configuration files. For example:
    [thaarres@t3ui12 Traditional]$ delphize
    Available resolution files:
    File 1 = TechnicalProposal2014/linptres_pixel_MS000.root
    File 2 = TechnicalProposal2014/linptres_tracker_MS000.root
    File 3 = TechnicalProposal2014/linptres_trigger_MS000.root
You will then be asked to select your desired resolution file (1,2,3....)
    Select the desired resolution: 1
The new resolution configuration files will be stored at $HOME/Phase2UpgradeStudies/tkgeometry/www/layouts/TechnicalProposal2014/delphes/. The EfficiencyFormula and ResolutionFormula are in a format that can be copied ans pasted into your Delphes data card.

For some running options, have a look at [[http://mersi.web.cern.ch/mersi/1.2_Installation_and_running.html|Stefanos CUPS instructions]].  

Bens local copies of tkLayout and Delphes can be found at **linux.physik.uzh.ch:/home/hep/bjk/cups** with a short description from Ben [[phase2:BensNotes|here]].

===== Tasks =====

See [[phase2:experts|Experts list]]

===== Additional material =====
  * Presentation on [[http://conference.ippp.dur.ac.uk/event/247/material/slides/0.pdf|Delphes]]
  * Presentation on [[https://indico.cern.ch/event/264837/material/slides/0?contribId=1|Delphes CMS Phase-II Configurations]]
  * Presentation on [[https://indico.cern.ch/event/262190/material/slides/1?contribId=9|Delphes Validation using H → 4μ analysis]]
  * Presentation on [[https://indico.cern.ch/event/259860/material/slides/0?contribId=1|Phase II Delphes Cards]]
  * Presentation on [[https://indico.cern.ch/event/356574/contribution/8/material/slides/0.pdf|Delphes Detector Simulation: Improvements for the TP]]

===== Links =====
  * [[https://cp3.irmp.ucl.ac.be/projects/delphes|Official Delphes page]]
  * [[https://github.com/sethzenz/Delphes|CMS Delphes on Git]]
  * [[https://github.com/delphes/delphes|Official Delphes on Git]]
  * [[https://indico.cern.ch/event/363441/|Phase 2 Upgrade Workshop Indico]]
  * [[https://twiki.cern.ch/twiki/bin/view/CMS/TkLayout| tklayout CMS twiki]]
  * [[https://code.google.com/p/tkgeometry/wiki/ConfigFilesOverview | tkgeometry description]]
  * [[http://iopscience.iop.org/1748-0221/9/03/C03054/pdf/1748-0221_9_03_C03054.pdf| tklayout paper]]
  * [[phase2:old_phase2|Link to old Delphes instructions]]
  * [[phase2:old_tklayout|Old tkLayout instructions (without Delphize)]]
  * [[https://twiki.cern.ch/twiki/bin/viewauth/CMS/VFPix#Strawman_geometry_5|Description of Roland design - strawman 5]]
  * [[https://git.cern.ch/web/CMS-VFPIX.git/blob/HEAD:/TklayoutConfigs/Pixel/PixelStrawman_5.cfg|Roland VFPIX design]]
Physik-Institut

CMS Wiki Pages

User Tools

Site Tools

Page Tools
