Spec-Zone.ru › NumPy 1.14

numpy.interp

numpy.interp(x, xp, fp, left=None, right=None, period=None) [source]

Линейная интерполяция в одномерном случае.

Возвращает одномерный кусочно-линейный интерполянт для функции с заданными значениями в дискретных точках.

Параметры:

x : array_like

Координаты x для интерполируемых значений.

xp : последовательность значений с плавающей точкой размерности 1

Координаты x точек данных, должны быть возрастающими, если параметр period не указан. В противном случае xp внутренне сортируется после нормализации периодических границ с помощью xp = xp % period.

fp : последовательность значений с плавающей точкой или комплексными числами размерности 1

Координаты y точек данных, длина такая же, как у xp.

left : необязательное значение с плавающей точкой или комплексное число, соответствующее fp

Значение, возвращаемое для x < xp[0], по умолчанию fp[0].

right : необязательное значение с плавающей точкой или комплексное число, соответствующее fp

Значение, возвращаемое для x > xp[-1], по умолчанию fp[-1].

period : None или число с плавающей точкой, необязательно

Период для координат x. Этот параметр позволяет правильно интерполировать угловые координаты x. Параметры left и right игнорируются, если period указан.

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

Возвращает:

y : число с плавающей точкой или комплексное число (соответствует fp) или массив

Интерполированные значения, имеющие ту же форму, что и x.

Возможные исключения:

ValueError

Если xp и fp имеют разную длину, если xp или fp не являются последовательностями размерности 1, если period == 0

Примечания

Не проверяет, что последовательность координат x xp возрастает. Если xp не возрастает, результаты будут бессмысленными. Простая проверка на возрастание:

np.all(np.diff(xp) > 0)

Примеры

>>> xp = [1, 2, 3]
>>> fp = [3, 2, 0]
>>> np.interp(2.5, xp, fp)
1.0
>>> np.interp([0, 1, 1.5, 2.72, 3.14], xp, fp)
array([ 3. ,  3. ,  2.5 ,  0.56,  0. ])
>>> UNDEF = -99.0
>>> np.interp(3.14, xp, fp, right=UNDEF)
-99.0

Построение интерполянты для синусоидальной функции:

>>> x = np.linspace(0, 2*np.pi, 10)
>>> y = np.sin(x)
>>> xvals = np.linspace(0, 2*np.pi, 50)
>>> yinterp = np.interp(xvals, x, y)
>>> import matplotlib.pyplot as plt
>>> plt.plot(x, y, 'o')
[<matplotlib.lines.Line2D object at 0x...>]
>>> plt.plot(xvals, yinterp, '-x')
[<matplotlib.lines.Line2D object at 0x...>]
>>> plt.show()
../../_images/numpy-interp-1_00_00.png

Интерполяция с периодическими координатами x:

>>> x = [-180, -170, -185, 185, -10, -5, 0, 365]
>>> xp = [190, -190, 350, -350]
>>> fp = [5, 10, 3, 4]
>>> np.interp(x, xp, fp, period=360)
array([7.5, 5., 8.75, 6.25, 3., 3.25, 3.5, 3.75])

Комплексная интерполяция >>> x = [1.5, 4.0] >>> xp = [2,3,5] >>> fp = [1.0j, 0, 2+3j] >>> np.interp(x, xp, fp) array([ 0.+1.j , 1.+1.5j])

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

Spec-Zone.ru

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