- 1 Category
- 2 Description
- 3 Available versions
- 4 Environment modules
- 5 Interactive session
- 6 How to submit a job
- 7 Parallel jobs
- 8 Example
- 9 License information
- 10 Troubleshooting
- 11 Notes
- 12 Links
DescriptionMATLAB (matrix laboratory) is a multi-paradigm numerical computing environment and fourth-generation programming language. A proprietary programming language developed by MathWorks, MATLAB allows matrix manipulations, plotting of functions and data, implementation of algorithms, creation of user interfaces, and interfacing with programs written in other languages, including C, C++, Java, Fortran and Python.
|Legacy versions||Supported versions||New versions|
|8.2, 8.5, R2017b||8.4, 8.6, 8.7, 9.1, R2018a|
|Version||Module load command||Additional modules loaded automatically|
|8.2||module load matlab/8.2|
|8.5||module load matlab/8.5|
|R2017b||module load new matlab/9.1|
|8.4||module load new matlab/8.4|
|8.6||module load new matlab/8.6|
|8.7||module load new matlab/8.7|
|9.1||module load new matlab/9.1|
|R2018a||module load new matlab/R2018a|
Interactive sessionYou can run an interactive MATLAB session on the login node, to do some quick tests, but larger calculations must be submitted through the batch system. In order to start an interactive MATLAB session, load the matlab module and type the command matlab.
[leonhard@euler03 ~]$ module load matlab/8.2 [leonhard@euler03 ~]$ matlab Warning: No display specified. You will not be able to display graphics on the screen. Warning: No window system found. Java option 'Desktop' ignored. < M A T L A B (R) > Copyright 1984-2013 The MathWorks, Inc. R2013b (126.96.36.1991) 64-bit (glnxa64) August 13, 2013 No window system found. Java option 'Desktop' ignored. To get started, type one of these: helpwin, helpdesk, or demo. For product information, visit www.mathworks.com. >> vpa(exp(1),50) ans = 2.7182818284590455348848081484902650117874145507812 >>If you have established an SSH connection with X11 forwarding enabled, then the matlab command will start the MATLAB GUI.
How to submit a jobAssuming that you already loaded the MATLAB module and have a MATLAB program simulation.m you would like to run, the command to submit a job to the batch system would look like
bsub [LSF options] matlab -nodisplay -nojvm -singleCompThread -r simulation
Please note, that you have to leave away the file ending .m. You need to replace [LSF options] with LSF parameters for the resource requirements of the job. Please find a documentation about the parameters of bsub on the wiki page about the batch system.
We suggest you include the extra options shown above:
- since jobs on compute nodes are not run interactively, this flag explicitly tells Matlab that no graphical display (X server) is available is available.
- forces Matlab to use only one thread for its computations. This option is crucial to prevent MATLAB from overloading the compute nodes.
- (optional) prevents the JVM (Java virtual machine) from being used. Add this flag unless you need the JVM, such as the with the PCT (Parallel Computing Toolbox).
Parallel jobsMATLAB's Parallel Computing Toolbox lets you run suitably-written programs in parallel. Several cores calculate different parts of a problem at the same time to reduce the time-to-solution.
For running MATLAB in parallel, you can either use a local parpool (up to 24 cores), an LSF parpool (24+ cores) or use the MATLAB distributed computing server (MDCS), which allows to offload jobs from a local MATLAB instance running on your computer to the Euler cluster. Please find below the documentation about using a local parpool. Instructions for using an LSF parpool as well as for using the MDCS are provided on separate wiki pages.
Use a parpool
For suitable MATLAB programs (such as those containing parfor loops), using the Parallel Computing Toolbox requires two steps:
- use a parpool in your MATLAB program and
- request multiple cores from Euler's LSF batch scheduler.
A trivial parallel program (simulation.m) is shown below:
euler = parcluster('local'); squares = zeros(10,1); pool = parpool(euler,4); parfor i = 1:10 squares(i) = i^2; end disp(squares) pool.delete()
Note that the local parpool is limited to 12 cores in releases up to R2016a (8.7/9.0). From release R2016b (9.1) on, you can use all the cores of Euler nodes (effectively 24).
Older versions of MATLAB used a matlabpool instead of a parpool. For using a local pool there is no need to load a cluster profile.
Submit a parallel job
Pass the number of cores (e.g., 4) to bsub's -n argument. This should match the size of the pool requested in your MATLAB script.
bsub -n 4 -W "1:00" -R "rusage[mem=2048]" matlab -nodisplay -singleCompThread -r simulation
Note that you must not use the -nojvm argument but you should include the -singleCompThread argument. MATLAB is quite memory-hungry, so request at least 2 GB of memory.
Troubleshoot parallel jobs
Using parallel pools often results in hard-to-diagnose errors. Many of these errors are related to running several pools at the same time, which is not what MATLAB expects. If you encounter persistent problems starting pools, try to perform one of these commands. Before running them, make sure that you do not have a MATLAB processes running.
- Remove the matlab_metadat.mat file in your current working directory.
- Remove the $HOME/.matlab/local_cluster_jobs directory.
- Remove the entire $HOME/.matlab directory. Warning: Your MATLAB settings on Euler will be lost.
ExampleAs an example for a MATLAB job, we are calculating the determinant of a 3x3 Matrix.
[leonhard@euler01 ~]$ cat matrix_determinant.m A = [1 -2 4; -5 2 0; 1 0 3] d = det(A) [leonhard@euler01 ~]$ module load matlab/8.5 [leonhard@euler01 ~]$ bsub -n 1 -W 1:00 -R "rusage[mem=512]" "matlab -nodisplay -nojvm -singleCompThread -r matrix_determinant" MATLAB job. Job <30576749> is submitted to queue <normal.4h>. [leonhard@euler01 ~]$ bjobs JOBID USER STAT QUEUE FROM_HOST EXEC_HOST JOB_NAME SUBMIT_TIME 30576749 leonhard PEND normal.4h euler01 *terminant Oct 21 13:32 [leonhard@euler01 ~]$ bjobs JOBID USER STAT QUEUE FROM_HOST EXEC_HOST JOB_NAME SUBMIT_TIME 30576749 leonhard PEND normal.4h euler01 *terminant Oct 21 13:32 [leonhard@euler01 ~]$ bjobs JOBID USER STAT QUEUE FROM_HOST EXEC_HOST JOB_NAME SUBMIT_TIME 30576749 leonhard RUN normal.4h euler01 e1245 *terminant Oct 21 13:32 [leonhard@euler01 ~]$ grep -A9 "A =" lsf.o30576749 A = 1 -2 4 -5 2 0 1 0 3 d = -32 [sfux@euler01 test1]$The output of the MATLAB calculation can be found in the LSF log file lsf.o30576749.
License informationCommercial (centrally provided by IT shop)
TroubleshootingSometimes, MATLAB jobs crash with a segmentation fault (exit code 137).
Your job looked like: ------------------------------------------------------------ # LSBATCH: User input matlab -nodisplay -nojvm -singleCompThread -r matlab_script_that_uses_more_memory_than_requested ------------------------------------------------------------ Exited with exit code 137. Resource usage summary: CPU time : 12385.20 sec. Max Memory : 14133 MB Average Memory : 12578 MB Total Requested Memory : 15000 MB Delta Memory : 867 MB Max Swap : - Max Processes : 4 Max Threads : 11 Run time : 8433 sec. Turnaround time : 8534 sec.
Usually this means that not enough memory was requested from the batch system. This can happen, even if the resource usage summary in the LSF logfile shows a positive delta memory. The resource usage summary only includes successful memory allocations. If a job tries to allocate a larger amount of memory and fails, then this is not reflected in the resource usage summary.In such a case, please restart the job and request a larger amount of memory.
Alternative to MATLAB
There is a freely available alternative to MATLAB, which is called Octave. It understands most MATLAB programs. It is not directly compatible with Matlab toolboxes but alternatives to some toolboxes exist.
Compiling MATLAB programs
MATLAB programs can be compiled into standalone executable programs using the Matlab Compiler mcc. A key benefit is that the compiled program does not check out a Matlab license. However, many toolboxes can not be used with compiled programs.
A function simulation defined in a file simulation.m is compiled into a standalone executable program simulation using the
mcc -m -R -nodisplay -R -nojvm -R -singleCompThread simulation.m
command. Note the dashes in front of the options, especially -R -singleCompThread.
To run the program, execute it through the generated script, which is call run_simulation.sh, where simulation is the name of your script.
bsub "./run_simulation.sh $MATLAB"The script needs the $MATLAB argument, which is defined when the appropriate Matlab module is loaded.