Differences

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

--- hepsim:dev_singularity [2017/10/10 18:49]
hepsim17 [Fortran generators]
+++ hepsim:dev_singularity [2019/10/30 20:59] (current)
hepsim17 [Setting up Jas4pp]
@@ Line 2: / Line 2: @@
 {{indexmenu_n>14}}
 [[:|<< back to HepSim manual]]
 HepSim software is deployed using a [[http://singularity.lbl.gov/|Singularity/Docker]]  that enables HepSim users to have a full control of their simulation environment.
@@ Line 11: / Line 12: @@
 <code bash>
-wget http://atlaswww.hep.anl.gov/hepsim/soft/centos7hepsim.img # get docker image
+wget http://atlaswww.hep.anl.gov/hepsim/soft/centos7hepsim.img # get singularity image
-singularity  exec centos7hepsim.img  bash -l                   # setup HepSim
+singularity  exec centos7hepsim.img  bash -l                   # setup HepSim software
 </code>
 After the last line, the HepSim environment software should be ready. The software will be located in the directory given by the environmental variable HEPSIM (/opt/hepsim/)
@@ Line 22: / Line 23: @@
 docker pull chekanov/centos7hepsim
 </code>
+<note important>We recommend the "singularity" instead. This docker image may have problems in accessing XML files</note>
 The HepSim image is based on a minimalistic version  CentOS7 x64 with the basic C++ development environments. It includes:
@@ Line 56: / Line 59: @@
 Section [[hepsim:dev_fpadsim]] explains how to use this image to create full simulations using detector tags.
+====== Setting up Jas4pp ======
+One can setup a recent Jas4pp (with hs-tools) as
+<code bash>
+singularity exec centos7hepsim.img  bash -l
+source /opt/jas4pp.sh
+</code>
+and then type "jaspp". Please forward X11 to see the GUI.
+All other HepSim commands, such as "hs-ls", "hs-run" should be available.
 ====== HepSim tests ======
+To setup simulation and reconstruction software from HepSim, you can use this commend:
+<code bash>
+singularity exec centos7hepsim.img  bash -l
+source /opt/hepsim.sh
+</code>
 The docker container has a few basic tests that checks that everything works as expected.
@@ Line 89: / Line 114: @@
 This code compiles a Pythia8 program with ProMC output.
 You will see several ProMC files inside the directory "out". The input for Pythia is given by the control card inside the directory "cards". To recompile the Pythia8 program, type "make".
 ===== Fast simulation =====
@@ Line 113: / Line 139: @@
 ./TEST.sh
 </code>
+This example uses the input file "pgun_pi10gev_001.promc" with 10 GeV single pions, converts to LCIO, and than creates fully simulated and reconstructed files inside "output".
+The final file is output/pgun_pi10gev_001_pandora.slcio with all tracking and PFO information. The detector itself is located inside "sidcc3/compact.xml".
+If you make modifications inside "sidcc3/compact.xml", you will need to convert this file to other formats to run "TEST.sh".
+To do this, run
+<code bash>
+cd tests/rfull102
+./A_RUN_GEOMETRY
+</code>
 More about the full simulations can be found in Sect. [[hepsim:dev_fpadsim|Full simulations with FPadSim]]. Note that, in addition to the singularity container, you need a "tag" file with the detector description.
@@ Line 154: / Line 192: @@
 ====== Fortran generators ======
 The previous CentOS7 image is incompatible with older f77-based Monte Carlo generators.
-You can run Fortran Monte Carlo programs (LEPTO, LEPTO/Ariadne, Aroma, Epjpsi,  Pythia6)  using the [http://atlaswww.hep.anl.gov/hepsim/slc6hepsim.img|slc6hepsim.img]] singularity image.
+You can run Fortran Monte Carlo programs (LEPTO, LEPTO/Ariadne, Aroma, Epjpsi,  Pythia6)  using the [[http://atlaswww.hep.anl.gov/hepsim/soft/slc6hepsim.img|slc6hepsim.img]] singularity image.
-This image is based on Scientific-Linux 6.8 and included the native gcc4.4 with compatibility libraries and f77, CERNLIB, LHAPDF5.8 and other
+This image is based on Scientific-Linux 6.8 with the native gcc4.4 with f77 compatibility libraries. The image includes
-older libraries.
+CERNLIB, LHAPDF5.8, HEPMC, CLHEP and other older libraries.
+All Monte Carlo models are interfaced with ProMC IO for compact output of events.
 <code bash>
-singularity exec slc6hepsim.img  bash -l
+wget http://atlaswww.hep.anl.gov/hepsim/soft/slc6hepsim.img # get singularity image
+singularity exec slc6hepsim.img  bash -l                    # setup f77 software
 </code>
+Or, if you use Docker:
+<code bash>
+docker pull chekanov/slc6hepsim
+</code>
 Monte Carlo generators are located inside the directory /opt/generators/ directory, which can be setup  using /opt/setup.sh script.
@@ Line 167: / Line 213: @@
-David Blyth created a much lighter version of FPadSim image for EIC work described in Sec. [[fcs:eic:singularity|Singularity image for EIC]]. It is based on Arch Linux, and does not contain the usual Linux environment included inside centos7hepsim image.
+David Blyth created a lighter version of FPadSim image for EIC work described in Sec. [[fcs:eic:singularity|Singularity image for EIC]]. It is based on Arch Linux, and does not contain the usual Linux environment included inside centos7hepsim image.
  --- //[[[email protected]|Sergei Chekanov]] 2017/09/24 17:49//