DSPEPSetCoefficients#
Sets the polynomial basis coefficients for a DSPEP.
Synopsis#
#include "slepcds.h"
PetscErrorCode DSPEPSetCoefficients(DS ds,PetscReal pbc[])
Logically Collective
Input Parameters#
ds - the direct solver context
pbc - the polynomial basis coefficients
Notes#
This function is required only in the case of a polynomial specified in a non-monomial basis, to provide the coefficients that will be used during the linearization, multiplying the identity blocks on the three main diagonal blocks. Depending on the polynomial basis (Chebyshev, Legendre, …) the coefficients must be different.
There must be a total of \(3(d+1)\) coefficients, where \(d\) is the degree of the polynomial. The coefficients are arranged in three groups, \(\alpha_i\), \(\beta_i\), and \(\gamma_i\), according to the definition of the three-term recurrence. In the case of the monomial basis, \(\alpha_i=1\) and \(\beta_i=\gamma_i=0\), in which case it is not necessary to invoke this function.
See Also#
DS: Direct Solver (or Dense System), DSPEPGetCoefficients(), DSPEPSetDegree()
Level#
advanced
Location#
Implementations#
DSPEPSetCoefficients_PEP() in src/sys/classes/ds/impls/pep/dspep.c
Index of all DS routines Table of Contents for all manual pages Index of all manual pages