make_mcev: Create a multi-companion eigenvector

View source: R/mc.R

make_mcevR Documentation

Create a multi-companion eigenvector

Description

Creates an eigenvector of a multicompanion matrix from the eigenvalue and the seed parameters.

Usage

make_mcev(eigval, co, dim, what.co = "bottom")
make_mcgev(eigval, co, v, what.co = "bottom")

Arguments

eigval

the eigenvalue.

co

the bottom (default) or the top seed elements of the vector.

dim

the size of the matrix.

what.co

type of co: "bottom" or "top".

v

the previous vector in the chain.

Details

make_mcev computes an eigenvector for a multi-companion dim x dim matrix by filling its top or bottom part with co and completing the remaining elements using the general pattern of eigenvectors of such matrices \insertCiteboshnakov2002mcmcompanion.

Similarly, make_mcgev computes the next generalised eigenvector in a chain whose previous element is v.

what.co cannot be "top" if the eigenvalue is 0. Generalised eigenvectors corresponding to the zero eigenvalue have some specifics, so it is better to use the specialised functions in that case.

Value

make_mcev returns the required eigenvector.

make_mcgev returns the required generalised eigenvector.

Author(s)

Georgi N. Boshnakov

References

\insertRef

boshnakov2002mcmcompanion

Examples

v1 <- make_mcev(0.5, c(1, 1), dim = 4)
v1
make_mcev(0.5, c(1, 1), dim = 4, what.co = "top")

v2 <- make_mcgev(0.5, c(0, 1), v = v1, what.co = "top")
v2
make_mcgev(0.5, c(0, 1), v = v2, what.co = "top")

mcompanion documentation built on Sept. 22, 2023, 5:12 p.m.