Difference between revisions of "Quick Start Guide to building GlueX Software"

From GlueXWiki
Jump to: navigation, search
(add example for rhel5)
(add run steps)
Line 33: Line 33:
  
 
These five lines can also be found in trunk/scripts/build_scripts/boot.csh as an executable script (the second line checks out the boot_scripts directory).
 
These five lines can also be found in trunk/scripts/build_scripts/boot.csh as an executable script (the second line checks out the boot_scripts directory).
 +
 +
=Run the code=
 +
 +
Again you have to start somewhere. Let's assume that you want to get the default calibration, create a directory to run the code, update your path, run the default configuration of the Monte Carlo and reconstruct the result with a default analysis code.
 +
 +
==Get the calibration==
 +
 +
cd $GLUEX_TOP
 +
make -f $BUILD_SCRIPTS/Makefile_all calib_make
 +
 +
==Create a run directory==
 +
 +
An example:
 +
 +
cd $HOME
 +
mkdir run
 +
 +
==Refresh the path==
 +
 +
rehash
 +
 +
==Run the Monte Carlo==
 +
 +
cd $HOME/run
 +
cp $HALLD_HOME/src/programs/Simulation/HDGeant/control.in .
 +
hdgeant
 +
 +
==Run the analysis==
 +
 +
cd $HOME/run
 +
hd_root hdgeant.hddm

Revision as of 14:54, 4 January 2010

Pre-requisites

You gotta start somewhere. Here that means you need Xerces-C, Cernlib, and Root. The following need to be defined first:

  • XERCESCROOT
  • ROOTSYS
  • CERN
  • CERN_LEVEL

Here is an example of a working definition on ifarml5 (running Fedora 8):

setenv XERCESCROOT /group/halld/Software/ExternalPackages/xerces-c-src_2_7_0.Linux_Fedora8-i686-gcc4.1.2
setenv ROOTSYS /apps/root/PRO/root
setenv CERN /apps/cernlib/i386_fc8
setenv CERN_LEVEL 2005

and an example for jlabl3 (running RHEL5):

setenv XERCESCROOT /group/halld/Software/ExternalPackages/xerces-c-src_2_7_0.Linux_RHEL5-i686-gcc4.1.2
setenv ROOTSYS /apps/root/PRO/root
setenv CERN /apps/cernlib/i386_rhel5
setenv CERN_LEVEL 2005

Check-out and build

The following will checkout out and build jana, hdds, and the GlueX source tree in the current directory:

setenv GLUEX_TOP `pwd`
svn checkout https://halldsvn.jlab.org/repos/trunk/scripts/build_scripts
source build_scripts/gluex_env.csh
set make_targets="jana_build hdds_build halld_build"
make -f $BUILD_SCRIPTS/Makefile_all $make_targets

These five lines can also be found in trunk/scripts/build_scripts/boot.csh as an executable script (the second line checks out the boot_scripts directory).

Run the code

Again you have to start somewhere. Let's assume that you want to get the default calibration, create a directory to run the code, update your path, run the default configuration of the Monte Carlo and reconstruct the result with a default analysis code.

Get the calibration

cd $GLUEX_TOP
make -f $BUILD_SCRIPTS/Makefile_all calib_make

Create a run directory

An example:

cd $HOME
mkdir run

Refresh the path

rehash

Run the Monte Carlo

cd $HOME/run
cp $HALLD_HOME/src/programs/Simulation/HDGeant/control.in .
hdgeant

Run the analysis

cd $HOME/run
hd_root hdgeant.hddm