numpy.polynomial.polynomial.polyval

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

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

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

\[p(x) = c_0 + c_1 * x + ... + c_n * x^n\]

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

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

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

Parameters

xarray_like, совместимый объект

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

carray_like

Массив коэффициентов, упорядоченный таким образом, что коэффициенты для членов степени n содержатся в c[n]. Если c многомерный, оставшиеся индексы перечисляют несколько многочленов. В двумерном случае коэффициенты можно рассматривать как хранящиеся в столбцах c.

tensorboolean, optional

Если True, форма массива коэффициентов расширяется единицами справа, по одному для каждой размерности x. Скаляры имеют размерность 0 для этого действия. В результате каждый столбец коэффициентов в c вычисляется для каждого элемента x. Если False, x транслируется по столбцам c для вычисления. Этот ключевой параметр полезен, когда c является многомерным. Значение по умолчанию — True.

New in version 1.7.0.

Returns

valuesndarray, совместимый объект

Форма возвращаемого массива описана выше.

См. также

polyval2d, polygrid2d, polyval3d, polygrid3d

Notes

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

Примеры

>>> 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.])