cotd

引数の余接 (単位: 度)

構文

Y = cotd(X)

説明

Y = cotd(X) は、X の要素の余接を返します。これは度単位で表されます。

例

90 度と 180 度近傍の角度の余接

90 度および次に小さい倍精度数と次に大きい倍精度数で構成される入力角度のベクトルを作成します。そして、余接を計算します。

x1 = [90-eps(90) 90 90+eps(90)];
y1 = cotd(x1)

y1 = 1×3
10-15 ×

    0.2480         0   -0.2480

入力角度が厳密に 90 度の場合、cotd はゼロを返します。次に小さい倍精度角での評価は、わずかに正の結果を返します。同様に、入力角が 90°よりも次に大きい倍精度数である場合、余接はわずかに負となります。

入力角度が 180 度近傍の場合も、動作は同様です。

x2 = [180-eps(180) 180 180+eps(180)];
y2 = cotd(x2)

y2 = 1×3
1015 ×

   -2.0159      -Inf    2.0159

度単位で指定する複素数角度の余接

x = 35+5i;
y = cotd(x)

y = 
1.3958 - 0.2606i

入力引数

X — 角度 (度単位)

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

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

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

出力引数

Y — 角度の余接

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

角度の余接。X と同じサイズの実数値または複素数値のスカラー、ベクトル、行列、多次元配列、table、または timetable として返されます。

拡張機能

tall 配列

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

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

C/C++ コード生成

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

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

• MATLAB^® が Inf を返すときに、生成されたコードが -Inf を返す場合があります。

• MATLAB が -Inf を返すときに、生成されたコードが Inf を返す場合があります。

スレッドベースの環境

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

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

GPU 配列

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

cotd 関数は、GPU 配列を完全にサポートします。GPU 上で関数を実行するには、入力データを gpuArray (Parallel Computing Toolbox) として指定します。詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

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

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

バージョン履歴

R2006a より前に導入

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

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

参考

acotd | cot | acot