This is a pre-release version (latest).Go to latest (1.18.0)
{ } Raw JSON

bundles / scipy latest / scipy / linalg / _flapack / dtgexc

lapack_function

scipy.linalg._flapack:dtgexc

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 dtgexc).

Parameters

a : ndarray

Upper (quasi-)triangular factor of the pencil, shape (n, n).

b : ndarray

Upper triangular factor of the pencil, shape (n, n).

q : ndarray

Left Schur vectors; updated when wantq is nonzero.

z : ndarray

Right Schur vectors; updated when wantz is nonzero.

ifst : int

Current position of the diagonal block to move, 1-based.

ilst : int

Position 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, optional

If nonzero, the left transformation is accumulated into q. Default is 1.

wantz : int, optional

If nonzero, the right transformation is accumulated into z. Default is 1.

lwork : int, optional

Workspace size, at least 4 * n + 16; -1 requests the query. Default is 4 * n + 16. The complex flavors need no workspace and take no lwork.

overwrite_a : int, optional

If nonzero, a may be overwritten in place. Default is 0.

overwrite_b : int, optional

If nonzero, b may be overwritten in place. Default is 0.

overwrite_q : int, optional

If nonzero, q may be overwritten in place. Default is 0.

overwrite_z : int, optional

If nonzero, z may be overwritten in place. Default is 0.

Returns

a : ndarray

The reordered first factor.

b : ndarray

The reordered second factor.

q : ndarray

The updated left Schur vectors.

z : ndarray

The updated right Schur vectors.

work : ndarray

Workspace; work[0] holds the optimal lwork. The complex flavors do not return it.

info : int

0 on success; if negative, the -info-th argument had an illegal value.

Aliases

  • scipy.linalg._flapack.dtgexc