numpy.nanmax#

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

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

参数:
a类数组对象

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

axis{int, tuple of int, None}, optional

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

outndarray,可选

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

keepdimsbool,可选

如果设置为 True,则被缩减的轴将作为大小为一的维度保留在结果中。使用此选项,结果将能够正确地与原始 a 进行广播。如果值不是默认值,则 keepdims 将被传递给 max 方法的 ndarray 子类。如果子类方法未实现 keepdims,则会引发任何异常。

initial标量,可选

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

New in version 1.22.0。

wherearray_like of bool,可选

用于比较最大值的元素。有关详细信息,请参见 reduce

New in version 1.22.0。

返回:
nanmaxndarray

一个与 a 形状相同的数组,移除了指定的轴。如果 a 是一个 0-维数组,或者 axis 为 None,则返回一个 ndarray 标量。返回与 a 相同的 dtype。

另请参阅

nanmin

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

amax

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

fmax

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

maximum

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

isnan

显示哪些元素是“非数字”(NaN)。

isfinite

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

amin, fmin, minimum

备注

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

如果输入是整数类型,则该函数等同于 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