Quick Start Guide to building GlueX Software

From GlueXWiki
Revision as of 12:52, 6 March 2013 by Marki (Talk | contribs) (Check-out and build)

Jump to: navigation, search


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

  • CERN

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 CCDB, JANA, HDDS, and sim-recon in the current directory in the C-shell:

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

Note that this prescription uses gluex_env.csh to set-up the GlueX environment.

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

make -f $BUILD_SCRIPTS/Makefile_all calib_make

Create a run directory

An example:

cd $HOME
mkdir run
cd run

Refresh the path


Run the Monte Carlo

cp $HALLD_HOME/src/programs/Simulation/HDGeant/control.in .

Smear the hits

mcsmear hdgeant.hddm

Run the analysis

hd_root hdgeant_nsmeared.hddm

What if I don't have the prerequisites?

If the system you are on does not have Xerces-C, ROOT, or CERNLIB, there are targets in Makefile_all that can build these for you (although YMMV). For example if you do not have xerces on your system then you can modify the instructions above as follows:

  1. Do not set the XERCESCROOT environment on your own (as described in the "pre-requisites" section above). gluex_env.csh will do that for you.
  2. Add the target "xerces_build" to the "make_targets" environment variable (as described in the "check-out and build" section above), i. e., say
    set make_targets="xerces_build jana_build hdds_build halld_build"

Likewise you can build ROOT and CERNLIB in a similar manner. The appropriate targets are "cernlib_build" and "root_build" respectively.

More information

For more information on the scripts and makefiles used in this HOWTO, see Build Scripts and Makefiles.