Difference between revisions of "Analysis Getting Started"

Revision as of 16:12, 4 March 2022

How to Reach the SBS Work Directory

• https://scicomp.jlab.org/docs/getting_started
  • From any terminal ssh username@login.jlab.org
  • ssh ifarm

• 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

• Open ~/.cshrc and add the lines:

source /site/12gev_phys/softenv.csh 2.5
source /work/halla/sbs/ANALYZER/install/bin/setup.csh 

• This will set up the proper environments for using the analyzer
• 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/raw
• Cached EVIO files are located at /cache/halla/sbs/raw
• 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 to cache execute jcache get /mss/halla/sbs/raw/*runnumber*

Storing Output Files

• No output files (logs or ROOT) should be stored in the work directory
• They should be stored in the "volatile" directory
  • Go to /volatile/halla/sbs
  • Created a directory here with mkdir username

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 test 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_swif.csh