numpy.linspace

numpy.linspace(start, stop, num=50, endpoint=True, retstep=False, dtype=None, axis=0) [source]

Возвращает равномерно распределённые числа на заданном интервале.

Возвращает num равномерно распределённые отсчёты, вычисленные на интервале [start, stop].

Конечная точка интервала может быть необязательно исключена.

Изменено в версии 1.16.0: Теперь поддерживаются нескалярные start и stop.

Параметры

startarray_like

Начальное значение последовательности.

stoparray_like

Конечное значение последовательности, если endpoint не установлено в False. В этом случае последовательность состоит из всех, кроме последнего, из num + 1 равномерно распределённых отсчётов, так что stop исключается. Обратите внимание, что шаг изменяется, когда endpoint равно False.

numint, optional

Количество отсчётов для генерации. По умолчанию 50. Должно быть неотрицательным.

endpointbool, optional

Если True, stop является последним отсчётом. В противном случае он не включается. По умолчанию True.

retstepbool, optional

Если True, возвращает (samples, step ), где step — расстояние между отсчётами.

dtypedtype, optional

Тип выходного массива. Если dtype не задан, тип данных определяется по другим входным аргументам.

Новое в версии 1.9.0.

axisint, optional

Ось в результате, куда будут записаны отсчёты. Актуально только если start или stop являются массивоподобными. По умолчанию (0) отсчёты будут вдоль новой оси, вставленной в начало. Используйте -1, чтобы получить ось в конце.

Новое в версии 1.16.0.

Возвращает

samplesndarray

В замкнутом интервале [start, stop] или в полуоткрытом интервале [start, stop) (в зависимости от того, endpoint равно True или False) содержатся num равномерно распределённых отсчётов.

stepfloat, optional

Возвращается только если retstep равно True

Размер шага между отсчётами.

См. также

arange

Аналогично linspace, но использует шаг (вместо количества отсчётов).

geomspace

Аналогично linspace, но с числами, равномерно распределёнными на логарифмической шкале (геометрическая прогрессия).

logspace

Аналогично geomspace, но с конечными точками, заданными как логарифмы.

Примеры

>>> np.linspace(2.0, 3.0, num=5)
array([2.  , 2.25, 2.5 , 2.75, 3.  ])
>>> np.linspace(2.0, 3.0, num=5, endpoint=False)
array([2. ,  2.2,  2.4,  2.6,  2.8])
>>> np.linspace(2.0, 3.0, num=5, retstep=True)
(array([2.  ,  2.25,  2.5 ,  2.75,  3.  ]), 0.25)

Графическая иллюстрация:

>>> import matplotlib.pyplot as plt
>>> N = 8
>>> y = np.zeros(N)
>>> x1 = np.linspace(0, 10, N, endpoint=True)
>>> x2 = np.linspace(0, 10, N, endpoint=False)
>>> plt.plot(x1, y, 'o')
[<matplotlib.lines.Line2D object at 0x...>]
>>> plt.plot(x2, y + 0.5, 'o')
[<matplotlib.lines.Line2D object at 0x...>]
>>> plt.ylim([-0.5, 1])
(-0.5, 1)
>>> plt.show()