Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 11/07/2023
Public

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

Document Table of Contents

mkl_set_num_stripes

Specifies the number of partitions along the leading dimension of the output matrix for parallel ?GEMM functions.

Syntax

call mkl_set_num_stripes( ns )

Fortran Include Files/Modules

  • Include file: mkl.fi
  • Module (compiled): mkl_service.mod
  • Module (source): mkl_service.f90

Input Parameters

Name

Type

Description

ns

INTEGER*4

ns > 0 - Specifies the number of partitions to use.

ns= 0 - Instructs Intel® oneAPI Math Kernel Library (oneMKL) to use the default partitioning algorithm.

ns < 0 - Invalid value; ignored.

Description

This function enables you to specify the number of stripes, or partitions along the leading dimension of the output matrix, for parallel ?GEMMfunctions. If this number is not set (default) or if it is set to zero, Intel® oneAPI Math Kernel Library (oneMKL)?GEMM functions use the default partitioning algorithm. The specified number of partitions only applies to ?GEMM functions.

The number specified is a hint, and Intel® oneAPI Math Kernel Library (oneMKL) may actually use a smaller number.

NOTE:

This function takes precedence over the MKL_NUM_STRIPES environment variable.

Example

use mkl_service
…
call mkl_set_num_stripes(4)
call dgemm(...)   !Intel MKL uses up to 4 stripes for DGEMM