log10#
ベクトル要素の要素ごとに底 10 の対数を計算します。
説明#
log10(a) 関数はベクトル要素の底 10 の対数を計算します。
引数 |
結果 |
エラーコード |
|---|---|---|
+1 |
+0 |
|
a <+0 |
QNAN |
|
+0 |
\(- \infty\) |
|
-0 |
\(- \infty\) |
|
\(- \infty\) |
QNAN |
|
\(+ \infty\) |
\(+ \infty\) |
|
QNAN |
QNAN |
|
SNAN |
QNAN |
RE(a) i·IM(a) |
\(-\infty\) |
\(-X\) |
\(-0\) |
\(+0\) |
\(+X\) |
\(+\infty\) |
\(NAN\) |
|---|---|---|---|---|---|---|---|
\(+i \cdot \infty\) |
\(+ \infty + i \frac{3}{4} \frac{\pi}{\ln(10)}\) |
\(+ \infty + i \frac{\pi}{2} \frac{1}{\ln(10)}\) |
\(+ \infty + i \frac{\pi}{2} \frac{1}{\ln(10)}\) |
\(+ \infty + i \frac{\pi}{2} \frac{1}{\ln(10)}\) |
\(+ \infty + i \frac{\pi}{2} \frac{1}{\ln(10)}\) |
\(+ \infty + i \frac{\pi}{4} \frac{1}{\ln(10)}\) |
\(+ \infty +i·QNAN\) |
\(+i \cdot Y\) |
\(+ \infty + i \frac{\pi}{\ln(10)}\) |
\(+ \infty + i \cdot 0\) |
\(QNAN+i·QNAN\) |
||||
\(+i \cdot 0\) |
\(+ \infty + i \frac{\pi}{\ln(10)}\) |
\(- \infty + i \frac{\pi}{\ln(10)}\) |
\(- \infty + i \cdot 0\) |
\(+ \infty + i \cdot 0\) |
\(QNAN+i·QNAN\) |
||
\(-i \cdot 0\) |
\(+ \infty - i \frac{\pi}{\ln(10)}\) |
\(- \infty - i \frac{\pi}{\ln(10)}\) |
\(- \infty - i \cdot 0\) |
\(+ \infty - i \cdot 0\) |
\(QNAN-i·QNAN\) |
||
\(-i \cdot Y\) |
\(+ \infty - i \frac{\pi}{\ln(10)}\) |
\(+ \infty - i \cdot 0\) |
\(QNAN+i·QNAN\) |
||||
\(-i \cdot \infty\) |
\(+ \infty + i \frac{3}{4} \frac{\pi}{\ln(10)}\) |
\(+ \infty - i \frac{\pi}{2} \frac{1}{\ln(10)}\) |
\(+ \infty - i \frac{\pi}{2} \frac{1}{\ln(10)}\) |
\(+ \infty - i \frac{\pi}{2} \frac{1}{\ln(10)}\) |
\(+ \infty - i \frac{\pi}{2} \frac{1}{\ln(10)}\) |
\(+ \infty - i \frac{\pi}{4} \frac{1}{\ln(10)}\) |
\(+ \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\) |
API#
構文#
バッファー API
namespace oneapi::mkl::vm {
sycl::event log10(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 log10(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 log10(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 log10(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 = {});
}log10 は次の精度とデバイスをサポートしています。
T |
デバイスサポート |
|---|---|
|
GPU |
|
CPU |
|
CPU および GPU |
|
CPU および GPU |
|
CPU および GPU |
|
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)
計算終了イベント。
例#
log10 の使用例は、oneMKL インストール・ディレクトリーの以下の場所にあります。
share/doc/mkl/examples/sycl/vml/source/vlog10.cpp