Installing_RAVEN_Libraries

Installing Libraries Needed to Run RAVEN

RAVEN requires various python libraries to run.

Standard Installation

RAVEN uses conda to maintain a contained library environment with all the specific tested python library versions needed to run RAVEN. The requirements may change from commit to commit, but can be updated via a simple utility.

To install or update Python libraries, navigate to the folder where raven is located and do the following:

cd raven
scripts/establish_conda_env.sh

This will install the correct set of libraries for your copy of RAVEN.

In the event that there is some problem with the conda environemnt, it may be necessary to refresh it (this might be caused by old libraries linking incorrectly with new ones). To do this, do the following:

cd raven
conda deactivate
conda remove -n raven_libraries --all
scripts/establish_conda_env.sh

When prompted if you want to remove all libraries from raven_libraries, confirm the action.

Alternate Installation

In the event conda cannot be used, some suggestions for operating systems are listed below. To get the full list of libraries RAVEN needs to install, along with their specific versions, run the commands:

cd raven
python scripts/TestHarness/testers/RavenUtils.py --conda-install

which will print to terminal the list of libraries that should be installed for RAVEN to run, along with specific tagged versions. These libraries will need to be installed through a package manager such as conda or pip, or via the operating system tools listed below. Note the library lists in the examples below are not exhaustive, but give an example of how the libraries can be installed.

OSX

As described in http://mooseframework.org/getting-started/osx/ First install XQuartz and XCode command line tools.

OSX conda

The MOOSE redistributable package installs conda, and conda can be used to install the libraries:

sudo bash
#Set up http_proxy and https_proxy variables if needed
conda install -y numpy hdf5 h5py scipy scikit-learn matplotlib swig

OSX Mavericks 10.9

The MOOSE redistributable package (From http://mooseframework.org/getting-started/osx/ ) contains everything needed to run RAVEN. Alternatively install the raven libraries package raven_miniconda.dmg

OSX Yosemite 10.10

Either install the moose package (From http://mooseframework.org/getting-started/osx/ ) , or install the raven libraries package raven_miniconda.dmg, or use the raven_libs_script.sh

Linux

Either use apt-get or yum to install libraries, or use raven_libs_script.sh

Fedora (22 or newer):

Library install:

dnf install swig libtool gcc-c++ python-devel python3-devel \
 numpy h5py scipy python-scikit-learn python-matplotlib-qt4

Tex install (to rebuild manual):

dnf install texlive texlive-subfigure texlive-stmaryrd \
  texlive-titlesec texlive-preprint texlive-placeins

Ubuntu (14.4 or newer):

Library install:

sudo apt-get install libtool python-dev swig g++ python3-dev \
 python-numpy python-sklearn python-h5py

Tex install (to rebuild manual):

sudo apt-get install texlive-latex-base texlive-extra-utils \
  texlive-latex-extra texlive-math-extra

Installing without root privilages

For this, the raven_libs_script.sh should be used.