numpy.floor#

numpy.floor(x, /, out=None, *, where=True, casting='same_kind', order='K', dtype=None, subok=True[, signature]) = <ufunc 'floor'>#

逐元素返回输入值的地板值。

标量 x 的地板值是小于或等于 x 的最大整数 i。它通常表示为 \(\lfloor x \rfloor\)

参数:
xarray_like

输入数据。

outndarray、None,或由 ndarray 和 None 组成的元组,可选

存储结果的位置。如果提供,它必须具有与输入广播后的形状相同的形状。如果未提供或为 None,则返回一个新分配的数组。元组(只能作为关键字参数)的长度必须等于输出的数量。

wherearray_like,可选

此条件将广播到输入上。在条件为 True 的位置,out 数组将被设置为 ufunc 的结果。在其他位置,out 数组将保留其原始值。请注意,如果通过默认的 out=None 创建了未初始化的 out 数组,则其中条件为 False 的位置将保持未初始化状态。

**kwargs

有关其他仅关键字参数,请参阅 ufunc 文档

返回:
yndarray 或标量

x 中每个元素的地板值。如果 x 是一个标量,则返回一个标量。

另请参阅

ceil, trunc, rint, fix

说明

有些电子表格程序会计算“向零取整”的地板值,例如 floor(-2.5) == -2。NumPy 则使用 floor 的定义,其中 floor(-2.5) == -3。在 NumPy 中,“向零取整”函数被称为 fix

示例

>>> import numpy as np
>>> a = np.array([-1.7, -1.5, -0.2, 0.2, 1.5, 1.7, 2.0])
>>> np.floor(a)
array([-2., -2., -1.,  0.,  1.,  1.,  2.])