Full Detector Simulation using SLIC

Version 21 by Jeremy McCormick
on Jun 09, 2006 12:06.

<< Changes from 20 to 21
compared with
Current by Jeremy McCormick
on Jun 09, 2006 12:09.

 
Key
These lines were removed. This word was removed.
These lines were added. This word was added.

View page history


There are 1 changes. View first change.

 h1. Full Detector Simulation using SLIC
  
 h2. Overview
  
 This tutorial shows how to obtain a full detector resource file and extract the data necessary for the full simulator. Lastly, a few simple commands are given for running the simulator in batch mode using the downloaded file.
  
 h2. SLIC Executables
  
 {info}
 This tutorial assumes that the SLIC binary is executed using the command *slic*. On your system, this will need to be substituted with the full path to the SLIC binary.
 {info}
  
 h3. Windows
  
 Windows users should refer to [SLIC from Scratch on Windows]. These instructions show how to download and use a pre-packaged binary and also give the steps for building an executable from scratch using Cygwin.
  
 h3. Linux
  
 No binaries are available for Linux users, due to the large number of possible system configurations.
  
 Follow the instructions in [SLIC From Scratch on Linux] to build the binaries on Linux.
  
 h2. Full Detector Files
  
 The [LCSim website|http://www.lcsim.org] maintains a set of [full detector|http://www.lcsim.org/detectors] resource files that include the LCDD files used by the simulator.
  
 A list of available full detectors is maintained at this URL:
  
 {noformat}
 http://www.lcsim.org/detectors/taglist.txt
 {noformat}
  
 Resource packs for individual detectors are available at standard URLs by tag:
  
 {noformat}
 http://www.lcsim.org/detectors/[tag].zip
 {noformat}
  
 For instance, the zip file for the _cdcaug05_ detector is located at the URL:
  
 {noformat}
 http://www.lcsim.org/detectors/cdcaug05.zip
 {noformat}
  
 Linux users can use the *wget* command to obtain this:
  
 {noformat}
 wget http://www.lcsim.org/detectors/cdcaug05.zip
 {noformat}
  
 If *wget* is not available, simply copy the URL into a browser and save the file to the local disk.
  
 The zip file contains the LCDD XML file required by SLIC.
  
 If the *unzip* command is available on your system, use a command like the following to extract the LCDD file to the current directory, substituting the name of the detector for *tag*:
  
 {noformat}
 unzip [tag].zip -C [tag].lcdd
 {noformat}
  
 To extract _cdcaug05_'s LCDD file, use this command:
  
 {noformat}
 unzip cdcaug05.zip -C cdcaug05.lcdd
 {noformat}
  
 Windows XP users can view the zip file as a compressed folder.
  
 It should look something like this.
  
 !detector_zip_lcdd.PNG!
  
 To extract the LCDD file from the archive, simply drag it into your working directory.
  
 h2. Running a Full Detector Simulation
  
 Now that the full detector geometry file has been obtained, standard SLIC commands can be used to run a simulation job.
  
 This is the general (minimalistic) command for running a simulation, where *tag* should be the name of the LCDD file, *stdhep_file* is the path to a binary StdHep input file, and *num_to_run* is the number of events to be simulated.
  
 {noformat}
  slic -g [tag].lcdd -z -i [stdhep_file] -r [num_to_run]
  slic -g [tag].lcdd -i [stdhep_file] -r [num_to_run]
 {noformat}
  
 For instance, this command will run 1000 events on _cdcaug05_ using the input file events.stdhep.
  
 {noformat}
 slic -g cdcaug05.lcdd -i events.stdhep -r 1000
 {noformat}
  
 StdHep files are available within the [ILC FTP directory hierarchy|http://www.lcsim.org/datasets/ftp.html].