BVSumQuadrature#

Computes the sum of terms required in the quadrature rule to approximate the contour integral.

Synopsis#

#include "slepcbv.h" 
PetscErrorCode BVSumQuadrature(BV S,BV Y,PetscInt M,PetscInt L,PetscInt L_max,PetscScalar w[],PetscScalar zn[],VecScatter scat,PetscSubcomm subcomm,PetscInt npoints,PetscBool useconj)

Collective

Input Parameters#

  • Y - input basis vectors

  • M - number of moments

  • L - block size

  • L_max - maximum block size

  • w - quadrature weights

  • zn - normalized quadrature points

  • scat - (optional) VecScatter object to communicate between subcommunicators

  • subcomm - subcommunicator layout

  • npoints - number of points to process by the subcommunicator

  • useconj - whether conjugate points can be used or not

Output Parameter#

  • S - output basis vectors

Notes#

This is a generalization of BVMult(). The resulting matrix S consists of M panels of L columns, and the following formula is computed for each panel \(S_k = \sum_j w_j\zeta_j^kY_j\), where \(Y_j\) is the \(j\)-th panel of \(Y\) containing the result of solving \(T(z_j)^{-1}X\) for each integration point \(j\). L_max is the width of the panels in \(Y\).

When using subcommunicators, Y is stored in the subcommunicators for a subset of integration points. In that case, the computation is done in the subcomm and then scattered to the whole communicator in S using the VecScatter scat. The value npoints is the number of points to be processed in this subcomm and the flag useconj indicates whether symmetric points can be reused.

See Also#

BV: Basis Vectors, BVMult(), BVScatter(), BVDotQuadrature(), RGComputeQuadrature(), RGCanUseConjugates()

Level#

developer

Location#

src/sys/classes/bv/interface/bvcontour.c

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