Versions Compared

Key

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

...

  1. Download the Cygwin setup program.
  2. Double-click on it and click Next.
  3. Select Install from Internet and click Next.
  4. Enter your preferred Root Directory and click Next.
  5. Enter your preferred Local Package Directory, which can be the same as the Root Directory, and then click Next.
  6. Select Direct Connection, if it is not already, and click Next.
  7. Select a site from the Available Download Sites. Servers inside your country will probably be fastest. I use ftp://ftp.sunsite.utk.edu.
  8. Click Next.
  9. In the Cygwin Setup - Select Packages window, you need to make sure that the following tools are selected by clicking in the corresponding box under the New column until you see a version number.
    1. Required packages.
      • Devel -> cvs
      • Devel -> gcc-core
      • Devel -> gcc-g++
      • Devel -> make
      • Base -> gzip
      • Base -> tar
    2. Tool for downloading package tarballs and zip files.
      • Web -> wget
  10. Click Next after you have selected the packages.
  11. Cygwin will now automatically download and install all the selected packages. It might take awhile, so now is the time to go get some coffee.
  12. If desired, select Create icon on Desktop or Add icon to Start Menu, and click Finish.

...

  1. From the Cygwin shell, create a work directory and go into it.
    No Format
    cd /cygdrive/c
    mkdir sim
    cd sim
    
  2. Create the file setup.sh with the following contents.
    No Format
    #!/bin/sh
    export sim_work=/cygdrive/c/sim
    
    Info
    We will be adding to this file as the installation proceeds in order to build-up the application environment.
  3. Source the script to setup the work dir.
    No Format
    source setup.sh
    
Tip

Throughout the guide, any time a line is added to setup.sh, The $sim_work/setup.sh script will henceforth be referred to as setup.sh. At the end, it will have all of the environment variables required by SLIC and its dependencies. Throughout the guide, any time a line is added to setup.sh, you should also execute this line in your current bash shell. Probably the easiest way to do this is by adding to the script first and then (re)sourcing it.

...

Java is required for LCIO installation.

  1. Install an appropriate JDK JRE from http://java.sun.com/ with a minimum version of 1.4.2.
  2. In your setup.sh, set JAVA_HOME and JDK_HOME to the Java installation area.
    No Format
    export JAVA_HOME=/cygdrive/c/java/jdk1.4.2/
    export JDK_HOME=${JAVA_HOME}
    export PATH=$JDK_HOME:$JDK_HOME/bin
    
  3. To test the Java installation, try to run the compilerJava.
    No Format
    javacjava
    
Warning

The above JAVA_HOME directory is an example only. You need to replace it with the correct path to your JDK.

Info

Full LCIO installation actually requires a Java JDK, but the C++ libraries should only need a working java command in order to run ant.

Proceed to Package Installation!

...

  1. Create a working directory for CLHEP and go into it.
    No Format
    mkdir clhep
    cd clhep
    
  2. Download the CLHEP tarball.
    No Format
    wget http://cern.ch/clhep/clhep-1.9.2.0.tgz
    
  3. Unzip to your work directory.
    No Format
    tar -zxvf clhep-1.9.2.0.tgz
    
  4. Change to CLHEP directory.
    No Format
    cd 1.9.2.0/CLHEP
    
  5. Run configure. (Takes a long time!)
    No Format
    ./configure --prefix=`cd ../..; pwd` --disable-shared
    
  6. Build the library and install it. (Also takes a long time!)
    No Format
    make
    make install
    
  7. Add the following to $sim_work/setup.sh
    No Format
    export CLHEP_BASE_DIR=$sim_work/clhep
    

...

  1. Return to the work dir, create a Geant4 work subdir and go into it.
    No Format
    cd $sim_work
    mkdir geant4
    cd geant4
    
  2. Download the Geant4 tarball.
    No Format
    wget http://geant4.cern.ch/geant4/source/source/geant4.7.0.p01.tar.gz
    
  3. Unzip it.
    No Format
    tar zxvf geant4.7.0.p01.tar.gz
    
  4. Setting the following variables in $sim_work/setup$setup.sh should will allow you to compile without running the ./Configure script.
    No Format
    G4INSTALL=${sim_wrk}/geant4/geant4.7.0.p01
    G4SYSTEM=WIN32-g++
    
  5. Go into the Geant4 install dir.
    No Format
    cd geant4.7.0.p01
    
  6. Build the libraries. These , which will be placed at $G4INSTALL/lib/WIN32-g++. (Maybe you should let this run overnight!It could take up to a few hours depending on your machine.)
    No Format
    make
    
  7. Build the physics list libraries. These will go into $G4INSTALL/lib/plists/WIN32-g++.
    No Format
    cd ../physics_lists/hadronic
    make
    
  8. Install the headers into $G4INSTALL/include.
    No Format
    make includes
    

Hopefully, Geant4 has been installed successfully, and you don't have too many more gray hairs.

LCPhys

SLIC requires a special physics list written by Dennis Wright for Linear Collider physics.

  1. Go back to the work dir.
    No Format
    cd $sim_wrk
    
  2. Checkout the physics list from CVS.
    No Format
    cvs -d :pserver:anonymous@cvs.freehep.org:/cvs/lcd checkout LCPhys
    
  3. Assuming that the environment from the Geant4 installation is still in place, you can build this like any other physics list, and the library should be installed into $G4INSTALL/lib/plists/WIN32-g++.
    No Format
    cd LCPhys
    make
    
  4. Set the LCPhys variable in setup.sh.
    No Format
    LCPHYS_BASE=$sim_wrk/LCPhys
    

LCIO

LCIO provides binary output capabilities.

Warning

LCIO installation Installation requires a working Java SDKruntime for ant support.

LCIO has a very nice manual with a whole section on installation. Thanks, Frank!

...