DSPEPSetCoefficients — SLEPc 3.25.1 documentation

Skip to main content
`Ctrl`+`K`

# 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), `DSPEP`, `DSPEPGetCoefficients()`, `DSPEPSetDegree()`

## Level

advanced

## Location

src/sys/classes/ds/impls/pep/dspep.c

## 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