sign сигнум-функция

## Синтаксис

    X = sign(A)

## Аргументы

А

  матрица кодированных целых чисел, десятичных чисел или комплексных чисел. `A` может быть разрежённой.

X

  матрица того же размера и типа данных, что и `A`.

## Описание

Если `X` состоит из целых или вещественных чисел, то

- `X(i) = -1` где `A(i)<0`
- `X(i) = 0` где `A(i)==0`
- `X(i) = 1` где `A(i)>0`
- `X(i)= %nan` где `A(i)` равно NaN.

Если `X` состоит из комплексных чисел: `sign(A==0) = 0`. В противном случае `sign(A) = A./abs(A)`.

## Примеры

С десятичными числами:

    m  = [ 1.25  -2.5  -%inf   2.75
           0.     1.    0.75   %inf
           %nan   0.   -1.5   -2.5 ]; m
    sign(m)

    --> m  =
       1.25  -2.5  -Inf    2.75
       0.     1.    0.75   Inf
       Nan    0.   -1.5   -2.5
    --> sign(m)
     ans  =
       1.   -1.  -1.   1.
       0.    1.   1.   1.
       Nan   0.  -1.  -1.

С комплексными числами:

    i = %i;
    c = [-1, -i, -3+4*i
          1,  i,  3+4*i
          3,  0,  3-4*i
         -4, 4*i,-4-3*i ];
    c
    sign(c)

    --> c  =
      -1.  -i     -3. + 4.i
       1.   i      3. + 4.i
       3.   0.     3. - 4.i
      -4.   4.i   -4. - 3.i
    --> sign(c)
     ans  =
      -1.  -i     -0.6 + 0.8i
       1.   i      0.6 + 0.8i
       1.   0.     0.6 - 0.8i
      -1.   i     -0.8 - 0.6i

С разряжённой матрицей:

    sign(sprand(8,3,0.3,"normal"))

## Смотрите также

- abs
- csgn
- signm

## История

6.0 Расширение до разряжённых матриц.