acosh

ベクトル要素の要素ごとの逆双曲線余弦を計算します。

説明

acosh(a) 関数はベクトル要素の逆双曲線余弦 (非負) を計算します。

引数	結果	エラーコード
+1	+0
a < +1	QNAN	status::errdom
\(- \infty\)	QNAN	status::errdom
\(+ \infty\)	\(+ \infty\)
QNAN	QNAN
SNAN	QNAN

RE(a) i·IM(a)	\(- \infty\)	\(-X\)	\(-0\)	\(+0\)	\(+X\)	\(+ \infty\)	\(NAN\)
\(+i \cdot \infty\)	\(+\infty + i \cdot \frac{3\pi}{4}\)	\(+\infty + i \cdot \frac{\pi}{2}\)	\(+\infty + i \cdot \frac{\pi}{2}\)	\(+\infty + i \cdot \frac{\pi}{2}\)	\(+\infty + i \cdot \frac{\pi}{2}\)	\(+\infty + i \cdot \frac{\pi}{4}\)	\(+ \infty +i·QNAN\)
\(+i \cdot Y\)	\(+ \infty + i \cdot \pi\)					\(+ \infty + i \cdot 0\)	\(QNAN+i·QNAN\)
\(+i \cdot 0\)	\(+ \infty + i \cdot \pi\)		\(+0 + i \cdot \frac{\pi}{2}\)	\(+0 + i \cdot \frac{\pi}{2}\)		\(+ \infty + i \cdot 0\)	\(QNAN+i·QNAN\)
\(-i \cdot 0\)	\(+ \infty + i \cdot \pi\)		\(+0 + i \cdot \frac{\pi}{2}\)	\(+0 + i \cdot \frac{\pi}{2}\)		\(+ \infty + i \cdot 0\)	\(QNAN+i·QNAN\)
\(-i \cdot Y\)	\(+ \infty + i \cdot \pi\)					\(+ \infty + i \cdot 0\)	\(QNAN+i·QNAN\)
\(-i \cdot \infty\)	\(+ \infty - i \cdot \frac{3\pi}{4}\)	\(+ \infty - i \cdot \frac{\pi}{2}\)	\(+ \infty - i \cdot \frac{\pi}{2}\)	\(+ \infty - i \cdot \frac{\pi}{2}\)	\(+ \infty - i \cdot \frac{\pi}{2}\)	\(+ \infty - i \cdot \frac{\pi}{4}\)	\(+ \infty +i·QNAN\)
\(+i·NAN\)	\(+ \infty +i·QNAN\)	\(QNAN+i·QNAN\)	\(QNAN+i·QNAN\)	\(QNAN+i·QNAN\)	\(QNAN+i·QNAN\)	\(+ \infty +i·QNAN\)	\(QNAN+i·QNAN\)

注

acosh(CONJ(a))=CONJ(acosh(a))。

API

構文

バッファー API

namespace oneapi::mkl::vm { 

sycl::event acosh(sycl::queue & exec_queue, 
      std::int64_t n, 
      sycl::buffer<T> & a, 
      sycl::buffer<T> & y, 
      oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, 
      oneapi::mkl::vm::error_handler<T> errhandler = {}); 

}

namespace oneapi::mkl::vm { 

sycl::event acosh(sycl::queue & exec_queue, 
      sycl::buffer<T> & a, 
      oneapi::mkl::slice sa, 
      sycl::buffer<T> & y, 
      oneapi::mkl::slice sy, 
      oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, 
      oneapi::mkl::vm::error_handler<T> errhandler = {}); 

}

USM API

namespace oneapi::mkl::vm { 

sycl::event acosh(sycl::queue & exec_queue, 
      std::int64_t n, 
      T const * a, 
      T * y, 
      std::vector<sycl::event> const & depends = {}, 
      oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, 
      oneapi::mkl::vm::error_handler<T> errhandler = {}); 

}

namespace oneapi::mkl::vm { 

sycl::event acosh(sycl::queue & exec_queue, 
      T const * a, 
      oneapi::mkl::slice sa, 
      T * y, 
      oneapi::mkl::slice sy, 
      std::vector<sycl::event> const & depends = {}, 
      oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, 
      oneapi::mkl::vm::error_handler<T> errhandler = {}); 

}

acosh は次の精度とデバイスをサポートしています。

T	デバイスサポート
sycl::half	GPU
_Float16	CPU
float	CPU および GPU
double	CPU および GPU

入力パラメーター

バッファー API

exec_queue

ルーチンが実行されるキュー。

n

計算する要素の数を指定します。

a

入力ベクトルを含むバッファー。

sa

a のスライスセレクター。oneMKL スライスタイプの説明については、データタイプを参照してください。

sy

y のスライスセレクター。oneMKL スライスタイプの説明については、データタイプを参照してください。

mode

この関数呼び出しのグローバル VM モード設定をオーバーライドします。指定可能な値とその説明については、set_mode 関数を参照してください。これはオプションのパラメーターです。デフォルト値は mode::not_defined です。

errhandler

この関数呼び出しのローカルエラー処理モードを設定します。引数と説明については、create_error_handler 関数を参照してください。これはオプションのパラメーターです。ローカル・エラー・ハンドラーはデフォルトで無効になっています。

USM API

exec_queue

ルーチンが実行されるキュー。

n

計算する要素の数を指定します。

a

入力ベクトルへのポインター。

sa

a のスライスセレクター。oneMKL スライスタイプの説明については、データタイプを参照してください。

sy

y のスライスセレクター。oneMKL スライスタイプの説明については、データタイプを参照してください。

depends

依存イベントのベクトル (入力データの準備ができるまで待機)。これはオプションのパラメーターです。デフォルトは空のベクトルです。

mode

この関数呼び出しのグローバル VM モード設定をオーバーライドします。指定可能な値とその説明については、set_mode 関数を参照してください。これはオプションのパラメーターです。デフォルト値は mode::not_defined です。

errhandler

この関数呼び出しのローカルエラー処理モードを設定します。引数と説明については、create_error_handler 関数を参照してください。これはオプションのパラメーターです。ローカル・エラー・ハンドラーはデフォルトで無効になっています。

出力パラメーター

バッファー API

y

出力ベクトルを含むバッファー。

戻り値 (event)

計算終了イベント。

USM API

y

出力ベクトルへのポインター。

戻り値 (event)

計算終了イベント。

例

acosh の使用例は、oneMKL インストール・ディレクトリーの以下の場所にあります。

share/doc/mkl/examples/sycl/vml/source/vacosh.cpp