mars.tensor.floor#

mars.tensor.floor(x, out=None, where=None, **kwargs)[来源]#

逐元素返回输入的下限。

标量 x 的下取整是最大整数 i，满足 i <= x。它通常记作 \(\lfloor x \rfloor\)。

Parameters

  • x (类数组) – 输入数据。

  • out (Tensor, None, 或 tuple 的 Tensor 和 None, 可选) – 结果存储的位置。如果提供，它必须具有和输入相同的广播形状。如果未提供或None，将返回一个新分配的张量。元组（仅作为关键字参数可能）必须具有与输出数量相等的长度。

  • where (array_like, 可选) – 值为 True 表示在该位置计算 ufunc，值为 False 表示保持输出中的该值不变。

  • **kwargs –

Returns

y – 每个元素在 x 中的下限。

Return type

张量或标量

另请参阅

ceil, trunc, rint

备注

一些电子表格程序计算“向零取整”，换句话说 floor(-2.5) == -2. NumPy则使用floor的定义，其中floor(-2.5) == -3。

示例

>>> import mars.tensor as mt

>>> a = mt.array([-1.7, -1.5, -0.2, 0.2, 1.5, 1.7, 2.0])
>>> mt.floor(a).execute()
array([-2., -2., -1.,  0.,  1.,  1.,  2.])