bundles / scipy latest / scipy / linalg / _flapack / stgexc
lapack_function
scipy.linalg._flapack:stgexc
source: build-install/usr/lib/python3.14/site-packages/scipy/linalg/_flapack.cpython-314-x86_64-linux-gnu.so
Summary
Reorder a generalized Schur decomposition by moving one diagonal block (LAPACK stgexc).
Parameters
a: ndarrayUpper (quasi-)triangular factor of the pencil, shape
(n, n).b: ndarrayUpper triangular factor of the pencil, shape
(n, n).q: ndarrayLeft Schur vectors; updated when wantq is nonzero.
z: ndarrayRight Schur vectors; updated when wantz is nonzero.
ifst: intCurrent position of the diagonal block to move, 1-based.
ilst: intPosition to move it to, 1-based. LAPACK adjusts both when a block turns out to be 2x2; the adjusted values are not returned.
wantq: int, optionalIf nonzero, the left transformation is accumulated into q. Default is 1.
wantz: int, optionalIf nonzero, the right transformation is accumulated into z. Default is 1.
lwork: int, optionalWorkspace size, at least
4 * n + 16; -1 requests the query. Default is4 * n + 16. The complex flavors need no workspace and take no lwork.overwrite_a: int, optionalIf nonzero, a may be overwritten in place. Default is 0.
overwrite_b: int, optionalIf nonzero,
bmay be overwritten in place. Default is 0.overwrite_q: int, optionalIf nonzero, q may be overwritten in place. Default is 0.
overwrite_z: int, optionalIf nonzero,
zmay be overwritten in place. Default is 0.
Returns
a: ndarrayThe reordered first factor.
b: ndarrayThe reordered second factor.
q: ndarrayThe updated left Schur vectors.
z: ndarrayThe updated right Schur vectors.
work: ndarrayWorkspace;
work[0]holds the optimal lwork. The complex flavors do not return it.info: int0 on success; if negative, the
-info-th argument had an illegal value.
Aliases
scipy.linalg._flapack.stgexc