a new object with type S, a subtype of T
|
|
|
appendOptionsPrefix(self,
prefix)
Appends to the prefix used for searching for all EPS options
in the database. |
|
|
|
cancelMonitor(self)
Clears all monitors for an EPS object. |
|
|
|
computeError(self,
int i,
etype=None)
Computes the error (based on the residual norm) associated with the i-th
computed eigenpair. |
|
|
|
create(self,
comm=None)
Creates the EPS object. |
|
|
|
destroy(self)
Destroys the EPS object. |
|
|
|
errorView(self,
etype=None,
Viewer viewer=None)
Displays the errors associated with the computed solution
(as well as the eigenvalues). |
|
|
|
getArnoldiDelayed(self)
Gets the type of reorthogonalization used during the Arnoldi
iteration. |
|
|
|
getBV(self)
Obtain the basis vector objects associated to the eigensolver. |
|
|
|
getBalance(self)
Gets the balancing type used by the EPS object,
and the associated parameters. |
|
|
|
|
|
getCISSKSPs(self)
Retrieve the array of linear solver objects associated with
the CISS solver. |
|
|
|
|
|
getCISSRefinement(self)
Gets the values of various refinement parameters in the CISS solver. |
|
|
|
getCISSSizes(self)
Gets the values of various size parameters in the CISS solver. |
|
|
|
getCISSThreshold(self)
Gets the values of various threshold parameters in the CISS solver. |
|
|
|
getCISSUseST(self)
Gets the flag for using the ST object in the CISS solver. |
|
|
|
|
|
|
|
getConvergenceTest(self)
Return the method used to compute the error estimate
used in the convergence test. |
|
|
|
getDS(self)
Obtain the direct solver associated to the eigensolver. |
|
|
|
getDimensions(self)
Gets the number of eigenvalues to compute and the dimension of
the subspace. |
|
|
|
getEigenpair(self,
int i,
Vec Vr=None,
Vec Vi=None)
Gets the i-th solution of the eigenproblem as computed by
solve(). |
|
|
|
|
|
|
|
getErrorEstimate(self,
int i)
Returns the error estimate associated to the i-th computed
eigenpair. |
|
|
|
getExtraction(self)
Gets the extraction type used by the EPS object. |
|
|
|
getGDBOrth(self)
Returns the orthogonalization used in the search subspace in
case of generalized Hermitian problems. |
|
|
|
getGDBlockSize(self)
Gets the number of vectors to be added to the searching space
in every iteration. |
|
|
|
getGDDoubleExpansion(self)
Gets a flag indicating whether the double expansion variant
has been activated or not. |
|
|
|
|
|
getGDKrylovStart(self)
Gets a flag indicating if the search subspace is started with a
Krylov basis. |
|
|
|
getGDRestart(self)
Gets the number of vectors of the search space after restart and
the number of vectors saved from the previous iteration. |
|
|
|
getInterval(self)
Gets the computational interval for spectrum slicing. |
|
|
|
|
|
|
|
getJDBOrth(self)
Returns the orthogonalization used in the search subspace in
case of generalized Hermitian problems. |
|
|
|
getJDBlockSize(self)
Gets the number of vectors to be added to the searching space
in every iteration. |
|
|
|
getJDConstCorrectionTol(self)
Returns the flag indicating if the dynamic stopping is being used for
solving the correction equation. |
|
|
|
getJDFix(self)
Gets the threshold for changing the target in the correction equation. |
|
|
|
|
|
getJDKrylovStart(self)
Gets a flag indicating if the search subspace is started with a
Krylov basis. |
|
|
|
getJDRestart(self)
Gets the number of vectors of the search space after restart and
the number of vectors saved from the previous iteration. |
|
|
|
|
|
getKrylovSchurDimensions(self)
Gets the dimensions used for each subsolve step in case of doing
spectrum slicing for a computational interval. |
|
|
|
getKrylovSchurInertias(self)
Gets the values of the shifts and their corresponding inertias
in case of doing spectrum slicing for a computational interval. |
|
|
|
getKrylovSchurKSP(self)
Retrieve the linear solver object associated with the internal EPS
object in case of doing spectrum slicing for a computational interval. |
|
|
|
|
|
|
|
|
|
getKrylovSchurSubcommInfo(self)
Gets information related to the case of doing spectrum slicing
for a computational interval with multiple communicators. |
|
|
|
getKrylovSchurSubcommMats(self)
Gets the eigenproblem matrices stored internally in the subcommunicator
to which the calling process belongs. |
|
|
|
getKrylovSchurSubcommPairs(self,
int i,
Vec V)
Gets the i-th eigenpair stored internally in the multi-communicator
to which the calling process belongs. |
|
|
|
getKrylovSchurSubintervals(self)
Returns the points that delimit the subintervals used
in spectrum slicing with several partitions. |
|
|
|
|
|
|
|
|
|
|
|
|
|
getLyapIIRanks(self)
Return the rank values used for the Lyapunov step. |
|
|
|
getMonitor(self)
Gets the list of monitor functions. |
|
|
|
getOperators(self)
Gets the matrices associated with the eigenvalue problem. |
|
|
|
getOptionsPrefix(self)
Gets the prefix used for searching for all EPS options in the
database. |
|
|
|
|
|
|
|
getPurify(self)
Returns the flag indicating whether purification is activated
or not. |
|
|
|
getRG(self)
Obtain the region object associated to the eigensolver. |
|
|
|
getRQCGReset(self)
Gets the reset parameter used in the RQCG method. |
|
|
|
getST(self)
Obtain the spectral transformation (ST) object associated to
the eigensolver object. |
|
|
|
getStoppingTest(self)
Gets the stopping function. |
|
|
|
getTarget(self)
Gets the value of the target. |
|
|
|
getTolerances(self)
Gets the tolerance and maximum iteration count used by the
default EPS convergence tests. |
|
|
|
getTrackAll(self)
Returns the flag indicating whether all residual norms must be
computed or not. |
|
|
|
getTrueResidual(self)
Returns the flag indicating whether true residual must be
computed explicitly or not. |
|
|
|
getTwoSided(self)
Returns the flag indicating whether a two-sided variant
of the algorithm is being used or not. |
|
|
|
getType(self)
Gets the EPS type of this object. |
|
|
|
|
|
isGeneralized(self)
Tells whether the EPS object corresponds to a generalized
eigenvalue problem. |
|
|
|
isHermitian(self)
Tells whether the EPS object corresponds to a Hermitian
eigenvalue problem. |
|
|
|
isPositive(self)
Tells whether the EPS object corresponds to an eigenvalue problem
type that requires a positive (semi-) definite matrix B. |
|
|
|
reset(self)
Resets the EPS object. |
|
|
|
setArbitrarySelection(self,
arbitrary,
args=None,
kargs=None)
Sets a function to look for eigenvalues according to an arbitrary selection
criterion. |
|
|
|
setArnoldiDelayed(self,
delayed)
Activates or deactivates delayed reorthogonalization in the
Arnoldi iteration. |
|
|
|
setBV(self,
BV bv)
Associates a basis vectors object to the eigensolver. |
|
|
|
setBalance(self,
balance=None,
iterations=None,
cutoff=None)
Specifies the balancing technique to be employed by the
eigensolver, and some parameters associated to it. |
|
|
|
setCISSExtraction(self,
extraction)
Sets the extraction technique used in the CISS solver. |
|
|
|
setCISSQuadRule(self,
quad)
Sets the quadrature rule used in the CISS solver. |
|
|
|
setCISSRefinement(self,
inner=None,
blsize=None)
Sets the values of various refinement parameters in the CISS solver. |
|
|
|
setCISSSizes(self,
ip=None,
bs=None,
ms=None,
npart=None,
bsmax=None,
realmats=False)
Sets the values of various size parameters in the CISS solver. |
|
|
|
setCISSThreshold(self,
delta=None,
spur=None)
Sets the values of various threshold parameters in the CISS solver. |
|
|
|
setCISSUseST(self,
usest)
Sets a flag indicating that the CISS solver will use the ST
object for the linear solves. |
|
|
|
setConvergenceTest(self,
conv)
Specifies how to compute the error estimate
used in the convergence test. |
|
|
|
setDS(self,
DS ds)
Associates a direct solver object to the eigensolver. |
|
|
|
|
|
setDimensions(self,
nev=None,
ncv=None,
mpd=None)
Sets the number of eigenvalues to compute and the dimension of
the subspace. |
|
|
|
|
|
setExtraction(self,
extraction)
Sets the extraction type used by the EPS object. |
|
|
|
|
|
setGDBOrth(self,
borth)
Selects the orthogonalization that will be used in the search
subspace in case of generalized Hermitian problems. |
|
|
|
setGDBlockSize(self,
bs)
Sets the number of vectors to be added to the searching space
in every iteration. |
|
|
|
setGDDoubleExpansion(self,
doubleexp)
Activate a variant where the search subspace is expanded with
K*[A*x B*x] (double expansion) instead of the classic K*r, where
K is the preconditioner, x the selected approximate eigenvector
and r its associated residual vector. |
|
|
|
setGDInitialSize(self,
initialsize)
Sets the initial size of the searching space. |
|
|
|
setGDKrylovStart(self,
krylovstart=True)
Activates or deactivates starting the search subspace
with a Krylov basis. |
|
|
|
setGDRestart(self,
minv=None,
plusk=None)
Sets the number of vectors of the search space after restart and
the number of vectors saved from the previous iteration. |
|
|
|
setInitialSpace(self,
space)
Sets the initial space from which the eigensolver starts to
iterate. |
|
|
|
setInterval(self,
inta,
intb)
Defines the computational interval for spectrum slicing. |
|
|
|
setJDBOrth(self,
borth)
Selects the orthogonalization that will be used in the search
subspace in case of generalized Hermitian problems. |
|
|
|
setJDBlockSize(self,
bs)
Sets the number of vectors to be added to the searching space
in every iteration. |
|
|
|
setJDConstCorrectionTol(self,
constant)
Deactivates the dynamic stopping criterion that sets the
KSP relative tolerance to 0.5**i , where i is the number
of EPS iterations from the last converged value. |
|
|
|
setJDFix(self,
fix)
Sets the threshold for changing the target in the correction equation. |
|
|
|
setJDInitialSize(self,
initialsize)
Sets the initial size of the searching space. |
|
|
|
setJDKrylovStart(self,
krylovstart=True)
Activates or deactivates starting the search subspace
with a Krylov basis. |
|
|
|
setJDRestart(self,
minv=None,
plusk=None)
Sets the number of vectors of the search space after restart and
the number of vectors saved from the previous iteration. |
|
|
|
setKrylovSchurDetectZeros(self,
detect)
Sets a flag to enforce detection of zeros during the factorizations
throughout the spectrum slicing computation. |
|
|
|
setKrylovSchurDimensions(self,
nev=None,
ncv=None,
mpd=None)
Sets the dimensions used for each subsolve step in case of doing
spectrum slicing for a computational interval. |
|
|
|
setKrylovSchurLocking(self,
lock)
Choose between locking and non-locking variants of the
Krylov-Schur method. |
|
|
|
setKrylovSchurPartitions(self,
npart)
Sets the number of partitions for the case of doing spectrum
slicing for a computational interval with the communicator split
in several sub-communicators. |
|
|
|
setKrylovSchurRestart(self,
keep)
Sets the restart parameter for the Krylov-Schur method, in
particular the proportion of basis vectors that must be kept
after restart. |
|
|
|
|
|
|
|
setLOBPCGLocking(self,
lock)
Choose between locking and non-locking variants of the
LOBPCG method. |
|
|
|
setLOBPCGRestart(self,
restart)
Sets the restart parameter for the LOBPCG method. |
|
|
|
setLanczosReorthogType(self,
reorthog)
Sets the type of reorthogonalization used during the Lanczos
iteration. |
|
|
|
setLeftInitialSpace(self,
space)
Sets the left initial space from which the eigensolver starts to
iterate. |
|
|
|
setLyapIIRanks(self,
rkc=None,
rkl=None)
Set the ranks used in the solution of the Lyapunov equation. |
|
|
|
setMonitor(self,
monitor,
args=None,
kargs=None)
Appends a monitor function to the list of monitors. |
|
|
|
setOperators(self,
Mat A,
Mat B=None)
Sets the matrices associated with the eigenvalue problem. |
|
|
|
setOptionsPrefix(self,
prefix)
Sets the prefix used for searching for all EPS options in the
database. |
|
|
|
setPowerShiftType(self,
shift)
Sets the type of shifts used during the power iteration. |
|
|
|
setProblemType(self,
problem_type)
Specifies the type of the eigenvalue problem. |
|
|
|
setPurify(self,
purify=True)
Activate or deactivate eigenvector purification. |
|
|
|
setRG(self,
RG rg)
Associates a region object to the eigensolver. |
|
|
|
setRQCGReset(self,
nrest)
Sets the reset parameter of the RQCG iteration. |
|
|
|
setST(self,
ST st)
Associates a spectral transformation object to the
eigensolver. |
|
|
|
setStoppingTest(self,
stopping,
args=None,
kargs=None)
Sets a function to decide when to stop the outer iteration of the eigensolver. |
|
|
|
setTarget(self,
target)
Sets the value of the target. |
|
|
|
setTolerances(self,
tol=None,
max_it=None)
Sets the tolerance and maximum iteration count used by the
default EPS convergence tests. |
|
|
|
setTrackAll(self,
trackall)
Specifies if the solver must compute the residual of all
approximate eigenpairs or not. |
|
|
|
setTrueResidual(self,
trueres)
Specifies if the solver must compute the true residual
explicitly or not. |
|
|
|
setTwoSided(self,
twosided)
Sets the solver to use a two-sided variant so that left
eigenvectors are also computed. |
|
|
|
setType(self,
eps_type)
Selects the particular solver to be used in the EPS object. |
|
|
|
setUp(self)
Sets up all the internal data structures necessary for the
execution of the eigensolver. |
|
|
|
|
|
solve(self)
Solves the eigensystem. |
|
|
|
updateKrylovSchurSubcommMats(self,
s=1.0,
a=1.0,
Mat Au=None,
t=1.0,
b=1.0,
Mat Bu=None,
structure=None,
globalup=False)
Update the eigenproblem matrices stored internally in the
subcommunicator to which the calling process belongs. |
|
|
|
valuesView(self,
Viewer viewer=None)
Displays the computed eigenvalues in a viewer. |
|
|
|
vectorsView(self,
Viewer viewer=None)
Outputs computed eigenvectors to a viewer. |
|
|
|
view(self,
Viewer viewer=None)
Prints the EPS data structure. |
|
|
Inherited from petsc4py.PETSc.Object :
__copy__ ,
__deepcopy__ ,
__eq__ ,
__ge__ ,
__gt__ ,
__le__ ,
__lt__ ,
__ne__ ,
__nonzero__ ,
compose ,
decRef ,
getAttr ,
getClassId ,
getClassName ,
getComm ,
getDict ,
getName ,
getRefCount ,
getTabLevel ,
incRef ,
incrementTabLevel ,
query ,
setAttr ,
setName ,
setTabLevel ,
stateGet ,
stateIncrease ,
stateSet ,
viewFromOptions
Inherited from object :
__delattr__ ,
__format__ ,
__getattribute__ ,
__hash__ ,
__init__ ,
__reduce__ ,
__reduce_ex__ ,
__repr__ ,
__setattr__ ,
__sizeof__ ,
__str__ ,
__subclasshook__
|