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.

Параметры:

start : array_like Начальное значение последовательности. stop : array_like Конечное значение последовательности, если endpoint не установлено в False. В противном случае последовательность состоит из всех, кроме последнего, из num + 1 равномерно распределённых образцов, так что stop исключается. Обратите внимание, что шаг изменяется, когда endpoint равно False. num : int, optional Количество генерируемых образцов. По умолчанию 50. Должно быть неотрицательным. endpoint : bool, optional Если True, stop является последним образцом. В противном случае он не включается. По умолчанию True. retstep : bool, optional Если True, возвращается (samples, step), где step - расстояние между образцами. dtype : dtype, optional Тип выходного массива. Если dtype не задан, тип данных определяется из других входных аргументов. Новое в версии 1.9.0. axis : int, optional Ось в результате, для хранения образцов. Актуально только если start или stop являются массивоподобными. По умолчанию (0), образцы будут по новой оси, добавленной в начале. Используйте -1, чтобы получить ось в конце. Новое в версии 1.16.0.

Возвращает:

samples : ndarray В замкнутом интервале [start, stop] или полуоткрытом интервале [start, stop) (в зависимости от того, endpoint True или False) содержится num равномерно распределённых образцов. step : float, 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()