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

abs

絶対値と複素数の大きさ

構文

Y = abs(X)

説明

Y = abs(X) は、入力 X の各要素の絶対値を返します。

X が複素数の場合、abs(X) は複素数の大きさを返します。

例

スカラーの絶対値

y = abs(-5)

y = 
5

ベクトルの絶対値

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

x = [1.3 -3.56 8.23 -5 -0.01]'

x = 5×1

    1.3000
   -3.5600
    8.2300
   -5.0000
   -0.0100

ベクトルの要素の絶対値を求めます。

y = abs(x)

y = 5×1

    1.3000
    3.5600
    8.2300
    5.0000
    0.0100

複素数の大きさ

y = abs(3+4i)

y = 
5

入力引数

X — 入力配列

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

入力配列。スカラー、ベクトル、行列、多次元配列、table または timetable として指定します。X が複素数である場合、single または double の配列でなければなりません。出力配列のサイズとデータ型は入力配列と同じになります。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | duration | table | timetable

詳細

絶対値

実数の絶対値は、符号を除いた非負の対応する値です。

実数 a の絶対値は次のようになります。

• a が 0 以上の場合は a

• a が 0 未満の場合は -a

abs(-0) は 0 を返します。

複素数の大きさ

複素数の大きさ (絶対値) は、複素平面にプロットされた原点から複素数値までのベクトル長です。

複素数値の $$|a+bi|$$ は $$\sqrt{a^2+b^2}$$ と定義されます。

拡張機能

tall 配列

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

abs 関数は 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) 上で実行することにより、コードを高速化します。

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

分散配列

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

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

バージョン履歴

R2006a より前に導入

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

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

参考

angle | sign | unwrap | hypot | norm | imag | real