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

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

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()