HPC/Applications/matlab

Alternatives

MATLAB is vendor-specific, and comparably expensive licensed software and thus not generally available. Consider using an unencumbered alternative solution.

Octave

If you have existing MATLAB code, try running in using GNU Octave instead of MATLAB for all but the most demanding or vendor-specific tasks:

• To start octave:

octave

• GNU Octave Documentation
• Differences between Octave and MATLAB in the WikiBook MATLAB Programming (slightly out of date).
• Why/when should I prefer MATLAB over Octave? – Discussion at stackoverflow.com.

Python or Perl

For more flexibility, use a general-purpose scripting language.

• Most users may want to look at Python with NumPy, available as module "numpy" on Carbon. See also:
  • Numerical python functions written for compatability with MATLAB
  • NumPy for Matlab Users
• Users who like a stonger Unix flavor should look at Perl.

NLopt – Nonlinear optimization

For users wishing to solve nonlinear optimization problems, the nlopt module is a fairly general-purpose optimization library with interfaces in C, C++ and Fortran.

Licensing

MATLAB is available on Carbon on request, and is subject to strictly limited license terms. Running MATLAB is restricted to:

• Argonne employees (including consultants and students),
• by one user at a time.

Toolboxes

We have the following toolboxes installed:

• Curve Fitting Toolbox
• Image Processing Toolbox
• Optimization Toolbox
• Parallel Computing Toolbox
• Statistics Toolbox

Running MATLAB

• To get started, load the "matlab" module as described at HPC/Module Setup.
• Then choose how to run the application:

GUI

matlab

Command line

For basic calculations, you could save some startup time by simply using the text interface.

matlab -nojvm

Does not load the Java VM and toolboxes requiring any java.

or

matlab -nodisplay

Suppresses X11.

Running the MATLAB compiler

A MATLAB compiler is installed on Carbon. The compiler allows you to create standalone Linux binaries that do not need a MATLAB license token to run.

For documentation, see HPC/Applications/matlab/Compiler.

Parallel toolkit

• http://www.mathworks.com/help/distcomp/
• or http://www.mathworks.com/help/releases/R2013a/distcomp/
• http://www.mathworks.com/help/distcomp/release-notes.html?searchHighlight=matlabpool

  parpool: New command-line interface (replaces matlabpool)

• http://www.mathworks.com/help/mdce/release-notes.html?searchHighlight=matlabpool

  Same, plus: Discontinued Support for parallel.cluster.Mpiexec

  Automatic start of a parallel pool when executing code that uses parfor or spmd

An error has occurred processing your job, see below.
Post job file processing error; job 435379.sched1.carboncluster on host n189/7+n189/6+…+n187/0

Unable to copy file /var/spool/torque/spool/435379.sched1.carboncluster.OU to /home/stern/somedir/Job1/Job1.log
*** error from copy
/bin/cp: cannot create regular file `/home/stern/somedir/Job1/Job1.log': No such file or directory
*** end error output
Output retained on that host in: /var/spool/torque/undelivered/435379.sched1.carboncluster.OU

Troubleshooting

Access

To run MATLAB on Carbon, you must be a member of the "employees" group. You could still load the "matlab" module if you are not, but it will not enable anything.

• To inspect your current group membership, run:

groups

The word "employees" must show.

License in use

License checkout failed.
License Manager Error -9
This error may occur when:
-The hostid of this computer does not match the hostid in the license file.
-A Designated Computer installation is in use by another user.
If no other user is currently running MATLAB, you may need to activate.

Solution:

• Wait a few minutes or hours.
• For urgent request, to locate and possibly terminate an existing session, Send a support request.