Matlab

From CVL Wiki

(Difference between revisions)
Jump to: navigation, search
(How to use Matlab on CVL)
 
(71 intermediate revisions by 6 users not shown)
Line 1: Line 1:
[[Image:Matlab.jpg]]
 
  
== Creating an Account for Matlab ==
 
[[Image:Create_account_0.jpg|thumb|(fg.1) Click on this image for the visual location of the create account option on the Mathworks homepage.]]
 
[[Image:Create_account_2.jpg|thumb|(fg.2) Click on this image for more information for creating an account]]
 
  
 +
[[Image:Matlab.jpg|right]]
 +
=How to use Matlab on CVL=
 +
'''[[Using the CVL|Log in]]''' to the CVL Workstations.
 +
<br><br>Type the following command
 +
  matlab
  
Go to [http://www.mathworks.com/ Mathworks home page] (fg.1) and click on create account.
+
=General Information about Matlab=
 +
MatLab is a program developed by MathWorks Incorporated. This program provides a high-level language and interactive environment that enables
 +
you to perform computationally intensive tasks faster than with traditional programming languages such as C, C++, and Fortran.
  
Once you have reached the create account page fill out the E-mail and Password information using your PID (ex.johnsmith@vt.edu) and password. Also fill out the box entitled County/Software Usage Information and select USA for Country/Region and Academic Use on a University Computer for software use. Finally fill out all of the contact information and submit (fg.2)
+
'''The "Toolboxes" that the Virginia Tech license offers are:'''
[[Image:Create_account_1.jpg]]
+
*Simulink
 +
*Aerospace Blockset
 +
*Aerospace Toolbox
 +
*Bioinformatics Toolbox
 +
*Communications System Toolbox
 +
*Computer Vision System Toolbox
 +
*Control System Toolbox
 +
*Curve Fitting Toolbox
 +
*DSP System Toolbox
 +
*Data Acquisition Toolbox
 +
*Database Toolbox
 +
*Embedded Coder
 +
*Fixed-Point Toolbox
 +
*Fuzzy Logic Toolbox
 +
*Global Optimization Toolbox
 +
*HDL Coder
 +
*Image Acquisition Toolbox
 +
*Image Processing Toolbox
 +
*Instrument Control Toolbox
 +
*LMI Control Toolbox (Transitioned) 
 +
*MATLAB Builder NE
 +
*MATLAB Coder
 +
*MATLAB Compiler
 +
*MATLAB® C/C++ Math Library (Transitioned) 
 +
*Mapping Toolbox
 +
*Mu-Analysis and Synthesis Toolbox (Transitioned) 
 +
*Neural Network Toolbox
 +
*Optimization Toolbox
 +
*Parallel Computing Toolbox
 +
*Partial Differential Equation Toolbox
 +
*Robust Control Toolbox
 +
*Signal Processing Toolbox
 +
*SimBiology
 +
*SimElectronics
 +
*SimEvents
 +
*SimMechanics
 +
*SimPowerSystems
 +
*Simscape
 +
*Simulink 3D Animation
 +
*Simulink Coder
 +
*Simulink Control Design
 +
*Simulink Fixed Point
 +
*Spline Toolbox (Transitioned) 
 +
*Spreadsheet Link EX
 +
*Stateflow
 +
*Stateflow Coder (Transitioned) 
 +
*Statistics Toolbox
 +
*Symbolic Math Toolbox
 +
*System Identification Toolbox
 +
*Wavelet Toolbox
 +
*xPC Target
  
  
 +
'''Toolboxes that have been integrated with other Toolboxes:'''
  
 +
<br>The Robust Control Toolbox has merged with the following toolboxes
 +
* Mu-Analysis and Synthesis
 +
* LMI Control
  
 +
=Installing Matlab=
  
 +
Email support@ece.vt.edu for installation directions.
  
 +
==Installing Matlab on Linux/UNIX==
  
 +
*This Section is under construction.
  
 +
==Installing Matlab on MAC OSX==
  
==Associating Your Account With a License==
+
==Using the MPI parallel toolbox==
[[Image:License_Association_0.jpg|thumb|(fg.3) An account main page]]
+
The CVL lab has installed a toolbox that simplifies parallelizing matlab code. This is the location of the [http://einar.heiberg.se/mpi/index.html Matlab Parallelization Toolkit]. It utilizes a Master/Slave arrangement to automatically login to multiple machines and have them individually run parts of a matlab scriptThe majority of the setup and configuration has been done on all of the CVL machines, but it is not in your matlab path by default.
[[Image:License_Association_2.jpg|thumb|(fg.5) How to get your license number]]
+
'''Disclaimer: The information for associating an account with a license is for Virgina Tech faculty only. Students should use their version of Matlab or use the CVL in order to use Matlab.'''
+
<br>After you have created your account, if you are faculty, you can associate it with a License. To do this make sure you are logged in at the Mathworks website. Once you are logged in go to your account's main page. (fg.3) On the left hand menu there is an option to "Associate with a License" click on that linkYou will now get the option of entering in a License Number (fg.4). The License number can be found by looking up the version on an already installed copy of Matlab. (fg.5)
+
  
 +
*In order to access the MPI toolbox, you must manually add the directory '/software/MPI' to your path, either with the matlab path GUI, or with the command
 +
addpath /software/MPI
 +
*Once this is done, more information on how to operate the toolkit can be obtained by typing
 +
help MPI from the matlab command window.
  
[[Image:License_Association_1.jpg]]
+
*The [http://computing.ece.vt.edu/MPI/example2.m following] is an example of how to implement the toolbox in matlab code
<br><sub>fg.4 License Association Page</sub>
+
  
 +
%This part defines how many nodes to try to use
 +
%connects to available machines, and fires a Matlab slave node
 +
addpath /software/MPI
 +
%addpath /software/MPI_VAL32
 +
 +
%Read the config file set up for the cluster
 +
mconfig = pconfig;
 +
%Use all the machines available
 +
Nparallel = length(mconfig);
 +
%Run this many MATLAB processes per machine.  This should be set to 1 to
 +
%make resources available for others.
 +
Nperhost = 1;
 +
 +
%Fire up matlab on the slaves.  It may be worth using the load-checking
 +
%version of psetup('available', Nparallel*Nperhost);
 +
for j=1:Nparallel
 +
    psetup(mconfig{j}{1}, Nperhost);
 +
end
 +
 +
 +
%A example of a data set to chew on
 +
a = rand(64, 64, 32);
 +
res = zeros(size(a));
 +
 +
%Run a parallel profiler on the code to be run to see how much speedup there was (optional)
 +
pprofile on -detail builtin
 +
 +
%The main parallel loop.
 +
%It executes the function 'exampleloop.m'
 +
pfor(1:size(a, 3), 'res(:, :, %d) = exampleloop(a(:, :, %d));');
 +
 +
%Finish the parallel profile stats collection
 +
s = pprofile('report');
 +
 +
 +
%Once the main computation is done, shut-down all the slave Matlab nodes
 +
MPI_Finalize;
  
 +
[http://computing.ece.vt.edu/MPI/exampleloop.m Here's] a functional example of an 'exampleloop.m' matlab function
 +
function out = exampleloop(in)
 +
 +
tempout = in
 +
N=10000;
 +
for i=1:N
 +
    tempout = inv(tempout) + rand(size(tempout));
 +
end
 +
out = tempout
  
  
 +
One important point to note is that a portion of the MPI toolbox library must be compiled for the platform it's being run on.  This has already been done for most of the CVL machines being run as 64-bit Linux.  If the toolbox is to be used on a 32-bit Linux installation, a the [http://computing.ece.vt.edu/MPI/MPI121_CVL.tar.gz MPI library] will have to be installed into your home directory (or somehwere else you have write permission).  It will also have to be added to your matlab path, and
 +
makeMPI
 +
must be issued from the matlab command prompt.  The matlab installation must include mex, mcc, gcc, and g++ compiler properly installed.
  
  
 +
==Help==
  
 +
For any additional questions, comments, or concerns contact your system administrator or post a ticket on [https://helpdesk.ece.vt.edu/helpdesk/index.php Help Desk].
  
==Installing Matlab on Windows (2000/XP/Vista)==
+
=Additional Links=
===Downloading and Installing===
+
==Installing Matlab on Linux/UNIX==
+
 
+
==Additional Links==
+
  
 
[http://www.mathworks.com/ Mathworks home page]
 
[http://www.mathworks.com/ Mathworks home page]

Latest revision as of 10:42, 3 December 2015


Matlab.jpg

Contents

[edit] How to use Matlab on CVL

Log in to the CVL Workstations.

Type the following command

  matlab

[edit] General Information about Matlab

MatLab is a program developed by MathWorks Incorporated. This program provides a high-level language and interactive environment that enables you to perform computationally intensive tasks faster than with traditional programming languages such as C, C++, and Fortran.

The "Toolboxes" that the Virginia Tech license offers are:

  • Simulink
  • Aerospace Blockset
  • Aerospace Toolbox
  • Bioinformatics Toolbox
  • Communications System Toolbox
  • Computer Vision System Toolbox
  • Control System Toolbox
  • Curve Fitting Toolbox
  • DSP System Toolbox
  • Data Acquisition Toolbox
  • Database Toolbox
  • Embedded Coder
  • Fixed-Point Toolbox
  • Fuzzy Logic Toolbox
  • Global Optimization Toolbox
  • HDL Coder
  • Image Acquisition Toolbox
  • Image Processing Toolbox
  • Instrument Control Toolbox
  • LMI Control Toolbox (Transitioned) 
  • MATLAB Builder NE
  • MATLAB Coder
  • MATLAB Compiler
  • MATLAB® C/C++ Math Library (Transitioned) 
  • Mapping Toolbox
  • Mu-Analysis and Synthesis Toolbox (Transitioned) 
  • Neural Network Toolbox
  • Optimization Toolbox
  • Parallel Computing Toolbox
  • Partial Differential Equation Toolbox
  • Robust Control Toolbox
  • Signal Processing Toolbox
  • SimBiology
  • SimElectronics
  • SimEvents
  • SimMechanics
  • SimPowerSystems
  • Simscape
  • Simulink 3D Animation
  • Simulink Coder
  • Simulink Control Design
  • Simulink Fixed Point
  • Spline Toolbox (Transitioned) 
  • Spreadsheet Link EX
  • Stateflow
  • Stateflow Coder (Transitioned) 
  • Statistics Toolbox
  • Symbolic Math Toolbox
  • System Identification Toolbox
  • Wavelet Toolbox
  • xPC Target


Toolboxes that have been integrated with other Toolboxes:


The Robust Control Toolbox has merged with the following toolboxes

  • Mu-Analysis and Synthesis
  • LMI Control

[edit] Installing Matlab

Email support@ece.vt.edu for installation directions.

[edit] Installing Matlab on Linux/UNIX

  • This Section is under construction.

[edit] Installing Matlab on MAC OSX

[edit] Using the MPI parallel toolbox

The CVL lab has installed a toolbox that simplifies parallelizing matlab code. This is the location of the Matlab Parallelization Toolkit. It utilizes a Master/Slave arrangement to automatically login to multiple machines and have them individually run parts of a matlab script. The majority of the setup and configuration has been done on all of the CVL machines, but it is not in your matlab path by default.

  • In order to access the MPI toolbox, you must manually add the directory '/software/MPI' to your path, either with the matlab path GUI, or with the command
addpath /software/MPI
  • Once this is done, more information on how to operate the toolkit can be obtained by typing
help MPI from the matlab command window.
  • The following is an example of how to implement the toolbox in matlab code
%This part defines how many nodes to try to use
%connects to available machines, and fires a Matlab slave node
addpath /software/MPI
%addpath /software/MPI_VAL32

%Read the config file set up for the cluster
mconfig = pconfig;
%Use all the machines available
Nparallel = length(mconfig);
%Run this many MATLAB processes per machine.  This should be set to 1 to
%make resources available for others.
Nperhost = 1;

%Fire up matlab on the slaves.  It may be worth using the load-checking
%version of psetup('available', Nparallel*Nperhost);
for j=1:Nparallel
    psetup(mconfig{j}{1}, Nperhost);
end


%A example of a data set to chew on
a = rand(64, 64, 32);
res = zeros(size(a));

%Run a parallel profiler on the code to be run to see how much speedup there was (optional)
pprofile on -detail builtin

%The main parallel loop.
%It executes the function 'exampleloop.m'
pfor(1:size(a, 3), 'res(:, :, %d) = exampleloop(a(:, :, %d));');

%Finish the parallel profile stats collection
s = pprofile('report');


%Once the main computation is done, shut-down all the slave Matlab nodes
MPI_Finalize;

Here's a functional example of an 'exampleloop.m' matlab function

function out = exampleloop(in)

tempout = in
N=10000;
for i=1:N
    tempout = inv(tempout) + rand(size(tempout));
end
out = tempout


One important point to note is that a portion of the MPI toolbox library must be compiled for the platform it's being run on. This has already been done for most of the CVL machines being run as 64-bit Linux. If the toolbox is to be used on a 32-bit Linux installation, a the MPI library will have to be installed into your home directory (or somehwere else you have write permission). It will also have to be added to your matlab path, and

makeMPI

must be issued from the matlab command prompt. The matlab installation must include mex, mcc, gcc, and g++ compiler properly installed.


[edit] Help

For any additional questions, comments, or concerns contact your system administrator or post a ticket on Help Desk.

[edit] Additional Links

Mathworks home page
Matlab Tutorials
Additional information about Matlab
Octave A Free alternative to Matlab

Views
Personal tools
Support