petsc-3.3-p7 2013-05-11

KSPGetResidualHistory

Gets the array used to hold the residual history and the number of residuals it contains.

Synopsis

#include "petscksp.h" 
PetscErrorCode  KSPGetResidualHistory(KSP ksp,PetscReal *a[],PetscInt *na)
Not Collective

Input Parameter

ksp -iterative context obtained from KSPCreate()

Output Parameters

a - pointer to array to hold history (or PETSC_NULL)
na - number of used entries in a (or PETSC_NULL)

Notes

Can only be called after a KSPSetResidualHistory() otherwise a and na are set to zero

The Fortran version of this routine has a calling sequence

  call KSPGetResidualHistory(KSP ksp, integer na, integer ierr)
note that you have passed a Fortran array into KSPSetResidualHistory() and you need to access the residual values from this Fortran array you provided. Only the na (number of residual norms currently held) is set.

Keywords

KSP, get, residual, history, norm

See Also

KSPGetResidualHistory()

Level:advanced
Location:
src/ksp/ksp/interface/itfunc.c
Index of all KSP routines
Table of Contents for all manual pages
Index of all manual pages

Examples

src/snes/examples/tutorials/ex6.c.html
src/snes/examples/tutorials/ex38.c.html