tbsv

tbsv#

係数が三角帯行列にある線形方程式系を解きます。

説明#

tbsv ルーチンは、係数が三角帯行列にある線形方程式系を解きます。操作はのように定義されています。

\[op(A)*x = b\]

説明:

  • op(A) は、op(A) = A、op(A) = AT、または op(A) = AH のいずれかです

  • A は n x n の単位または非単位の上三角帯行列または下三角帯行列で、対角要素は (k + 1) です

  • b と x は長さ n のベクトルです

tbsv は次の精度をサポートします。

T

float

double

std::complex<float>

std::complex<double>

tbsv (バッファーバージョン)#

構文#

namespace oneapi::mkl::blas::column_major { 
    void tbsv(sycl::queue &queue, 
              oneapi::mkl::uplo upper_lower, 
              oneapi::mkl::transpose trans, 
              oneapi::mkl::diag unit_diag, 
              std::int64_t n, 
              std::int64_t k, 
              sycl::buffer<T,1> &a, 
              std::int64_t lda, 
              sycl::buffer<T,1> &x, 
              std::int64_t incx) 
}
namespace oneapi::mkl::blas::row_major { 
    void tbsv(sycl::queue &queue, 
              oneapi::mkl::uplo upper_lower, 
              oneapi::mkl::transpose trans, 
              oneapi::mkl::diag unit_diag, 
              std::int64_t n, 
              std::int64_t k, 
              sycl::buffer<T,1> &a, 
              std::int64_t lda, 
              sycl::buffer<T,1> &x, 
              std::int64_t incx) 
}

入力パラメーター#

queue

ルーチンを実行するキュー。

upper_lower

行列 A が上三角行列か下三角行列であるかを指定します。詳細はデータタイプを参照してください。

trans

行列 A に適用される転置演算 op(A) を指定します。詳細はデータタイプを参照してください。

unit_diag

行列 A が単位三角行列であるかどうかを指定します。詳細はデータタイプを参照してください。

n

行列 A の行数と列数。最小値は 0 です。

k

行列 A のサブ/スーパー対角要素の数。最小値は 0 です。

a

入力行列 A を保持するバッファー。バッファーのサイズはlda * n 以上である必要があります。行列ストレージを参照してください。

lda

行列 A の先頭次元。(k + 1) 以上かつ正の数である必要があります。

x

入力ベクトル x を保持するバッファー。バッファーのサイズは (1 + (n - 1)*abs(incx) 以上である必要があります。行列ストレージを参照してください。

incx

ベクトル x のストライド。ゼロであってはなりません。

出力パラメーター#

x

解ベクトル x を保持するバッファー。

tbsv (USM バージョン)#

構文#

namespace oneapi::mkl::blas::column_major { 
    sycl::event tbsv(sycl::queue &queue, 
                     oneapi::mkl::uplo upper_lower, 
                     oneapi::mkl::transpose trans, 
                     oneapi::mkl::diag unit_diag, 
                     std::int64_t n, 
                     std::int64_t k, 
                     const T *a, 
                     std::int64_t lda, 
                     T *x, 
                     std::int64_t incx, 
                     const std::vector<sycl::event> &dependencies = {}) 
}
namespace oneapi::mkl::blas::row_major { 
    sycl::event tbsv(sycl::queue &queue, 
                     oneapi::mkl::uplo upper_lower, 
                     oneapi::mkl::transpose trans, 
                     oneapi::mkl::diag unit_diag, 
                     std::int64_t n, 
                     std::int64_t k, 
                     const T *a, 
                     std::int64_t lda, 
                     T *x, 
                     std::int64_t incx, 
                     const std::vector<sycl::event> &dependencies = {}) 
}

入力パラメーター#

queue

ルーチンを実行するキュー。

upper_lower

行列 A が上三角行列か下三角行列であるかを指定します。詳細はデータタイプを参照してください。

trans

行列 A に適用される転置演算 op(A) を指定します。詳細はデータタイプを参照してください。

unit_diag

行列 A が単位三角行列であるかどうかを指定します。詳細はデータタイプを参照してください。

n

行列 A の行数と列数。最小値は 0 です。

k

行列 A のサブ/スーパー対角要素の数。最小値は 0 です。

a

入力行列 A へのポインター。入力行列 A を保持する配列のサイズは、lda * n 以上である必要があります。行列ストレージを参照してください。

lda

行列 A の先頭次元。(k + 1) 以上かつ正の数である必要があります。

x

入力ベクトル x へのポインター。入力ベクトル x を保持する配列のサイズは、(1 + (n - 1)*abs(incx)) 以上である必要があります。行列ストレージを参照してください。

incx

ベクトル x のストライド。ゼロであってはなりません。

dependencies

計算を開始する前に待機するイベントのリスト (存在する場合)。省略した場合、依存関係はデフォルトでなくなります。

出力パラメーター#

x

解ベクトル x へのポインター。

戻り値#

計算が完了したことを確認するために待機する出力イベント。