spmv

spmv#

対称パック行列を使用して行列 - ベクトル積を計算します。

説明#

spmv ルーチンは、スカラー -行列 - ベクトル積を計算し、その結果を対称パック行列に加算します。操作はのように定義されています。

\[y \leftarrow alpha*A*x + beta*y\]

説明:

  • alpha と beta はスカラーです

  • A は n x n 対称行列であり、パック形式で提供されます

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

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

T

float

double

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

構文#

namespace oneapi::mkl::blas::column_major { 
    void spmv(sycl::queue &queue, 
              oneapi::mkl::uplo upper_lower, 
              std::int64_t n, 
              T alpha, 
              sycl::buffer<T,1> &a, 
              sycl::buffer<T,1> &x, 
              std::int64_t incx, 
              T beta, 
              sycl::buffer<T,1> &y, 
              std::int64_t incy) 
}
namespace oneapi::mkl::blas::row_major { 
    void spmv(sycl::queue &queue, 
              oneapi::mkl::uplo upper_lower, 
              std::int64_t n, 
              T alpha, 
              sycl::buffer<T,1> &a, 
              sycl::buffer<T,1> &x, 
              std::int64_t incx, 
              T beta, 
              sycl::buffer<T,1> &y, 
              std::int64_t incy) 
}

入力パラメーター#

queue

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

upper_lower

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

n

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

alpha

行列 - ベクトル積のスケーリング係数。

a

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

x

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

incx

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

beta

ベクトル y のスケーリング係数。beta = 0 の場合、spmv を呼び出す前にベクトル y を初期化する必要はありません。

y

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

incy

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

出力パラメーター#

y

更新されたベクトル y を保持するバッファー。

spmv (USM バージョン)#

構文#

namespace oneapi::mkl::blas::column_major { 
    sycl::event spmv(sycl::queue &queue, 
                     oneapi::mkl::uplo upper_lower, 
                     std::int64_t n, 
                     oneapi::mkl::value_or_pointer<T> alpha, 
                     const T *a, 
                     const T *x, 
                     std::int64_t incx, 
                     oneapi::mkl::value_or_pointer<T> beta, 
                     T *y, 
                     std::int64_t incy, 
                     const std::vector<sycl::event> &dependencies = {}) 
}
namespace oneapi::mkl::blas::row_major { 
    sycl::event spmv(sycl::queue &queue, 
                     oneapi::mkl::uplo upper_lower, 
                     std::int64_t n, 
                     oneapi::mkl::value_or_pointer<T> alpha, 
                     const T *a, 
                     const T *x, 
                     std::int64_t incx, 
                     oneapi::mkl::value_or_pointer<T> beta, 
                     T *y, 
                     std::int64_t incy, 
                     const std::vector<sycl::event> &dependencies = {}) 
}

入力パラメーター#

queue

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

upper_lower

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

n

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

alpha

行列 - ベクトル積のスケーリング係数。value_or_pointer データタイプの詳細については、スカラー引数を参照してください。

a

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

x

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

incx

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

beta

ベクトル y のスケーリング係数。beta = 0 の場合、spmv を呼び出す前にベクトル y を初期化する必要はありません。value_or_pointer データタイプの詳細については、スカラー引数を参照してください。

y

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

incy

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

dependencies

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

出力パラメーター#

y

更新されたベクトル y へのポインター。

戻り値#

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