KSPGetErrorHistory#

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

Synopsis#

#include "petscksp.h" 
#include "petscmat.h" 
PetscErrorCode KSPGetErrorHistory(KSP ksp, const PetscReal *a[], PetscInt *na)

Not Collective

Input Parameter#

  • ksp - iterative context obtained from KSPCreate()

Output Parameters#

  • a - pointer to array to hold history (or NULL)

  • na - number of used entries in a (or NULL)

Note#

This array is borrowed and should not be freed by the caller. Can only be called after a KSPSetErrorHistory() otherwise a and na are set to NULL and zero

Fortran Note#

The Fortran version of this routine has a calling sequence

call KSPGetErrorHistory(KSP ksp, integer na, integer ierr)

note that you have passed a Fortran array into KSPSetErrorHistory() 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.

See Also#

KSP: Linear System Solvers, KSPSetErrorHistory(), KSPGetResidualHistory(), KSP

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