# Difference between revisions of "MATLAB"

(→Using a MATLAB stand-alone executable on Niagara) |
(→Avaiable MATLAB runtime versions) |
||

(3 intermediate revisions by one other user not shown) | |||

Line 12: | Line 12: | ||

=== Creating a MATLAB stand-alone executable === | === Creating a MATLAB stand-alone executable === | ||

− | If MATLAB must be used, you may be able to compile your MATLAB code into a stand-alone executable, and run this on a Niagara compute node. The version of MATLAB being used will require a compiler license, and the compilation must be done on a Linux machine (not Niagara). | + | If MATLAB must be used, you may be able to compile your MATLAB code into a stand-alone executable, and run this on a Niagara compute node. The version of MATLAB being used will require a compiler license, and the compilation must be done on a Linux machine (not Niagara). |

+ | |||

+ | Note: The compilation of a matlab code produces two files, e.g., compiling <tt>myscript.m</tt> will produce a file <tt>myscript</tt> and a file <tt>run_myscripts.sh</tt>. You will need both files. | ||

=== Using a MATLAB stand-alone executable on Niagara === | === Using a MATLAB stand-alone executable on Niagara === | ||

− | Once the compilation is done, the executable can be copied to SciNet, and run using the MATLAB Compiler Runtime (MCR), which can be accessed using the MCR module. The MCR used must be the same version of MATLAB as the compiler. If the version of MCR that you need is not listed among the MCR module versions, contact us and we will install the version which you require. | + | Once the compilation is done, the executable and its run script (<tt>run_SOMETHING.sh</tt>) can be copied to SciNet, and run using the MATLAB Compiler Runtime (MCR), which can be accessed using the MCR module. The MCR used must be the same version of MATLAB as the compiler. If the version of MCR that you need is not listed among the MCR module versions, contact us and we will install the version which you require. |

Here is an example script which uses the MCR. Note that the "run_myscript.sh" script is produced by the MATLAB compiler, together with the "myscript" executable (assuming you were working on the myscript.m MATLAB code): | Here is an example script which uses the MCR. Note that the "run_myscript.sh" script is produced by the MATLAB compiler, together with the "myscript" executable (assuming you were working on the myscript.m MATLAB code): | ||

Line 44: | Line 46: | ||

</source> | </source> | ||

− | === | + | === Available MATLAB runtime versions === |

Below is a list of the available MATLAB runtime versions on Niagara, with the required module command: | Below is a list of the available MATLAB runtime versions on Niagara, with the required module command: |

## Latest revision as of 21:37, 16 August 2020

We often get questions about running MATLAB on Niagara. With a few exceptions for compilers and debuggers, SciNet does not purchase licenses for commercial software. As such, SciNet does not have a license for MATLAB, nor will it in the future. If users wish to run MATLAB they must supply their own license, or explore alternative options. This page gives information about the options for getting your MATLAB code to run, in recommended order.

## Contents

## Not using MATLAB

Users can attempt to run MATLAB code using the open-source program Octave, accessible through the octave module. Though there are some differences between the two programs, Octave has been designed to interpret MATLAB code and can often be used in place of MATLAB. If your MATLAB code does not use some of the more-fancy MATLAB toolboxes, you may be able to get away with using Octave instead. Be sure to test your implementation in Octave thoroughly before committing to this option.

It is worth observing that, while convenient for prototyping and running on a single workstation, there are reasons to avoid using MATLAB for larger HPC/ARC projects. These include the prohibitive license cost for large-scale work, poor performance at scale, and portability issues. If you can switch to a license-free option, such as Python, it may be worth the effort.

## Using stand-alone MATLAB executables

### Creating a MATLAB stand-alone executable

If MATLAB must be used, you may be able to compile your MATLAB code into a stand-alone executable, and run this on a Niagara compute node. The version of MATLAB being used will require a compiler license, and the compilation must be done on a Linux machine (not Niagara).

Note: The compilation of a matlab code produces two files, e.g., compiling `myscript.m` will produce a file `myscript` and a file `run_myscripts.sh`. You will need both files.

### Using a MATLAB stand-alone executable on Niagara

Once the compilation is done, the executable and its run script (`run_SOMETHING.sh`) can be copied to SciNet, and run using the MATLAB Compiler Runtime (MCR), which can be accessed using the MCR module. The MCR used must be the same version of MATLAB as the compiler. If the version of MCR that you need is not listed among the MCR module versions, contact us and we will install the version which you require.

Here is an example script which uses the MCR. Note that the "run_myscript.sh" script is produced by the MATLAB compiler, together with the "myscript" executable (assuming you were working on the myscript.m MATLAB code):

#!/bin/bash #SBATCH --nodes=1 #SBATCH --cpus-per-task=40 #SBATCH --time=1:00:00 #SBATCH --job-name test_matlab #SBATCH --output=matlab_output_%j.txt # DIRECTORY TO RUN - $SLURM_SUBMIT_DIR is the directory from which the job was submitted cd $SLURM_SUBMIT_DIR # load module module load mcr/R2018a # Directory for the MCR to use to write temporary files. Use whatever directory you wish. mkdir -p $SCRATCH/temp export MCR_CACHE_ROOT=$SCRATCH/temp # EXECUTION COMMAND (note that the MATLAB script may require that LD_LIBRARY_PATH be added # to the script arguments). Note that, if the calculations are serial, you must bundle 40 such # calculations together for production runs! ./run_myscript.sh $MATLAB:$LD_LIBRARY_PATH

### Available MATLAB runtime versions

Below is a list of the available MATLAB runtime versions on Niagara, with the required module command:

module load NiaEnv/2018a mcr/R2018a module load NiaEnv/2019b mcr/R2019a module load CCEnv nixpkgs/16.09 mcr/R2013a module load CCEnv nixpkgs/16.09 mcr/R2013b module load CCEnv nixpkgs/16.09 mcr/R2014a module load CCEnv nixpkgs/16.09 mcr/R2014b module load CCEnv nixpkgs/16.09 mcr/R2015a module load CCEnv nixpkgs/16.09 mcr/R2015b module load CCEnv nixpkgs/16.09 mcr/R2016a module load CCEnv nixpkgs/16.09 mcr/R2016b module load CCEnv nixpkgs/16.09 mcr/R2017a module load CCEnv nixpkgs/16.09 mcr/R2017b

## Tunneling to a license server

If you have access to a non-SciNet MATLAB license server, and have installed MATLAB in your $HOME directory, you can setup your submission script to access the external license server. The following lines should be added to the beginning of your submission script, after the #SBATCH commands:

PORT=XXX # port number of the license server LICENSE_IP=AAA.BBB.CCC.DDD # IP address of the license server ssh nia-gw -L${PORT}:${LICENSE_IP}:${PORT} -N &

This last line will tunnel the port from the compute node back to the license server, through nia-gw. The port number and IP address of the licence server must be supplied by the system administrator of the license server.

## Using a different Consortium

Both Sharcnet and Westgrid have purchased different types of MATLAB licenses. Users can contact those consortia if they wish to attempt to run on those systems.