Quick Start Guide to building GlueX Software
Contents
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