ungqr_batch (USM ストライドバージョン)#
geqrf_batch (USM ストライドバージョン) 関数によって形成された QR 分解のバッチの複素ユニタリー行列 Qi を生成します。このルーチンは、oneapi::mkl::lapack 名前空間に属します。
説明#
このルーチンは、geqrf_batch (USM ストライドバージョン)) 関数によって形成された QR 分解の m 行 m 列のユニタリー行列 Qi の全体または一部を生成します。
通常、Qi は、m ≥ p の m 行 p 列の行列 Ai の QR 分解から決定されます。行列 Q i 全体を計算するには、次を使用します。
ungqr_batch(queue, m, m, p, a, ...)Q i の先頭の p 列 (A i の列によってスパンされる空間の正規直交基底を形成する) を計算するには、次のようにします。
ungqr_batch(queue, m, p, p, a, ...)行列 Ai の先頭 k 列の QR 分解 Q ik を計算するには、次のようにします。
ungqr_batch(queue, m, m, k, a, ...)Q ik の先頭の k 列 (A i の先頭 k 列によってスパンされる空間の正規直交基底を形成) を計算するには、次のようにします。
ungqr_batch(queue, m, k, k, a, ...)API#
構文#
namespace oneapi::mkl::lapack {
sycl::event ungqr_batch(sycl::queue &queue,
int64_t m,
int64_t n,
int64_t k,
T *a,
int64_t lda,
int64_t stride_a,
const T *tau,
int64_t stride_tau,
int64_t batch_size,
T *scratchpad,
int64_t scratchpad_size,
const std::vector<sycl::event> &events = {})
}この関数は次の精度とデバイスをサポートしています。
T |
デバイスサポート |
|---|---|
|
CPU および GPU* |
|
CPU および GPU* |
*インターフェイスのサポートのみ。すべての計算は CPU 上で実行されます。
入力パラメーター#
- queue
計算が実行されるデバイスキュー。
- m
行列
Ai の行数 (m ≥ 0)。- n
行列
Ai の列数 (n ≥ 0)。- k
積が行列
Qi を定義する基本反射体の数 (0 ≤k≤n)。- a
geqrf_batch (USM ストライドバージョン) の呼び出し後に生成される配列。
- lda
Ai の先頭次元 i(lda≥max(1,m))。- stride_a
バッチ配列
a内の行列Ai の先頭間のストライド (stride_a≥max(1, lda * n))。- tau
geqrf_batch (USM ストライドバージョン) の呼び出し後に生成される配列。
- stride_tau
配列
tau内の行列taui の先頭間のストライド (stride_tau≥max(1, min(m,n)))。- batch_size
バッチ内の問題数 (
batch_size≥ 0)。- scratchpad
ルーチンが中間結果を保存するスクラッチパッド・メモリー。
- scratchpad_size
Tタイプの浮動小数点要素の数であるスクラッチパッド・メモリーのサイズ。サイズは、ungqr_batch_scratchpad_size (ストライドバージョン) によって返される値以下であってはなりません。- events
計算を開始する前に待機するイベントのリスト。デフォルトでは空のリストになります。
出力パラメーター#
- a
配列データは、
m行m列のユニタリー行列Qi の先頭n列のバッチによって上書きされます。
例外#
例外 |
説明 |
|---|---|
|
この例外は、計算中に問題が発生した場合にスローされます。例外オブジェクトの info() メソッドを使用して、問題の情報コードを取得できます。
|
戻り値#
計算が完了したことを確認するために待機する出力イベント。