====== BG@HEPlib manual ======
(S.Chekanov, E.May)

{{:hpc:bghep:bghep1.png?1600x20|BG@HEPlib library}}

ANL BG-HEP library is designed to run CPU-intensive HEP calculations on the BlueGene/Q supercomputer (Vesta/Mira) of [[https://www.alcf.anl.gov/ | Argonne Leadership Computing Facility]].  
The main features of the BG@HEP library are:

  * Many packages have been redesigned removing ROOT, HBOOK  and CERNLIB calls
  * Monte Carlo / NLO programs redesigned to use MPI for random seeds and outputs on multiple cores
  * The default output of event records is [[https://atlaswww.hep.anl.gov/asc/promc/| ProMC file format]] 

The following HEP libraries are supported:


  * CERNLIBlite  - a light version of [[http://www.desy.de/~chekanov/cernlib/ | CERNLIB]] (without HBOOK, my slimmed version SC)
  * fastjet (v 3.03) -  jet library [[http://fastjet.fr/ | Fastjet]]
  * hepmc  (v 2.06.09) - [[http://lcgapp.cern.ch/project/simu/HepMC/ | HEPMC library]]
  * lhapdf5 (v5.9) - [[https://lhapdf.hepforge.org/ | LHAPDF the Les Houches Accord PDF Interface]]
  * lhapdf6 (v6.4)
  * [[http://mcfm.fnal.gov/ | MCFM v.6.7]] - NLO program with ProMC output for ntuples
  * jetphox (v3.02) - A JetPhox NLO program
  * promc   (v1.3) - [[https://atlaswww.hep.anl.gov/asc/promc/ | ProMC data I/O library]]
  * protobuf (v2.5) - (comes with ProMC)
  * pythia8 (v8180)- Pythia8 with [[https://atlaswww.hep.anl.gov/asc/promc/ | ProMC]] output
  * [[http://lapth.cnrs.fr/PHOX_FAMILY/jetphox.html | jetphox]] 1.302  - NLO program with [[https://atlaswww.hep.anl.gov/asc/promc/ | ProMC]] output 
  * zlib (v2.09)

To setup the library, run this setup script:

<code bash>
source /home/chakanau/public/BG-HEP/bghep_setup.sh
</code>

This will setup the above libraries. Each library has a "Makefile" which can be compiled and run a program on BlueGene/Q.
Look at this "bghep_setup.sh" to see location of each library.


A list of Monte Carlo simulations and NLO programs generated on BlueGene/Q (Vesta, ANL) is listed on the **[[http://atlaswww.hep.anl.gov/hepsim/ | =HepSim= event repository]]**.

You can download this package as [[http://atlaswww.hep.anl.gov/asc/download/BG-HEP.tgz |BG-HEP.tgz]]**.

====== Acknowledgement ======

//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.
//


[[hpc:bghep:| << back]]

 --- //[[chekanov@anl.gov|Sergei Chekanov]] 2014/02/04 10:24//