View source for Mc-single-arm (R-SIDIS version)

== Setting up mc-single-arm (R-SIDIS version) ==
=== Git suff  ===
* Setup a github.com account
* Fork the mc-single-arm repository: https://github.com/JeffersonLab/mc-single-arm
**Optionally select '''Watch''' to be notified of changes to mc-single-arm
* Setup ssh keys on ifarm or other machines
#Generate ssh key if you do not have one.
##ssh-keygen -t rsa  ( when prompted for pass phrase just hit return )
##ssh-add ~/.ssh/id_rsa (Note: I got an error message when I tried this on the ifarm machines, but it seemed to have worked anyway.)
#Put ssh public key on Github
## Open the "Settings" in the pull down menu on the extreme right.
## Go to "SSH and GPG keys"
## Click on "new ssh key" button. At terminal type "more ~/.ssh/id_rsa.pub". Copy the code and paste into github.
*On the computer that you plan to run and develop the analyzer, type either: 
#<br><code>git clone git@github.com:''GitHub-Username''/mc-single-arm.git</code><br> where ''GitHub-Username'' is the name of the account that you created.
#<br><code>git clone https://github.com/''GitHub-Username''/mc-single-arm.git</code><br> where ''GitHub-Username'' is the name of the account that you created.
# Note: I suggest doing this in your personal directory on the r-sidis group disk: /group/c-rsidis/''My-Username''
# On cdaq machines you must use https.
#Do <br><code>cd mc-single-arm</code>
#Do <br><code>git remote -v</code> and it should return (''https://github.com/ could be git@github.com:'')<br>origin https://github.com/''Github-UserName''/mc-single-arm.git (fetch)<br>origin https://github.com/''Github-UserName''/mc-single-arm.git (pull)
#Execute the command<br><code>git remote add --track rctables upstream https://github.com/JeffersonLab/hcana</code><br> or <br><code>git remote add --track rctables upstream git@github.com:JeffersonLab/mc-single-arm</code><br> This will be needed to keep your forked copy and local machine copy of the code up to date with the main development repository.
# Note that we are using a special branch of mc-single-arm. Make sure you are working in the rctables branch: <br><code>git checkout rctables</code>
# If the rctables branch on the main repository ( your "upstream" repository) changes and you want to incorporate these changes in your local copy then follow these steps:
   git fetch upstream
   git merge upstream/rctables
   git push origin rctables

==Compiling and configuring==
* To compile mc-single-arm on the ifarm machines, simply type <code>make</code> in the mc-single-arm/src directory
* There are "helper" applications in the <code>util</code> subdirectory that convert the mc-single-arm output to PAW ntuples or ROOT trees. I'm assuming everyone would rather use ROOT trees.  
** Go to the <code>util/root_tree</code> subdirectory and type <code>make</code>
** Note that the "make_root_tree" application uses ROOT version 6.30.04 when compiling. If you load a different version when you log into ifarm, this may cause problems.
* The <code>worksim</code> subdirectory of the <code>mc-single-arm</code> directory will be the destination for the sometimes large output ROOT trees.  The group disk is not meant for large files, so I suggest making a <code>worksim</code> directory on the work disk, and making a symlink. In the <code>mc-single-arm</code> directory:
** Remove your existing (local) worksim directory: <code>rm -r worksim</code>
** Then make a worksim directory on the work disk: <code>mkdir /work/hallc/c-rsidis/''My-Username''/single_arm_worksim</code>
** Make a symbolic link to that directory: <code>ln -s /work/hallc/c-rsidis/''My-Username''/single_arm_worksim worksim</code>