numpy.linspace#

numpy.linspace(начало, стоп, число=50, конечная точка=True, retstep=False, dtype=None, ось=0, *, device=None)[источник]#

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

Возвращает число равномерно распределенные выборки, вычисленные на интервале [начало, стоп].

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

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

Параметры:
началоarray_like

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

стопarray_like

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

числоint, необязательный

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

конечная точкаbool, необязательно

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

retstepbool, необязательно

Если True, возвращает (образцы, шаг), где шаг это расстояние между выборками.

dtypedtype, опционально

Тип выходного массива. Если dtype не указан, тип данных выводится из начало и стоп. Выведенный dtype никогда не будет целочисленным; float выбирается, даже если аргументы могут создать массив целых чисел.

осьint, необязательный

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

devicestr, optional

Устройство, на котором размещается созданный массив. По умолчанию: None. Только для совместимости с Array-API, поэтому должно быть "cpu" если передано.

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

Возвращает:
образцыndarray

Существуют число равномерно распределенные выборки в замкнутом интервале [start, stop] или полуоткрытый интервал [start, stop) (в зависимости от того, конечная точка имеет значение True или False).

шагfloat, опционально

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

Размер интервала между выборками.

Смотрите также

arange

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

geomspace

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

logspace

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

Как создавать массивы с регулярно расположенными значениями

Примеры

>>> import numpy as np
>>> 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')
[]
>>> plt.plot(x2, y + 0.5, 'o')
[]
>>> plt.ylim([-0.5, 1])
(-0.5, 1)
>>> plt.show()
../../_images/numpy-linspace-1.png