unmtr_scratchpad

oneMKL - Data Parallel C++ Developer Reference

Download PDF

ID 772045

Date 6/24/2024

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-AB7C945E-2988-4AC7-921D-62FD38F2A4C6

View Details

unmtr_scratchpad_size

Computes size of scratchpad memory required for unmtr (USM Version) function. This routine belongs to the oneapi::mkl::lapack namespace.

Description
API

Description

Computes the number of elements of type T the scratchpad memory to be passed to the unmtr (buffer or USM version) function must be able to hold.

API

Syntax

namespace oneapi::mkl::lapack {
  template<typename T>
  std::int64_t unmtr_scratchpad_size(sycl::queue &queue,
  mkl::side side,
  mkl::uplo uplo,
  mkl::transpose trans,
  std::int64_t n,
  std::int64_t lda,
  std::int64_t ldc)
}

Input Parameters

In the descriptions below, r denotes the order of Q:

`r = m`	if `side = side::left`
`r = n`	if `side = side::right`

queue

Device queue where calculations by the unmtr (buffer or USM version) function will be performed.

side

Must be either side::left or side::right.

If side = side::left, Q or Q^T is applied to C from the left.

If side = side::right, Q or Q^T is applied to C from the right.

uplo

Must be either uplo::upper or uplo::lower. Uses the same uplo as supplied to hetrd (USM Version).

trans

Must be either transpose::nontrans or transpose::trans.

If trans = transpose::nontrans, the routine multiplies C by Q.

If trans = transpose::trans, the routine multiplies C by Q^T.

m

The number of rows in the matrix C(m ≥ 0).

n

The number of columns in the matrix C(n ≥ 0).

lda

The leading dimension of a(lda ≥ max(1, r)).

ldc

The leading dimension of c(ldc ≥ max(1, m)).

Exceptions

Exception	Description
`mkl::lapack::exception`	This exception is thrown when an incorrect argument value is supplied. You can determine the position of the incorrect argument by the info() method of the exception object.

Return Values

The number of elements of type T the scratchpad memory to be passed to the unmtr (buffer or USM version) function must be able to hold.

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

oneMKL - Data Parallel C++ Developer Reference

unmtr_scratchpad_size

Description

API