trtri (USM バージョン)#
三角行列の逆行列を計算します。このルーチンは、oneapi::mkl::lapack
名前空間に属します。
説明#
このルーチンは、上三角行列または下三角行列 A
の逆行列 inv(A)
を計算します。
API#
構文#
namespace oneapi::mkl::lapack {
sycl::event trtri(sycl::queue &queue,
mkl::uplo uplo,
mkl::diag diag,
int64_t n,
T *a,
int64_t lda,
T *scratchpad,
int64_t scratchpad_size,
const std::vector<sycl::event> &events = {})
}
trtri
(USM バージョン) は、次の精度とデバイスをサポートします。
T |
デバイスサポート |
---|---|
|
CPU および GPU |
|
CPU および GPU |
|
CPU および GPU |
|
CPU および GPU |
入力パラメーター#
- queue
計算が実行されるデバイスキュー。
- uplo
A
が上三角か下三角であるかを示します。uplo=
uplo::upper
の場合、配列a
には行列A
の上三角部分が格納され、行列の厳密な下三角部分は参照されません。uplo=
uplo::lower
の場合、配列a
には行列A
の下三角部分が格納され、行列の厳密な上三角部分は参照されません。- diag
diag =
diag::nonunit
の場合、行列A
は単位三角行列ではありません。diag =
diag::unit
の場合、行列A
は単位三角行列です。つまり、対角要素は 1 であると見なされ、参照されません。- n
行列
A
の次数(n ≥ 0)
。- a
上三角行列または下三角行列
A
のいずれかを含む入力配列へのポインター (uplo を参照)。配列のサイズはlda * max(1, n)
以上である必要があります。- lda
a
の先頭次元 ;lda ≥ max(1, n)
。- scratchpad
ルーチンが中間結果を保存するスクラッチパッド・メモリーへのポインター。
- scratchpad_size
T
タイプの浮動小数点要素の数であるスクラッチパッド・メモリーのサイズ。サイズは、trtri_scratchpad_size 関数が返す値以下であってはなりません。- events
計算を開始する前に待機するイベントのリスト。デフォルトでは空のリストになります。
出力パラメーター#
- a
uplo =
uplo::upper
の場合、A
の上三角部分はその逆数で上書きされます。uplo =
uplo::lower
の場合、A
の下三角部分はその逆数で上書きされます。
例外#
例外 |
説明 |
---|---|
|
この例外は、この計算中に問題が発生した場合にスローされます。例外オブジェクトの info() メソッドを使用して、問題の情報コードを取得できます。
|
戻り値#
計算が完了したことを確認するために待機する出力イベント。