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