PrimEx Software Get Started

Getting Started @ Jlab Linux Computer Farm

The program CVS repository exists under /group/primex . /group is mounted from farm linux machines at Jlab.
  • Define following environmental variables in $HOME/.cshrc
      setenv CVSROOT /group/primex/CVS_REPOSITORY
      setenv TOP_DIR $HOME/PrimEx
  • % source ~/.cshrc
  • Make sure your CVSROOT enviroment is aliased
      % echo $CVSROOT
    /group/primex/CVS_REPOSITORY
  • Setup the ROOT environment:
      % setup root
  • Create directory where you want to install programs, as defined in TOP_DIR in .cshrc
      % mkdir PrimEx
  • Change directory
      % cd PrimEx
  • Download source programs from CVS repository.
      % cvs checkout release
  • Execute .cshrc script to setup enviromnent (Presently supports only cshrc.)
      % source /group/primex/scripts/primex_jlab.cshrc
  • Make libraries
      % make -C src/libraries
  • Make root libraries
      % make -C src/libraries/roottools
  • Make executables
      % make -C src/programs
  • The executable will be installed under PrimEx/bin/Linux directory (If you are installing in SunOS, then PrimEx/Bin/SunOS)
      % ls bin/Linux
       bankdump   pflux_mon   ...

Access to Data Files

JLab data are accessible using jcache command from ifarm LINUX computers (not from SunOS Unix machines such as jlabs1,jlabs2...). Check this out for more details.
  • Load data file from SILO to cache directory. Here is a typical example of loading some data file e.g. run#784 from Aug.2002 beam test to cache disk.
      % jcache /mss/hallb/primex/data/august_2002/primex_00784.dat.00
    The data will be copied under the directory /cache and exactly the same path as above   /cache/mss/hallb/primex/data/august_2002/primex_00784.dat.00
The information about data from Aug.2002 run can be found in PrimEx News page.

Running Analyzer

Here is some example of running analyzer programs, which have compiled so far.
  • % pwd
      ~/PrimEx
  • bankdump is a command-line utility for printing the contents of a primex data file(s) to the screen.
    % bin/Linux/bankdump /cache/mss/hallb/primex/data/august_2002/primex_00784.dat.00
  • pflux_mon is an analyzer for the pair spectrometer flux monitor. It will create output data file (prim_ana00784.root) in root format.
    % bin/Linux/pflux_mon /cache/mss/hallb/primex/data/august_2002/primex_00784.dat.00
  • Open root file and browse histograms
    % root prim_ana00784.root
    root[0] TBrowser x
Use -h option for more detail of each executables.