Spec-Zone.ru › NumPy 1.16

numpy.logspace

numpy.logspace(start, stop, num=50, endpoint=True, base=10.0, dtype=None, axis=0) [source]

Возвращает числа, равномерно распределённые на логарифмической шкале.

В линейном пространстве последовательность начинается с base ** start (base в степени start) и заканчивается base ** stop (см. endpoint ниже).

Изменено в версии 1.16.0: Теперь поддерживаются нескалярные start и stop.

Параметры:
start : array_like

base ** start — начальное значение последовательности.

stop : array_like

base ** stop — конечное значение последовательности, если endpoint равно False. В этом случае значения num + 1 равномерно распределены на интервале в логарифмическом пространстве, при этом все, кроме последнего (последовательность длиной num), возвращаются.

num : integer, optional

Количество генерируемых выборок. По умолчанию 50.

endpoint : boolean, optional

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

base : float, optional

Основание логарифмического пространства. Шаг между элементами в ln(samples) / ln(base) (или log_base(samples)) равномерный. По умолчанию 10.0.

dtype : dtype

Тип выходного массива. Если dtype не задан, тип данных определяется из других входных аргументов.

axis : int, optional

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

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

Возвращает:
samples : ndarray

num образцов, равномерно распределённых на логарифмической шкале.

См. также

arange
Аналогично linspace, но с указанием шага вместо количества образцов. Обратите внимание, что при использовании с плавающей точкой конечная точка может или не может быть включена.
linspace
Аналогично logspace, но образцы равномерно распределены в линейном, а не логарифмическом пространстве.
geomspace
Аналогично logspace, но конечные точки указаны напрямую.

Примечания

Logspace эквивалентно коду

>>> y = np.linspace(start, stop, num=num, endpoint=endpoint)
... 
>>> power(base, y).astype(dtype)
... 

Примеры

>>> np.logspace(2.0, 3.0, num=4)
array([  100.        ,   215.443469  ,   464.15888336,  1000.        ])
>>> np.logspace(2.0, 3.0, num=4, endpoint=False)
array([ 100.        ,  177.827941  ,  316.22776602,  562.34132519])
>>> np.logspace(2.0, 3.0, num=4, base=2.0)
array([ 4.        ,  5.0396842 ,  6.34960421,  8.        ])

Графическая иллюстрация:

>>> import matplotlib.pyplot as plt
>>> N = 10
>>> x1 = np.logspace(0.1, 1, N, endpoint=True)
>>> x2 = np.logspace(0.1, 1, N, endpoint=False)
>>> y = np.zeros(N)
>>> 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()
../../_images/numpy-logspace-1.png

© 2005–2019 NumPy Developers
Licensed under the 3-clause BSD License.
https://docs.scipy.org/doc/numpy-1.16.1/reference/generated/numpy.logspace.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API