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.

Изменено в версии 1.20.0: Значения округляются к -inf вместо 0, когда указан целое число dtype. Старое поведение по-прежнему можно получить с помощью np.linspace(start, stop, num).astype(int).

Параметры

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 не задано, тип данных определяется из start и stop. Выведенный тип данных никогда не будет целым числом; float выбирается, даже если аргументы дадут массив целых чисел.

Введено в версии 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()