HPC/Applications/matlab: Difference between revisions

From CNM Wiki
Jump to navigation Jump to search
 
(33 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Licensing ==
[http://www.mathworks.com/ MATLAB] is available on Carbon on request, and is subject to strictly limited license terms.
<!--
In fact, most of the information conveyed here concerns licensing, a thoroughly unloved necessity of high-profile commercial software.
-->
Running MATLAB is restricted to:
* '''Argonne employees''' (including consultants and students),
* by '''one user at a time'''.
<!--
* on node '''clogin5 only''',
* '''not remotely''', except for a certain number of users per year.
-->
=== Toolboxes ===
We have the following toolboxes installed:
* Curve Fitting Toolbox
* Image Processing Toolbox
* Optimization Toolbox
* Parallel Computing Toolbox
* Statistics Toolbox
<!--
=== Request access ===
To request access to MATLAB on Carbon, [mailto:[email protected]?subject=MATLAB%20on%20Carbon send an email].
-->
== Alternatives ==
== Alternatives ==
MATLAB is vendor-specific, and comparably expensive licensed software and thus not generally available.
Given licensing and availability limitations of MATLAB you may wish to consider using alternative solutions, especially for new projects.
Consider using an unencumbered alternative solution.


=== Octave ===
=== Octave ===
Line 18: Line 43:
* Users who like a stonger Unix flavor should look at [http://www.perl.org/ Perl].
* Users who like a stonger Unix flavor should look at [http://www.perl.org/ Perl].


== Licensing ==
=== NLopt – Nonlinear optimization ===
[http://www.mathworks.com/ MATLAB] is available on Carbon on request, and is subject to strictly limited license terms.
For users wishing to solve nonlinear optimization problems, the [[HPC/Applications#nlopt | nlopt module]] is a fairly general-purpose optimization library with interfaces in C, C++ and Fortran.
<!--
In fact, most of the information conveyed here concerns licensing, a thoroughly unloved necessity of high-profile commercial software.
-->
Running MATLAB is restricted to:
* '''Argonne employees''' (including consultants and students),
* on node '''clogin5 only''',
* by '''one user at a time''',
* '''not remotely''', except for a certain number of users per year.
 
=== Toolboxes ===
We have the following toolboxes installed:
* Curve_Fitting_Toolbox
* Image_Toolbox
* Optimization_Toolbox
* Distrib_Computing_Toolbox
* Statistics_Toolbox
 
=== Request access ===
To request access to MATLAB on Carbon, [mailto:[email protected]?subject=MATLAB%20on%20Carbon send an email].


== Running MATLAB ==
== Running MATLAB ==
Line 47: Line 53:
; Command line: For basic calculations, you could save some startup time by simply using the text interface.
; Command line: For basic calculations, you could save some startup time by simply using the text interface.
  matlab -nojvm
  matlab -nojvm
: Does not load the Java VM and toolboxes requiring any java.
or
matlab -nodisplay
: Suppresses X11.
== Documentation ==
Consult the vendor's documentation:
* http://www.mathworks.com/help/matlab/index.html
: '''Caution:''' This page presents the vendor's current release (R2014b at time of writing). To see documentation specific to the release installed on Carbon (R2013a), whose behavior could differ from the current release, see the tab "Other Releases". You will need an existing or new user-specific site login.
* http://www.mathworks.com/help/matlab/getting-started-with-matlab.html .
== Using the MATLAB compiler ==
The MATLAB compiler, available on Carbon, 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==
See [[HPC/Applications/matlab/Parallel]].


== Troubleshooting ==
== Troubleshooting ==
=== Access ===
=== Access ===
To run MATLAB on Carbon, you must be a member of the "matlab" group. You could still load the "matlab" module if you are not, but it will not enable anything.
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:
* To inspect your current group membership, run:
  groups
  groups
: The word "matlab" must show.
: The word "employees" must show.


<!--
=== Running on a host that is not licensed ===
=== Running on a host that is not licensed ===
  License checkout failed.
  License checkout failed.
Line 60: Line 85:
  The hostid of your computer ("001122334455 001122334466") '''does not match the hostid''' of the license file (001122334400).
  The hostid of your computer ("001122334455 001122334466") '''does not match the hostid''' of the license file (001122334400).
'''Solution:''' log in to clogin5 and retry. If you use the Mega SSH gateway, review the updated instructions for [[HPC/Network Access/SSH Tunnel Setup on Linux and MacOS#Advanced: Connecting to a specific login node | Linux/Mac/Cygwin]] or [[HPC/Network Access/PuTTY Configuration | PuTTY on Windows]] on how to configure and use port forwarding to reach a specific login node.
'''Solution:''' log in to clogin5 and retry. If you use the Mega SSH gateway, review the updated instructions for [[HPC/Network Access/SSH Tunnel Setup on Linux and MacOS#Advanced: Connecting to a specific login node | Linux/Mac/Cygwin]] or [[HPC/Network Access/PuTTY Configuration | PuTTY on Windows]] on how to configure and use port forwarding to reach a specific login node.
-->


=== License in use ===
=== License in use ===
Line 68: Line 94:
  -'''A Designated Computer installation is in use by another user.'''
  -'''A Designated Computer installation is in use by another user.'''
  If no other user is currently running MATLAB, you may need to activate.
  If no other user is currently running MATLAB, you may need to activate.
'''Solution:''' [mailto:[email protected]?Subject=MATLAB%20on%20Carbon%20busy Send a support request.]
'''Solution:'''
* Wait a few minutes or hours.
* For urgent request, to locate and possibly terminate an existing session, [mailto:[email protected]?Subject=MATLAB%20on%20Carbon%20busy Send a support request.]

Latest revision as of 18:00, November 24, 2014

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


Alternatives

Given licensing and availability limitations of MATLAB you may wish to consider using alternative solutions, especially for new projects.

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

Python or Perl

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

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.

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.

Documentation

Consult the vendor's documentation:

Caution: This page presents the vendor's current release (R2014b at time of writing). To see documentation specific to the release installed on Carbon (R2013a), whose behavior could differ from the current release, see the tab "Other Releases". You will need an existing or new user-specific site login.

Using the MATLAB compiler

The MATLAB compiler, available on Carbon, 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

See HPC/Applications/matlab/Parallel.

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.
Retrieved from "https://wiki.anl.gov/wiki_cnm/index.php?title=HPC/Applications/matlab&oldid=5045"