Differences

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

--- hepsim:dev_fpadsim [2017/09/21 13:55]
hepsim17
+++ hepsim:dev_fpadsim [2017/09/24 22:52] (current)
hepsim17 [Simulations with FPadSim]
@@ Line 5: / Line 5: @@
 ===== Simulation with FPadSim =====
-In many cases, HepSim detector simulations were done using SiD-derived software.
+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
-[[hepsim:usage_truth#converting_to_lcio|LCIO conversions]].
+[[hepsim:usage_truth#converting_to_lcio|LCIO conversions]] and [[hepsim:dev_full|LCIO]] sections.
 Many samples posted in HepSim are created with the  package called "fpadsim" (**F**uture **Pa**rticle **D**etector **Sim**ulator"). This package is under constant development.
-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)
@@ Line 37: / Line 28: @@
 of the reconstruction is PandoraPFA (J.Marshall, M.Thomson).
+====== Simulations with FPadSim ======
-To create LCIO files with full simulations and reconstruction, you need:
+To process truth-level events with FpadSim, you need a few things:
-  * ProMC file from HepSim
+  * A tag file with the detector description. The concept of tag files is described in Sect.[[hepsim:dev_tags]]. You can find all submitted tag files in [[http://atlaswww.hep.anl.gov/hepsim/recotags.php|tag file catalog]]
-  * Simulation and Reconstruction package called "fpadsim-[version]".
+  * Singularity  container with pre-built libraries to process a given tag file
-  * Tag file which includes detector and the simulation and reconstruction sequence.
-The fpadsim package is located [[http://atlaswww.hep.anl.gov/hepsim/soft/ |here]]. It is usually designed for the OSG grid.
+The tag files should be processed with the simulation and reconstruction chain described above.
-The tag files are also located [[http://atlaswww.hep.anl.gov/hepsim/soft/ |here]].  They have the names "rfull[XXX].tgz".
+This can be done by using [[http://singularity.lbl.gov/|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.
-After untaring the file fpadsim.tgz, untar the file "rfull[XXX].tgz".
-There is a simple script "Test.sh" that creates a few events and illustrate this concept.
-Note that the version of fpadsim is defined inside the script A_RUN used to create reconstructed events.
+Here is the download link [[http://atlaswww.hep.anl.gov/hepsim/soft/centos7hepsim.img|centos7hepsim.img]] (>5 GB).
+The image includes basic CentOS7 environment, and programs such as SLIC, LCSIM, slicPandora, ProMC, Jas4PP, ROOT, PYTHIA8, LHAPDF  and various converters.
+<code bash>
+wget http://atlaswww.hep.anl.gov/hepsim/soft/centos7hepsim.img # get the singularity image
+singularity  exec centos7hepsim.img  bash -l                   # setup fpadsim
+</code>
+After the last line, the environment should be ready. For example, type "slic -h". It shows the available commands.
-====== Changes in compact.xml ======
+Now you can process the tag file:
-If you want to make changes in the detector design, edit "compact.xml", and then run the converters:
 <code bash>
-JAVA_OPTS="-Xms2048m -Xmx2048m"
+wget http://atlaswww.hep.anl.gov/hepsim/soft/rfull102.tgz
-GCONVERTER=lcsim/detector-framework/target/lcsim-detector-framework-3.1.6-SNAPSHOT-bin.jar
+tar -zvxf rfull102.tgz
-GEOM="mydetector" # name of your detector
+cd ilcsoft/rfull102/
-java $JAVA_OPTS -jar $GCONVERTER -o lcdd compact.xml $GEOM.lcdd
+./TEST.sh #  runs simple a test with single particles
-slic -g ${GEOM}.lcdd  -G ${GEOM}.gdml
-echo "heprep compact.xml.."
-java $JAVA_OPTS -jar $GCONVERTER -o heprep compact.xml $GEOM.heprep
-echo "pandora compact.xml.."
-java $JAVA_OPTS -jar $GCONVERTER -o pandora compact.xml $GEOM.pandora
-java $JAVA_OPTS -jar $GCONVERTER -o html compact.xml ${GEOM}.html
 </code>
-where "${GEOM}" is the name of the detector geometry.  Next, check that you do not have overlapping volumes. Run ROOT with the commands:
+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.
-<code cpp>
+To process other promc files, download the required promc files and edit the file Test.sh
-TGeoManager::Import("mydetector.gdml");
-gGeoManager->ViewLeaves(true);
-gGeoManager->ls("All");
-gGeoManager->CheckOverlaps(0.1); //0.1 tolerance or better!
-gGeoManager->PrintOverlaps();
-gGeoManager->GetTopVolume()->Draw("ogl");
-</code>
-If you see that some volumes overlap, come back to "compact.xml" and make corrections.
-====== Pandora PFA ======
-All information required by Pandora algorithm is stored in the file with the extension ".pandora". This file is created using GeoConvertor, which reads CalorimeterCalibration.properties file.
+More information about how to use HepSim container can be found in Section [[hepsim:dev_singularity|HepSim singularity container]].
-In particular, it reads:
-  * mipEnergy
+===== Light version of FPadSim image=====
-  * mipSigma
-  * mipCut
-  * timeCut
-The sampling fractions are taken from the detector  directory called "SamplingFractions".
+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.
-Here files look as this:
-<code>
-BeamCal.properties*
-EcalBarrel.properties*
-EcalEndcap.properties*
-HcalBarrel.properties*
-HcalEndcap.properties*
-LumiCal.properties*
-MuonBarrel.properties*
-MuonEndcap.properties*
-README*
-</code>
+====== Contributions ======
-Look at the file:
+The contributed authors of this package since 2015 are:
-<code>
-lcsim/detector-framework/src/main/java/org/lcsim/geometry/compact/converter/pandora/Main.java
+  * D.Blyth (HEP/ANL)
-</code>
+  * J.MacCormick (SLAC)
+  * W.Armstrong  (PHYS/HEP)
+  * S.Chekanov (HEP/ANL)
+  * A.Kotwal (Duke)
+  * J.Strube (PNNL)
+  * J.Marshall (U.Cambridge)
  --- //[[[email protected]|Sergei Chekanov]] 2017/04/12 21:58//