DSSort#
Sorts the result of DSSolve() according to a given sorting criterion.
Synopsis#
Logically Collective
Input Parameters#
ds - the direct solver context
rr - (optional) array containing auxiliary values (real part)
ri - (optional) array containing auxiliary values (imaginary part)
Input/Output Parameters#
eigr - array containing the computed eigenvalues (real part)
eigi - array containing the computed eigenvalues (imaginary part)
k - (optional) number of elements in the leading group
Notes#
This routine sorts the arrays provided in eigr and eigi, and also sorts the dense system stored inside ds (assumed to be in condensed form). The sorting criterion is specified with DSSetSlepcSC().
If arrays rr and ri are provided, then a (partial) reordering based on these values rather than on the eigenvalues is performed. In symmetric problems a total order is obtained (parameter k is ignored), but otherwise the result is sorted only partially. In this latter case, it is only guaranteed that all the first k elements satisfy the comparison with any of the last n-k elements. The output value of parameter k is the final number of elements in the first set.
See Also#
DSSolve(), DSSetSlepcSC(), DSSortWithPermutation()
Level#
intermediate
Location#
Implementations#
DSSort_GHEP() in src/sys/classes/ds/impls/ghep/dsghep.c
DSSort_GHIEP() in src/sys/classes/ds/impls/ghiep/dsghiep.c
DSSort_GNHEP() in src/sys/classes/ds/impls/gnhep/dsgnhep.c
DSSort_GSVD() in src/sys/classes/ds/impls/gsvd/dsgsvd.c
DSSort_HEP() in src/sys/classes/ds/impls/hep/dshep.c
DSSort_HSVD() in src/sys/classes/ds/impls/hsvd/dshsvd.c
DSSort_NEP() in src/sys/classes/ds/impls/nep/dsnep.c
DSSort_NHEP() in src/sys/classes/ds/impls/nhep/dsnhep.c
DSSort_NHEPTS() in src/sys/classes/ds/impls/nhepts/dsnhepts.c
DSSort_PEP() in src/sys/classes/ds/impls/pep/dspep.c
DSSort_SVD() in src/sys/classes/ds/impls/svd/dssvd.c
Index of all DS routines Table of Contents for all manual pages Index of all manual pages