PBLAS Routines Overview

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 11/07/2023

Version

Public

A newer version of this document is available. Customers should click here to go to the newest version.

Visible to Intel only — GUID: GUID-43D26042-64B2-412A-A509-D52E366EFC79

View Details

PBLAS Routines Overview

The model of the computing environment for PBLAS is represented as a one-dimensional array of processes or also a two-dimensional process grid. To use PBLAS, all global matrices or vectors must be distributed on this array or grid prior to calling the PBLAS routines.

PBLAS uses the two-dimensional block-cyclic data distribution as a layout for dense matrix computations. This distribution provides good work balance between available processors, as well as gives the opportunity to use PBLAS Level 3 routines for optimal local computations. Information about the data distribution that is required to establish the mapping between each global array and its corresponding process and memory location is contained in the so called array descriptor associated with each global array. Table "Content of the array descriptor for dense matrices" gives an example of an array descriptor structure.

Content of Array Descriptor for Dense Matrices
Array Element #	Name	Definition
1	`dtype`	Descriptor type ( =1 for dense matrices)
2	`ctxt`	BLACS context handle for the process grid
3	`m`	Number of rows in the global array
4	`n`	Number of columns in the global array
5	`mb`	Row blocking factor
6	`nb`	Column blocking factor
7	`rsrc`	Process row over which the first row of the global array is distributed
8	`csrc`	Process column over which the first column of the global array is distributed
9	`lld`	Leading dimension of the local array

The number of rows and columns of a global dense matrix that a particular process in a grid receives after data distributing is denoted by LOCr() and LOCc(), respectively. To compute these numbers, you can use the ScaLAPACK tool routine numroc.

After the block-cyclic distribution of global data is done, you may choose to perform an operation on a submatrix of the global matrix A, which is contained in the global subarray sub(A), defined by the following 6 values (for dense matrices):

m: The number of rows of sub(A)
n: The number of columns of sub(A)
a: A pointer to the local array containing the entire global array A
ia: The row index of sub(A) in the global array
ja: The column index of sub(A) in the global array
desca: The array descriptor for the global array A

Intel® oneAPI Math Kernel Library (oneMKL) provides the PBLAS routines with interface similar to the interface used in the Netlib PBLAS (see http://www.netlib.org/scalapack/html/pblas_qref.html).

Parent topic: PBLAS Routines

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Developer Reference for Intel® oneAPI Math Kernel Library for C

PBLAS Routines Overview