CLIC Detector Simulation Software

Required Software

• java (sdk) from SUN, version >= 1.5
• maven 1.02
• SLIC
• JAS3 (Java Analysis Studio) 0.84
• pythia

Detailed Installation (CERN Scientific Linux 4.6)

• yum Extender
  • JAVA-1.5.0-sun-devel
  • python-lxml (optional)
  • jython (optional)
  • maven from the repository does NOT work

Screenshot of the selected packages in yum:

• Define environment variables for java and increase java memory (according to your java path):
  for bash:

  export JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun
  export JAVA_OPTS="-Xmx1024m -Xms1024m"

  for t(csh):

  setenv JAVA_HOME /usr/lib/jvm/java-1.5.0-sun
  setenv JAVA_OPTS "-Xmx1024m -Xms1024m"

• Maven
  • Maven 2 should be used instead of Maven (see below)
  • download maven-1.0.2 do NOT download version 1.1.x (which was found to be buggy)
  • unpack to your favorite location (for example: /usr/local/sbin/)

    tar xzvf maven-1.0.2.tar.gz

  • Define environment variables:
    for bash:

    export MAVEN_HOME=/usr/local/sbin/maven-1.0.2
    export PATH=${PATH}:${MAVEN_HOME}/bin

    for t(csh):

    setenv MAVEN_HOME /usr/local/sbin/maven-1.0.2
    setenv PATH ${PATH}:${MAVEN_HOME}/bin

• Maven 2
  • Download latest version
  • unpack to your favorite location (for example: /usr/local/sbin/)
  • Set environment variables:

    export PATH ${PATH}:/usr/local/sbin/maven/bin

• slic
  • download latest version
  • unpack to your favorite location (for example: /usr/local/sbin) and update the PATH variable:
    

    tar xzvf slic_[version]_i686_linux-gnu.tar.gz

    for (t)csh:

    setenv PATH ${PATH}:/usr/local/sbin/SimDist/scripts/

    for bash:

    export PATH=${PATH}:/usr/local/sbin/SimDist/scripts/

• pythia
  • download
  • unpack tar-file into your home-directory (where you want to use pythia)
  • set environment variables:
    for (t)csh:

    setenv JDK_ROOT ${JAVA_HOME}/bin
    setenv CLASSPATH ""

    for bash:

    export JDK_ROOT=${JAVA_HOME}/bin

  • go to:

    cd evtgen/pythiaJNI

  • execute:

    g++ -shared -I$JDK_ROOT/include -I$JDK_ROOT/include/linux *.cpp *.f -lg2c -o ../libpythiaevtgen.so

  • go to:

    cd ../

  • execute (bash):

    source setup.sh

  • for (t)csh:

    cat > setup.csh << EOF
    setenv CLASSPATH ./hep.jar:\${CLASSPATH}
    setenv LD_LIBRARY_PATH .:\${LD_LIBRARY_PATH}
    EOF

  • and (for (t)csh):

    source setup.csh

  • to create 10 events with pythia:

    java EvtGen 10 pythia outfile.stdhep

• JAS3
  • download latest version
  • unpack to your favorite location (for example: /usr/local/sbin)

  •  export PATH=${PATH}:/usr/local/sbin/jas3-0.8.3

  • start JAS3

    jas3

  • go to: View -> Plugin Manager -> Available -> hep
    • add lineracollider -> org.lcsim
    • add visualization -> WIRED4
    • add visualization -> WIRED4baselibrary
    • add visualization -> heprep
    • do NOT add visualization -> lcio

• install org.lcsim (can also be found here)
  • go to your favorite location (for example: /usr/local/sbin)
  • checkout org.lcsim and GeomConverter from CVS

    export CVSROOT=:pserver:anonymous@cvs.freehep.org:/cvs/lcd
    cvs login (just hit enter when prompted for password)
    cvs co GeomConverter
    cvs co lcsim

  • update org.lcsim and GeomConverter using maven 2 (without testing to save time and tests tend to fail for memory reasons)

    cd GeomConverter
    mvn -DskipTests=true clean install
    cd ../lcsim
    mvn -DskipTests=true clean install

  • JAS3-org.lcsim plugin is updated automatically if existing

• guinea-pig

• lcio: merge events

Testing the Software

• pythia
  • configure the steering files pythia.cmd and pythia.cards
  • generate some events

    java EvtGen 10 pythia outfile.stdhep

• slic
  • get a detector model
  • unpack the detector definition from the archive ([detectorname].lcdd)
  • create a lcio file

    slic.sh -g [detectorname].lcdd -i [pythiaevents].stdhep -r [numberofevents] -o outfile.slcio

• jas3
  • start jas3
  • open a lcio file (File -> Open File)
  • open wired4 view (File -> New -> Wired4 View)
  • process one event (press ALT + 1)

Latest Changes