hpc documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Using Matlab ======

MATLAB® is a high-level language and interactive environment for numerical computation, visualization, and programming. Using MATLAB, you can analyze data, develop algorithms, and create models and applications. The language, tools, and built-in math functions enable you to explore multiple approaches and reach a solution faster than with spreadsheets or traditional programming languages, such as C/C++ or Java™


See [[software:matlab:shared-node|Computational model for running Matlab on a shared Cluster]]

====== License information ======

MATLAB is product licensed by Mathworks.  The MATLAB product and related toolboxes are usually installed requiring access to the UD license server and requires a **persistent network connection** as well as [[http://www.udel.edu/it/help/connecting/vpn/|UD VPN]] when accessing off-campus. When MATLAB is started a license token is checked out from the license server. Each toolbox function also requires the availability of a license token to start during a MATLAB session. The UD license server currently has tokens (number of licenses) for [[central licenses|core MATLAB and about 50 toolboxes]].

The Mathworks R2013b and newer license server is being queried every 6 minutes on each cluster for available seats licensed for Matlab, Simulink and associated toolboxes.

====== Project directory ======

MATLAB is a language for scientific computing.  A MATLAB project consists of a main program, called a MATLAB script, that when executed will read data, call MATLAB functions, and write data.  This data may be in the form of text files, image files, MATLAB save files (MAT-file), or any of many standard file formats, e.g., HDF5.  To keep your project portable you should put your scripts, functions and data in one directory.  This directory is called the //Current Folder// on the MATLAB desktop.

MATLAB has tools to help you make your project portable, and you should use them.  For example, you should specify all files using
[[http://www.mathworks.com/help/matlab/file-name-construction.html| MATLAB file construction functions]].

<note tip>**MAT-file save format:**  

Your preferences at

MATLAB -> General -> MAT-files 

may have a older MAT-file save format selected as the default.  You should check to make sure you can save large files (greater than 2GB) for all versions of MATLAB where you may write ''.mat'' files. There is another advantage to using the newest file format:

[[http://www.mathworks.com/help/matlab/import_export/load-parts-of-variables-from-mat-files.html|You can load parts of variables from a MAT-file]].
</note>

When you have a MATLAB job tested and debugged in a project directory, you are ready run on a cluster.

See [[#details-by-clusters|cluster details]] for examples on running your Matlab job on a particular cluster.

====== Parallel job ======

You can use [[http://www.mathworks.com/discovery/matlab-multicore.html|multicore or multiprocessor]] MATLAB for your project.
There are three ways do this using the cluster scheduler and/or MATLAB toolboxes.


=====  Array job =====

Multiple, independent, single-threaded MATLAB scripts can be run on the same node, or different nodes. The only communication between the jobs is through reading and writing files. Your script should be compiled using ''mcc'' so it can be deployed on the cluster to run in a [[http://www.mathworks.com/products/compiler/mcr/index.html|MATLAB Runtime]] environment.

===== Multiple computational threads =====

MATLAB will detect you are on a multicore host and use all the cores it can to speed up its internal calculations.  Use MATLAB builtin functions to take advantage of these multiple computational threads.  You should scedule a computing node with exclusive access, so your job does not interfere with other jobs on the node.

===== Parallel computing toolbox =====

Using the [[http://www.mathworks.com/products/parallel-computing/| MATLAB Parallel Computing Toolbox]] you can create a pool of workers and take control of the parallelism in your algorithm using MATLAB functions such as ''parfor''.  You can run this on one node using the default local scheduler, but the real benefit comes with a separate Mathworks product called the [[http://www.mathworks.com/products/distriben/|MATLAB Distributed Computing Server]]


======Details by cluster======
  * [[software:matlab:caviness | Caviness]]
  * [[software:matlab:farber | Farber]]
  * [[software:matlab:mills| Mills]]

====== Additional Resources ======
  * [[https://www.mathworks.com/support.html|Matlab - Mathworks Support]]
  * Increase Matlab Throughput ([[http://www.udel.edu/it/research/files/cluster/workshop/millsexpress-20120210.pdf|slides]])  ([[http://udcapture.udel.edu/misc/it-css/?t=3f991958920a2160637807e19d369aa2|video]])
  * Matlab Parallel Computing Toolbox ([[http://www.udel.edu/it/research/files/cluster/workshop/millsexpress-20120316.pdf|slides]]) ([[http://udcapture.udel.edu/misc/it-css/?t=7e7406b0e6d03ce86b555f4ad378fcfa|video]])
  * Benefits of Using the Matlab Compiler ([[http://www.udel.edu/it/research/files/cluster/workshop/millsexpress-20120224.pdf|slides]]) ([[http://udcapture.udel.edu/misc/it-css/?t=2b87c0f4d9448880e6d9d07b4ff5f9dd|video]])