slepc-3.20.1 2023-11-27
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 STFilterSetRange STMatMode
STCayleySetAntishift STGetKSP STSetMatMode
STFilterGetDegree STGetMatMode STSetMatrices
STFilterGetInterval STGetMatrix STSetShift
STFilterGetRange STGetNumMatrices STViewFromOptions
STFilterSetDegree STGetShift
STFilterSetInterval STGetType
Advanced - Setting more advanced options and customization
STAppendOptionsPrefix STRegisterAll STSetSplitPreconditioner
STGetMatStructure STReset STSetUp
STGetOperator STRestoreOperator STShellGetContext
STGetOptionsPrefix STSHELL STShellSetApply
STGetPreconditionerMat STSetKSP STShellSetApplyTranspose
STGetSplitPreconditionerInfo STSetMatStructure STShellSetBackTransform
STGetSplitPreconditionerTerm STSetOptionsPrefix STShellSetContext
STRegister STSetPreconditionerMat
Developer - Interfaces intended primarily for library developers, not for typical applications programmers
STApply STGetTransform STMatSolve
STApplyHermitianTranspose STInitializePackage STMatSolveTranspose
STApplyMat STIsInjective STPostSolve
STApplyTranspose STMatCreateVecs STPrecondGetKSPHasMat
STBackTransform STMatCreateVecsEmpty STPrecondSetKSPHasMat
STCheckNullSpace STMatGetLocalSize STResetMatrixState
STFilterGetThreshold STMatGetSize STScaleShift
STFinalizePackage STMatMatSolve STSetBalanceMatrix
STGetBalanceMatrix STMatMult STSetDefaultShift
STGetBilinearForm STMatMultTranspose STSetTransform
STGetMatrixTransformed STMatSetUp STSetWorkVecs
No deprecated routines

Table of Contents