MATLAB: Difference between revisions

From Cheaha
Jump to navigation Jump to search
No edit summary
 
(57 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Main_Banner}}
[[Matlab_OSX_JAVA | '''Mac OSX USERS click here to view any outstanding issues with installing MATLAB on OSX''']]
'''[[wikipedia:MATLAB|MATLAB]]''' ('''mat'''rix '''lab'''oratory) is a [[wikipedia:Numerical analysis|numerical computing]] environment and [[wikipedia:fourth-generation programming language|fourth-generation programming language]]. Developed by [[wikipedia:MathWorks|Mathworks]], MATLAB allows [[wikipedia:matrix (mathematics)|matrix]] manipulations, plotting of [[wikipedia:function (mathematics)|functions]] and data, implementation of [[wikipedia:algorithm|algorithm]]s, creation of [[wikipedia:user interface|user interface]]s, and interfacing with programs written in other languages, including [[wikipedia:C (programming language)|C]], [[wikipedia:C++|C++]], and [[wikipedia:Fortran|Fortran]]. An additional package, [[wikipedia:Simulink|Simulink]], adds graphical multi-domain simulation and [[wikipedia:Model based design|Model-Based Design]] for [[wikipedia:dynamical system|dynamic]] and [[wikipedia:embedded systems|embedded systems]].
'''[[wikipedia:MATLAB|MATLAB]]''' ('''mat'''rix '''lab'''oratory) is a [[wikipedia:Numerical analysis|numerical computing]] environment and [[wikipedia:fourth-generation programming language|fourth-generation programming language]]. Developed by [[wikipedia:MathWorks|Mathworks]], MATLAB allows [[wikipedia:matrix (mathematics)|matrix]] manipulations, plotting of [[wikipedia:function (mathematics)|functions]] and data, implementation of [[wikipedia:algorithm|algorithm]]s, creation of [[wikipedia:user interface|user interface]]s, and interfacing with programs written in other languages, including [[wikipedia:C (programming language)|C]], [[wikipedia:C++|C++]], and [[wikipedia:Fortran|Fortran]]. An additional package, [[wikipedia:Simulink|Simulink]], adds graphical multi-domain simulation and [[wikipedia:Model based design|Model-Based Design]] for [[wikipedia:dynamical system|dynamic]] and [[wikipedia:embedded systems|embedded systems]].


MATLAB can be used on personal computers and powerful server systems, including the [[Cheaha]] compute cluster.  With the addition of the Parallel Computing Toolbox, the language can be extended with parallel implementations for common computational functions, including for-loop unrolling.  Additionally this toolbox supports offloading computationally intensive workloads to [[Cheaha]] the campus compute cluster.
MATLAB can be used on personal computers and powerful server systems, including the [[Cheaha]] compute cluster.  With the addition of the Parallel Computing Toolbox, the language can be extended with parallel implementations for common computational functions, including for-loop unrolling.  Additionally this toolbox supports offloading computationally intensive workloads to [[Cheaha]] the campus compute cluster.


In January 2011, UAB acquired a site license for MATLAB that allows faculty, staff, post-docs, and graduate students to use MATLAB, Simulink, and 42 toolboxes (including the parallel toolbox) for research activities on campus and personal systems.  Additionally, MATLAB is available to students on campus computer systems.
In January 2011, UAB acquired a site license for MATLAB that allows faculty, staff, post-docs, and graduate students to use MATLAB, Simulink, and 42 toolboxes (including the parallel toolbox) for research activities on campus and personal systems.  Additionally, from January 2012 MATLAB is available to students on campus and personal computer systems.
 
== MATLAB Versions ==
 
Mathworks has two annual releases of Matlab: the "a" release in the spring and the "b" release in the fall.  Each release gets tagged with the current year and "a" or "b". For example, "Matlab 2013a"  is the spring release for 2013.
 
If you are using Matlab in an isolated environment like on your laptop or desktop, you can generally install the most recent release available from Mathworks.
 
If you plan to uses specific features of Matlab, however, like running computations on the [[Cheaha]] cluster or using a network install.  You should install our recommended release of Matlab that we know works with our services.
 
'''The current recommended release is Matlab 2013a.'''


== Using MATLAB ==
In UAB IT Research Computing, we update our services to work with the latest Matlab release a month or so after the general release of that productThis gives us time to try out the latest release, get feedback from other early adopters, and update services like the Distributed Computing Toolbox, license server and our documentation.
Using Mathworks software available under the UAB campus license on your computer involves download and install steps common to all software packages and an authorization step that grants you the rights to use the software under the campus agreementWhile straight forward, there are several authorization scenarios designed to support a variety of user communities. In an effort to simplify the software installation and get you working with MATLAB as quickly as possible, we detail three authorization scenarios to help you decide the best installation for your needs.


===Installation Overview===
Note: you can always install whichever Matlab release you need and that is still available from Mathworks. Different versions of Matlab are always installed side-by side. Depending on your science domain, you may need to select certain releases in order to access specific features.  However, not all of these releases may be supported by our compute cluster or network license manager.
'''NOTE:'''These steps are common to all install scenarios and are detailed in [[Downloading and Installing MATLAB]].


# [http://www.mathworks.com/accesslogin/createProfile.do Create an account at the Mathworks site] using your campus @uab.edu email address if you do not have one already.
== MATLAB on the Desktop ==
#Request an activation [[Get a UAB Mathworks key | key]].
Using Mathworks software available under the UAB campus license on your computer involves download and install steps common to all software packages and an authorization step that grants you the rights to use the software under the campus agreement.
#Associate to the campus-wide license using your activation key.
#Download the software from [http://www.mathworks.com/downloads/web_downloads/agent_check?s_cid=mwa-cmlndedl&mode=gwylf&refer=mwa mathworks download site] and install.
#Activate the software using the activation scenario that best suits your particular needs.


We are working to simplify these steps and will update this documentation as improvements are introduced.
===Download and Installation Steps===
'''NOTE:'''These steps are common to all installation and activation scenarios and are detailed in [[Downloading and Installing MATLAB]].


=== Installation for Various Activation Scenarios ===
# [http://www.mathworks.com/accesslogin/createProfile.do Create an account at the Mathworks site] using your campus @uab.edu email address. Please do not share your mathworks account ''username'' or ''password'' with anyone as this account will be associated with the UAB TAH license. An end user must choose one of these values when creating a MathWorks Account.  '''Students should choose Student use. Faculty, researchers, and grad students should choose Teaching or research in school.'''
#Request an [[Get a UAB Mathworks key |activation key]] from the [http://www.uab.edu/it/software/index.php UAB software library page] for faculty/staff and from [http://uab.onthehub.com/ UAB on the Hub] for students. Please make sure to request the appropriate key (Faculty/staff or student) as the software are on different licenses.
#[[Downloading_and_Installing_MATLAB#Associate_with_the_UAB_TAH_license|Associate your Mathworks account]] with the campus-wide MATLAB license using your activation key.
#[[Downloading_and_Installing_MATLAB#Download_Matlab|Download the software]] from the [http://www.mathworks.com/downloads/web_downloads/agent_check?s_cid=mwa-cmlndedl&mode=gwylf&refer=mwa mathworks download site] and [[Downloading_and_Installing_MATLAB#Install_Matlab|install MATLAB]]
#[[Downloading_and_Installing_MATLAB#Activating_Matlab|Activate the software]] using the activation scenario that best suits your particular needs.


'''NOTE''': Most on-campus users are encouraged to use the '''[[Simplified MATLAB Install]]''' option for activation unless there are special circumstances.
===Updating MATLAB on Desktop===


# '''[[Simplified MATLAB Install]]''' - This is the recommended install when MATLAB will be used on computers that remain connected to the campus network.  This installation still requires MATLAB to be downloaded and installed, but provides a simple activation process that amounts to adding a static 2-line file after the software is installed your computer.  This option is highly recommend.
If you have been running MATLAB on your desktop during 2011, one can click 'Help', then 'Licensing', and finally 'Update Current Licenses'. This will remedy the license expiration message without having to update to a new copy of MATLAB.  
# '''[[Matlab Designated Computer Install]]''' - This is the recommended install for mobile computing systems that may not be connected to any network when MATLAB is being used.  This install type authorizes an individual computer to run MATLAB, allowing MATLAB to run regardless of where the computer is located.
# '''[[Matlab Network Concurrent User Install]]''' - This installation is only recommended for system administrators who already manage a lab or departmental installation of MATLAB and who would like to continue to provide this service for their user community.  This install type may also be practical if there are special additional license needs that will apply multiply computers running MATLAB.  At present, all MATLAB toolboxes actively used at UAB are covered under the [[UAB TAH license]].


===Installation Help===
===Installation Help===
If you get stuck or have problems with the ''self-service'' installation you may contact [[User:Tanthony@uab.edu | tanthony@uab.edu]], [[User:Laurenr@uab.edu | laurenr@uab.edu]],  [[User:Mbolding@uab.edu | mbolding@uab.edu]], or [mailto:support@mathworks.com support@mathworks.com]. Mathworks will want your license number: 678600.  If you do not hear back from Mark within one working day then call 4-2009. You must be faculty, staff, post-doc, or a grad student using Mathworks software for UAB research activities to activate this software.


=== MATLAB on Cheaha ===
MATLAB is a self-supported application at UAB.  A UAB MATLAB users peer  support forum is available. Subscription options are described below in [[MATLAB#MATLAB Support|MATLAB Support]].


MATLAB is pre-installed for user accounts on the [[Cheaha]] research computing system.  The Distributed Computing Server licenses on Cheaha can be utilized directly from your desktop, see [[MatLab DCS]] or from the Cheaha command-line shell environment, please see [[MatLab CLI]].
== MATLAB on Cheaha (compute cluster) ==


Accessing MATLAB on Cheaha from the desktop is recommended for most users: [[MatLab DCS]]. The command line environment is recommended for advanced users who are comfortable accessing systems via a secure shell (SSH) and have experience working with Linux command-line environments or who have a need to debug interactions between their desktop MATLAB and cluster servicesThe SSH environment can support X Windows sessions for displaying a full graphical MATLAB development environment on client desktops with an X Windows server installed, typically Linux and OSX systems.  For more information on using MATLAB in this environment please see [[MatLab CLI]].
MATLAB is pre-installed on the [[Cheaha]] research computing system. This allows users to run MATLAB directly on the cluster without any need to install softwareMATLAB jobs can also be submitted to Cheaha directly from your desktop, however, this requires additional configuration described in [[MatLab DCS]].


== Getting Started with MATLAB ==
=== Integration with Desktop MATLAB ===


[[Image:Getstart.png|right|frame| [http://138.26.125.107/usertools/ Getting Started]  ]]
Accessing the additional compute power of Cheaha from your desktop MATLAB install is recommended for most users because it combines the familiar MATLAB user experience with cluster computing power.  However, additional steps are required to configure a desktop MATLAB installation to access worker nodes on the Cheaha cluster via the Distributed Computing Server (DCS) platform.  Please see [[MatLab DCS]] for configuration information.
* [http://138.26.125.107/usertools/ Getting Started]  
 
=== Using Batch Submit from the Desktop Instead of ''matlabpool'' Jobs ===
 
It is not possible to use matlabpool jobs on the cluster from your desktop due to firewall restrictions.  Instead, desktop MATLAB users should use the batch submit options described in the [[MatLab DCS]] configuration to submit their jobs to the cluster. Matlabpool jobs are possible when running MATLAB directly on the cluster as described in  [[MatLab_CLI#Matlabpool.2FParFor_Parallel_Example| matlabpool from the head node]] .
 
=== Direct Use on the Cluster ===
 
Using MATLAB directly on the cluster is recommended only for people comfortable accessing systems via a command line environment (eg. secure shell SSH). SSH access to Cheaha supports X Windows and VNC sessions for displaying a full graphical MATLAB development environment on client desktops with an X Windows servers or VNC client applications installed.  For more information please see [[MatLab CLI]].  Matlabpool jobs are possible when running MATLAB directly in this environment as described in  [[MatLab_CLI#Matlabpool.2FParFor_Parallel_Example| matlabpool from the head node]] .
 
== Advanced Install Scenarios ==
 
This information is helpful for people interested in the many ways in which MATLAB can be installed.  A normal end-user installing MATLAB for themselves on a desktop of laptop computer should follow the [[#MATLAB on the Desktop]] instructions above.  The following information is of most interest to IT or computer lab administrators who maintain MATLAB installs for many people on many computers.
 
=== User Installation and Activation Scenarios ===
 
#'''[[Matlab Designated Computer Install | Installation and activation with Designated Computer License ]]''' - This option is recommended for mobile computing systems which may or may not be on the UAB network  when MATLAB is being used.  This install type authorizes an individual computer to run MATLAB, allowing MATLAB to run regardless of where the computer is located. (This is the only option available if you want to use your MATLAB on your computer when you are not physically present at UAB)
#'''[[Simplified MATLAB Install | Installation and Activation with Network License]]''' - This is the recommended install when MATLAB will be used on computers that remain connected to the campus network. This installation requires MatLab software to be installed on your computer and provides a simple 2-line file to activate the software.   This option is highly recommend for UAB desktops.
 
'''NOTE''': Most on-campus users are encouraged to use the '''[[Simplified MATLAB Install | Installation and Activation with Network License]]''' option for activation unless there are special circumstances that require the alternative activation scenarios.
 
=== Network Concurrent/Lab admin Installation and Activation Scenarios ===
# '''[[Matlab Network Concurrent User Install]]''' - This installation is only recommended for system administrators who already manage a lab or departmental installation of MATLAB and who would like to continue to provide this service for their user community. This install type may also be practical if there are special additional license needs that will apply to multiple computers running MATLAB.  Note, all MATLAB toolboxes actively used at UAB are currently covered under the [[UAB TAH license|UAB campus license]].
 
== On-line Tutorials and Learning Resources ==
 
* [http://www.mathworks.com/help/techdoc/learn_matlab/bqr_2pl.html Getting Started]  
* Recorded [http://www.mathworks.com/company/events/webinars/?s_cid=HP_E_RW Webinars], select a topic and complete the request form.
* Recorded [http://www.mathworks.com/company/events/webinars/?s_cid=HP_E_RW Webinars], select a topic and complete the request form.
* Interactive Tutorials for Students and Faculty
* Interactive Tutorials for Students and Faculty
Line 47: Line 86:
** [http://www.mathworks.com/matlabcentral Matlab Central]
** [http://www.mathworks.com/matlabcentral Matlab Central]
** [http://www.mathworks.com/academia/classroom-resources Classroom resources]
** [http://www.mathworks.com/academia/classroom-resources Classroom resources]
<br />
<br />
<br />


== Parallel Computing Extensions ==
{{MATLAB Support}}


MATLAB language extensions to support parallel processing are available via the Parallel Computing Toolbox. This is one of the [[2011 UAB MATLAB site license software|42 toolboxes]] available under the [[UAB TAH license]].  The Parallel Computing Toolbox enables MATLAB to make use of the multi-core processors found on many computers in order to speed the execution of code sections that can execute in parallel.  This toolbox supports the use of up to 8 cores on a single computer systems through the use of worker threads the spread the execution of code across multiple cores.
== UAB Mathworks Site License ==


Additional parallelism can be supported by adding more worker threads via a secondary software platform known as the [http://www.mathworks.com/products/distriben/ Distributed Computing Server (DCS)]. The DCS runs on a compute cluster and can provide many more worker threads to increase parallelism.  UAB IT Research Computing has licensed a 128 worker DCS installation for the Cheaha compute cluster.  The Parallel Computing Toolbox can be configured to access this license from desktop MATLAB installations.  Please see [[MatLab DCS]] for configuration details.
UAB has acquired a university wide site license for MATLAB and Simulink software. This license includes all Mathworks Inc. products in use at UAB, with the exception of the Distributed Computing Server (DCS) which must be licensed separately. This new site license also makes available several new toolboxes and blocksets not previously licensed by UAB.


== MATLAB Support ==
This site license is known as the Mathworks Inc. Total Academic Headcount (TAH) license or Mathworks TAH.  As of January 1, 2012, UAB has two TAH licenses.  First, the TAH campus with license number 678600 is the same TAH license which was in operations during 2011 and is for use by all UAB full-time faculty and staff. Second, the TAH student with license number 731720 is for use by UAB students, where graduate and professional students at UAB with funding or working on UAB research projects should use the TAH campus license.


UAB does not have a campus-wide user support service for MATLAB.  Users are requested to work with their normal IT support personnel for issues with installation and use.
Mathworks TAH license -- either campus or student -- will make it easier for everyone in the UAB community to use MATLAB, MATLAB Toolboxes (extensions) and Simulink software. Specifically, it authorizes use of MATLAB on university owned machines for all faculty, staff and studentsFaculty and staff are also entitled to install the software (TAH campus - 678600) on personally owned computers. Students are authorized to install TAH student (TAH student - 731730) are authorized to install this software on their personal computer.  It is important each authorized user of either TAH license to use the the authentication key corresponding to their authorized TAH license.  That is, authorized users of TAH campus (678600) should use the authentication key obtained from http://www.uab.edu/it/software/, after selecting Mathworks/Mathlab, corresponding to the Faculty/staff group.  Similarly, authorized users for TAH student (731730) should use the authentication key for the Students group.  For questions on which authentication key to use or with help on installing MATHLAB software on your computer, please contact askit@uab.edu or post a question the list serve matlab-user@vo.uabgrid.uab.edu.


In order to facilitate interaction among MATLAB users, share experience, and provide peer-support UAB IT Research Computing has established a MATLAB-users group.  To join this group and participate in email discussions please [http://vo.uabgrid.uab.edu/sympa/subscribe/matlab-user subscribe to the matlab-users group].  On-line archives of these discussions are available [https://vo.uabgrid.uab.edu/sympa/arc/matlab-user here].  Please note, the email discussions are a public forum. You are advised to only post information you are authorized to share and comfortable with being public.
The TAH allows unlimited use MATLAB, Simlink and the 48 MATLAB Toolboxes, block sets and complier in both research and teaching activities. Faculty, staff and students can install the software on computers located off-campus, however, students may only use Mathworks software on UAB owned computers computers located on-campus.


== UAB Mathworks Site License ==
UAB was the first university in Alabama to implement a Mathworks TAH license.


UAB has acquired a university wide site license for MATLAB and Simulink software. This license includes all Mathworks Inc. products in use at UAB, with the exception of the Distributed Computing Server (DCS) which must be licensed separately. This new site license also makes available several new toolboxes and blocksets not previously licensed by UAB.
== Parallel Computing Extensions ==


This site license is known as the Mathworks Inc. Total Academic Headcount (TAH) license or Mathworks TAHMathworks TAH will make it easier for everyone in the UAB community to use MATLAB, MATLAB Toolboxes (extensions) and Simulink software. Specifically, it authorizes use of MATLAB on university owned machines for all faculty, staff and students.  Faculty and staff are also entitled to install the software on personally owned computers.
MATLAB language extensions to support parallel processing are available via the Parallel Computing Toolbox. This is one of the [[2011 UAB MATLAB site license software|42 toolboxes]] available under the [[UAB TAH license]]The Parallel Computing Toolbox enables MATLAB to make use of the multi-core processors found on many computers in order to speed the execution of code sections that can execute in parallel. This toolbox supports the use of up to 8 cores on a single computer systems through the use of worker threads the spread the execution of code across multiple cores.


The TAH allows unlimited use MATLAB, Simlink and the 42 MATLAB Toolboxes in both research and teaching activities. Faculty and staff can install the software on computers located off-campus, however, students may only use Mathworks software on UAB owned computers computers located on-campus.
Additional parallelism can be supported by adding more worker threads via a secondary software platform known as the [http://www.mathworks.com/products/distriben/ Distributed Computing Server (DCS)]. The DCS runs on a compute cluster and can provide many more worker threads to increase parallelism.   UAB IT Research Computing has licensed a 128 worker DCS installation for the Cheaha compute cluster.  The Parallel Computing Toolbox can be configured to access this license from desktop MATLAB installations.  Please see [[MatLab DCS]] for configuration details.
 
UAB was the first university in Alabama to implement a Mathworks TAH license.


[[Category:MATLAB]]
[[Category:MATLAB]][[Category:MATLAB installation]][[Category:Software]][[Category:Math]]

Latest revision as of 18:00, 17 January 2018

Information.png

HPC Web Portal now in Beta

The new HPC web portal is now available. We encourage you to try it out as an alternative to traditional clients. It provides file, shell, and desktop access to the cluster within your web browser.


Mac OSX USERS click here to view any outstanding issues with installing MATLAB on OSX


MATLAB (matrix laboratory) is a numerical computing environment and fourth-generation 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++, and Fortran. An additional package, Simulink, adds graphical multi-domain simulation and Model-Based Design for dynamic and embedded systems.

MATLAB can be used on personal computers and powerful server systems, including the Cheaha compute cluster. With the addition of the Parallel Computing Toolbox, the language can be extended with parallel implementations for common computational functions, including for-loop unrolling. Additionally this toolbox supports offloading computationally intensive workloads to Cheaha the campus compute cluster.

In January 2011, UAB acquired a site license for MATLAB that allows faculty, staff, post-docs, and graduate students to use MATLAB, Simulink, and 42 toolboxes (including the parallel toolbox) for research activities on campus and personal systems. Additionally, from January 2012 MATLAB is available to students on campus and personal computer systems.

MATLAB Versions

Mathworks has two annual releases of Matlab: the "a" release in the spring and the "b" release in the fall. Each release gets tagged with the current year and "a" or "b". For example, "Matlab 2013a" is the spring release for 2013.

If you are using Matlab in an isolated environment like on your laptop or desktop, you can generally install the most recent release available from Mathworks.

If you plan to uses specific features of Matlab, however, like running computations on the Cheaha cluster or using a network install. You should install our recommended release of Matlab that we know works with our services.

The current recommended release is Matlab 2013a.

In UAB IT Research Computing, we update our services to work with the latest Matlab release a month or so after the general release of that product. This gives us time to try out the latest release, get feedback from other early adopters, and update services like the Distributed Computing Toolbox, license server and our documentation.

Note: you can always install whichever Matlab release you need and that is still available from Mathworks. Different versions of Matlab are always installed side-by side. Depending on your science domain, you may need to select certain releases in order to access specific features. However, not all of these releases may be supported by our compute cluster or network license manager.

MATLAB on the Desktop

Using Mathworks software available under the UAB campus license on your computer involves download and install steps common to all software packages and an authorization step that grants you the rights to use the software under the campus agreement.

Download and Installation Steps

NOTE:These steps are common to all installation and activation scenarios and are detailed in Downloading and Installing MATLAB.

  1. Create an account at the Mathworks site using your campus @uab.edu email address. Please do not share your mathworks account username or password with anyone as this account will be associated with the UAB TAH license. An end user must choose one of these values when creating a MathWorks Account. Students should choose Student use. Faculty, researchers, and grad students should choose Teaching or research in school.
  2. Request an activation key from the UAB software library page for faculty/staff and from UAB on the Hub for students. Please make sure to request the appropriate key (Faculty/staff or student) as the software are on different licenses.
  3. Associate your Mathworks account with the campus-wide MATLAB license using your activation key.
  4. Download the software from the mathworks download site and install MATLAB
  5. Activate the software using the activation scenario that best suits your particular needs.

Updating MATLAB on Desktop

If you have been running MATLAB on your desktop during 2011, one can click 'Help', then 'Licensing', and finally 'Update Current Licenses'. This will remedy the license expiration message without having to update to a new copy of MATLAB.

Installation Help

MATLAB is a self-supported application at UAB. A UAB MATLAB users peer support forum is available. Subscription options are described below in MATLAB Support.

MATLAB on Cheaha (compute cluster)

MATLAB is pre-installed on the Cheaha research computing system. This allows users to run MATLAB directly on the cluster without any need to install software. MATLAB jobs can also be submitted to Cheaha directly from your desktop, however, this requires additional configuration described in MatLab DCS.

Integration with Desktop MATLAB

Accessing the additional compute power of Cheaha from your desktop MATLAB install is recommended for most users because it combines the familiar MATLAB user experience with cluster computing power. However, additional steps are required to configure a desktop MATLAB installation to access worker nodes on the Cheaha cluster via the Distributed Computing Server (DCS) platform. Please see MatLab DCS for configuration information.

Using Batch Submit from the Desktop Instead of matlabpool Jobs

It is not possible to use matlabpool jobs on the cluster from your desktop due to firewall restrictions. Instead, desktop MATLAB users should use the batch submit options described in the MatLab DCS configuration to submit their jobs to the cluster. Matlabpool jobs are possible when running MATLAB directly on the cluster as described in matlabpool from the head node .

Direct Use on the Cluster

Using MATLAB directly on the cluster is recommended only for people comfortable accessing systems via a command line environment (eg. secure shell SSH). SSH access to Cheaha supports X Windows and VNC sessions for displaying a full graphical MATLAB development environment on client desktops with an X Windows servers or VNC client applications installed. For more information please see MatLab CLI. Matlabpool jobs are possible when running MATLAB directly in this environment as described in matlabpool from the head node .

Advanced Install Scenarios

This information is helpful for people interested in the many ways in which MATLAB can be installed. A normal end-user installing MATLAB for themselves on a desktop of laptop computer should follow the #MATLAB on the Desktop instructions above. The following information is of most interest to IT or computer lab administrators who maintain MATLAB installs for many people on many computers.

User Installation and Activation Scenarios

  1. Installation and activation with Designated Computer License - This option is recommended for mobile computing systems which may or may not be on the UAB network when MATLAB is being used. This install type authorizes an individual computer to run MATLAB, allowing MATLAB to run regardless of where the computer is located. (This is the only option available if you want to use your MATLAB on your computer when you are not physically present at UAB)
  2. Installation and Activation with Network License - This is the recommended install when MATLAB will be used on computers that remain connected to the campus network. This installation requires MatLab software to be installed on your computer and provides a simple 2-line file to activate the software. This option is highly recommend for UAB desktops.

NOTE: Most on-campus users are encouraged to use the Installation and Activation with Network License option for activation unless there are special circumstances that require the alternative activation scenarios.

Network Concurrent/Lab admin Installation and Activation Scenarios

  1. Matlab Network Concurrent User Install - This installation is only recommended for system administrators who already manage a lab or departmental installation of MATLAB and who would like to continue to provide this service for their user community. This install type may also be practical if there are special additional license needs that will apply to multiple computers running MATLAB. Note, all MATLAB toolboxes actively used at UAB are currently covered under the UAB campus license.

On-line Tutorials and Learning Resources

MATLAB Support / Mailing List

As with any application or computer language, learning to use MATLAB to analyze data or to develop or modify MATLAB applications is an individual responsibility. There is ample application documentation available from the Mathworks website, potential outreach to colleagues who also use MATLAB, and options for consultation with Mathworks. Mathworks also host on-campus training seminars several times a year and provides many on-line learning tutorials.

Installation support for MATLAB at UAB is provided by your local IT support organization and the Docs wiki.

Mathworks Website

Your first and best option for application-specific questions on MATLAB is to refer to the on-line MATLAB documentation. The Mathworks site also provides a a support matrix and an on-line knowledge base.

UAB MATLAB Wiki

The MATLAB page on the Docs wiki is the starting point for installing MATLAB at UAB and, optionally, configuring it to use cluster computing. All users are encouraged to contribute to the MATLAB knowledge in this wiki, especially if you see areas where improvements are needed. Remember, this knowledge base is only as good as the people who contribute to it.

Contributing to the wiki is as easy as clicking the login link on the top-right of the page and signing in with your UAB BlazerID. If you are unsure about making an edit, you can make suggestions for improvement on the page's Discussion tab or discuss the proposed improvement in the MATLAB user group.

UAB MATLAB User Group

At UAB, MATLAB installation support is provided by your local IT support group. Support for application specific questions is available from peers in your research group. We realize that some people are not as familiar with MATLAB as others. For this reason, we have established a MATLAB user forum (mailing list) where users of MATLAB at UAB can help answer each others questions.

This is a network of volunteers sharing their knowledge with peers. You are encouraged to reach out to this community for questions on using MATLAB by

Archives of MATLAB user group discussions are available on-line at https://vo.uabgrid.uab.edu/sympa/arc/matlab-user. You may find your question is already answered in these archives.


UAB MATLAB announce mailing list

To receive information about UAB's MATLAB license and announcements please subscribe to the matlab-annc mailing list by

UAB Mathworks Site License

UAB has acquired a university wide site license for MATLAB and Simulink software. This license includes all Mathworks Inc. products in use at UAB, with the exception of the Distributed Computing Server (DCS) which must be licensed separately. This new site license also makes available several new toolboxes and blocksets not previously licensed by UAB.

This site license is known as the Mathworks Inc. Total Academic Headcount (TAH) license or Mathworks TAH. As of January 1, 2012, UAB has two TAH licenses. First, the TAH campus with license number 678600 is the same TAH license which was in operations during 2011 and is for use by all UAB full-time faculty and staff. Second, the TAH student with license number 731720 is for use by UAB students, where graduate and professional students at UAB with funding or working on UAB research projects should use the TAH campus license.

Mathworks TAH license -- either campus or student -- will make it easier for everyone in the UAB community to use MATLAB, MATLAB Toolboxes (extensions) and Simulink software. Specifically, it authorizes use of MATLAB on university owned machines for all faculty, staff and students. Faculty and staff are also entitled to install the software (TAH campus - 678600) on personally owned computers. Students are authorized to install TAH student (TAH student - 731730) are authorized to install this software on their personal computer. It is important each authorized user of either TAH license to use the the authentication key corresponding to their authorized TAH license. That is, authorized users of TAH campus (678600) should use the authentication key obtained from http://www.uab.edu/it/software/, after selecting Mathworks/Mathlab, corresponding to the Faculty/staff group. Similarly, authorized users for TAH student (731730) should use the authentication key for the Students group. For questions on which authentication key to use or with help on installing MATHLAB software on your computer, please contact askit@uab.edu or post a question the list serve matlab-user@vo.uabgrid.uab.edu.

The TAH allows unlimited use MATLAB, Simlink and the 48 MATLAB Toolboxes, block sets and complier in both research and teaching activities. Faculty, staff and students can install the software on computers located off-campus, however, students may only use Mathworks software on UAB owned computers computers located on-campus.

UAB was the first university in Alabama to implement a Mathworks TAH license.

Parallel Computing Extensions

MATLAB language extensions to support parallel processing are available via the Parallel Computing Toolbox. This is one of the 42 toolboxes available under the UAB TAH license. The Parallel Computing Toolbox enables MATLAB to make use of the multi-core processors found on many computers in order to speed the execution of code sections that can execute in parallel. This toolbox supports the use of up to 8 cores on a single computer systems through the use of worker threads the spread the execution of code across multiple cores.

Additional parallelism can be supported by adding more worker threads via a secondary software platform known as the Distributed Computing Server (DCS). The DCS runs on a compute cluster and can provide many more worker threads to increase parallelism. UAB IT Research Computing has licensed a 128 worker DCS installation for the Cheaha compute cluster. The Parallel Computing Toolbox can be configured to access this license from desktop MATLAB installations. Please see MatLab DCS for configuration details.