NEPGetLeftEigenvector — SLEPc 3.25.1 documentation

Skip to main content
`Ctrl`+`K`

# NEPGetLeftEigenvector

Gets the `i`-th left eigenvector as computed by `NEPSolve()`.

## Synopsis

    #include "slepcnep.h"
    PetscErrorCode NEPGetLeftEigenvector(NEP nep,PetscInt i,Vec Wr,Vec Wi)

Collective

## Input Parameters

- nep - the nonlinear eigensolver context

- i - index of the solution

## Output Parameters

- Wr - real part of left eigenvector

- Wi - imaginary part of left eigenvector

## Notes

The caller must provide valid `Vec` objects, i.e., they must be created by the calling program with e.g. `MatCreateVecs()`.

If the corresponding eigenvalue is real, then `Wi` is set to zero. If PETSc is configured with complex scalars the eigenvector is stored directly in `Wr` (`Wi` is set to zero). In any case, the user can pass `NULL` in `Wr` or `Wi` if one of them is not required.

The index `i` should be a value between 0 and `nconv`-1 (see `NEPGetConverged()`). Eigensolutions are indexed according to the ordering criterion established with `NEPSetWhichEigenpairs()`.

Left eigenvectors are available only if the twosided flag was set, see `NEPSetTwoSided()`.

## See Also

NEP: Nonlinear Eigenvalue Problems, `NEPGetEigenpair()`, `NEPGetConverged()`, `NEPSetWhichEigenpairs()`, `NEPSetTwoSided()`

## Level

intermediate

## Location

src/nep/interface/nepsolve.c

## Examples

src/nep/tutorials/ex42.c

Index of all NEP routines Table of Contents for all manual pages Index of all manual pages