====== About HepSim ======
 
 

[[http://atlaswww.hep.anl.gov/hepsim/ | HepSim]] is a public repository with Monte Carlo simulated events for particle-collision  experiments.
The [[http://atlaswww.hep.anl.gov/hepsim/ | HepSim repository]] was started at ANL during the US long-term planning study of the American Physical Society’s Division of Particles and Fields (Snowmass 2013).
It contains predictions  from leading-order (LO) parton shower models, next-to-leading order (NLO) and NLO with matched parton showers.
It also includes Monte Carlo events after fast ("parametric") and full (Geant4) detector simulations and event reconstruction.

HepSim  contains event samples for physics and detector-performance studies
for High-Luminosity LHC (HL-LHC), International Linear Collider (ILC), Very Large Hadron Collider (VLHC), Future Circular Collider (FCC-ee and FCC-hh),
Compact Linear Collider (CLIC), Circular Electron-Positron Collider (CEPC), Electron-Ion Collider (EIC) and other future particle colliders.


HepSim Monte Carlo samples are registered by the U.S. Department of Energy
Office of Scientific and Technical Information,  [[https://www.osti.gov/elink/ | OSTI.GOV]].                       
Each event sample is assigned a DOI (Digital Object Identifier) number as listed on the [[https://www.osti.gov/search/semantic:ANL-HEPSIM|ANL-HEPSIM  OSTI.GOV]]  page.
The assigned DOI numbers are also indicated on the HepSim information panel for datasets.    
HepSim was designed following
the guidelines and principles of [[http://www.energy.gov/sites/prod/files/2014/08/f18/DOE_Public_Access%20Plan_FINAL.pdf|DOE Public Access Plan]]
for unclassified and otherwise unrestricted scientific data in digital formats.


====== For HepSim users ======
{{:hepsim:bghep1.png?1600x20|HepSim manual:For HepSim users }}

If you are a HepSim user, start from here.
 

  * [[hepsim:quick|Quick start with HepSim]]
  * [[hepsim:usage_download| How to find, view and download data]]
  * [[hepsim:usage_truth| Making plots using  EVGEN (truth-level) files]]
  * [[hepsim:usage_analysis| HepSim analysis tutorial]]
  * [[hepsim:usage_fast| How to analyse fast simulations]]
  * [[hepsim:usage_full| How to analyse full (Geant4) simulations]]
  * [[hepsim:jas4pp|Jas4pp introduction]]
  * [[hepsim:usage_view| Visualizing events]]
  * [[hepsim:usage_detectors| Detector descriptions and reconstructed tags]]

<note tip>See also: {{:hepsim_tour.pdf|"A tour of HepSim from user's perspective" by David Blyth}}
([[https://docs.google.com/presentation/d/1GT8Q_VTtW8ekeLWxSrvta32p6nbc4uIX_1NzU2DZ-G0/edit?usp=sharing|or in pptx]])
</note>

======  Physics and detector studies  ======
{{:hepsim:bghep1.png?1600x20|HepSim manual:Physics and detector studies}}

Here are several links for 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:|SID detector studies]] - explains how to analyses data for the SiD detector (ILC)
  * [[fcs:cepc:|CEPC detector studies]] - shows some results with full simulations for CEPC
  * [[fcs:eic:|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


====== For developers ======
{{:hepsim:bghep1.png?1600x20|HepSim manual:For developers}}

If you plan to contribute to HepSim (Monte Carlo events, data storage etc), read this:

  * [[hepsim:dev_truth | Creating truth-level samples]]
  * [[hepsim:dev_fast | Creating fast detector simulations]]
  * [[hepsim:dev_full | Creating full (Geant4) detector simulations]]
  * [[hepsim:dev_hepsim | Making a mirror or publishing your files]]
  * [[hepsim:pgun | Single particle guns]]
  * [[hepsim:dev_opentasks | Open tasks]]





====== Public results ======
{{:hepsim:bghep1.png?1600x20|HepSim manual:Public results and contributions}}


  * [[hepsim:public|List with pubic results based on HepSim]]


====== Contributions ======
{{:hepsim:bghep1.png?1600x20|HepSim manual:Public results and contributions}}


  * [[hepsim:contributions| List with contributions to the HepSim repository]]


====== How to cite ======
{{:hepsim:bghep1.png?1600x20|HepSim manual:For HepSim users }}

If you use HepSim event samples, Python/Jython analysis scripts and output XML files in  your research, talks or
publications, please cite this project as:

S.V. Chekanov. //HepSim: a repository with predictions for high-energy physics experiments//. Advances in High Energy Physics, vol. 2015, ID136093, 2015. [[http://arxiv.org/abs/1403.1886 | arXiv:1403.1886]]  and [[http://www.hindawi.com/journals/ahep/2015/136093/|link]]. 

<hidden Click here to display BibTeX article entry>
<code bibtex>
@article{Chekanov:2014fga,
      author         = "Chekanov, S.V.",
      title          = "{HepSim: a repository with predictions for high-energy physics experiments}",
      year           = "2015",
      eprint         = "1403.1886",
      journal        = "Advances in High Energy Physics",
      volume         = "2015",
      pages          = "136093",
      archivePrefix  = "arXiv",
      primaryClass   = "hep-ph",
      note           = {Available as \url{http://atlaswww.hep.anl.gov/hepsim/}}
}
</code>
</hidden>


====== Acknowledgement ======
The current work  is supported  UChicago Argonne, LLC,
Operator of Argonne National Laboratory (``Argonne'').
Argonne, a U.S. Department of Energy Office of Science laboratory,
is operated under Contract No. DE-AC02-06CH11357.
This research used resources of the Argonne Leadership Computing Facility at Argonne National Laboratory, which is supported by the Office of Science of the U.S. Department of Energy under contract DE-AC02-06CH11357.


 --- //[[chekanov@anl.gov|Sergei Chekanov]] 2016/04/29 16:24//