Project

General

Profile

Analysis Getting Started » History » Revision 14

Revision 13 (Sean Jeffas, 05/11/2023 10:31 AM) → Revision 14/25 (Sean Jeffas, 05/11/2023 10:32 AM)

h1. Analysis Getting Started 

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

 {{toc}} 

 h1. 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. 

 h1. Setting up Environments 

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

 h1. 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*@ 

 h1. 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 

 h2. 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. 

 h2. SBS Replay Environments 

 * The following lines should be used in a script to define where the data and output files should be located 
 <pre> 
 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 
 </code></pre> 
 * @DATA_DIR@ tells the replay where the EVIO files are. 
 * @OUT_DIR@ tells the replay where to put the output ROOT files. 

 

 h2. Running the SBS Replay 

 * The main replay script, with all detectors, is @replay_gmn.C@ 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@ /work/halla/sbs/puckett/GMN_ANALYSIS/run_GMN_swif2.csh