Actual source code: slepceps.h
slepc-3.10.0 2018-09-18
1: /*
2: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
3: SLEPc - Scalable Library for Eigenvalue Problem Computations
4: Copyright (c) 2002-2018, Universitat Politecnica de Valencia, Spain
6: This file is part of SLEPc.
7: SLEPc is distributed under a 2-clause BSD license (see LICENSE).
8: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
9: */
10: /*
11: User interface for the SLEPc linear eigenvalue solvers
12: */
16: #include <slepcst.h>
17: #include <slepcbv.h>
18: #include <slepcds.h>
19: #include <slepcrg.h>
20: #include <petscsnes.h>
22: PETSC_EXTERN PetscErrorCode EPSInitializePackage(void);
24: /*S
25: EPS - Abstract SLEPc object that manages all the eigenvalue
26: problem solvers.
28: Level: beginner
30: .seealso: EPSCreate(), ST
31: S*/
32: typedef struct _p_EPS* EPS;
34: /*J
35: EPSType - String with the name of a SLEPc eigensolver
37: Level: beginner
39: .seealso: EPSSetType(), EPS
40: J*/
41: typedef const char* EPSType;
42: #define EPSPOWER "power"
43: #define EPSSUBSPACE "subspace"
44: #define EPSARNOLDI "arnoldi"
45: #define EPSLANCZOS "lanczos"
46: #define EPSKRYLOVSCHUR "krylovschur"
47: #define EPSGD "gd"
48: #define EPSJD "jd"
49: #define EPSRQCG "rqcg"
50: #define EPSLOBPCG "lobpcg"
51: #define EPSCISS "ciss"
52: #define EPSLAPACK "lapack"
53: #define EPSARPACK "arpack"
54: #define EPSBLZPACK "blzpack"
55: #define EPSTRLAN "trlan"
56: #define EPSBLOPEX "blopex"
57: #define EPSPRIMME "primme"
58: #define EPSFEAST "feast"
60: /* Logging support */
61: PETSC_EXTERN PetscClassId EPS_CLASSID;
63: /*E
64: EPSProblemType - Determines the type of eigenvalue problem
66: Level: beginner
68: .seealso: EPSSetProblemType(), EPSGetProblemType()
69: E*/
70: typedef enum { EPS_HEP=1,
71: EPS_GHEP,
72: EPS_NHEP,
73: EPS_GNHEP,
74: EPS_PGNHEP,
75: EPS_GHIEP } EPSProblemType;
77: /*E
78: EPSExtraction - Determines the type of extraction technique employed
79: by the eigensolver
81: Level: advanced
83: .seealso: EPSSetExtraction(), EPSGetExtraction()
84: E*/
85: typedef enum { EPS_RITZ,
86: EPS_HARMONIC,
87: EPS_HARMONIC_RELATIVE,
88: EPS_HARMONIC_RIGHT,
89: EPS_HARMONIC_LARGEST,
90: EPS_REFINED,
91: EPS_REFINED_HARMONIC } EPSExtraction;
93: /*E
94: EPSWhich - Determines which part of the spectrum is requested
96: Level: intermediate
98: .seealso: EPSSetWhichEigenpairs(), EPSGetWhichEigenpairs()
99: E*/
100: typedef enum { EPS_LARGEST_MAGNITUDE=1,
101: EPS_SMALLEST_MAGNITUDE,
102: EPS_LARGEST_REAL,
103: EPS_SMALLEST_REAL,
104: EPS_LARGEST_IMAGINARY,
105: EPS_SMALLEST_IMAGINARY,
106: EPS_TARGET_MAGNITUDE,
107: EPS_TARGET_REAL,
108: EPS_TARGET_IMAGINARY,
109: EPS_ALL,
110: EPS_WHICH_USER } EPSWhich;
112: /*E
113: EPSBalance - The type of balancing used for non-Hermitian problems
115: Level: intermediate
117: .seealso: EPSSetBalance()
118: E*/
119: typedef enum { EPS_BALANCE_NONE,
120: EPS_BALANCE_ONESIDE,
121: EPS_BALANCE_TWOSIDE,
122: EPS_BALANCE_USER } EPSBalance;
123: PETSC_EXTERN const char *EPSBalanceTypes[];
125: /*E
126: EPSErrorType - The error type used to assess accuracy of computed solutions
128: Level: intermediate
130: .seealso: EPSComputeError()
131: E*/
132: typedef enum { EPS_ERROR_ABSOLUTE,
133: EPS_ERROR_RELATIVE,
134: EPS_ERROR_BACKWARD } EPSErrorType;
135: PETSC_EXTERN const char *EPSErrorTypes[];
137: /*E
138: EPSConv - Determines the convergence test
140: Level: intermediate
142: .seealso: EPSSetConvergenceTest(), EPSSetConvergenceTestFunction()
143: E*/
144: typedef enum { EPS_CONV_ABS,
145: EPS_CONV_REL,
146: EPS_CONV_NORM,
147: EPS_CONV_USER } EPSConv;
149: /*E
150: EPSStop - Determines the stopping test
152: Level: advanced
154: .seealso: EPSSetStoppingTest(), EPSSetStoppingTestFunction()
155: E*/
156: typedef enum { EPS_STOP_BASIC,
157: EPS_STOP_USER } EPSStop;
159: /*E
160: EPSConvergedReason - Reason an eigensolver was said to
161: have converged or diverged
163: Level: intermediate
165: .seealso: EPSSolve(), EPSGetConvergedReason(), EPSSetTolerances()
166: E*/
167: typedef enum {/* converged */
168: EPS_CONVERGED_TOL = 1,
169: EPS_CONVERGED_USER = 2,
170: /* diverged */
171: EPS_DIVERGED_ITS = -1,
172: EPS_DIVERGED_BREAKDOWN = -2,
173: EPS_DIVERGED_SYMMETRY_LOST = -3,
174: EPS_CONVERGED_ITERATING = 0} EPSConvergedReason;
175: PETSC_EXTERN const char *const*EPSConvergedReasons;
177: PETSC_EXTERN PetscErrorCode EPSCreate(MPI_Comm,EPS*);
178: PETSC_EXTERN PetscErrorCode EPSDestroy(EPS*);
179: PETSC_EXTERN PetscErrorCode EPSReset(EPS);
180: PETSC_EXTERN PetscErrorCode EPSSetType(EPS,EPSType);
181: PETSC_EXTERN PetscErrorCode EPSGetType(EPS,EPSType*);
182: PETSC_EXTERN PetscErrorCode EPSSetProblemType(EPS,EPSProblemType);
183: PETSC_EXTERN PetscErrorCode EPSGetProblemType(EPS,EPSProblemType*);
184: PETSC_EXTERN PetscErrorCode EPSSetExtraction(EPS,EPSExtraction);
185: PETSC_EXTERN PetscErrorCode EPSGetExtraction(EPS,EPSExtraction*);
186: PETSC_EXTERN PetscErrorCode EPSSetBalance(EPS,EPSBalance,PetscInt,PetscReal);
187: PETSC_EXTERN PetscErrorCode EPSGetBalance(EPS,EPSBalance*,PetscInt*,PetscReal*);
188: PETSC_EXTERN PetscErrorCode EPSSetOperators(EPS,Mat,Mat);
189: PETSC_EXTERN PetscErrorCode EPSGetOperators(EPS,Mat*,Mat*);
190: PETSC_EXTERN PetscErrorCode EPSSetFromOptions(EPS);
191: PETSC_EXTERN PetscErrorCode EPSSetUp(EPS);
192: PETSC_EXTERN PetscErrorCode EPSSolve(EPS);
193: PETSC_EXTERN PetscErrorCode EPSView(EPS,PetscViewer);
194: PETSC_STATIC_INLINE PetscErrorCode EPSViewFromOptions(EPS eps,PetscObject obj,const char name[]) {return PetscObjectViewFromOptions((PetscObject)eps,obj,name);}
195: PETSC_EXTERN PetscErrorCode EPSErrorView(EPS,EPSErrorType,PetscViewer);
196: PETSC_DEPRECATED("Use EPSErrorView()") PETSC_STATIC_INLINE PetscErrorCode EPSPrintSolution(EPS eps,PetscViewer v) {return EPSErrorView(eps,EPS_ERROR_RELATIVE,v);}
197: PETSC_EXTERN PetscErrorCode EPSErrorViewFromOptions(EPS);
198: PETSC_EXTERN PetscErrorCode EPSReasonView(EPS,PetscViewer);
199: PETSC_EXTERN PetscErrorCode EPSReasonViewFromOptions(EPS);
200: PETSC_EXTERN PetscErrorCode EPSValuesView(EPS,PetscViewer);
201: PETSC_EXTERN PetscErrorCode EPSValuesViewFromOptions(EPS);
202: PETSC_EXTERN PetscErrorCode EPSVectorsView(EPS,PetscViewer);
203: PETSC_EXTERN PetscErrorCode EPSVectorsViewFromOptions(EPS);
205: PETSC_EXTERN PetscErrorCode EPSSetTarget(EPS,PetscScalar);
206: PETSC_EXTERN PetscErrorCode EPSGetTarget(EPS,PetscScalar*);
207: PETSC_EXTERN PetscErrorCode EPSSetInterval(EPS,PetscReal,PetscReal);
208: PETSC_EXTERN PetscErrorCode EPSGetInterval(EPS,PetscReal*,PetscReal*);
209: PETSC_EXTERN PetscErrorCode EPSSetST(EPS,ST);
210: PETSC_EXTERN PetscErrorCode EPSGetST(EPS,ST*);
211: PETSC_EXTERN PetscErrorCode EPSSetBV(EPS,BV);
212: PETSC_EXTERN PetscErrorCode EPSGetBV(EPS,BV*);
213: PETSC_EXTERN PetscErrorCode EPSSetRG(EPS,RG);
214: PETSC_EXTERN PetscErrorCode EPSGetRG(EPS,RG*);
215: PETSC_EXTERN PetscErrorCode EPSSetDS(EPS,DS);
216: PETSC_EXTERN PetscErrorCode EPSGetDS(EPS,DS*);
217: PETSC_EXTERN PetscErrorCode EPSSetTolerances(EPS,PetscReal,PetscInt);
218: PETSC_EXTERN PetscErrorCode EPSGetTolerances(EPS,PetscReal*,PetscInt*);
219: PETSC_EXTERN PetscErrorCode EPSSetConvergenceTestFunction(EPS,PetscErrorCode (*)(EPS,PetscScalar,PetscScalar,PetscReal,PetscReal*,void*),void*,PetscErrorCode (*)(void*));
220: PETSC_EXTERN PetscErrorCode EPSSetConvergenceTest(EPS,EPSConv);
221: PETSC_EXTERN PetscErrorCode EPSGetConvergenceTest(EPS,EPSConv*);
222: PETSC_EXTERN PetscErrorCode EPSConvergedAbsolute(EPS,PetscScalar,PetscScalar,PetscReal,PetscReal*,void*);
223: PETSC_EXTERN PetscErrorCode EPSConvergedRelative(EPS,PetscScalar,PetscScalar,PetscReal,PetscReal*,void*);
224: PETSC_EXTERN PetscErrorCode EPSConvergedNorm(EPS,PetscScalar,PetscScalar,PetscReal,PetscReal*,void*);
225: PETSC_EXTERN PetscErrorCode EPSSetStoppingTestFunction(EPS,PetscErrorCode (*)(EPS,PetscInt,PetscInt,PetscInt,PetscInt,EPSConvergedReason*,void*),void*,PetscErrorCode (*)(void*));
226: PETSC_EXTERN PetscErrorCode EPSSetStoppingTest(EPS,EPSStop);
227: PETSC_EXTERN PetscErrorCode EPSGetStoppingTest(EPS,EPSStop*);
228: PETSC_EXTERN PetscErrorCode EPSStoppingBasic(EPS,PetscInt,PetscInt,PetscInt,PetscInt,EPSConvergedReason*,void*);
229: PETSC_EXTERN PetscErrorCode EPSGetConvergedReason(EPS,EPSConvergedReason*);
231: PETSC_EXTERN PetscErrorCode EPSSetDimensions(EPS,PetscInt,PetscInt,PetscInt);
232: PETSC_EXTERN PetscErrorCode EPSGetDimensions(EPS,PetscInt*,PetscInt*,PetscInt*);
234: PETSC_EXTERN PetscErrorCode EPSGetConverged(EPS,PetscInt*);
235: PETSC_EXTERN PetscErrorCode EPSGetEigenpair(EPS,PetscInt,PetscScalar*,PetscScalar*,Vec,Vec);
236: PETSC_EXTERN PetscErrorCode EPSGetEigenvalue(EPS,PetscInt,PetscScalar*,PetscScalar*);
237: PETSC_EXTERN PetscErrorCode EPSGetEigenvector(EPS,PetscInt,Vec,Vec);
239: PETSC_EXTERN PetscErrorCode EPSComputeError(EPS,PetscInt,EPSErrorType,PetscReal*);
240: PETSC_DEPRECATED("Use EPSComputeError()") PETSC_STATIC_INLINE PetscErrorCode EPSComputeRelativeError(EPS eps,PetscInt i,PetscReal *r) {return EPSComputeError(eps,i,EPS_ERROR_RELATIVE,r);}
241: PETSC_DEPRECATED("Use EPSComputeError() with EPS_ERROR_ABSOLUTE") PETSC_STATIC_INLINE PetscErrorCode EPSComputeResidualNorm(EPS eps,PetscInt i,PetscReal *r) {return EPSComputeError(eps,i,EPS_ERROR_ABSOLUTE,r);}
242: PETSC_EXTERN PetscErrorCode EPSGetInvariantSubspace(EPS,Vec*);
243: PETSC_EXTERN PetscErrorCode EPSGetErrorEstimate(EPS,PetscInt,PetscReal*);
245: PETSC_EXTERN PetscErrorCode EPSMonitor(EPS,PetscInt,PetscInt,PetscScalar*,PetscScalar*,PetscReal*,PetscInt);
246: PETSC_EXTERN PetscErrorCode EPSMonitorSet(EPS,PetscErrorCode (*)(EPS,PetscInt,PetscInt,PetscScalar*,PetscScalar*,PetscReal*,PetscInt,void*),void*,PetscErrorCode (*)(void**));
247: PETSC_EXTERN PetscErrorCode EPSMonitorSetFromOptions(EPS,const char*,const char*,const char*,PetscErrorCode (*)(EPS,PetscInt,PetscInt,PetscScalar*,PetscScalar*,PetscReal*,PetscInt,PetscViewerAndFormat*),PetscBool);
248: PETSC_EXTERN PetscErrorCode EPSConvMonitorSetFromOptions(EPS,const char*,const char*,const char*,PetscErrorCode (*)(EPS,PetscInt,PetscInt,PetscScalar*,PetscScalar*,PetscReal*,PetscInt,SlepcConvMonitor));
249: PETSC_EXTERN PetscErrorCode EPSMonitorCancel(EPS);
250: PETSC_EXTERN PetscErrorCode EPSGetMonitorContext(EPS,void**);
251: PETSC_EXTERN PetscErrorCode EPSGetIterationNumber(EPS,PetscInt*);
253: PETSC_EXTERN PetscErrorCode EPSSetWhichEigenpairs(EPS,EPSWhich);
254: PETSC_EXTERN PetscErrorCode EPSGetWhichEigenpairs(EPS,EPSWhich*);
255: PETSC_EXTERN PetscErrorCode EPSSetTrueResidual(EPS,PetscBool);
256: PETSC_EXTERN PetscErrorCode EPSGetTrueResidual(EPS,PetscBool*);
257: PETSC_EXTERN PetscErrorCode EPSSetPurify(EPS,PetscBool);
258: PETSC_EXTERN PetscErrorCode EPSGetPurify(EPS,PetscBool*);
259: PETSC_EXTERN PetscErrorCode EPSSetEigenvalueComparison(EPS,PetscErrorCode (*func)(PetscScalar,PetscScalar,PetscScalar,PetscScalar,PetscInt*,void*),void*);
260: PETSC_EXTERN PetscErrorCode EPSSetArbitrarySelection(EPS,PetscErrorCode (*func)(PetscScalar,PetscScalar,Vec,Vec,PetscScalar*,PetscScalar*,void*),void*);
261: PETSC_EXTERN PetscErrorCode EPSIsGeneralized(EPS,PetscBool*);
262: PETSC_EXTERN PetscErrorCode EPSIsHermitian(EPS,PetscBool*);
263: PETSC_EXTERN PetscErrorCode EPSIsPositive(EPS,PetscBool*);
265: PETSC_EXTERN PetscErrorCode EPSMonitorFirst(EPS,PetscInt,PetscInt,PetscScalar*,PetscScalar*,PetscReal*,PetscInt,PetscViewerAndFormat*);
266: PETSC_EXTERN PetscErrorCode EPSMonitorAll(EPS,PetscInt,PetscInt,PetscScalar*,PetscScalar*,PetscReal*,PetscInt,PetscViewerAndFormat*);
267: PETSC_EXTERN PetscErrorCode EPSMonitorConverged(EPS,PetscInt,PetscInt,PetscScalar*,PetscScalar*,PetscReal*,PetscInt,SlepcConvMonitor);
268: PETSC_EXTERN PetscErrorCode EPSMonitorLGCreate(MPI_Comm,const char[],const char[],int,int,int,int,PetscDrawLG*);
269: PETSC_EXTERN PetscErrorCode EPSMonitorLG(EPS,PetscInt,PetscInt,PetscScalar*,PetscScalar*,PetscReal*,PetscInt,void*);
270: PETSC_EXTERN PetscErrorCode EPSMonitorLGAll(EPS,PetscInt,PetscInt,PetscScalar*,PetscScalar*,PetscReal*,PetscInt,void*);
272: PETSC_EXTERN PetscErrorCode EPSSetTrackAll(EPS,PetscBool);
273: PETSC_EXTERN PetscErrorCode EPSGetTrackAll(EPS,PetscBool*);
275: PETSC_EXTERN PetscErrorCode EPSSetDeflationSpace(EPS,PetscInt,Vec*);
276: PETSC_EXTERN PetscErrorCode EPSSetInitialSpace(EPS,PetscInt,Vec*);
278: PETSC_EXTERN PetscErrorCode EPSSetOptionsPrefix(EPS,const char*);
279: PETSC_EXTERN PetscErrorCode EPSAppendOptionsPrefix(EPS,const char*);
280: PETSC_EXTERN PetscErrorCode EPSGetOptionsPrefix(EPS,const char*[]);
282: PETSC_EXTERN PetscFunctionList EPSList;
283: PETSC_EXTERN PetscErrorCode EPSRegister(const char[],PetscErrorCode(*)(EPS));
285: PETSC_EXTERN PetscErrorCode EPSSetWorkVecs(EPS,PetscInt);
286: PETSC_EXTERN PetscErrorCode EPSAllocateSolution(EPS,PetscInt);
288: /* --------- options specific to particular eigensolvers -------- */
290: /*E
291: EPSPowerShiftType - determines the type of shift used in the Power iteration
293: Level: advanced
295: .seealso: EPSPowerSetShiftType(), EPSPowerGetShiftType()
296: E*/
297: typedef enum { EPS_POWER_SHIFT_CONSTANT,
298: EPS_POWER_SHIFT_RAYLEIGH,
299: EPS_POWER_SHIFT_WILKINSON } EPSPowerShiftType;
300: PETSC_EXTERN const char *EPSPowerShiftTypes[];
302: PETSC_EXTERN PetscErrorCode EPSPowerSetShiftType(EPS,EPSPowerShiftType);
303: PETSC_EXTERN PetscErrorCode EPSPowerGetShiftType(EPS,EPSPowerShiftType*);
304: PETSC_EXTERN PetscErrorCode EPSPowerSetNonlinear(EPS,PetscBool);
305: PETSC_EXTERN PetscErrorCode EPSPowerGetNonlinear(EPS,PetscBool*);
306: PETSC_EXTERN PetscErrorCode EPSPowerSetUpdate(EPS,PetscBool);
307: PETSC_EXTERN PetscErrorCode EPSPowerGetUpdate(EPS,PetscBool*);
308: PETSC_EXTERN PetscErrorCode EPSPowerSetSNES(EPS,SNES);
309: PETSC_EXTERN PetscErrorCode EPSPowerGetSNES(EPS,SNES*);
311: PETSC_EXTERN PetscErrorCode EPSArnoldiSetDelayed(EPS,PetscBool);
312: PETSC_EXTERN PetscErrorCode EPSArnoldiGetDelayed(EPS,PetscBool*);
314: PETSC_EXTERN PetscErrorCode EPSKrylovSchurSetRestart(EPS,PetscReal);
315: PETSC_EXTERN PetscErrorCode EPSKrylovSchurGetRestart(EPS,PetscReal*);
316: PETSC_EXTERN PetscErrorCode EPSKrylovSchurSetLocking(EPS,PetscBool);
317: PETSC_EXTERN PetscErrorCode EPSKrylovSchurGetLocking(EPS,PetscBool*);
318: PETSC_EXTERN PetscErrorCode EPSKrylovSchurSetPartitions(EPS,PetscInt);
319: PETSC_EXTERN PetscErrorCode EPSKrylovSchurGetPartitions(EPS,PetscInt*);
320: PETSC_EXTERN PetscErrorCode EPSKrylovSchurSetDetectZeros(EPS,PetscBool);
321: PETSC_EXTERN PetscErrorCode EPSKrylovSchurGetDetectZeros(EPS,PetscBool*);
322: PETSC_EXTERN PetscErrorCode EPSKrylovSchurSetDimensions(EPS,PetscInt,PetscInt,PetscInt);
323: PETSC_EXTERN PetscErrorCode EPSKrylovSchurGetDimensions(EPS,PetscInt*,PetscInt*,PetscInt*);
324: PETSC_EXTERN PetscErrorCode EPSKrylovSchurSetSubintervals(EPS,PetscReal*);
325: PETSC_EXTERN PetscErrorCode EPSKrylovSchurGetSubintervals(EPS,PetscReal**);
326: PETSC_EXTERN PetscErrorCode EPSKrylovSchurGetInertias(EPS,PetscInt*,PetscReal**,PetscInt**);
327: PETSC_EXTERN PetscErrorCode EPSKrylovSchurGetSubcommInfo(EPS,PetscInt*,PetscInt*,Vec*);
328: PETSC_EXTERN PetscErrorCode EPSKrylovSchurGetSubcommPairs(EPS,PetscInt,PetscScalar*,Vec);
329: PETSC_EXTERN PetscErrorCode EPSKrylovSchurGetSubcommMats(EPS,Mat*,Mat*);
330: PETSC_EXTERN PetscErrorCode EPSKrylovSchurUpdateSubcommMats(EPS,PetscScalar,PetscScalar,Mat,PetscScalar,PetscScalar, Mat,MatStructure,PetscBool);
332: /*E
333: EPSLanczosReorthogType - determines the type of reorthogonalization
334: used in the Lanczos method
336: Level: advanced
338: .seealso: EPSLanczosSetReorthog(), EPSLanczosGetReorthog()
339: E*/
340: typedef enum { EPS_LANCZOS_REORTHOG_LOCAL,
341: EPS_LANCZOS_REORTHOG_FULL,
342: EPS_LANCZOS_REORTHOG_SELECTIVE,
343: EPS_LANCZOS_REORTHOG_PERIODIC,
344: EPS_LANCZOS_REORTHOG_PARTIAL,
345: EPS_LANCZOS_REORTHOG_DELAYED } EPSLanczosReorthogType;
346: PETSC_EXTERN const char *EPSLanczosReorthogTypes[];
348: PETSC_EXTERN PetscErrorCode EPSLanczosSetReorthog(EPS,EPSLanczosReorthogType);
349: PETSC_EXTERN PetscErrorCode EPSLanczosGetReorthog(EPS,EPSLanczosReorthogType*);
351: PETSC_EXTERN PetscErrorCode EPSBlzpackSetBlockSize(EPS,PetscInt);
352: PETSC_EXTERN PetscErrorCode EPSBlzpackSetNSteps(EPS,PetscInt);
354: /*E
355: EPSPRIMMEMethod - determines the method selected in the PRIMME library
357: Level: advanced
359: .seealso: EPSPRIMMESetMethod(), EPSPRIMMEGetMethod()
360: E*/
361: typedef enum { EPS_PRIMME_DYNAMIC=1,
362: EPS_PRIMME_DEFAULT_MIN_TIME,
363: EPS_PRIMME_DEFAULT_MIN_MATVECS,
364: EPS_PRIMME_ARNOLDI,
365: EPS_PRIMME_GD,
366: EPS_PRIMME_GD_PLUSK,
367: EPS_PRIMME_GD_OLSEN_PLUSK,
368: EPS_PRIMME_JD_OLSEN_PLUSK,
369: EPS_PRIMME_RQI,
370: EPS_PRIMME_JDQR,
371: EPS_PRIMME_JDQMR,
372: EPS_PRIMME_JDQMR_ETOL,
373: EPS_PRIMME_SUBSPACE_ITERATION,
374: EPS_PRIMME_LOBPCG_ORTHOBASIS,
375: EPS_PRIMME_LOBPCG_ORTHOBASISW } EPSPRIMMEMethod;
376: PETSC_EXTERN const char *EPSPRIMMEMethods[];
378: PETSC_EXTERN PetscErrorCode EPSPRIMMESetBlockSize(EPS,PetscInt);
379: PETSC_EXTERN PetscErrorCode EPSPRIMMEGetBlockSize(EPS,PetscInt*);
380: PETSC_EXTERN PetscErrorCode EPSPRIMMESetMethod(EPS,EPSPRIMMEMethod);
381: PETSC_EXTERN PetscErrorCode EPSPRIMMEGetMethod(EPS,EPSPRIMMEMethod*);
383: PETSC_EXTERN PetscErrorCode EPSGDSetKrylovStart(EPS,PetscBool);
384: PETSC_EXTERN PetscErrorCode EPSGDGetKrylovStart(EPS,PetscBool*);
385: PETSC_EXTERN PetscErrorCode EPSGDSetBlockSize(EPS,PetscInt);
386: PETSC_EXTERN PetscErrorCode EPSGDGetBlockSize(EPS,PetscInt*);
387: PETSC_EXTERN PetscErrorCode EPSGDSetRestart(EPS,PetscInt,PetscInt);
388: PETSC_EXTERN PetscErrorCode EPSGDGetRestart(EPS,PetscInt*,PetscInt*);
389: PETSC_EXTERN PetscErrorCode EPSGDSetInitialSize(EPS,PetscInt);
390: PETSC_EXTERN PetscErrorCode EPSGDGetInitialSize(EPS,PetscInt*);
391: PETSC_EXTERN PetscErrorCode EPSGDSetBOrth(EPS,PetscBool);
392: PETSC_EXTERN PetscErrorCode EPSGDGetBOrth(EPS,PetscBool*);
393: PETSC_EXTERN PetscErrorCode EPSGDSetDoubleExpansion(EPS,PetscBool);
394: PETSC_EXTERN PetscErrorCode EPSGDGetDoubleExpansion(EPS,PetscBool*);
396: PETSC_EXTERN PetscErrorCode EPSJDSetKrylovStart(EPS,PetscBool);
397: PETSC_EXTERN PetscErrorCode EPSJDGetKrylovStart(EPS,PetscBool*);
398: PETSC_EXTERN PetscErrorCode EPSJDSetBlockSize(EPS,PetscInt);
399: PETSC_EXTERN PetscErrorCode EPSJDGetBlockSize(EPS,PetscInt*);
400: PETSC_EXTERN PetscErrorCode EPSJDSetRestart(EPS,PetscInt,PetscInt);
401: PETSC_EXTERN PetscErrorCode EPSJDGetRestart(EPS,PetscInt*,PetscInt*);
402: PETSC_EXTERN PetscErrorCode EPSJDSetInitialSize(EPS,PetscInt);
403: PETSC_EXTERN PetscErrorCode EPSJDGetInitialSize(EPS,PetscInt*);
404: PETSC_EXTERN PetscErrorCode EPSJDSetFix(EPS,PetscReal);
405: PETSC_EXTERN PetscErrorCode EPSJDGetFix(EPS,PetscReal*);
406: PETSC_EXTERN PetscErrorCode EPSJDSetConstCorrectionTol(EPS,PetscBool);
407: PETSC_EXTERN PetscErrorCode EPSJDGetConstCorrectionTol(EPS,PetscBool*);
408: PETSC_EXTERN PetscErrorCode EPSJDSetBOrth(EPS,PetscBool);
409: PETSC_EXTERN PetscErrorCode EPSJDGetBOrth(EPS,PetscBool*);
411: PETSC_EXTERN PetscErrorCode EPSRQCGSetReset(EPS,PetscInt);
412: PETSC_EXTERN PetscErrorCode EPSRQCGGetReset(EPS,PetscInt*);
414: PETSC_EXTERN PetscErrorCode EPSLOBPCGSetBlockSize(EPS,PetscInt);
415: PETSC_EXTERN PetscErrorCode EPSLOBPCGGetBlockSize(EPS,PetscInt*);
416: PETSC_EXTERN PetscErrorCode EPSLOBPCGSetRestart(EPS,PetscReal);
417: PETSC_EXTERN PetscErrorCode EPSLOBPCGGetRestart(EPS,PetscReal*);
418: PETSC_EXTERN PetscErrorCode EPSLOBPCGSetLocking(EPS,PetscBool);
419: PETSC_EXTERN PetscErrorCode EPSLOBPCGGetLocking(EPS,PetscBool*);
421: /*E
422: EPSCISSQuadRule - determines the quadrature rule in the CISS solver
424: Level: advanced
426: .seealso: EPSCISSSetQuadRule(), EPSCISSGetQuadRule()
427: E*/
428: typedef enum { EPS_CISS_QUADRULE_TRAPEZOIDAL=1,
429: EPS_CISS_QUADRULE_CHEBYSHEV } EPSCISSQuadRule;
430: PETSC_EXTERN const char *EPSCISSQuadRules[];
432: /*E
433: EPSCISSExtraction - determines the extraction technique in the CISS solver
435: Level: advanced
437: .seealso: EPSCISSSetExtraction(), EPSCISSGetExtraction()
438: E*/
439: typedef enum { EPS_CISS_EXTRACTION_RITZ,
440: EPS_CISS_EXTRACTION_HANKEL } EPSCISSExtraction;
441: PETSC_EXTERN const char *EPSCISSExtractions[];
443: PETSC_EXTERN PetscErrorCode EPSCISSSetExtraction(EPS,EPSCISSExtraction);
444: PETSC_EXTERN PetscErrorCode EPSCISSGetExtraction(EPS,EPSCISSExtraction*);
445: PETSC_EXTERN PetscErrorCode EPSCISSSetQuadRule(EPS,EPSCISSQuadRule);
446: PETSC_EXTERN PetscErrorCode EPSCISSGetQuadRule(EPS,EPSCISSQuadRule*);
447: PETSC_EXTERN PetscErrorCode EPSCISSSetRegion(EPS,PetscScalar,PetscReal,PetscReal);
448: PETSC_EXTERN PetscErrorCode EPSCISSGetRegion(EPS,PetscScalar*,PetscReal*,PetscReal*);
449: PETSC_EXTERN PetscErrorCode EPSCISSSetSizes(EPS,PetscInt,PetscInt,PetscInt,PetscInt,PetscInt,PetscBool);
450: PETSC_EXTERN PetscErrorCode EPSCISSGetSizes(EPS,PetscInt*,PetscInt*,PetscInt*,PetscInt*,PetscInt*,PetscBool*);
451: PETSC_EXTERN PetscErrorCode EPSCISSSetThreshold(EPS,PetscReal,PetscReal);
452: PETSC_EXTERN PetscErrorCode EPSCISSGetThreshold(EPS,PetscReal*,PetscReal*);
453: PETSC_EXTERN PetscErrorCode EPSCISSSetRefinement(EPS,PetscInt,PetscInt);
454: PETSC_EXTERN PetscErrorCode EPSCISSGetRefinement(EPS,PetscInt*,PetscInt*);
455: PETSC_EXTERN PetscErrorCode EPSCISSSetUseST(EPS,PetscBool);
456: PETSC_EXTERN PetscErrorCode EPSCISSGetUseST(EPS,PetscBool*);
457: PETSC_EXTERN PetscErrorCode EPSCISSGetKSPs(EPS,PetscInt*,KSP**);
459: PETSC_EXTERN PetscErrorCode EPSBLOPEXSetBlockSize(EPS,PetscInt);
460: PETSC_EXTERN PetscErrorCode EPSBLOPEXGetBlockSize(EPS,PetscInt*);
462: PETSC_EXTERN PetscErrorCode EPSFEASTSetNumPoints(EPS,PetscInt);
463: PETSC_EXTERN PetscErrorCode EPSFEASTGetNumPoints(EPS,PetscInt*);
465: #endif