her

her#

エルミート行列のランク 1 更新を計算します。

説明

her ルーチンは、スカラー - ベクトル - ベクトル積を計算し、それらをエルミート行列に加算します。操作はのように定義されています。

\[A \leftarrow alpha*x*x^H + A\]

説明:

  • alpha はスカラーです

  • A は n x n エルミート行列です

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

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

T

Treal

std::complex<float>

float

std::complex<double>

double

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

構文#

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

入力パラメーター#

queue

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

upper_lower

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

n

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

alpha

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

x

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

incx

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

a

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

lda

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

出力パラメーター#

a

upper_lower=upper の場合はエルミート行列 A の更新された上三角部分を保持するバッファー、upper_lower=lower の場合はエルミート行列 A の更新された下三角部分を保持するバッファー。

alpha がゼロの場合、A 行列は変更されません。それ以外の場合、対角要素の虚数部はゼロに設定されます。

her (USM バージョン)#

構文#

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

入力パラメーター#

queue

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

upper_lower

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

n

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

alpha

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

x

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

incx

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

a

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

lda

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

dependencies

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

出力パラメーター#

a

upper_lower=upper の場合はエルミート行列 A の更新された上三角部分へのポインター、upper_lower=lower の場合はエルミート行列 A の更新された下三角部分へのポインター。

alpha がゼロの場合、A 行列は変更されません。それ以外の場合、対角要素の虚数部はゼロに設定されます。

戻り値#

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