numpy.polynomial.polynomial.polyval

numpy.polynomial.polynomial.polyval(x, c, tensor=True) [source]

Вычисление многочлена в точках x.

Если c имеет длину n + 1, эта функция возвращает значение

Параметр x преобразуется в массив только в том случае, если он является кортежем или списком, в противном случае он обрабатывается как скаляр. В любом случае, либо x, либо его элементы должны поддерживать умножение и сложение как с самими собой, так и с элементами c.

Если c является одномерным массивом, то p(x) будет иметь такую же форму, как и x. Если c является многомерным, то форма результата зависит от значения tensor. Если tensor равно true, форма будет c.shape[1:] + x.shape. Если tensor равно false, форма будет c.shape[1:]. Обратите внимание, что скаляры имеют форму (,).

Завершающие нули в коэффициентах будут использоваться при вычислении, поэтому их следует избегать, если важна эффективность.

Параметры:

x : array_like, compatible object Если x является списком или кортежем, он преобразуется в массив ndarray, в противном случае он остается неизменным и обрабатывается как скаляр. В любом случае, x или его элементы должны поддерживать сложение и умножение как с самими собой, так и с элементами c. c : array_like Массив коэффициентов, упорядоченных так, что коэффициенты для членов степени n содержатся в c[n]. Если c является многомерным, оставшиеся индексы перечисляют несколько многочленов. В двумерном случае коэффициенты можно рассматривать как хранящиеся в столбцах c. tensor : boolean, optional Если True, форма массива коэффициентов расширяется с помощью единиц справа, по одной для каждой размерности x. Скаляры имеют размерность 0 для этого действия. В результате каждый столбец коэффициентов в c вычисляется для каждого элемента x. Если False, x транслируется по столбцам c для вычисления. Этот ключевой параметр полезен, когда c многомерный. Значение по умолчанию равно True. Новое в версии 1.7.0.

Возвращает:

values : ndarray, compatible object Форма возвращаемого массива описана выше.

См. также

polyval2d, polygrid2d, polyval3d, polygrid3d

Примечания

Для вычисления используется метод Хорнера.

Примеры

>>> from numpy.polynomial.polynomial import polyval
>>> polyval(1, [1,2,3])
6.0
>>> a = np.arange(4).reshape(2,2)
>>> a
array([[0, 1],
       [2, 3]])
>>> polyval(a, [1,2,3])
array([[ 1.,   6.],
       [17.,  34.]])
>>> coef = np.arange(4).reshape(2,2) # multidimensional coefficients
>>> coef
array([[0, 1],
       [2, 3]])
>>> polyval([1,2], coef, tensor=True)
array([[2.,  4.],
       [4.,  7.]])
>>> polyval([1,2], coef, tensor=False)
array([2.,  7.])