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

bundles / scipy latest / scipy / linalg / _flapack / stgsyl

lapack_function

scipy.linalg._flapack:stgsyl

source: build-install/usr/lib/python3.14/site-packages/scipy/linalg/_flapack.cpython-314-x86_64-linux-gnu.so

Summary

Solve the generalized Sylvester equations (LAPACK stgsyl).

Extended Summary

Solves a @ r - l @ b == scale * c together with d @ r - l @ e == scale * f for the pair (r, l), which overwrites (c, f). The .pyf declares only the real flavors.

Parameters

a : ndarray

Upper quasi-triangular matrix of shape (m, m).

b : ndarray

Upper quasi-triangular matrix of shape (n, n).

c : ndarray

Right-hand side of the first equation, shape (m, n).

d : ndarray

Upper triangular matrix of shape (m, m).

e : ndarray

Upper triangular matrix of shape (n, n).

f : ndarray

Right-hand side of the second equation, shape (m, n).

trans : str, optional

'N' for the equations above, 'T' for the transposed pair. Default is 'N'.

ijob : int, optional

0 solves only; 1 through 4 also estimate dif, by different methods. Default is 0.

lwork : int, optional

Workspace size. Only ijob of 1 or 2 with trans == 'N' needs the full 2 * m * n; the rest get by with n. Default is 2 * m * n.

overwrite_c : int, optional

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

overwrite_f : int, optional

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

Returns

r : ndarray

First component of the solution, overwriting c.

l : ndarray

Second component of the solution, overwriting f.

scale : float

Scale factor, at most 1, chosen to avoid overflow in the solution.

dif : float

Estimate of the separation of the two pencils; 0 unless ijob asked for it.

info : int

0 on success; if negative, the -info-th argument had an illegal value; 1 if the pencils have common or very close eigenvalues.

Aliases

  • scipy.linalg._flapack.stgsyl