The easiest way to start using Rivet is via the Docker system (see https://www.docker.com/), which is like a lightweight Linux virtual machine that's easily installed and run on Mac, Linux and Windows machines. See the dedicated Docker tutorial page for more detail.
The rest of these instructions are mainly aimed at users who want to natively install and run a release of Rivet on their machine.
GettingStartedForDevelopers has some additional or replacement steps for people wishing to check out the development version from the repository and build from there.
The simplest Rivet installation uses a "bootstrap" script to install Rivet and all its dependencies from release tarballs.
Python header files are required. On Ubuntu and other Debian Linux derivatives, you can use this command to install the necessary files system-wide: sudo apt-get install python-dev
. You will also need a C++ compiler capable of building the C++14 dialect: on systems like CERN lxplus you can get such an environment (and also a fixed LaTeX for plotting) with:
source /cvmfs/sft.cern.ch/lcg/releases/LCG_96/Python/2.7.16/x86_64-centos7-gcc62-opt/Python-env.sh
export PATH=/cvmfs/sft.cern.ch/lcg/external/texlive/2016/bin/x86_64-linux:$PATH
Download the bootstrap script into a temporary working directory, and make it executable:
cd /scratch/rivet
wget https://gitlab.com/hepcedar/rivetbootstrap/raw/3.1.0/rivet-bootstrap
chmod +x rivet-bootstrap
(Replace the version string as appropriate if you want to install other versions of Rivet.)
Check the options. Look at the header of the script to see all variables which you can set, e.g. to skip installation of certain dependencies if they are available in your system:
less rivet-bootstrap ## and read...
Run the script. By default it will install to $PWD/local
, where $PWD
is the current directory. If you need to change that, specify the corresponding values on the command line. Examples:
./rivet-bootstrap
# or, e.g.
INSTALL_PREFIX=$HOME/software/rivet MAKE="make -j8" ./rivet-bootstrap
We will refer to the installation root path as $PREFIX
.
After the script grinds away for a while, it will tell you that it is finished and how to set up a runtime environment (similar to that used inside the build script) for running Rivet. A sourceable rivetenv.(c)sh script is provided for (c)sh shell users to help set up this environment. Here's how to set up the environment and then test the rivet
program's help feature and analysis listing:
source $PREFIX/rivetenv.sh
rivet --help
rivet --list-analyses
If that works, everything is installed correctly. If you are using the bash
shell in your terminal, then Rivet will offer you programmable tab completion: try typing {{{rivet}}} and pressing the Tab key!
You may wish to add the environment variable settings to your ~/.bashrc
shell config file, so that Rivet will work without needing any special session setup.
You can now check out the FirstRivetRun guide.