naginterfaces.library.lapackeig.zunmqr¶
- naginterfaces.library.lapackeig.zunmqr(side, trans, a, tau, c)[source]¶
zunmqr
multiplies an arbitrary complex matrix by the complex unitary matrix from a factorization computed byzgeqrf()
orzgeqp3()
.For full information please refer to the NAG Library document for f08au
https://support.nag.com/numeric/nl/nagdoc_30.3/flhtml/f08/f08auf.html
- Parameters
- sidestr, length 1
Indicates how or is to be applied to .
or is applied to from the left.
or is applied to from the right.
- transstr, length 1
Indicates whether or is to be applied to .
is applied to .
is applied to .
- acomplex, array-like, shape
Note: the required extent for this argument in dimension 1 is determined as follows: if : ; if : ; otherwise: .
Details of the vectors which define the elementary reflectors, as returned by
zgeqrf()
orzgeqp3()
.- taucomplex, array-like, shape
Further details of the elementary reflectors, as returned by
zgeqrf()
orzgeqp3()
.- ccomplex, array-like, shape
The matrix .
- Returns
- ccomplex, ndarray, shape
is overwritten by or or or as specified by and .
- Raises
- NagValueError
- (errno )
On entry, error in parameter .
Constraint: or .
- (errno )
On entry, error in parameter .
Constraint: or .
- (errno )
On entry, error in parameter .
Constraint: .
- (errno )
On entry, error in parameter .
Constraint: .
- (errno )
On entry, error in parameter .
Constraint: .
- (errno )
On entry, error in parameter .
Constraint: .
- Notes
zunmqr
is intended to be used after a call tozgeqrf()
orzgeqp3()
, which perform a factorization of a complex matrix . The unitary matrix is represented as a product of elementary reflectors.This function may be used to form one of the matrix products
overwriting the result on (which may be any complex rectangular matrix).
A common application of this function is in solving linear least squares problems, as described in the F08 Introduction.
- References
Golub, G H and Van Loan, C F, 1996, Matrix Computations, (3rd Edition), Johns Hopkins University Press, Baltimore