scipy.linalg.

ordqz#

scipy.linalg.ordqz(A, B, sort='lhp', output='real', overwrite_a=False, overwrite_b=False, check_finite=True)[source]#

用于一对矩阵的重新排序的 QZ 分解。

本文档假定数组参数具有指定的“核心”形状。但是,此函数的数组参数可能在核心形状前附加额外的“批处理”维度。在这种情况下,数组被视为低维切片的批处理;详情请参阅批处理线性运算

参数:
A(N, N) 类似数组

要分解的二维数组

B(N, N) 类似数组

要分解的二维数组

sort{可调用对象, ‘lhp’, ‘rhp’, ‘iuc’, ‘ouc’},可选

指定是否应对上部特征值进行排序。可以传递一个可调用对象,给定一个有序对 (alpha, beta) 来表示特征值 x = (alpha/beta),该对象返回一个布尔值,表示特征值是否应排序到左上角 (True)。对于实数矩阵对,beta 是实数,而 alpha 可以是复数;对于复数矩阵对,alphabeta 都可以是复数。该可调用对象必须能够接受 NumPy 数组。或者,可以使用字符串参数

  • ‘lhp’ 左半平面 (x.real < 0.0)

  • ‘rhp’ 右半平面 (x.real > 0.0)

  • ‘iuc’ 单位圆内 (x*x.conjugate() < 1.0)

  • ‘ouc’ 单位圆外 (x*x.conjugate() > 1.0)

使用预定义的排序函数,无限特征值(即 alpha != 0beta = 0)被认为既不在左半平面也不在右半平面,但被认为在单位圆外。对于特征值 (alpha, beta) = (0, 0),所有预定义的排序函数都返回 False

outputstr {‘real’,’complex’},可选

为实矩阵构造实数或复数 QZ 分解。默认值为 ‘real’。

overwrite_a布尔值,可选

如果为 True,则 A 的内容将被覆盖。

overwrite_b布尔值,可选

如果为 True,则 B 的内容将被覆盖。

check_finite布尔值,可选

如果为 True,则检查 AB 的元素是否为有限数。如果为 False,则不进行检查并将矩阵直接传递给底层算法。

返回:
AA(N, N) ndarray

A 的广义 Schur 形式。

BB(N, N) ndarray

B 的广义 Schur 形式。

alpha(N,) ndarray

alpha = alphar + alphai * 1j。参见说明。

beta(N,) ndarray

参见说明。

Q(N, N) ndarray

左 Schur 向量。

Z(N, N) ndarray

右 Schur 向量。

另请参阅

qz

说明

退出时,(ALPHAR(j) + ALPHAI(j)*i)/BETA(j), j=1,...,N 将是广义特征值。ALPHAR(j) + ALPHAI(j)*iBETA(j),j=1,...,N 是复数 Schur 形式 (S,T) 的对角线,如果 (A,B) 的实数广义 Schur 形式的 2x2 对角块使用复数酉变换进一步约化为三角形形式,则会得到该对角线。如果 ALPHAI(j) 为零,则第 j 个特征值为实数;如果为正,则第 j 个和第 (j+1) 个特征值是一对复共轭对,其中 ALPHAI(j+1) 为负。

在版本 0.17.0 中添加。

示例

>>> import numpy as np
>>> from scipy.linalg import ordqz
>>> A = np.array([[2, 5, 8, 7], [5, 2, 2, 8], [7, 5, 6, 6], [5, 4, 4, 8]])
>>> B = np.array([[0, 6, 0, 0], [5, 0, 2, 1], [5, 2, 6, 6], [4, 7, 7, 7]])
>>> AA, BB, alpha, beta, Q, Z = ordqz(A, B, sort='lhp')

由于我们已对左半平面特征值进行排序,负值会排在前面

>>> (alpha/beta).real < 0
array([ True,  True, False, False], dtype=bool)