scipy.linalg.lapack.stgsyl

scipy.linalg.lapack.stgsyl(a, b, c, d, e, f, trans='N', ijob=0, lwork=2 * m * n, overwrite_c=0, overwrite_f=0) = <flapack function stgsyl>

Solve the generalized Sylvester equations (LAPACK stgsyl).

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:

andarray

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

bndarray

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

cndarray

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

dndarray

Upper triangular matrix of shape (m, m).

endarray

Upper triangular matrix of shape (n, n).

fndarray

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

transstr, optional

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

ijobint, optional

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

lworkint, 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_cint, optional

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

overwrite_fint, optional

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

Returns:

rndarray

First component of the solution, overwriting c.

lndarray

Second component of the solution, overwriting f.

scalefloat

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

diffloat

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

infoint

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