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, необязательно

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

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

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

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

Если True, вернуть (samples, step), где step — шаг между образцами.

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

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

Введено в версии 1.9.0.

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

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

Введено в версии 1.16.0.

Возвращает

samplesndarray

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

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

Возвращается только если 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()