numpy.power()

Функция numpy.power() поэлементно возводит первый массив в степень второго. Эквивалентна оператору **. Поддерживает broadcasting.

Сигнатура

numpy.power(x1, x2, /, out=None, *, where=True, casting='same_kind', order='K', dtype=None)

Параметры

• x1 — основание.

• x2 — показатель степени.

• out — массив для результата.

• where — маска применения.

• dtype — тип результата.

Возвращает

ndarray поэлементных степеней.

Пример 1. Квадраты элементов

import numpy as np

a = np.array([1, 2, 3, 4])
print(np.power(a, 2))

[ 1  4  9 16]

Пример 2. Разные степени для разных элементов

import numpy as np

base = np.array([2, 3, 4])
exp  = np.array([3, 2, 1])
print(np.power(base, exp))

[8 9 4]

Пример 3. Корни через дробную степень

import numpy as np

a = np.array([4.0, 9.0, 16.0, 25.0])
print(np.power(a, 0.5))

[2. 3. 4. 5.]

Пример 4. Гамма-коррекция изображения

import numpy as np

# Пиксели 0..255 в нормированный диапазон, gamma = 2.2
pixels = np.array([0, 64, 128, 192, 255]) / 255
corrected = np.power(pixels, 1 / 2.2) * 255
print(np.round(corrected).astype(int))

[  0 137 187 222 255]

Пример 5. Возведение скаляра в степени массива

import numpy as np

exp = np.array([0, 1, 2, 3, 4])
print(np.power(2, exp))

[ 1  2  4  8 16]

См. также

• numpy.multiply()

• numpy.matmul()

• numpy.logspace()

Примечание

Лицензия и источники

Техническое описание функции адаптировано из официальной документации NumPy (https://numpy.org/doc/stable/), BSD-3-Clause License. Примеры и пояснения — © AlashEd Wiki.