Actual source code: preonly.c


  2: #include <petsc/private/kspimpl.h>

  4: static PetscErrorCode KSPSetUp_PREONLY(KSP ksp)
  5: {
  6:   return 0;
  7: }

  9: static PetscErrorCode KSPSolve_PREONLY(KSP ksp)
 10: {
 11:   PetscBool      diagonalscale;
 12:   PCFailedReason pcreason;

 14:   PCGetDiagonalScale(ksp->pc, &diagonalscale);
 17:                you probably want a KSP type of Richardson");
 18:   ksp->its = 0;
 19:   KSP_PCApply(ksp, ksp->vec_rhs, ksp->vec_sol);
 20:   PCGetFailedReasonRank(ksp->pc, &pcreason);
 21:   /* Note: only some ranks may have this set; this may lead to problems if the caller assumes ksp->reason is set on all processes or just uses the result */
 22:   if (pcreason) {
 23:     VecSetInf(ksp->vec_sol);
 24:     ksp->reason = KSP_DIVERGED_PC_FAILED;
 25:   } else {
 26:     ksp->its    = 1;
 27:     ksp->reason = KSP_CONVERGED_ITS;
 28:   }
 29:   if (ksp->numbermonitors) {
 30:     Vec       v;
 31:     PetscReal norm;
 32:     Mat       A;

 34:     VecNorm(ksp->vec_rhs, NORM_2, &norm);
 35:     KSPMonitor(ksp, 0, norm);
 36:     VecDuplicate(ksp->vec_rhs, &v);
 37:     PCGetOperators(ksp->pc, &A, NULL);
 38:     KSP_MatMult(ksp, A, ksp->vec_sol, v);
 39:     VecAYPX(v, -1.0, ksp->vec_rhs);
 40:     VecNorm(v, NORM_2, &norm);
 41:     VecDestroy(&v);
 42:     KSPMonitor(ksp, 1, norm);
 43:   }
 44:   return 0;
 45: }

 47: static PetscErrorCode KSPMatSolve_PREONLY(KSP ksp, Mat B, Mat X)
 48: {
 49:   PetscBool      diagonalscale;
 50:   PCFailedReason pcreason;

 52:   PCGetDiagonalScale(ksp->pc, &diagonalscale);
 55:                you probably want a KSP type of Richardson");
 56:   ksp->its = 0;
 57:   PCMatApply(ksp->pc, B, X);
 58:   PCGetFailedReason(ksp->pc, &pcreason);
 59:   /* Note: only some ranks may have this set; this may lead to problems if the caller assumes ksp->reason is set on all processes or just uses the result */
 60:   if (pcreason) {
 61:     MatSetInf(X);
 62:     ksp->reason = KSP_DIVERGED_PC_FAILED;
 63:   } else {
 64:     ksp->its    = 1;
 65:     ksp->reason = KSP_CONVERGED_ITS;
 66:   }
 67:   return 0;
 68: }

 70: /*MC
 71:      KSPPREONLY - This implements a method that applies ONLY the preconditioner exactly once.
 72:                   This may be used in inner iterations, where it is desired to
 73:                   allow multiple iterations as well as the "0-iteration" case. It is
 74:                   commonly used with the direct solver preconditioners like PCLU and PCCHOLESKY.
 75:                   There is an alias of KSPNONE.

 77:    Options Database Keys:
 78: .   -ksp_type preonly - use preconditioner only

 80:    Level: beginner

 82:    Notes:
 83:     Since this does not involve an iteration the basic KSP parameters such as tolerances and iteration counts
 84:           do not apply

 86:     To apply multiple preconditioners in a simple iteration use KSPRICHARDSON

 88:    Developer Notes:
 89:     Even though this method does not use any norms, the user is allowed to set the KSPNormType to any value.
 90:     This is so the users does not have to change KSPNormType options when they switch from other KSP methods to this one.

 92: .seealso: `KSPCreate()`, `KSPSetType()`, `KSPType`, `KSP`, `KSPRICHARDSON`, `KSPCHEBYSHEV`

 94: M*/

 96: PETSC_EXTERN PetscErrorCode KSPCreate_PREONLY(KSP ksp)
 97: {
 98:   KSPSetSupportedNorm(ksp, KSP_NORM_NONE, PC_LEFT, 3);
 99:   KSPSetSupportedNorm(ksp, KSP_NORM_NONE, PC_RIGHT, 2);
100:   KSPSetSupportedNorm(ksp, KSP_NORM_PRECONDITIONED, PC_LEFT, 2);
101:   KSPSetSupportedNorm(ksp, KSP_NORM_PRECONDITIONED, PC_RIGHT, 2);
102:   KSPSetSupportedNorm(ksp, KSP_NORM_UNPRECONDITIONED, PC_LEFT, 2);
103:   KSPSetSupportedNorm(ksp, KSP_NORM_UNPRECONDITIONED, PC_RIGHT, 2);
104:   KSPSetSupportedNorm(ksp, KSP_NORM_NATURAL, PC_LEFT, 2);

106:   ksp->data                = NULL;
107:   ksp->ops->setup          = KSPSetUp_PREONLY;
108:   ksp->ops->solve          = KSPSolve_PREONLY;
109:   ksp->ops->matsolve       = KSPMatSolve_PREONLY;
110:   ksp->ops->destroy        = KSPDestroyDefault;
111:   ksp->ops->buildsolution  = KSPBuildSolutionDefault;
112:   ksp->ops->buildresidual  = KSPBuildResidualDefault;
113:   ksp->ops->setfromoptions = NULL;
114:   ksp->ops->view           = NULL;
115:   return 0;
116: }