slepc-3.7.4 2017-05-17
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 | - (optional) matrix resulting from evaluating f(A)

### Notes

Matrix A must be a square sequential dense Mat, with all entries equal on all processes (otherwise each process will compute different results). If matrix B is provided, it must also be a square sequential dense Mat, and both matrices must have the same dimensions. If B is NULL (or B=A) then the function will perform an in-place computation, overwriting A with f(A).

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(), FNEvaluateFunctionMatVec()

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