SDSC "jags" roll
Overview
This roll bundles the JAGS Bayesian model analyzer as well as the corresponding R library.
For more information about the various packages included in the JAGS roll please visit the official web page:
- JAGS is Just Another Gibbs Sampler. It is a program for analysis of Bayesian hierarchical models using Markov Chain Monte Carlo (MCMC) simulation.
Requirements
To build/install this roll you must have root access to a Rocks development machine (e.g., a frontend or development appliance).
If your Rocks development machine does not have Internet access you must
download the appropriate jags source file(s) using a machine that does
have Internet access and copy them into the src/<package>
directories on your
Rocks development machine.
Dependencies
The sdsc-roll must be installed on the build machine, since the build process depends on make include files provided by that roll.
The roll sources assume that modulefiles provided by SDSC compiler and R rolls are available, but it will build without them as long as the environment variables they provide are otherwise defined.
The build process requires the lapack libraries and assumes that the lapack modulefile provided by the SDSC math-roll is available. It will build without the modulefile as long as the environment variables it provides are otherwise defined.
The build assumes that the R codo module is available to R. The SDSC r-modules-roll installs this along with a variety of other R packages.
Building
To build the jags-roll, execute this on a Rocks development machine (e.g., a frontend or development appliance):
% make 2>&1 | tee build.log
A successful build will create the file jags-*.disk1.iso
. If you built the
roll on a Rocks frontend, proceed to the installation step. If you built the
roll on a Rocks development appliance, you need to copy the roll to your Rocks
frontend before continuing with installation.
This roll source supports building with different compilers.
The ROLLCOMPILER
make variable can be used to
specify the names of compiler modulefiles to use for building the
software, e.g.,
% make ROLLCOMPILER=intel 2>&1 | tee build.log
The build process recognizes "gnu", "intel" or "pgi" as the value for the
ROLLCOMPILER
variable. The default value is "gnu".
Installation
To install, execute these instructions on a Rocks frontend:
% rocks add roll *.iso
% rocks enable roll jags
% cd /export/rocks/install
% rocks create distro
Subsequent installs of compute and login nodes will then include the contents of the jags-roll. To avoid cluttering the cluster frontend with unused software, the jags-roll is configured to install only on compute and login nodes. To force installation on your frontend, run this command after adding the jags-roll to your distro
% rocks run roll jags host=NAME | bash
where NAME is the DNS name of a compute or login node in your cluster.
In addition to the software itself, the roll installs jags environment module files in:
/opt/modulefiles/applications/jags
Testing
The jags-roll includes a test script which can be run to verify proper installation of the roll documentation, binaries and module files. To run the test scripts execute the following command(s):
% /root/rolltests/jags.t