slepc-3.12.2 2020-01-13
Report Typos and Errors

Spectral Transformation - ST

The Spectral Transformation (ST) class encapsulates the functionality required for acceleration techniques based on the transformation of the spectrum. As explained in the SLEPc Users Manual, the eigensolvers implemented in EPS work by applying an operator to a set of vectors and this operator can adopt different forms. The ST object handles all the different possibilities in a uniform way, so that the solver can proceed without knowing which transformation has been selected.

The type of spectral transformation can be specified at run time (e.g., -st_type sinvert) as well as several parameters such as the value of the shift (e.g., -st_shift 1.5).

Polynomial eigensolvers in PEP also support spectral transformation, see the users guide for details.

ST objects are always related to a solver object (either EPS or PEP). Users should not create a standalone ST object. ST options can also be set directly in application codes by first extracting the ST context from the EPS context via EPSGetST() and then directly calling the ST routines (e.g., STSetType() / STSetShift()).

Beginner - Basic usage
ST STSetFromOptions STView
STCreate STSetType
STDestroy STType
Intermediate - Setting options for algorithms and data structures
STCayleyGetAntishift STFilterSetInterval STGetShift
STCayleySetAntishift STFilterSetRange STGetType
STFilterGetDegree STGetKSP STMatMode
STFilterGetInterval STGetMatMode STSetMatMode
STFilterGetRange STGetMatrix STSetMatrices
STFilterSetDegree STGetNumMatrices STSetShift
Advanced - Setting more advanced options and customization
STAppendOptionsPrefix STRegisterAll STShellGetContext
STGetMatStructure STReset STShellSetApply
STGetOperator STSHELL STShellSetApplyTranspose
STGetOptionsPrefix STSetKSP STShellSetBackTransform
STPrecondGetMatForPC STSetMatStructure STShellSetContext
STPrecondSetMatForPC STSetOptionsPrefix
STRegister STSetUp
Developer - Interfaces intended primarily for library developers, not for typical applications programmers
STApply STInitializePackage STMatSolveTranspose
STApplyTranspose STIsInjective STPostSolve
STBackTransform STMatCreateVecs STPrecondGetKSPHasMat
STCheckNullSpace STMatCreateVecsEmpty STPrecondSetKSPHasMat
STFilterGetThreshold STMatGetLocalSize STResetMatrixState
STFinalizePackage STMatGetSize STScaleShift
STGetBalanceMatrix STMatMult STSetBalanceMatrix
STGetBilinearForm STMatMultTranspose STSetDefaultShift
STGetMatrixTransformed STMatSetUp STSetTransform
STGetTransform STMatSolve STSetWorkVecs
No deprecated routines

Table of Contents