Analysis Getting Started¶

These instructions are specific to the analyzer and SBS-offline installations existing under /work/halla/sbs, maintained by Andrew Puckett.

• Table of contents
• Analysis Getting Started
• How to Reach the SBS Work Directory
• Setting up Environments
• Getting Files from Cache
• Setting up the SBS Replay
  • SBS Installation
  • SBS Replay Environments
  • Running the SBS Replay

How to Reach the SBS Work Directory¶

• Log in to the JLab ifarm
  • https://scicomp.jlab.org/docs/getting_started
• The SBS work directory is located at /work/halla/sbs
  • Created a directory here with mkdir username
  • If you do not have permission contact Ole Hansen (ole@jlab.org) and ask to be added to the SBS user group.

Setting up Environments¶

• If you want to set up your own personal analyzer you can look here https://github.com/JeffersonLab/analyzer

Getting Files from Cache¶

• All raw EVIO files from GMn are on tape at /mss/halla/sbs
• Cached EVIO files are located at /cache/halla/sbs
• To write files from tape to cache see documentation here, https://scicomp.jlab.org/docs/node/586
  • For example, to get all EVIO splits from run runnumber in GMn to cache execute jcache get /mss/halla/sbs/raw/*runnumber*

Setting up the SBS Replay¶

• If you do not plan to make changes to the replay code you can simply use the version located at /work/halla/sbs/SBS_OFFLINE and /work/halla/sbs/SBS_REPLAY
• The SBS analysis is located at https://github.com/JeffersonLab/SBS-offline and https://github.com/JeffersonLab/SBS-replay
  • You can copy the github versions to your own work directory, if you plan to make your own changes to the analysis

SBS Installation¶

• Follow the README instructions on https://github.com/JeffersonLab/SBS-offline to install SBS-offline.
• After installing, there should be a directory, install/run_replay_here.
• Inside there should be one file named .rootrc (it is a hidden file).
  • Wherever you run the replay, this file must be there to load the SBS-offline libraries. Either run your replays here, or move the .rootrc file to the new destination.

SBS Replay Environments¶

• The following lines should be used in a script to define where the data and output files should be located
  

  setenv SBS_REPLAY path-to-your-replay/SBS-replay
  setenv DB_DIR $SBS_REPLAY/DB
  setenv DATA_DIR /cache/mss/halla/sbs/raw
  setenv OUT_DIR path-to-your-volatile/rootfiles
  setenv LOG_DIR path-to-your-volatile/logs
  setenv ANALYZER_CONFIGPATH $SBS_REPLAY/replay
  

• DATA_DIR tells the replay where the EVIO files are.
• OUT_DIR tells the replay where to put the output ROOT files.

Running the SBS Replay¶

• The main replay script, with all detectors, is replay_gmn.C located at https://github.com/JeffersonLab/SBS-replay/tree/master/replay
• An example of running this using a shell script can be found here, /work/halla/sbs/puckett/GMN_ANALYSIS/run_GMN_swif2.csh