acos

ラジアン単位の逆余弦

構文

Y = acos(X)

説明

Y = acos(X) は X の要素の逆余弦(cos^-1) をラジアン単位で返します。この関数は、実数入力と複素数入力の両方を受け入れます。

• X が区間 [-1, 1] の実数値の場合、acos(X) は区間 [0, π] の値を返す。

• X が [-1,1] の区間外にある実数値の場合、および X が複素数値の場合、acos(X) は複素数値を返す。

例

値の逆余弦

値の逆余弦を求めます。

y = acos(0)

y = 
1.5708

複素数値のベクトルの逆余弦

ベクトル x の要素の逆余弦を求めます。関数 acos は、x を要素単位で処理します。

x = [0.5i 1+3i -2.2+i];
y = acos(x)

y = 1×3 complex

   1.5708 - 0.4812i   1.2632 - 1.8642i   2.6799 - 1.5480i

逆余弦関数のプロット

$$-1\le x\le 1$$ の区間で逆余弦関数をプロットします。

x = -1:.01:1;
plot(x,acos(x))
grid on

入力引数

X — 角度の余弦

スカラー | ベクトル | 行列 | 多次元配列 | table | timetable

角度の余弦。スカラー、ベクトル、行列、多次元配列、table、または timetable として指定します。X が非スカラーの場合、acos 演算は要素単位で行われます。

データ型: single | double | table | timetable
複素数のサポート: あり

詳細

逆余弦

逆余弦は次のように定義されます。

$${\cos }^{-1}(z)=-i\log \left[z+i{\left(1-z^2\right)}^{1/2}\right].$$

拡張機能

tall 配列

メモリの許容量を超えるような多数の行を含む配列を計算します。

acos 関数は tall 配列を完全にサポートしています。詳細については、tall 配列を参照してください。

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意および制限:

• 入力値 X は実数でも出力が複素数になる場合、シミュレーション時にエラーを生成し、生成コードで NaN を返します。複素数の結果を得るには、complex(X) を渡して入力値を複素数にします。

GPU コード生成

GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

使用上の注意および制限:

• 入力値 X は実数でも出力が複素数になる場合、シミュレーション時にエラーを生成し、生成コードで NaN を返します。複素数の結果を得るには、complex(X) を渡して入力値を複素数にします。

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

この関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

acos 関数は GPU 配列入力をサポートしますが、次の使用上の注意および制限があります。

• GPU で実行される関数の出力が複素数になる可能性がある場合は、入力引数を明示的に複素数として指定しなければなりません。詳細については、GPU 上での複素数の処理 (Parallel Computing Toolbox)を参照してください。

詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

この関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2006a で導入

R2023a: table および timetable で直接計算を実行

関数 acos は、table または timetable 内のすべての変数に対して、それらの変数にアクセスするためのインデックス付けを行うことなく計算できます。すべての変数のデータ型で計算がサポートされている必要があります。詳細については、table および timetable での直接計算を参照してください。

参考

acosd | cos | asec | cosd