Simulator Distribution

compared with
Current by Jeremy McCormick
on Jun 19, 2007 17:23.


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

View page history


There are 3 changes. View first change.

 {toc}
  
 h1. Simulator Distribution
  
 h2. Overview
  
 The Geant4-based simulator [SLIC|http://www.lcsim.org/software/slic] requires the following 8 software packages.
 {noformat}
 Geant4
 CLHEP
 GDML
 LCDD
 LCIO
 LCPhys
 Xerces C++
 SLIC
 {noformat}
 The _SimDist_ CVS project provides a build system for these programs based on [GNU|http://www.gnu.org] [Make|http://www.gnu.org/software/make/] and [Autoconf|http://www.gnu.org/software/autoconf/]. SLIC can be built from scratch using the proto-typical "configure" and "make" commands, and it includes a run script for setting up the runtime dependencies and launching the program.
  
  
  
 h2. Known Working Configurations
  
 This is a list of known combinations of operating system and compiler (gcc).
  
 *Red Hat Enterprise Linux 3, Scientific Linux 3*: gcc 3.2, 3.4.3, 4.0, 4.1.1
  
 *Mac OSX*: gcc 3.4 and 4.0
  
 *Windows (Cygwin only):* gcc 3.3.3
  
 h2. Available Binaries
  
 Binaries built with this system can be obtained from [the distribution download area|http://www.lcsim.org/dist/slic/].
  
 The distributions are named according to the following scheme.
 {noformat}
 slic-[version]-[platform]-[compiler]-[type].tar.gz
 {noformat}
 For instance, this file is a binary distribution of slic version 1.13.3 for Linux, compiled with g++.
 {noformat}
 slic-1_13_3-Linux-g++-bin.tar.gz
 {noformat}
 The type can be "bin" or "dist". The "bin" downloads are binary distributions containing only the necessary runtime files for running the simulator, while the "dist" files include the entire set of libraries and sources that were used to build the binary.
  
 h3. Binary Installation
  
 The process for installing a binary release for the aforementioned configuration is similar to this.
 # Download the tarball using (for instance) the wget program.
  # Assuming that the tarball is called _slic.tar.gz_, download the tarball using (for instance) the wget program.
 {noformat}
wget http://www.lcsim.org/dist/slic/slic-1_13_3-Linux-g%2B%2B-bin.tar.gz
  wget http://www.lcsim.org/dist/slic/slic.tar.gz
 {noformat}
 # Decompress it.
 {noformat}
 tar -zxvf slic-1_13_3-Linux-g++-bin.tar.gz
  tar -zxvf slic.tar.gz
 {noformat}
 # Go into the _SimDist_ directory and run the simulator.
 {noformat}
 cd SimDist
 ./scripts/slic.sh
 {noformat}
  
 Downloading and installing from a dist file is the easiest way to get SLIC up and running.
  
 h2. Building from Source
  
 The Simulator Distribution can also be obtained and built from scratch. You may need to do this if the dist binaries do not work or if you need to make various customizations, such as changing the default Geant4 version.
 # First, checkout the project from the SLAC cvs.
 {noformat}
 cvs -d :pserver:anonymous@cvs.freehep.org:/cvs/lcd co SimDist
 {noformat}
 # Go into the directory.
 {noformat}
 cd SimDist
 {noformat}
 # Configure the project.
 {noformat}
 ./configure
 {noformat}
 # Now, build the SimDist.
 {noformat}
 make
 {noformat}
  
 The binaries can be executed just as before.
  
 h2.  Reporting Problems
  
  Bugs should be reported to [mailto:jeremym@slac.stanford.edu] or [SimDist's Jira bug tracker|https://jira.slac.stanford.edu/browse/SIMDIST].