This is an old revision of the document!
Simulation with FPadSim
In many cases, HepSim detector simulations were done using ILCSOFT-derived software. To create full simulations, you will need to convert ProMC files to LCIO files. This is described in LCIO conversions and LCIO sections.
Many samples posted in HepSim are created with the package called “fpadsim” (Future Particle Detector Simulator“). This package is under constant development. )
The package includes packages from ilcsoft, such as SLIC, PandoraPFA, and LCSIM The simulation and reconstruction proceeds as: SLIC→LCSIM→slicPandora/PandoraPFA. This digram shows the entire chain:
The input for SLIC are LCIO files with truth-level information (“MCParticle” table). The files are created from ProMC files using the converter promc2lcio (included inside the ProMC packages, in the directory “examples”). This concept originates from the SiD detector(T.Johnson, N.Graf, J.McCormick, J.Strube), and later was re-purposed to be used for generic feature detectors, including proton pp colliders (S.Chekanov, A.Kotwal). The final step of the reconstruction is PandoraPFA (J.Marshall, M.Thomson).
Simulations with FPadSim
To process truth-level events with FpadSim, you need a few things:
- Tag file with detector description. The concept of tag files is described in Sect.dev_tags. You can find all submitted tag files in tag file catalog
- Singularity image with pre-built libraries to process a given tag file
The tag files should be processed with the simulation and reconstruction chain described above. This can be done by using Singularity that enables users to have full control of their environment. Install singularity (version 2.3.1 and above) and download the CentOS7 HEPSIM image with the FPadSim software.
Here is the download link centos7hepsim.img (>5 GB). The image includes basic CentOS7 environment, and programs such as SLIC, LCSIM, slicPandora, ProMC, Jas4PP and various converters.
wget http://atlaswww.hep.anl.gov/hepsim/centos7hepsim.img # get the singularity image singularity exec centos7hepsim.img bash -l # setup fpadsim
After the last line, the environment should be ready. For example, type “slic -h”. It shows the available commands. You can also use the commands such as:
promc2lcio # convert ProMC file to LCIO promc2stdhep # convert ProMC file to STDHEP
and many other.
Now you can process the tag file:
wget http://atlaswww.hep.anl.gov/hepsim/soft/rfull102.tgz tar -zvxf rfull102.tgz cd ilcsoft/rfull102/ ./TEST.sh # runs simple a test with single particles
The final file after pandoraPFA reconstruction with the name *hepsim.slcio” will be created in the same directory. Other files after simulation and track reconstruction steps will be located inside “output” directory.
To process other promc files, download the required promc files and edit the file Test.sh
Singularity image
The singularity centos7hepsim.img image is created using CentOS7 using singularity version 2.3.1. It has the basic linux commands, vim editor and all the required packages.
Look inside this image as:
sudo singularity shell --contain --writable centos7hepsim.img
and check the directory “/home/hepsim”. It includes the script “hepsim.sh” which setups the environment. Here are a few useful commands:
sudo singularity shell --contain --writable centos7hepsim.img # open to make changes singularity expand centos7hepsim.img # expand the image +750 MB singularity copy centos7hepsim.img -pr test /home/hepsim/ # copy directory "test" from host computer
Light version of image
David Blyth created a much lighter version of FPadSim image for EIC work described in Sec.singularity. It is based on arch linux, and does not contain the usual Linux enviroment included inside centos7hepsim image.
Contributions
The contributed authors of this package since 2015 are:
- D.Blyth (HEP/ANL)
- J.MacCormick (SLAC)
- W.Armstrong (PHYS/HEP)
- S.Chekanov (HEP/ANL)
- A.Kotwal (Duke)
- J.Strube (PNNL)
- J.Marshall (U.Cambridge
— Sergei Chekanov 2017/04/12 21:58