The .linspace() function returns an array of evenly-spaced numbers over a specified interval [start,stop], optionally excluding the stop value.


numpy.linspace(start, stop, num, endpoint, retstep, dtype, axis)

The start and stop arguments are required and represent the beginning and end of the interval. They can be numbers or arrays.

.linspace() provides the following arguments:

  • start: The starting point of the sequence.
  • stop: The (optionally included) endpoint of the sequence.
  • num: The number of values to generate. Defaults to 50.
  • endpoint: Boolean flag. If True, stop is included as the last value. If False, stop is excluded. Defaults to True.
  • retstep: Boolean flag. If True, the result will include the calculated step size between values. Defaults to False.
  • dtype: The dtype of the returned array, if omitted, dtype is inferred from start and stop. Defaults to None.
  • axis: If start and stop are arrays, this specifies on what axis the values will be added. If 0 the axis is added at the beginning. If -1, it’s added at the end. Defaults to 0.


The following example creates a list of values between 10 and 20.

import numpy
result = numpy.linspace(10, 20, num=6)
result2 = numpy.linspace(10, 20, num=6, endpoint=False)
result3 = numpy.linspace([1,2,3],[4,5,6], num=6)

This results in the following output:

[10. 12. 14. 16. 18. 20.]
[10. 11.66666667 13.33333333 15. 16.66666667 18.33333333]
[[1. 2. 3. ]
[1.6 2.6 3.6]
[2.2 3.2 4.2]
[2.8 3.8 4.8]
[3.4 4.4 5.4]
[4. 5. 6. ]]


Interested in helping build Docs? Read the Contribution Guide or share your thoughts in this feedback form.

Learn Python:NumPy on Codecademy