Project

General

Profile

Documentation of libsbsdig » History » Version 2

Eric Fuchey, 04/06/2020 01:02 PM

1 1 Eric Fuchey
h1. Documentation of libsbsdig
2
3
h2. Overview
4
5
This page is maintained by the UConn group (Eric Fuchey + Andrew Puckett) and as of February 14, 2020 is specific to the '''''master''''' branch of libsbsdig on github.
6
7
h2. Purpose
8
9
This page documents the libsbsdig code, which purpose is to transform the output data from [https://hallaweb.jlab.org/wiki/index.php/Documentation_of_g4sbs G4SBS] to digital values such as ADCs or TDCs.
10
These produce files which can be analyzed with [https://hallaweb.jlab.org/wiki/index.php/Documentation_of_SBS-offline SBS-offline].
11
12
h2. Getting the code and building the program
13
14
h3. Prerequisites
15
16
*Working [https://root.cern.ch/drupal/ ROOT] installation. '''libsbsdig is compatible with ROOT version 5 and ROOT version 6'''. '''''ROOT 6 is strongly recommended'''''
17
*Working [https://redmine.jlab.org/projects/podd/wiki analyzer] installation. '''libsbsdig is compatible with analyzer versions 1.6 and beyond'''.
18
*Working [https://hallaweb.jlab.org/wiki/index.php/Documentation_of_SBS-offline SBS-offline] installation.
19
20
h3. Downloading the repository
21
22
The code is hosted on a github repository owned by JLab. To clone via ssh (preferred method on JLab batch farm), do: 
23
24
{| class="wikitable" style="background: #BFBFBF;"
25
|-
26
| '''git clone git@github.com:JeffersonLab/libsbsdig.git'''
27
|-
28
|}
29
30
For this method to work, the ssh public key on the machine where you want to get the code must be added to your github account (see [https://help.github.com/articles/generating-ssh-keys/ Guide] to generating ssh keys and adding to your github.com account.)
31
32
Cloning the repository defaults to the "master" branch.
33
34
h3. Building and installing the library
35
36 2 Eric Fuchey
Create a "build" directory that is parallel to the "libsbsdig" source directory (this is not strictly required, but the build directory must be separate from the "SBS-offline" directory in any case). 
37
You also need to have setup an installation path e.g. /path/to/libsbsdig-install
38
*NB*: similarly to the build directory, the /path/to/libsbsdig-install directory shall '''not''' be the same as the source directory!
39
_The following instructions assume that "build" is parallel to "libsbsdig":_
40
If successful, the libsbs library and several other files and folders will be created in the "build" and the "install" directory.
41 1 Eric Fuchey
42 2 Eric Fuchey
To build and install, the procedure needs to be completed. From scratch:
43
44
bq. mkdir build
45
cd build
46
cmake -DCMAKE_INSTALL_PREFIX=/path/to/libsbsdig-install ../libsbsdig
47
make install
48 1 Eric Fuchey
49
h2. Useful links