Differences

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

--- hepsim:quick [2018/05/30 20:37]
hepsim17
+++ hepsim:quick [2018/08/30 00:50]
hepsim17
@@ Line 13: / Line 13: @@
 </code>
-This creates the directory "hs-toolkit" with HepSim commands. You can also download it as [http://atlaswww.hep.anl.gov/hepsim/soft/hs-toolkit.tgz|hs-toolkit.tgz].
+This creates the directory "hs-toolkit" with HepSim commands. You can also download it as [[http://atlaswww.hep.anl.gov/hepsim/soft/hs-toolkit.tgz | hs-toolkit.tgz]]. Note that
-[[https://www.java.com/en/download/|Java7/8]] and above should be installed.
+[[https://www.java.com/en/download/|Java 8]] and above should be installed.
-You can view the commands by typing:
+You can view the commands using the bash shell by typing :
 <code bash>
-hs-help
+bash> hs-help
 </code>
-This package is used for download, view and analyse HepSim files (truth-level only).
+The directory contains several bash scripts for Linux/Mac, and Windows batch (BAT) files to process events on Windows OS.
-To analyse (*.lcio) files with Geant4 simulations, use
+The package is used for download, view and analyze truth-level events in the [[https://atlaswww.hep.anl.gov/asc/promc/ | PROMC]] or [[https://github.com/proio-org/ | PROIO]] format.
-[[http://atlaswww.hep.anl.gov/asc/jas4pp | JAS4PP program]]. To analyse ROOT files with fast simulations, use Delphes/ROOT frameworks.
+<note tip>
+Use [[http://atlaswww.hep.anl.gov/asc/jas4pp | JAS4PP program]] for analysing LCIO
+(*.lcio) files with Geant4 simulations.
+This program can also be used for truth-level records in the [[https://atlaswww.hep.anl.gov/asc/promc/|PROMC]] or [[ https://github.com/proio-org/| PROIO]] format.
+To analyse ROOT files with fast simulations, use Delphes/ROOT framework.
+</note>
 ====== Finding data files ======
@@ Line 57: / Line 62: @@
 <code bash>
-hs-ls [setname] simple     > input.list     # make list of ProMC files (without URL path)
+hs-ls [name] simple     > input.list     # make list of ProMC files (without URL path)
-hs-ls [setname] simple-url > input_url.list # make list with URL from the main server
+hs-ls [name] simple-url > input_url.list # make list with URL from the main server
 </code>
-where [setname] is the name of dataset. You can also use a URL if you want to create a list of files from certain (mirror) servers.
+where [name] is the name of dataset. You can also use a URL if you want to create a list of files from certain (mirror) servers.
 ====== Searching for datasets ======
@@ Line 227: / Line 232: @@
 </code>
 This command brings up a GUI window to look at separate events. You should forward X11 to see the GUI. For Windows: download the file [[http://atlaswww.hep.anl.gov/asc/hepsim/hepsim.jar|hepsim.jar]] and  click on it. Then open the file as [File]-[Open file].
+<note tip>If you use Windows OS, click "hs-view.bat" and open ProMC file using the File Menu.</note>
@@ Line 239: / Line 247: @@
 ====== Monte Carlo logfile ======
-You can work with ProMC using the standard Linux commands, such as "unzip":
+Each ProMC/ProIO file includes a logfile from the Monte Carlo generator. Show this file on the screen as:
+<code>
+hs-log [file]
+</code>
+where [file] is either a ProMC or ProIO file (you can use URL instead of the full path on the local computer).
+In the case of ProMC files, one can use the standard Linux commands, such as "unzip":
 <code>
@@ Line 323: / Line 338: @@
 It opens this file for editing. One can run it by clicking on the "run" button.
 It also provides an interactive Jython shell.
+<note tip>If you use Windows OS, click the file "hs-ide.bat" and open the Python script using the menu, and then run this script using the"Run" button.</note>
 When possible, use the downloaded ProMC files, rather than streaming the data over the network.