Difference between revisions of "MATLAB 2016"
m (→Using MATLAB with the HPC cluster: changed ntasks-per-node to ncpus-per-task) |
Schwietzer (talk | contribs) |
||
| (7 intermediate revisions by 4 users not shown) | |||
| Line 2: | Line 2: | ||
MATLAB is a commercial software product of [http://www.mathworks.com/ Mathworks Inc.] for solving mathematical and scientific problems and for displaying results graphically. MATLAB is primarily designed for numerical calculations with matrices, the name was derived from that purpose: MATrix LABoratory. | MATLAB is a commercial software product of [http://www.mathworks.com/ Mathworks Inc.] for solving mathematical and scientific problems and for displaying results graphically. MATLAB is primarily designed for numerical calculations with matrices, the name was derived from that purpose: MATrix LABoratory. | ||
== Installed version(s) | |||
These versions are installed and and currently available on all environments ... | |||
'''MATLAB/2016b''' | |||
'''MATLAB/2017b''' | |||
'''MATLAB/2018b''' | |||
'''MATLAB/2019b''' | |||
'''MATLAB/2020a''' | |||
== MATLAB at the University Oldenburg == | == MATLAB at the University Oldenburg == | ||
| Line 15: | Line 25: | ||
module spider matlab | module spider matlab | ||
will show you which versions are available. To run MATLAB you need to load the module for the desired version, e.g. | will show you which versions are available. To run MATLAB you need to load the module and the corresponding environment for the desired version, e.g. | ||
module load MATLAB/ | module load hpc-env/6.4 | ||
module load MATLAB/2018b | |||
(note that unlike the spider command, the load command is case-sensitive). After that you can start MATLAB with | (note that unlike the spider command, the load command is case-sensitive). After that you can start MATLAB with | ||
| Line 33: | Line 44: | ||
# Write a SLURM batch job script that calls MATLAB and runs a pre-defined MATLAB program. You can use a complete compute node for this if you allocate the resources accordingly. Explanations may follow in the future. | # Write a SLURM batch job script that calls MATLAB and runs a pre-defined MATLAB program. You can use a complete compute node for this if you allocate the resources accordingly. Explanations may follow in the future. | ||
# Run MATLAB interactively on a compute node using srun: | # Run MATLAB interactively on a compute node using srun: | ||
srun -- | srun --ntasks=1 --cpus-per-task=24 -p carl.p matlab | ||
MATLAB only runs in text-based mode this way (even without the -nodisplay option). | MATLAB only runs in text-based mode this way (even without the -nodisplay option). The interactive session will automatically terminate after 2 hours (the default time limit). You can use additional <tt>srun</tt>-options to request more resources, e.g. <tt>--time=hh:mm:ss</tt> for a different time limit. | ||
'''IMPORTANT NOTE:''' Make sure you are not using more compute cores than allocated when using options 2. or 3. above. Per default MATLAB | '''IMPORTANT NOTE:''' Make sure you are not using more compute cores than allocated when using options 2. or 3. above. Per default MATLAB should automatically detect the number of available compute cores and should make use of all of them. Since compute nodes are a shared resource, trying to use more than the allocated resources may interfere with other jobs! To avoid this problem you can: | ||
# allocate a compute node exclusively (see SLURM examples on how to achieve this) | # allocate a compute node exclusively (see SLURM examples on how to achieve this, the <tt>srun</tt>-example above does it by allocating all cores) | ||
# limit the number of compute threads in MATLAB by adding the line | # limit the number of compute threads in MATLAB by adding the line | ||
maxNumCompThreads(N) | maxNumCompThreads(N) | ||
to your MATLAB code. N is the number of compute threads and it must match the -- | to your MATLAB code. N is the number of compute threads and it must match the --cpus-per-tasks setting of your job allocation. | ||
== MATLAB Distributed Compute Server == | == MATLAB Distributed Compute Server == | ||
| Line 46: | Line 57: | ||
The MATLAB Distributed Compute Server (MDCS) is a special mechanism that allow users to setup and submit jobs in MATLAB from their own computer (desktop, laptop). The job is then scheduled and executed on the cluster. The results are returned back to your own MATLAB session. This is the recommended procedure for using MATLAB on the HPC cluster and itt requires to configure MATLAB on your local computer once. The configuration of MATLAB is explained in detail on the next page, the steps to take are: | The MATLAB Distributed Compute Server (MDCS) is a special mechanism that allow users to setup and submit jobs in MATLAB from their own computer (desktop, laptop). The job is then scheduled and executed on the cluster. The results are returned back to your own MATLAB session. This is the recommended procedure for using MATLAB on the HPC cluster and itt requires to configure MATLAB on your local computer once. The configuration of MATLAB is explained in detail on the next page, the steps to take are: | ||
# Install MATLAB on your computer (version must be available on the cluster, too). | # Install MATLAB on your computer (version must be available on the cluster, too). | ||
# Configure MATLAB for MDCS on your computer. | # [[Configuration MDCS 2016|Configure MATLAB for MDCS on your computer]]. | ||
Once the setup has been done, you can start submitting jobs to the cluster as explained in MDCS examples page. Further information can be found on the MDCS tutorial pages and on the Mathworks web page. | Once the setup has been done, you can start submitting jobs to the cluster as explained in MDCS examples page. Further information can be found on the MDCS tutorial pages and on the Mathworks web page. | ||
Latest revision as of 11:58, 23 September 2022
Introduction
MATLAB is a commercial software product of Mathworks Inc. for solving mathematical and scientific problems and for displaying results graphically. MATLAB is primarily designed for numerical calculations with matrices, the name was derived from that purpose: MATrix LABoratory.
== Installed version(s)
These versions are installed and and currently available on all environments ...
MATLAB/2016b MATLAB/2017b MATLAB/2018b MATLAB/2019b MATLAB/2020a
MATLAB at the University Oldenburg
A campus license agreement provides access to MATLAB, Simulink and a variety of toolboxes for all students, scientists, and employees at the University Oldenburg. The licensed software products may be installed on computers in the campus network and on laptops and computers at home. While the license agreement is running the software can be used for as long as you are a member of the University (as student or employee). The software can be used for teaching and research only, commercial applications are explicitly prohibited by the license agreement.
If you want to use MATLAB you can find instructions on downloading and installing the software at the web pages of IT services (German only). You may need to contact your local system administrator for help. It is recommended to install a recent version of MATLAB to get the most features and also optimal performance.
Using MATLAB with the HPC cluster
On the HPC clusters MATLAB is installed, the command
module spider matlab
will show you which versions are available. To run MATLAB you need to load the module and the corresponding environment for the desired version, e.g.
module load hpc-env/6.4 module load MATLAB/2018b
(note that unlike the spider command, the load command is case-sensitive). After that you can start MATLAB with
matlab
or
matlab -nodisplay
if you have not enabled X-forwarding at login.
Please note that MATLAB should not be used on the login nodes for compute-intensive applications. In that case you should submit a MATLAB job to the cluster which is then executed on the compute nodes. There are three ways of running MATLAB on a compute node:
- Use MATLAB Distributed Compute Server (MDCS) to submit MATLAB jobs from your desktop computer to the cluster. This is the recommended way, and is explained in detail in this Wiki (see below).
- Write a SLURM batch job script that calls MATLAB and runs a pre-defined MATLAB program. You can use a complete compute node for this if you allocate the resources accordingly. Explanations may follow in the future.
- Run MATLAB interactively on a compute node using srun:
srun --ntasks=1 --cpus-per-task=24 -p carl.p matlab
MATLAB only runs in text-based mode this way (even without the -nodisplay option). The interactive session will automatically terminate after 2 hours (the default time limit). You can use additional srun-options to request more resources, e.g. --time=hh:mm:ss for a different time limit.
IMPORTANT NOTE: Make sure you are not using more compute cores than allocated when using options 2. or 3. above. Per default MATLAB should automatically detect the number of available compute cores and should make use of all of them. Since compute nodes are a shared resource, trying to use more than the allocated resources may interfere with other jobs! To avoid this problem you can:
- allocate a compute node exclusively (see SLURM examples on how to achieve this, the srun-example above does it by allocating all cores)
- limit the number of compute threads in MATLAB by adding the line
maxNumCompThreads(N)
to your MATLAB code. N is the number of compute threads and it must match the --cpus-per-tasks setting of your job allocation.
MATLAB Distributed Compute Server
The MATLAB Distributed Compute Server (MDCS) is a special mechanism that allow users to setup and submit jobs in MATLAB from their own computer (desktop, laptop). The job is then scheduled and executed on the cluster. The results are returned back to your own MATLAB session. This is the recommended procedure for using MATLAB on the HPC cluster and itt requires to configure MATLAB on your local computer once. The configuration of MATLAB is explained in detail on the next page, the steps to take are:
- Install MATLAB on your computer (version must be available on the cluster, too).
- Configure MATLAB for MDCS on your computer.
Once the setup has been done, you can start submitting jobs to the cluster as explained in MDCS examples page. Further information can be found on the MDCS tutorial pages and on the Mathworks web page.
