UMBC logo
UMBC High Performance Computing Facility
Please note that this page is under construction. We are documenting the 240-node cluster maya that will be available after Summer 2014. Currently, the 84-node cluster tara still operates independently, until it becomes part of maya at the end of Summer 2014. Please see the 2013 Resources Pages under the Resources tab for tara information.
How to use MKL on maya

Introduction

MKL (Math Kernel Library) is a library of math procedures from Intel, which includes BLAS, LAPACK, and ScaLAPACK. On this page, we will show how to start using MKL with the Intel compiler on maya. Before you begin, make sure to read the tutorial for compiling C programs. Extensive documentation about programming with MKL can be found at Intel's reference manual.
Before compile and run your code on maya, make sure to load the following module
[hu6@maya-usr1 ~]$ module load intel/mkl/64/11.1/2013_sp1.3.174 

BLAS Example: Matrix Multiply

Consider three matrices \(A \in \mathbb{R}^{m \times k} \), \(B \in \mathbb{R}^{k \times n} \), and \(C \in \mathbb{R}^{m \times n} \), where all are represented as double precision floating point numbers. We will demonstrate the use of the "dgemm" function which computes \[ C = \alpha AB + \beta C. \] We will take \(\alpha = 1\) and \(\beta = 0\) to compute the simple matrix multiplication \( C = AB \). MKL has several versions of this function; we will use "cblas_dgemm", which has bit friendlier "C-style" interface than other variants. The most important line in the code is
cblas_dgemm(CblasColMajor, CblasNoTrans, CblasNoTrans,
   m, n, k, 1.0, A, m, B, k, 0.0, C, m);
Also notice in the Makefile that the option "-mkl" is given in CFLAGS, which enables the use of MKL. Next we compile and run the code.
[araim1@maya-usr1 matrix-multply]$ make clean
rm -f *.o matrix-multiply
[araim1@maya-usr1 matrix-multply]$ make
icc -O3 -std=c99 -mkl   -c matrix-multiply.c -o matrix-multiply.o
icc -O3 -std=c99 -mkl   matrix-multiply.o -o matrix-multiply  
[araim1@maya-usr1 matrix-multply]$ ./matrix-multiply 
Matrix A (3 x 5) is:
  1.0000  0.7290  0.5314  0.3874  0.2824
  0.9000  0.6561  0.4783  0.3487  0.2542
  0.8100  0.5905  0.4305  0.3138  0.2288

Matrix B (5 x 4) is:
  1.0000  0.5905  0.3487  0.2059
  0.9000  0.5314  0.3138  0.1853
  0.8100  0.4783  0.2824  0.1668
  0.7290  0.4305  0.2542  0.1501
  0.6561  0.3874  0.2288  0.1351

Matrix C (3 x 4) = AB is:
  2.5543  1.5083  0.8906  0.5259
  2.2989  1.3575  0.8016  0.4733
  2.0690  1.2217  0.7214  0.4260
[araim1@maya-usr1 matrix-multply]$
For more information about matrix multiplication with MKL, see this tutorial from Intel.

LAPACK Example: SVD

Given a matrix \(A \in \mathbb{R}^{m \times n} \), we will demonstrate the LAPACK "dgesvd" function for computing the singular value decomposition (SVD) \[ A = U S V^T, \] where \(S \in \mathbb{R}^{m \times n}\) is a diagonal matrix of singular values, \(U \in \mathbb{R}^{m \times m}\), and \(V^T \in \mathbb{R}^{n \times n}\). The MKL function call we will use is "LAPACKE_dgesvd". The most important line in the code, where the SVD is being computed, is
int info = LAPACKE_dgesvd(CblasColMajor, 'A', 'A', m, n, A, m, S, U, m,
   VT, n, superb);
Next we compile and run the code.
[araim1@maya-usr1 svd]$ make
icc -O3 -std=c99 -mkl   -c -o matrix-svd.o matrix-svd.c
icc -O3 -std=c99 -mkl   matrix-svd.o -o matrix-svd  
[araim1@maya-usr1 svd]$ ./matrix-svd 
Matrix A (3 x 4) is:
  1.0000  0.5000  0.3333  0.2500
  0.5000  0.3333  0.2500  0.2000
  0.3333  0.2500  0.2000  0.1667

Matrix U (3 x 3) is:
 -0.8199  0.5563  0.1349
 -0.4662 -0.5123 -0.7213
 -0.3322 -0.6543  0.6794

Vector S (3 x 1) is:
  1.4519
  0.1433
  0.0042

Matrix VT (4 x 4) is:
 -0.8015 -0.4466 -0.3143 -0.2435
  0.5729 -0.3919 -0.5127 -0.5053
  0.1692 -0.7398  0.1245  0.6392
 -0.0263  0.3157 -0.7892  0.5261
[araim1@maya-usr1 svd]$