qr_insert#
- scipy.linalg.qr_insert(Q, R, u, k, which='row', rcond=None, overwrite_qru=False, check_finite=True)#
行或列插入时的 QR 更新
如果
A = Q R
是A
的 QR 分解,则返回在行或列k
处插入行或列后的A
的 QR 分解。本文档假设数组参数具有指定的“核心”形状。然而,此函数的数组参数可能在核心形状前附加额外的“批处理”维度。在这种情况下,数组被视为低维切片的批处理;有关详细信息,请参阅 批处理线性运算。
- 参数:
- Q(M, M) 数组类型
来自 A 的 QR 分解的酉/正交矩阵。
- R(M, N) 数组类型
来自 A 的 QR 分解的上三角矩阵。
- u(N,), (p, N), (M,), 或 (M, p) 数组类型
要插入的行或列
- k整数
在 u 之前插入的索引。
- which: {‘row’, ‘col’},可选
确定是插入行还是列,默认为 ‘row’
- rcond浮点数
Q
加上u/||u||
的倒数条件数的下界。仅在更新经济模式(瘦模式,(M,N) (N,N))分解时使用。如果为 None,则使用机器精度。默认为 None。- overwrite_qru布尔值,可选
如果为 True,则在执行更新时尽可能消耗 Q、R 和 u,否则在必要时进行复制。默认为 False。
- check_finite布尔值,可选
是否检查输入矩阵仅包含有限数。禁用此选项可能会提高性能,但如果输入包含无穷大或 NaN,则可能会导致问题(崩溃、无法终止)。默认为 True。
- 返回:
- Q1ndarray
更新后的酉/正交因子
- R1ndarray
更新后的上三角因子
- 引发:
- LinAlgError
如果正在更新 (M,N) (N,N) 分解,并且 Q 加上
u/||u||
的倒数条件数小于 rcond。
另请参阅
备注
此例程不保证
R1
的对角线元素为正。0.16.0 版本新增。
参考文献
[1]Golub, G. H. & Van Loan, C. F. Matrix Computations, 3rd Ed. (Johns Hopkins University Press, 1996).
[2]Daniel, J. W., Gragg, W. B., Kaufman, L. & Stewart, G. W. Reorthogonalization and stable algorithms for updating the Gram-Schmidt QR factorization. Math. Comput. 30, 772-795 (1976).
[3]Reichel, L. & Gragg, W. B. Algorithm 686: FORTRAN Subroutines for Updating the QR Decomposition. ACM Trans. Math. Softw. 16, 369-377 (1990).
示例
>>> import numpy as np >>> from scipy import linalg >>> a = np.array([[ 3., -2., -2.], ... [ 6., -7., 4.], ... [ 7., 8., -6.]]) >>> q, r = linalg.qr(a)
给定此 QR 分解,当插入 2 行时更新 q 和 r。
>>> u = np.array([[ 6., -9., -3.], ... [ -3., 10., 1.]]) >>> q1, r1 = linalg.qr_insert(q, r, u, 2, 'row') >>> q1 array([[-0.25445668, 0.02246245, 0.18146236, -0.72798806, 0.60979671], # may vary (signs) [-0.50891336, 0.23226178, -0.82836478, -0.02837033, -0.00828114], [-0.50891336, 0.35715302, 0.38937158, 0.58110733, 0.35235345], [ 0.25445668, -0.52202743, -0.32165498, 0.36263239, 0.65404509], [-0.59373225, -0.73856549, 0.16065817, -0.0063658 , -0.27595554]]) >>> r1 array([[-11.78982612, 6.44623587, 3.81685018], # may vary (signs) [ 0. , -16.01393278, 3.72202865], [ 0. , 0. , -6.13010256], [ 0. , 0. , 0. ], [ 0. , 0. , 0. ]])
此更新是等效的,但比以下方法更快。
>>> a1 = np.insert(a, 2, u, 0) >>> a1 array([[ 3., -2., -2.], [ 6., -7., 4.], [ 6., -9., -3.], [ -3., 10., 1.], [ 7., 8., -6.]]) >>> q_direct, r_direct = linalg.qr(a1)
检查我们是否得到等效结果
>>> np.dot(q1, r1) array([[ 3., -2., -2.], [ 6., -7., 4.], [ 6., -9., -3.], [ -3., 10., 1.], [ 7., 8., -6.]])
>>> np.allclose(np.dot(q1, r1), a1) True
并且更新后的 Q 仍然是酉矩阵
>>> np.allclose(np.dot(q1.T, q1), np.eye(5)) True