このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

coth

双曲線余接

構文

Y = coth(X)

説明

Y = coth(X) は、X の要素の双曲線正接を返します。関数 coth は、配列の要素単位で演算を行います。この関数は、実数入力と複素数入力の両方を受け入れます。すべての角度は、ラジアン単位です。

例

ベクトルの双曲線余接

ベクトルを作成し、各値の双曲線余接を計算します。

X = [0 pi 2*pi 3*pi];
Y = coth(X)

Y = 1×4

       Inf    1.0037    1.0000    1.0000

双曲線余接のグラフ

定義域 $$-\pi <x<0$$ および $$0<x<\pi$$ で双曲線余接をプロットします。

x1 = -pi+0.01:0.01:-0.01; 
x2 = 0.01:0.01:pi-0.01;
y1 = coth(x1);
y2 = coth(x2);
plot(x1,y1,x2,y2)
grid on

入力引数

X — 入力角度 (ラジアン単位)

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

入力角度 (ラジアン単位)。スカラー、ベクトル、行列、多次元配列、table、または timetable として指定します。

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

詳細

双曲線余接

x の双曲線余接は双曲線正接の逆関数と同じです。

$$\coth \left(x\right)=\frac{1}{\tanh \left(x\right)}=\frac{e^{2x}+1}{e^{2x}-1}.$$

複素数引数をとる従来の余接関数についての恒等式は、次のようになります。

$$\coth \left(x\right)=i\cot \left(ix\right).$$

拡張機能

tall 配列

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

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

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

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

スレッドベースの環境

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

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

GPU 配列

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

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

分散配列

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

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

バージョン履歴

R2006a より前に導入

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

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

参考

acoth | cot | sinh | cosh | tanh