Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Along with other software for LCD research, a common distribution of the
SLIC simulator package is available for SLAC NFS users.

Info
titleAccess to NFS

If you need access to SLAC NFS, contact unix-admin@slac.stanford.edu.
(Of course, only do this if you already have a SLAC account!)

From a Unix terminal, open a connection to noric-new and login.

No Format
ssh noric-new

Now, switch to the bash shell.

No Format
bash

You need to setup the project environment to access the common software
distribution.

No Format
source /nfs/slac/g/lcd/mc/prj/bin/prj.sh

Now, you should be able to run slic from $PRJ_BIN.

No Format
slic [arguments]
Tip
titleSLIC Command Line Interface

Unlike most other packages, the command line interface to
SLIC simply maps to Geant4 commands. This keeps the interface
consistent. This also means that the order of the switches matters,
because it can affect Geant4's current state.

To see available command line options, invoke the help command.

No Format
slic --help

There are a number of different ways to run SLIC, including purely
macro or command-line driven.

For instance, here is a command to load the SDJan03 test geometry
and start an interactive terminal.

No Format
slic -g $PRJ_DIST/slic/current/examples/sdjan03/SDJan03.lcdd -z -n

Now, in order to have a work area for your SLIC usage, checkout the
package from CVS.

No Format
export CVSROOT=:pserver:anonymous@cvs.freehep.org:/cvs/lcd
cvs co slic
cd slic

Within this directory, you will be able to write LCIO files.

This is an example of visualizing a single muon event in the SDJan03 test
detector using GPS. From your slic directory, execute the following
commands.

No Format
slic -g examples/sdjan03/SDJan03.lcdd -z -n
Idle>/control/execute macros/vis_gl.mac
Idle>/control/execute macros/gps.mac
Idle>/run/beamOn

You could also dump a heprep.

No Format
Idle>/control/execute macros/heprep2.mac

Or you may want to check for overlaps in the detector.

No Format
Idle>/geometry/test/recursive_test

A purely macro-driven job can be executed from the slic directory like so.

No Format
slic macros/sdjan03_dbg.mac

You can dump this event using an LCIO utility.

No Format
dumpevent outfile.slcio 0 0

In general, a minimalist SLIC session will be started as follows.

No Format
slic -g /path/to/geometry/file -z -n

The -z option tells SLIC to initialize the simulator at that
point and -n will start an interactive session.

Tip
titleSLIC Initialization

SLIC must be initialized directly by the user, either by executing
the /run/initialize command from a macro or using the -z
option in the command line options. In the latter case, the
command option initializes the simulator in the order that the
switch was invoked at the command line.

Alternately, you may start in interactive mode and manually input
all required commands.

No Format
slic -n
Idle>/lcdd/setURI examples/sdjan03/SDJan03.lcdd
Idle>/run/initialize

An input StdHep file can be specified with the -i option or
using the /stdhep/setFile command from the PreInit> prompt.
When you call /run/beamOn, the events from this file will
be used as input to the simulator.

Tip
titleBatch job submission

A minimalist set of commands useful for batch submission is:

No Format
 slic -g geom_file -i input_file -p path_for_output_file -o output_file -z -r #_events -s #_events_to_skip