numpy.ptp

numpy.ptp(a, axis=None, out=None, keepdims=<no value>) [source]

Диапазон значений (максимум - минимум) по оси.

Имя функции происходит от аббревиатуры «пик-пик».

Параметры

aarray_like

Входные значения.

axisNone or int or tuple of ints, optional

Ось, по которой нужно найти пики. По умолчанию, выравнивает массив. axis может быть отрицательным, в этом случае он считает от последней к первой оси.

New in version 1.15.0.

Если это кортеж целых чисел, выполняется уменьшение по нескольким осям вместо одной оси или всех осей, как раньше.

outarray_like

Альтернативный выходной массив, в который нужно поместить результат. Он должен иметь такую же форму и длину буфера, как и ожидаемый результат, но тип выходных значений будет преобразован при необходимости.

keepdimsbool, optional

Если это установлено в True, оси, по которым выполняется уменьшение, остаются в результате как размерности с размером один. С этим параметром результат будет корректно транслироваться по отношению к входному массиву.

Если передано значение по умолчанию, то keepdims не будет передано методу ptp подклассов ndarray, но любое отличное от значения по умолчанию будет. Если метод подкласса не реализует keepdims , будут подняты исключения.

Возвращает

ptpndarray

Новый массив, содержащий результат, если out не был указан, в противном случае возвращается ссылка на out.

Примеры

>>> x = np.arange(4).reshape((2,2))
>>> x
array([[0, 1],
       [2, 3]])

>>> np.ptp(x, axis=0)
array([2, 2])

>>> np.ptp(x, axis=1)
array([1, 1])