numpy.nanmax#

numpy.nanmax(a, axis=None, out=None, keepdims=<no value>, initial=<no value>, where=<no value>)[source]#

返回数组的最大值或沿指定轴的最大值,忽略任何 NaN。当遇到全 NaN 切片时,会引发 RuntimeWarning 并在该切片中返回 NaN。

参数:
aarray_like

包含需要查找最大值的数字的数组。如果 a 不是数组,则尝试进行转换。

axis{int, tuple of int, None}, 可选

计算最大值的轴或轴集。默认为计算展平数组的最大值。

outndarray, 可选

用于放置结果的备用输出数组。默认为 None;如果提供,则其形状必须与预期输出相同,但类型将根据需要进行转换。有关详细信息,请参阅 输出类型确定

版本 1.8.0 中的新功能。

keepdimsbool, 可选

如果将其设置为 True,则结果中会保留被缩减的轴,其大小为 1。使用此选项,结果将针对原始 a 正确广播。

如果该值不是默认值,则 keepdims 将传递到 max 方法,该方法是 ndarray 的子类的。如果子类的方法未实现 keepdims,则会引发任何异常。

版本 1.8.0 中的新功能。

initial标量, 可选

输出元素的最小值。必须存在才能允许在空切片上进行计算。有关详细信息,请参阅 reduce

版本 1.22.0 中的新功能。

wherearray_like of bool, 可选

要比较最大值的元素。有关详细信息,请参阅 reduce

版本 1.22.0 中的新功能。

返回值:
nanmaxndarray

一个与 a 形状相同的数组,其中已移除指定的轴。如果 a 是一个 0 维数组,或者如果 axis 为 None,则返回一个 ndarray 标量。返回与 a 相同的数据类型。

另请参阅

nanmin

数组沿给定轴的最小值,忽略任何 NaN。

amax

数组沿给定轴的最大值,传播任何 NaN。

fmax

两个数组的逐元素最大值,忽略任何 NaN。

maximum

两个数组的逐元素最大值,传播任何 NaN。

isnan

显示哪些元素不是数字 (NaN)。

isfinite

显示哪些元素既不是 NaN 也不是无穷大。

amin, fmin, minimum

备注

NumPy 使用 IEEE 算术二进制浮点数标准 (IEEE 754)。这意味着“非数字”不等于无穷大。正无穷大被视为一个非常大的数字,负无穷大被视为一个非常小的(即负的)数字。

如果输入具有整数类型,则该函数等效于 np.max。

示例

>>> import numpy as np
>>> a = np.array([[1, 2], [3, np.nan]])
>>> np.nanmax(a)
3.0
>>> np.nanmax(a, axis=0)
array([3.,  2.])
>>> np.nanmax(a, axis=1)
array([2.,  3.])

当存在正无穷大和负无穷大时

>>> np.nanmax([1, 2, np.nan, -np.inf])
2.0
>>> np.nanmax([1, 2, np.nan, np.inf])
inf