`numpy.absolute()`

Функция numpy.absolute() возвращает поэлементный модуль (абсолютное значение) каждого элемента входного массива. Для комплексных чисел вычисляется их норма sqrt(a.real**2 + a.imag**2).

Сигнатура

numpy.absolute(x, /, out=None, *, where=True, casting='same_kind',
               order='K', dtype=None, subok=True[, signature, extobj])

Параметры

x — входной массив (array_like). Может быть скаляром, списком или ndarray.
out — массив для записи результата (опционально).
where — маска, определяющая, для каких элементов выполняется операция.
dtype — желаемый тип результата.

Возвращаемое значение

ndarray или скаляр с поэлементными модулями значений x. Для вещественных входов результат — вещественный массив, для комплексных — массив значений float.

Примеры

Пример 1. Модуль отрицательных чисел.

import numpy as np

arr = np.array([-3, -1, 0, 2, -7])
print(np.absolute(arr))

[3 1 0 2 7]

Пример 2. Комплексные числа.

z = np.array([3+4j, 1-1j, -2+0j])
print(np.absolute(z))

[5.         1.41421356 2.        ]

Пример 3. Двумерный массив температурных отклонений.

delta = np.array([[-1.2, 0.5], [-3.0, 2.1]])
print(np.absolute(delta))

[[1.2 0.5]
 [3.  2.1]]

Пример 4. Применение к показаниям датчика тока.

# Сигнал тока: знак указывает направление, нас интересует величина
current = np.array([0.12, -0.05, -0.30, 0.22, -0.18])
magnitude = np.absolute(current)
print("Средний модуль тока:", magnitude.mean())

Средний модуль тока: 0.174

Пример 5. Сокращённая запись через ``np.abs``.

x = np.array([-10, -5, 0, 5, 10])
print(np.abs(x))  # np.abs — алиас np.absolute

[10  5  0  5 10]

См. также

Примечание

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

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

numpy.absolute()