Numpy Spacing Function: A Complete Guide

Numpy Spacing

In this article, we will try to understand the spacing function in the NumPy package of Python. The Python package NumPy is used to manipulate arrays. Numerous mathematical operations can be carried out on an array with NumPy.

It provides a vast library of high-level mathematical functions that work on these arrays and matrices and strong data structures that ensure efficient calculations with arrays and matrices. In the year 2005, Travis Oliphant developed NumPy. You can use it for free because it is an open-source project.

Why is the spacing function used?

The distance between an input value x and the closest neighboring integer is calculated using the NumPy.spacing() function in the NumPy programming language. It gives back a scalar value that measures the separation between the input value x and the closest neighboring number.

Syntax of Numpy Spacing

numpy.spacing(x, /, out=None, *, where=True)


  • x: array_like
    • Required
    • Values to find the spacing of.
  • out: array, None, or tuple of ndarray and None,
    • Optional
    • a place where the outcome is saved. It must have a form that the inputs broadcast to if it is provided. In the absence of any input or None, a newly allocated array is returned. The length of a tuple (available only as a keyword parameter) must match the number of outputs.
  • where: array_like,
    • Optional
    • This circumstance is announced over the input. The ufunc result will be set to the out array at points where the condition is True. The out array will keep its initial value in all other places. It should be noted that places within an uninitialized out array that is formed with the default out=None will continue to be uninitialized if the condition is False.
  • **kwargs
    • Optional
    • For other keyword-only arguments, see the ufunc docs.

Implementing Numpy Spacing

Before implementing the spacing function, make sure to install/import the NumPy package in the working IDE. The following line of code is used to import NumPy.

import numpy as np

Implementation of single digit

x = np.spacing(10)


Implementation on array

arr = (10,20,30,50,1200)

y = np.spacing(arr)


The scalar value which represents the distance between an input value x (here 10 or tuple of value) and the nearest adjacent number.


In this article, we understood the basic syntax and implementation of the spacing() function of the Numpy library in Python.