This is an old revision of the document!


<< back to HepSim manual

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 the 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 image with 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 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 should also use the commands such as:

promc2lcio
promc2stdhep

and many other.

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