{{indexmenu_n>2}}

[[:|<< back to HepSim manual]]

====== Analyzing events ======

The Monte Carlo files (truth level, fast simulations and full simulations) 
 can be accessed from the [[http://atlaswww.hep.anl.gov/hepsim/ | HepSim repository]] link. 
Currently these studies are based on  [[http://atlaswww.hep.anl.gov/asc/jas4pp|Jas4pp data-analysis environment]].
Geometry files for full detector simulations can be found in the  [[http://atlaswww.hep.anl.gov/hepsim/soft/detectors/|detector repository]].


You have several choices for data analysis:

  * Using the hs-tools package. It is designed for downloading files and processing truth-level files using Python/Jython scripts (or using Java)
  * Using [[http://atlaswww.hep.anl.gov/asc/jas4pp/|Jas4pp]]. It is similar to the above package, but it has packages needed to process full-simulation samples (SLCIO files).
  * Using C++/ROOT. If you run over ProMC (truth-level) files, look at the manual [[https://atlaswww.hep.anl.gov/asc/promc/|ProMC manual]]. 
  * If you run over ROOT files from Delphes, use [[https://cp3.irmp.ucl.ac.be/projects/delphes|Delphes manual]].  Note that Delphes ROOT files can be processed using Java Jas4pp program.
  * If you analyse LCIO files with full simulation, look at [[http://lcio.desy.de/v01-07/doc/manual_html/manual.html|LCIO manual]].

Some analysis examples implemented in Python and C++ can be found in [[fcs:fcchh:intro|here]]. Here are more resources:


  * [[https://github.com/hepsim-org/analysis]] - shows analysis examples illustrating how to read  ProMC and LCIO files.
  * [[http://atlaswww.hep.anl.gov/hepsim/macrolist.php|ProMC validation]] - lists  examples that read ProMC files. The examples are implemented in Jython/Python. They can be converted to Java.
  * [[http://atlaswww.hep.anl.gov/hepsim/macrolist_lcio.php|LCIO validation]] - lists  examples that read LCIO files. The examples are implemented in Jython/Python. They can be converted to Java.



======  Finding detector simulations  ======

Every entry in the HepSim has "truth-level" files (created by Monte Carlo generators) and reconstruction tags: Data after processing 
by the fast simulation program (Delphes) have the tag "rfastNNN" (NNN is a number), while data after full simulation have the tag "rfullNNN" (NNN is a number). The info pages for each sample has the link to the tag and the information page describing the detector.
 
If you need to find all samples for a given tag, use the [[http://atlaswww.hep.anl.gov/hepsim/search.php|search page]]. Then type the tag name.
For example, if you are searching for the "**rfull006**" reconstruction tag, this page  returns a complete list of Monte Carlo samples which were processed for a given detector.





======  Physics and detector studies  ======

 Here are several links to extending this Wiki for particular detector-performance topics:
 

  * [[fcs:fcchh:|FCC-hh detector studies]] - explains how to analyses data for FCC-hh detector studies
  * [[fcs:sid:intro|SID detector studies]] - explains how to analyses data for the SiD detector (ILC)
  * [[fcs:cepc:intro|CEPC detector studies]] - shows some results with full simulations for CEPC
  * [[fcs:eic:intro|EIC detector studies]] - shows some results with full simulations for EIC
  * [[vlhc:hcal|HCAL studies]] explains how to analyse ROOT data after fast detector simulations used for FCC studies

Currently these studies are based on  [[http://atlaswww.hep.anl.gov/asc/jas4pp|Jas4pp data-analysis environment]].
Geometry files for full detector simulations can be found in the  [[http://atlaswww.hep.anl.gov/hepsim/soft/detectors/|detector repository]].

This manual describes how to work with truth-level samples posted on HepSim.
[[https://atlaswww.hep.anl.gov/asc/wikidoc/doku.php?id=community:refhepsim_analysis|HepSim Python/Java analysis page]] explains how to write code to read truth-level files using Python on the Java platform.

 --- //[[chekanov@hep.anl.gov|Sergei Chekanov]] 2016/04/27 11:37//