slepc-3.6.3 2016-03-29
Report Typos and Errors

FNEvaluateFunctionMat

Computes the value of the function f(A) for a given matrix A, where the result is also a matrix.

Synopsis

#include "slepcfn.h" 
PetscErrorCode FNEvaluateFunctionMat(FN fn,Mat A,Mat B)
Logically Collective on FN

Input Parameters

fn - the math function context
A - matrix on which the function must be evaluated

Output Parameter

B - matrix resulting from evaluating f(A)

Notes

The matrix A must be a sequential dense Mat, with all entries equal on all processes (otherwise each process will compute different results). Matrix B must also be a sequential dense Mat. Both matrices must be square with the same dimensions.

If A is known to be real symmetric or complex Hermitian then it is recommended to set the appropriate flag with MatSetOption(), so that a different algorithm that exploits symmetry is used.

Scaling factors are taken into account, so the actual function evaluation will return beta*f(alpha*A).

See Also

FNEvaluateFunction()

Location: src/sys/classes/fn/interface/fnbasic.c
Index of all FN routines
Table of Contents for all manual pages
Index of all manual pages