Main Content

# polyvalm

Matrix polynomial evaluation

## Syntax

``Y = polyvalm(p,X)``

## Description

example

````Y = polyvalm(p,X)` returns the evaluation of polynomial `p` in a matrix sense. This evaluation is the same as substituting matrix `X` in the polynomial, `p`.```

## Examples

collapse all

Find the characteristic polynomial of a Pascal Matrix of order 4.

`X = pascal(4)`
```X = 4×4 1 1 1 1 1 2 3 4 1 3 6 10 1 4 10 20 ```
`p = poly(X)`
```p = 1×5 1.0000 -29.0000 72.0000 -29.0000 1.0000 ```

The characteristic polynomial is

`$p\left(x\right)={x}^{4}-29{x}^{3}+72{x}^{2}-29x+1$`

Pascal matrices have the property that the vector of coefficients of the characteristic polynomial is the same forward and backward (palindromic).

Substitute the matrix, `X`, into the characteristic equation, `p`. The result is very close to being a zero matrix. This example is an instance of the Cayley-Hamilton theorem, where a matrix satisfies its own characteristic equation.

`Y = polyvalm(p,X)`
```Y = 4×4 10-10 × -0.0004 -0.0037 -0.0053 -0.0145 -0.0022 -0.0138 -0.0183 -0.0470 -0.0061 -0.0335 -0.0408 -0.1061 -0.0132 -0.0644 -0.0764 -0.1991 ```

## Input Arguments

collapse all

Polynomial coefficients, specified as a vector. For example, the vector `[1 0 1]` represents the polynomial ${x}^{2}+1$, and the vector `[3.13 -2.21 5.99]` represents the polynomial $3.13{x}^{2}-2.21x+5.99$.

For more information, see Create and Evaluate Polynomials.

Data Types: `single` | `double`
Complex Number Support: Yes

Input matrix, specified as a square matrix.

Data Types: `single` | `double`
Complex Number Support: Yes

## Output Arguments

collapse all

Output polynomial coefficients, returned as a row vector.

## Version History

Introduced before R2006a