numpy.min#
- numpy.min(a, axis=None, out=None, keepdims=<no value>, initial=<no value>, where=<no value>)[源代码]#
返回数组的最小值或沿轴的最小值。
- 参数:
- a类数组对象
输入数据。
- axisNone 或 int 或 int 元组,可选
操作的轴或轴。默认情况下,使用展平的输入。
如果这是一个整数元组,则在多个轴上选择最小值,而不是像之前那样在单个轴或所有轴上选择。
- outndarray,可选
用于放置结果的备选输出数组。必须与预期输出具有相同的形状和缓冲区长度。有关更多详细信息,请参阅 输出类型确定。
- keepdimsbool,可选
如果设置为 True,则被缩减的轴将保留在结果中,其大小为 1。使用此选项,结果将能够与输入数组正确广播。
如果传递了默认值,则 keepdims 不会传递给
ndarray的子类的min方法,但任何非默认值都会传递。如果子类的方法未实现 keepdims ,则会引发任何异常。- initial标量,可选
输出元素的最小值。必须存在才能对空切片进行计算。有关详细信息,请参阅
reduce。- wherearray_like of bool,可选
用于比较最小值的元素。有关详细信息,请参阅
reduce。
- 返回:
- minndarray 或标量
a 的最小值。如果 axis 为 None,则结果为标量值。如果 axis 为整数,则结果为维度为
a.ndim - 1的数组。如果 axis 是一个元组,则结果是维度为a.ndim - len(axis)的数组。
另请参阅
备注
NaN 值会被传播,也就是说,如果至少有一个元素是 NaN,则对应的最小值也将是 NaN。要忽略 NaN 值(MATLAB 行为),请使用 nanmin。
不要对两个数组进行逐元素比较时使用
min;当a.shape[0]为 2 时,minimum(a[0], a[1])比min(a, axis=0)快。示例
>>> import numpy as np >>> a = np.arange(4).reshape((2,2)) >>> a array([[0, 1], [2, 3]]) >>> np.min(a) # Minimum of the flattened array 0 >>> np.min(a, axis=0) # Minima along the first axis array([0, 1]) >>> np.min(a, axis=1) # Minima along the second axis array([0, 2]) >>> np.min(a, where=[False, True], initial=10, axis=0) array([10, 1])
>>> b = np.arange(5, dtype=float) >>> b[2] = np.nan >>> np.min(b) np.float64(nan) >>> np.min(b, where=~np.isnan(b), initial=10) 0.0 >>> np.nanmin(b) 0.0
>>> np.min([[-50], [10]], axis=-1, initial=0) array([-50, 0])
请注意,初始值被用作确定最小值的一个元素,这与 Python 的 max 函数的默认参数不同,后者仅用于空可迭代对象。
请注意,这与 Python 的
default参数不同。>>> np.min([6], initial=5) 5 >>> min([6], default=5) 6