potrs_batch_scratchpad_size (Group Version)

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

Description

Computes the number of elements of type T the scratchpad memory to be passed to the potrs_batch (Group Version) function must be able to hold.

API

Syntax

namespace oneapi::mkl::lapack {
   std::int64_t  potrs_batch_scratchpad_size(
      sycl::queue &queue,
      mkl::uplo *uplo,
      std::int64_t *n,
      std::int64_t *nrhs,
      std::int64_t *lda,
      std::int64_t *ldb,
      std::int64_t group_count,
      std::int64_t  *group_sizes)
}

This function supports the following precisions and devices:

T

Devices supported

float

CPU and GPU

double

CPU and GPU

std::complex<float>

CPU and GPU

std::complex<double>

CPU and GPU

Input Parameters

queue

Device queue where calculations will be performed.

uplo

Array of group_count parameters uplog.

Each of uplog indicates whether the upper or lower triangular parts of the input matrices are provided.

If uplog=mkl::uplo::upper, input matrices from array a belonging to group g store the upper triangular parts.

If uplog=mkl::uplo::lower, input matrices from array a belonging to group g store the lower triangular parts.

n

Array of group_count parameters ng.

Each ng specifies the order of the input matrices belonging to group g.

nrhs

Array of nrhsg parameters.

Each nrhsg specifies the number of right-hand sides supplied for to group g.

lda

Array of group_count parameters ldag.

Each ldag specifies the leading dimension of the matrices belonging to group g.

ldb

Array of group_count parameters ldbg.

Each ldbg specifies the leading dimension of the matrices belonging to group g.

group_count

Specifies the number of groups of parameters. Must be at least 0.

group_sizes

Array of group_count integers. Array element with index g specifies the number of problems to solve for each of the groups of parameters g. So the total number of problems to solve, batch_size, is a sum of all parameter group sizes.

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 potrs_batch (Group Version) function must be able to hold.