power, .^

Поэлементная степень

Синтаксис

Описание

пример

C = A.^B возводит каждый элемент A к соответствующим степеням в B. Размеры A и B должен быть то же самое или быть совместимым.

Если размеры A и B совместимы, затем эти два массива неявно расширяются, чтобы совпадать друг с другом. Например, если один из A или B скаляр, затем скаляр объединен с каждым элементом другого массива. Кроме того, векторы с различными ориентациями (один вектор-строка и один вектор-столбец) неявно расширяются, чтобы сформировать матрицу.

C = power(A,B) альтернативный путь состоит в том, чтобы выполнить A.^B, но редко используется. Это позволяет выполнить перегрузку оператора для классов.

Примеры

свернуть все

Создайте вектор, A, и квадрат каждый элемент.

A = 1:5;
C = A.^2
C = 1×5

     1     4     9    16    25

Создайте матрицу, A, и возьмите инверсию каждого элемента.

A = [1 2 3; 4 5 6; 7 8 9];
C = A.^-1
C = 3×3

    1.0000    0.5000    0.3333
    0.2500    0.2000    0.1667
    0.1429    0.1250    0.1111

Инверсия элементов не равна инверсии матрицы, которая является вместо этого записанным A^-1 или inv(A).

Создайте вектор 1 на 2 строки и вектор-столбец 3 на 1 и возведите вектор-строку в степень из вектор-столбца.

a = [2 3];
b = (1:3)';
a.^b
ans = 3×2

     2     3
     4     9
     8    27

Результатом является 3-на-2 матрица, где каждый (i, j) элемент в матрице равен a(j) .^ b(i):

a=[a1a2],b=[b1b2b3],          a.ˆb=[a1b1a2b1a1b2a2b2a1b3a2b3].

Вычислите корни -1 к 1/3 степень.

A = -1;
B = 1/3;
C = A.^B
C = 0.5000 + 0.8660i

Для отрицательного основного A и нецелое число B, power функция возвращает комплексные результаты.

Используйте nthroot функция, чтобы получить действительные корни.

C = nthroot(A,3)
C = -1

Входные параметры

свернуть все

Операнды в виде скаляров, векторов, матриц или многомерных массивов. A и B должен или быть одного размера или иметь размеры, которые совместимы (например, A M- N матрица и B скаляр или 1- N вектор-строка). Для получения дополнительной информации см. "Совместимые размеры массивов для основных операций".

  • Операнды с целочисленным типом данных не могут быть комплексными.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char
Поддержка комплексного числа: Да

Больше о

свернуть все

Податливость IEEE

Для действительных входных параметров, power имеет несколько поведений, которые отличаются от рекомендуемых в IEEE®- 754 Стандарта.

 MATLAB® IEEE

power(1,NaN)

NaN

1

power(NaN,0)

NaN

1

Вопросы совместимости

развернуть все

Поведение изменяется в R2016b

Расширенные возможности

Представлено до R2006a