Gettin Started

dependencies

  • Only Linux and OSX is supported

  • We recommend to install anaconda (python3)

installation

  1. Create and activate a new python enviroment

conda create --name  jam  python=3.6
conda activate jam

  1. Clone the fitpack repository

git clone  git@github.com:QCDHUB/fitpack2
cd fitpack2

  1. Install dependencies on your enviroment

pip install -r deps

  1. Install core and default libraries

./pacman.py install

Additional repos for observables can be installed by adjusting the file repos.tex. Also to updates on all repos can be done via

./pacman.py update

setups

Some environmental variables need to be set. For csh

setenv FITPACK $PWD
setenv PATH ${FITPACK}/bin:${PATH}
setenv PYTHONPATH ${FITPACK}

For bash

path=`pwd`
export FITPACK=$path
export PATH=$FITPACK/bin:$PATH
export PYTHONPATH=$FITPACK:$PYTHONPATH

Alternatively source the setup file fitpack2/setup.sh or fitpack2/setup.csh

source setup.sh

To test the installation do

cd fitlib
./driver.py

Alternative installation

The following repos can only be modified via pull request.

  • fitlib

  • tools

You can forked them into your account and before running ./pacman.py install replace QCDHUB by your github username in order to clone from you account.

To update your fork with recent changes at the fitpack upstream you need to do the following within fitlib and tools

git remote add upstream git@github.com:JeffersonLab/fitpack.git
git fetch upstream

This is done only once. After that you can sync the fork using

git pull upstream master

Next steps

Checkout the tutorials