### Navigation

- index
- modules |
- modules |
- next |
- previous |
- SciPy v0.12 Reference Guide (DRAFT) »
- Linear algebra (`scipy.linalg`) »

# scipy.linalg.companion

`scipy.linalg.``companion`(a)

  Create a companion matrix.

  Create the companion matrix [R47] associated with the polynomial whose coefficients are given in a.

  Parameters : | a : (N,) array_like 1-D array of polynomial coefficients. The length of a must be at least two, and `a[0]` must not be zero.
  Returns : | c : (N-1, N-1) ndarray The first row of c is `-a[1:]/a[0]`, and the first sub-diagonal is all ones. The data-type of the array is the same as the data-type of `1.0*a[0]`.
  Raises : | ValueError : If any of the following are true: a) `a.ndim != 1`; b) `a.size < 2`; c) `a[0] == 0`.

  Notes

  New in version 0.8.0.

  References

  [R47] | (1, 2) R. A. Horn & C. R. Johnson, Matrix Analysis. Cambridge, UK: Cambridge University Press, 1999, pp. 146-7.

  Examples

      >>> from scipy.linalg import companion
      >>> companion([1, -10, 31, -30])
      array([[ 10., -31.,  30.],
             [  1.,   0.,   0.],
             [  0.,   1.,   0.]])

### Navigation

- index
- modules |
- modules |
- next |
- previous |
- SciPy v0.12 Reference Guide (DRAFT) »
- Linear algebra (`scipy.linalg`) »