sinpi

sin(X*pi) を正確に計算

構文

Y = sinpi(X)

説明

Y = sinpi(X) は、X*pi を明示的に計算せずに sin(X*pi) を計算します。この計算は sin(X*pi) よりも正確です。というのも浮動小数点値である pi は π の近似であるためです。以下に例を示します。

• 整数の場合、sinpi(n) は厳密にゼロになります。

• 奇数の整数の場合、sinpi(n/2) は +1 または -1 になります。

例

π の倍数の正弦を計算

sinpi(X) と sin(X*pi) の精度を比較します。

値のベクトルを作成します。

X = [0 1/2 1 3/2 2];

通常の関数 sin を使用して X*pi の正弦を計算します。

Y = sin(X*pi)

Y = 1×5

         0    1.0000    0.0000   -1.0000   -0.0000

この結果に含まれる小さい数値誤差は、pi が $\pi$ の真の値の浮動小数点数近似であるという事実によるものです。たとえば、$\sin \left(\pi \right)=0$ は成り立ちますが、Y(3) は "厳密な" ゼロになりません。

Y(3)

ans = 
1.2246e-16

sinpi を使用して同じ値を計算します。この場合、結果は正確です。

Z = sinpi(X)

Z = 1×5

     0     1     0    -1     0

Z(3)

ans = 
0

入力引数

X — 入力配列

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

入力配列。スカラー、ベクトル、行列、多次元配列、table または timetable として指定します。

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

拡張機能

tall 配列

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

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

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

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

GPU 配列

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

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

分散配列

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

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

バージョン履歴

R2018b で導入

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

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

参考

sin | sind | cospi