dpnp.floor

dpnp.floor(x, /, out=None, *, order='K', where=True, dtype=None, subok=True, **kwargs)[source]

Round a number to the nearest integer toward minus infinity.

For full documentation refer to numpy.floor.

Returns:: out – The floor of each element of x.
Return type:: dpnp.ndarray

Limitations

Parameter x is only supported as either dpnp.ndarray or dpctl.tensor.usm_ndarray. Parameters where, dtype, and subok are supported with their default values. Keyword argument kwargs is currently unsupported. Otherwise the function will be executed sequentially on CPU. Input array data types are limited by real-value data types.

See also

dpnp.ceil: Compute the ceiling of the input, element-wise.
dpnp.trunc: Return the truncated value of the input, element-wise.

Notes

Some spreadsheet programs calculate the “floor-towards-zero”, in other words floor(-2.5) == -2. DPNP instead uses the definition of floor where floor(-2.5) == -3.

Examples

>>> import dpnp as np
>>> a = np.array([-1.7, -1.5, -0.2, 0.2, 1.5, 1.7, 2.0])
>>> np.floor(a)
array([-2.0, -2.0, -1.0, 0.0, 1.0, 1.0, 2.0])