temcom/octave-roll

SDSC octave roll

SDSC "octave" roll

Overview

This roll bundles GNU Octave.

For more information about please visit the official web page:

• Octave is a high-level interpreted language, primarily intended for numerical computations. It provides capabilities for the numerical solution of linear and nonlinear problems, and for performing other numerical experiments.

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 octave 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 mpi 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 MKL, FFTW, and HDF5 libraries and assumes that the boost modulefiles provided by the corresponding SDSC rolls are available. It will build without the modulefiles as long as the environment variables they provide are otherwise defined.

Building

To build the octave-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 octave-*.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 name of the compiler modulefile to use for building the software, e.g.,

make ROLLCOMPILER=gnu 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".

For gnu compilers, the roll also supports a ROLLOPTS make variable value of 'avx' and 'avx2', indicating that the target architecture supports AVX instructions.

Installation

To install, execute these instructions on a Rocks frontend:

% rocks add roll *.iso
% rocks enable roll octave 
% cd /export/rocks/install
% rocks create distro
% rocks run roll octave | bash

In addition to the software itself, the roll installs octave environment module files in:

/opt/modulefiles/applications

Testing

The octave-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/octave.t