Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
hepsim:dev_fast [2017/03/19 14:06]
hepsim17 [Reproducing HepSim simulations] 		hepsim:dev_fast [2018/04/27 16:35]
hepsim17
Line 1: Line 1:
- {{indexmenu_n>10}}+{{indexmenu_n>12}}
  
  
 [[:|<< back to HepSim manual]] [[:|<< back to HepSim manual]]
  
-Fast simulations in the HepSim are posted under the [[http://atlaswww.hep.anl.gov/hepsim/list.php?find=rfast | rfast link]]. The detectors configurations are posted +====== Creating Delphes files ======
-to [[http://atlaswww.hep.anl.gov/hepsim/detectors.php|this link]].+
  
-===== Creating Delphes files  ===== 
  
-Here we describe how to make fast detector simulation files  +Fast simulations in the HepSim are posted under the [[http://atlaswww.hep.anl.gov/hepsim/list.php?find=rfast|rfast link]]. The detectors configurations are posted to [[http://atlaswww.hep.anl.gov/hepsim/detectors.php|this link]].
-using separate external libraries, without installing FastHepSim. +
-Use the [[https://cp3.irmp.ucl.ac.be/projects/delphes | Delphes]] fast detector simulation program to process the MC events. Delphes can read [[http://atlaswww.hep.anl.gov/asc/promc/ | ProMC]] files directly. First, make sure that ProMC and ROOT library is installed: +
-<code bash> +
-echo $PROMC $ROOTSYS +
-</code> +
-This should point to the installation paths of ProMC and ROOT. +
-  +
-Here are the steps to perform a  fast detector simulation using ProMC files from the HepSim repository:+
  
-1) Download [[http://cp3.irmp.ucl.ac.be/downloads/Delphes-3.3.0.tar.gz | Delphes-3.3.0.tar.gz]] (or higher) and compile it as:  +Generally, you do not need to install Delphes to run fast simulations. You can run fast simulations using the HepSim singularity container. This topic is described in [[hepsim:dev_singularity|HepSim singularity container]] section. 
-<code bash> +
-wget http://cp3.irmp.ucl.ac.be/downloads/Delphes-3.2.0.tar.gz +
-tar -zvxf Delphes-3.3.0.tar.gz +
-cd Delphes-3.3.0 +
-./configure +
-make +
-</code> +
-This  creates the converter "DelphesProMC" (among others), if "PROMC" environmental variable is detected. +
  
-2)  For FCC studies, copy and modify the detector configuration file "delphes_card_FCC_basic.tcl"  +Below is the description how to use Delphes if you do not want to use the HepSim docker container.
-<code bash> +
-cp cards/delphes_card_FCC_basic.tcl delphes_card_FCC_notau.tcl +
-</code> +
-Then remove the line "TauTagging". Do the same when using the card "cards/delphes_card_ATLAS.tcl" (for ATLAS). +
-We do not use  the tau tagging module since it requires complete event records with all mother particles. Since ProMC files are often slimmed by removing some unstable low pT particles and showered partons, Delphes will fail on this line. If you need tau tagging, please use ProMC files with complete particle record.+
  
-3) Download Monte Carlo files from the [[ http://mc.hep.anl.gov/asc/hepsim/events/?dir=pp/100tev | 100 HepSim repository]]. +===== Creating Delphes files  =====
-For example, get a file with 5000 ttbar events generated for a 100 TeV collider: +
-<code bash> +
-wget http://mc.hep.anl.gov/asc/hepsim/events/pp/100tev/ttbar_mg5/mg5_ttbar_100tev_001.promc +
-</code> +
- +
-and then create a ROOT file with reconstructed objects after a  fast detector simulation (FCC detector):+
  
 +Here we describe how to make fast detector simulation files  using separate external libraries, without installing FastHepSim. Use the [[https://cp3.irmp.ucl.ac.be/projects/delphes | Delphes]] fast detector simulation program to process the MC events. Delphes can read [[http://atlaswww.hep.anl.gov/asc/promc/ | ProMC]] files directly. First, make sure that ProMC and ROOT library is installed:
 <code bash> <code bash>
-./DelphesProMC delphes_card_FCC_notau.tcl  mg5_ttbar_100tev_001.root mg5_ttbar_100tev_001.promc+echo $PROMC $ROOTSYS
 </code> </code>
-The conversion typically takes 30 seconds. +This should point to the installation paths of ProMC and ROOT. The detectors configurations for Delphes together with appropriate Delphes package are posted to [[http://atlaswww.hep.anl.gov/hepsim/detectors.php#fast|this link]].
- +
-===== Reproducing HepSim simulations  ===== +
-The detectors configurations for Delphes together with appropriate Delphes package +
-are posted to [[http://atlaswww.hep.anl.gov/hepsim/detectors.php|this link]].+
 Copy the ZIP file with Delphes card and Delphes package and compile it. Copy the ZIP file with Delphes card and Delphes package and compile it.
  
Line 58: Line 26:
  
 <code bash> <code bash>
-echo $PROMC          # make sure ProMC variable is defined. Must be non-empty  
-echo $ROOTSYS        # make sure ROOT is installed. Must be non-empty 
 det="delphes_atlas1" # define detector det="delphes_atlas1" # define detector
 wget http://atlaswww.hep.anl.gov/hepsim/soft/detectors/$det.zip wget http://atlaswww.hep.anl.gov/hepsim/soft/detectors/$det.zip
Line 65: Line 31:
 cd $det cd $det
 tar --strip-components=1 -zvxf Delphes*.tar.gz # untar in the current directory tar --strip-components=1 -zvxf Delphes*.tar.gz # untar in the current directory
-./cofigure +./configure; make                              # configure and compile                                      
-./DelphesProMC card.tcl  file.promc # run test using input ProMC file+</code>                                         
 +The last command should create the binary file "DelphesProMC". Now you can process a ProMC file: 
 + 
 +<code bash> 
 +wget http://mc.hep.anl.gov/asc/hepsim/events/pp/14tev/mg5_ttbar_jet/mg5_ttbar_jet_001.promc 
 +./DelphesProMC card.tcl mg5_ttbar_jet_001.root mg5_ttbar_jet_001.promc
 </code> </code>
 +This commands creates a ROOT file with fast simulations.
 +
 +<note>
 +Detector configuration files [detector].zip include the Delphes source code  used to make the simulation tag, 
 +and the input control card "card.tcl" that defines the geometry. Look at [[http://atlaswww.hep.anl.gov/hepsim/detectors.php#fast|this link]].
 +</note>
  
-Now you can create a complete list of input files. Here is how to do this:+You can create a complete list of input files. Here is how to do this:
  
 <code bash> <code bash>
Line 85: Line 62:
 </code> </code>
 where [setname] is the dataset name, such as "tev100_ttbar_mg5". where [setname] is the dataset name, such as "tev100_ttbar_mg5".
-If you know URL of the mirror, replaces [setname] with qualified URL pointing to your dataset.+If you know URL of the mirror, replaces [setname] with qualified URL pointing to your dataset. Now, you have the necessary tools. Fetch the list of URLs with input files, and make a loop over files. 
  
-Now, you have the necessary tools. Fetch the list of URLs with input files, and make a loop over files. 
  
 +One can also run Delphes in an automated mode, without the above scripts. You need to use "hs-exec" command.
 +<code bash>
 +hs-exec DelphesProMC card.tcl output.root [URL] [Nfiles]
 +</code>
 +where [URL] is HepSim location of files and  [Nfiles] is the number of files for processing.
 +The output ROOT will be located inside "hepsim_output" directory.
  
 +Here is a small example:
 +<code bash>
 +hs-exec DelphesProMC card.tcl output.root http://mc.hep.anl.gov/asc/hepsim/events/pp/14tev/mg5_ttbar_jet/ 5
 +</code>
 +which processes 5 files from [[http://atlaswww.hep.anl.gov/hepsim/info.php?item=143/|HiggsToTTbar sample]]. Skip "5" at the end to process all files.                                                                                                                                                              
 +
 +
 +
 +====== Creating files manually ======
 +
 +
 +If you want to create a new simulations with updated Delphes and input cards, follow these steps:
 +
 +
 +(1) Download [[http://cp3.irmp.ucl.ac.be/downloads/ | current Delphes ]] (or higher) and compile it as: 
 +<code bash>
 +tar -zvxf Delphes-X.X.Xtar.gz
 +cd Delphes-X.X.X.tar.gz
 +./configure
 +make
 +</code>
 +where "X.X.X" is the version of Delphes. This  creates the converter "DelphesProMC" (among others), if "PROMC" environmental variable is detected. 
 +
 +(2)  Copy and modify the detector configuration files. The configuration files with the extension "tcl" can be found in [[http://atlaswww.hep.anl.gov/hepsim/detectors.php|this link]]
 +
 +Often,  the line "TauTagging" from the Delphes control card. We do not use  the tau tagging module since it requires complete event records with all mother particles. Since ProMC files are often slimmed by removing some unstable low pT particles and showered partons, Delphes will fail on this line. If you need tau tagging, please use ProMC files with complete particle record.
 +
 +Download Monte Carlo files from the [[ http://mc.hep.anl.gov/asc/hepsim/events/?dir=pp/100tev | 100 HepSim repository]].
 +For example, get a file with 5000 ttbar events generated for a 100 TeV collider:
 +<code bash>
 +wget http://mc.hep.anl.gov/asc/hepsim/events/pp/100tev/ttbar_mg5/mg5_ttbar_100tev_001.promc
 +</code>
 +
 +and then create a ROOT file with reconstructed objects after a  fast detector simulation (FCC detector):
 +
 +<code bash>
 +./DelphesProMC card.tcl  mg5_ttbar_100tev_001.root mg5_ttbar_100tev_001.promc
 +</code>
  
 ===== On the fly reconstruction ===== ===== On the fly reconstruction =====
Line 159: Line 179:
  
  
 +<note important>Tim Kallage made a correction for DPF Delphes card that corrects b-tagging. Download it from 
 +{{ :hepsim:snowmass_fixed.tcl.txt |}}</note>
  
  
hepsim/dev_fast.txt · Last modified: 2018/04/27 16:35 by hepsim17
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International


  • Show page
  • Old revisions
  • Backlinks
  • Recent Changes
  • Media Manager
  • Sitemap