Hall A » SBS experiments » SBS-analysis

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