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

sign

符号関数 (関数 signum)

構文

sign(x)

説明

Y = sign(x) は、x と同じサイズの配列 Y を返します。Y の各要素は次のようになります。

• x の対応する要素が 0 より大きい場合、1

• x の対応する要素が 0 に等しい場合、0

• x の対応する要素が 0 より小さい場合、-1

• x が複素数の場合、x./abs(x)。

例

符号関数を求める

数値の符号関数を求めます。

sign(2)

ans = 1

ベクトルの値の符号関数を求めます。

V = [-11 0 1.5 Inf NaN];
sign(V)

ans = 1×5

    -1     0     1     1   NaN

行列の値の符号関数を求めます。

M = magic(3) - 5;
sign(M)

ans = 3×3

     1    -1     1
    -1     0     1
    -1     1    -1

複素数の符号関数を求めます。

z = 4 - 3*i;
sign(z)

ans = 0.8000 - 0.6000i

符号関数のプロット

符号関数をプロットし、ゼロクロッシングでの動作を表示します。0 のすぐ上と下の値を表現するには、eps を使用します。

x = [-5 -eps(1) 0 eps(1) 5];
y = sign(x);
plot(x,y)
ylim([-2 2])
grid on

符号関数の実数部と虚数部のプロット

符号関数の実数部と虚数部を $$-3<x<-3$$ および $$-3<y<3$$ でプロットします。

まず meshgrid を使用して、-3 < x < 3 および -3 < y < 3 の値のメッシュを作成します。次に z = x + 1i*y を使用して、これらの値から複素数を作成します。

v = -3:0.1:3;
[x, y] = meshgrid(v);
z = x + 1i*y;

z の符号関数の実数部と虚数部を求めます。

s = sign(z);
re = real(s);
im = imag(s);

実数部と虚数部をプロットします。

surf(x,y,re)
title('Real part of sign function')
xlabel('x')
ylabel('y')

figure(2)
surf(x,y,im)
title('Imaginary part of sign function')
xlabel('x')
ylabel('y')

入力引数

x — 入力

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

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

x の要素が NaN である場合、sign は出力の対応する要素に NaN を返します。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | duration
複素数のサポート: あり

拡張機能

tall 配列

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

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

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

スレッドベースの環境

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

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

GPU 配列

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

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

分散配列

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

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

バージョン履歴

R2006a より前に導入

参考

abs | conj | imag | real