Overview

The BRAHMS Matlab Invocation Bindings (995) work, to a large extent, under Octave. Octave is a free alternative to Matlab, which you may prefer. Some of the GUI features are lacking, but there are mechanisms to do everything you can do under Matlab. Use the Matlab documentation, but note that the BRAHMS Manager is absent (use brahms_utils to perform the tasks you would usually perform in the manager).

Notes
  • Version 3.2 or above of Octave is required (for object-oriented support).

Install BRAHMS in Octave

You need to add the folder below to your Octave path. You can use the addpath command; put this in your octaverc file to stay connected to BRAHMS when you restart Octave.

Notes
  • See this for information about your octaverc file(s).

Tip

I use this snippet in my octaverc file to easily set the Octave path based on SYSTEMML_INSTALL_PATH.

Octave Console
path = getenv('SYSTEMML_INSTALL_PATH'); addpath([path '/BRAHMS/bindings/invocation/995']);

Test

Open Octave and enter brahms. If BRAHMS is correctly installed, the output should look something like this:

Octave Console
BRAHMS Version ... Copyright (C) 2007-2011 Ben Mitchinson BRAHMS comes with ABSOLUTELY NO WARRANTY. This is free software, and you are welcome to redistribute it under certain conditions. For details, type "brahms --license", and/or visit us at http://brahms.sourceforge.net Usage: brahms <exefile> [<option> ...] brahms <operation> [<option> ...] ...

Try sml_utils. If the SystemML Toolbox is correctly installed, the output should look something like this:

Octave Console
SystemML Toolbox Version ... is installed

If that does not work...
  • Check that path has been set correctly (enter pathdef at the Octave prompt). It must include the paths detailed above.
  • Restart Octave.
  • Restart your machine.

Set WorkingDirectory

Use brahms_utils to set your WorkingDirectory using the following syntax. This is a folder for temporary files, so choose something appropriate.

Octave Console
brahms_utils SetExecutionParameter user WorkingDirectory ...

Test

You can now run the full test suite, brahms_test all, from Octave. If everything is working correctly, the output should look like this:

Octave Console
>> brahms_test all ________________________________________________ brahms_test "source" 1 result fields validated OK ________________________________________________ ...
Notes
  • If you do not use MPI (that is, if you don't have it installed or turned on), this test will fail at "source.m". This is fine, so long as you don't want to use MPI - if you do, see the Advanced Install section.