trtrs_scratchpad_size
Contents
trtrs_scratchpad_size#
Computes size of scratchpad memory required for trtrs function.
Description
trtrs_scratchpad_size
supports the following precisions.
T
float
double
std::complex<float>
std::complex<double>
Computes the number of elements of type T
the scratchpad memory to be passed to trtrs function should be able to hold.
Calls to this routine must specify the template parameter explicitly.
trtrs_scratchpad_size#
Syntax
namespace oneapi::mkl::lapack {
template <typename T>
std::int64_t trtrs_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, oneapi::mkl::transpose trans, oneapi::mkl::diag diag, std::int64_t n, std::int64_t nrhs, std::int64_t lda, std::int64_t ldb)
}
Input Parameters
- queue
Device queue where calculations by trtrs function will be performed.
- upper_lower
Indicates whether
is upper or lower triangular:If upper_lower =
uplo::upper
, then is upper triangular.If upper_lower =
uplo::lower
, then is lower triangular.- trans
Indicates the form of the equations:
If
trans=oneapi::mkl::transpose::nontrans
, then is solved for .If
trans=oneapi::mkl::transpose::trans
, then is solved for .If
trans=oneapi::mkl::transpose::conjtrans
, then is solved for .- diag
If diag =
oneapi::mkl::diag::nonunit
, then is not a unit triangular matrix.If unit_diag =
diag::unit
, then is unit triangular: diagonal elements of are assumed to be 1 and not referenced in the arraya
.- n
The order of
; the number of rows in ; .- nrhs
The number of right-hand sides (
).- lda
The leading dimension of
a
; .- ldb
The leading dimension of
b
; .
Throws
This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here.
oneapi::mkl::unsupported_device
oneapi::mkl::lapack::invalid_argument
Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by info() method of exception object.
Return Value
The number of elements of type T
the scratchpad memory to be passed to trtrs function should be able to hold.
Parent topic: LAPACK Linear Equation Routines