Differences

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

--- community:hepsim:usage_full [2016/04/29 00:02]
asc [Full detector simulation]
+++ community:hepsim:usage_full [2017/09/30 14:35] (current)
asc
@@ Line 1: / Line 1: @@
+<note important>This manual is outdated. Please use
+http://atlaswww.hep.anl.gov/hepsim/doc/doku.php
+</note>
 [[community:hepsim:|<< back to HepSim manual]]
 ====== Full detector simulations  ======
-Currently, the full detector simulation can be done using the SLIC software. You will need to convert ProMC files to LCIO files and
+Currently, the Geant4-based detector simulation can be done using the SLIC software. You will need to convert ProMC files to LCIO files and
 use these files for the "slic" Geant4-based program.
 To process SLCIO files, you will need [[http://atlaswww.hep.anl.gov/asc/jas4pp/|Jas4pp]]  program.
 The files with full simulations are located under the "rfullNNN" tags ("NNN" is a number)
-Here how you can find all samples that have "rfull" tag for download. Click here: [[http://atlaswww.hep.anl.gov/hepsim/list.php?find=rfull]]. If you need to find all  files
+Here how you can find all samples that have "rfull" tag for download. Click here: [[http://atlaswww.hep.anl.gov/hepsim/list.php?find=rfull]].
+The description of the detector tags is given in [[community:hepsim:usage_detectors|Detector description]].
+ If you need to find all  files
 for a give tag, say rfull005, use this command:
@@ Line 25: / Line 32: @@
 Each "rfullNNN" tag corresponds to the  detector given in the  [[http://atlaswww.hep.anl.gov/hepsim/soft/detectors/| detector repository]].
-The physics performance studies are  [[fcs:start|listed here]]. They are based on  [[http://atlaswww.hep.anl.gov/asc/jas4pp|Jas4pp program]].
+The physics performance studies based on full simulation files from HepSim
+are  [[fcs:start|listed here]].
+====== Processing LCIO files  ======
+To perform data analysis using LCIO files, use the [[https://atlaswww.hep.anl.gov/asc/jas4pp/|Jas4pp]] data-analysis package.
+The installation does not have external dependencies besides Java. Make sure Java7 and above is installed.
+Then run these commands to install the package using Linux/Mac with the "bash" shell:
+<code bash>
+wget http://atlaswww.hep.anl.gov/asc/jas4pp/download/current.php -O jas4pp.tgz
+tar -zvxf jas4pp.tgz
+cd jas4pp
+source ./setup.sh # takes 5 sec for first-time optimization
+</code>
+The last command optimizes Java packages for the Python language.
+Now you are ready to run over  any file with truth-level and datector-simulation files, such as LCIO and ProMC. This program can be used for:
+  * Downloading and searching HepSim data
+  * Processing ProMC files from HepSim
+  * Running over SLCIO files with Geant4 simulated / reconstructed events.
+  * Data analysis (jets, physics vectors, histogram packages)
+  * Visualisation of reconstructed events using Wired4 display
+You can find more details in [[asc:jas4pp|Jas4pp manual]]. The examples showing how to run over SLCIO files using [[https://atlaswww.hep.anl.gov/asc/jas4pp/|Jas4pp]] are located in the "examples/slic" directory of the Jas4pp package.
+The standard set of containers is available from the LCIO files posted on HepSim. Read
+[[http://lcio.desy.de/v02-04-03/doc/manual_html/manual.html|Manual]]. The API is described in
+[[http://lcio.desy.de/v02-04-03/doc/api/| LCIO Java API description]].
+Look the Java API definition of the needed objects in [[http://www.lcsim.org/sites/lcsim/apidocs/org/lcsim/lcio/package-summary.html|org.lcsim.lcio]]. The data containers are shown below:
+<hidden>
+<code>
+BeamCalHits
+CalorimeterHitRelations
+EM_BARREL
+EM_ENDCAP
+EcalBarrelHits
+EcalEndcapHits
+HAD_BARREL
+HAD_ENDCAP
+HcalBarrelHits
+HcalEndcapHits
+HelicalTrackHitRelations
+HelicalTrackHits
+HelicalTrackMCRelations
+LumiCalHits
+MCParticle
+MUON_BARREL
+MUON_ENDCAP
+MuonBarrelHits
+MuonEndcapHits
+PandoraPFOCollection
+ReconClusters
+SiTrackerBarrelHits
+SiTrackerEndcapHits
+SiTrackerForwardHits
+SiVertexBarrelHits
+SiVertexEndcapHits
+StateAtECal
+StateAtEnd
+StateAtStart
+TKR_RawTrackerHits
+TKR_TrackerHits
+Tracks
+VXD_RawTrackerHits
+VXD_TrackerHits
+</code>
+</hidden>
+====== Using C++/ROOT with LCIO ======
+If you need to read LCIO files in C++ code with ROOT/FastJet, use this example package:
+<code bash>
+wget http://atlaswww.hep.anl.gov/hepsim/soft/lcio-cpp.tgz -O - | tar -xz;
+cd lcio-cpp; make
+</code>
+It will compile "example.cpp" file linking FastJet package. Look at README file to see how to install the "LCIO" package required by this example.  Your LCIO" files from HepSim should be in the directory "data".

ATLAS Support Center

User Tools

Site Tools

Differences

Page Tools