petsc-3.12.5 2020-03-29

KSPSetOptionsPrefix

Sets the prefix used for searching for all KSP options in the database.

#include "petscksp.h" 
PetscErrorCode  KSPSetOptionsPrefix(KSP ksp,const char prefix[])

Logically Collective on ksp

	ksp	- the Krylov context
	prefix	- the prefix string to prepend to all KSP option requests

A hyphen (-) must NOT be given at the beginning of the prefix name. The first character of all runtime options is AUTOMATICALLY the hyphen.

For example, to distinguish between the runtime options for two different KSP contexts, one could call

      KSPSetOptionsPrefix(ksp1,"sys1_")
      KSPSetOptionsPrefix(ksp2,"sys2_")

This would enable use of different options for each system, such as

      -sys1_ksp_type gmres -sys1_ksp_rtol 1.e-3
      -sys2_ksp_type bcgs  -sys2_ksp_rtol 1.e-4

advanced