mxnet.np.around

around(x, decimals=0, out=None)

Evenly round to the given number of decimals.

Parameters

  • x (ndarray or scalar) – Input data.

  • decimals (int, optional) – Number of decimal places to round to (default: 0). If decimals is negative, it specifies the number of positions to the left of the decimal point.

  • out (ndarray, optional) – Alternative output array in which to place the result. It must have the same shape and type as the expected output.

Returns

  • rounded_array (ndarray or scalar) – An array of the same type as x, containing the rounded values. A reference to the result is returned.

  • .. note:: – For values exactly halfway between rounded decimal values, NumPy rounds to the nearest even value. Thus 1.5 and 2.5 round to 2.0, -0.5 and 0.5 round to 0.0, etc.

    This function differs from the original numpy.prod in the following aspects:

    • Cannot cast type automatically. Dtype of out must be same as the expected one.

    • Cannot support complex-valued number.

Examples

>>> np.around([0.37, 1.64])
array([ 0.,  2.])
>>> np.around([0.37, 1.64], decimals=1)
array([ 0.4,  1.6])
>>> np.around([.5, 1.5, 2.5, 3.5, 4.5]) # rounds to nearest even value
array([ 0.,  2.,  2.,  4.,  4.])
>>> np.around([1, 2, 3, 11], decimals=1) # ndarray of ints is returned
array([ 1,  2,  3, 11])
>>> np.around([1, 2, 3, 11], decimals=-1)
array([ 0,  0,  0, 10])