changes.
| | {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]. |