petsc-3.14.5 2021-03-03
Report Typos and Errors

# PCShellSetApply

Sets routine to use as preconditioner on a block of vectors.

### Synopsis

    #include "petscpc.h"
    PetscErrorCode  PCShellSetMatApply(PC pc,PetscErrorCode (*matapply)(PC,Mat,Mat))

Logically Collective on PC

### Input Parameters

| pc | - the preconditioner context
| apply | - the application-provided preconditioning routine

### Calling sequence of apply

       PetscErrorCode apply (PC pc,Mat Xin,Mat Xout)

| pc | - the preconditioner, get the application context with PCShellGetContext()
| Xin | - input block of vectors
| Xout | - output block of vectors

### Notes

the function MUST return an error code of 0 on success and nonzero on failure.

### See Also

PCShellSetApply()

### Level

developer

### Location

src/ksp/pc/impls/shell/shellpc.c

### Examples

src/ksp/ksp/tutorials/ex15.c.html
src/ksp/ksp/tutorials/ex15f.F90.html
src/snes/tutorials/ex3.c.html
src/tao/pde_constrained/tutorials/parabolic.c.html
src/tao/pde_constrained/tutorials/hyperbolic.c.html

### Implementations

PCShellSetApply_Shell(PC pc,PetscErrorCode (*apply) in src/ksp/pc/impls/shell/shellpc.c
Index of all PC routines
Table of Contents for all manual pages
Index of all manual pages