naginterfaces.library.matop.complex_​gen_​rq_​formq

naginterfaces.library.matop.complex_gen_rq_formq(wheret, m, nrowp, a, theta)[source]

complex_gen_rq_formq returns the first rows of the unitary matrix , where is given as the product of Householder transformation matrices.

This function is intended for use following complex_gen_rq().

For full information please refer to the NAG Library document for f01rk

https://www.nag.com/numeric/nl/nagdoc_28.4/flhtml/f01/f01rkf.html

Parameters
wheretstr, length 1

Indicates where the elements of are to be found.

(In )

The elements of are in .

(Separate)

The elements of are separate from , in .

mint

, the number of rows of the matrix .

nrowpint

, the required number of rows of .

If , an immediate return is effected.

acomplex, array-like, shape

The leading strictly lower triangular part of the array , and the rectangular part of with top left-hand corner at element must contain details of the matrix . In addition, if , the diagonal elements of must contain the elements of .

thetacomplex, array-like, shape

Note: the required length for this argument is determined as follows: if : ; otherwise: .

If , the array must contain the elements of . If , is assumed to be , if and , is assumed to be of the form

otherwise is assumed to contain given by

If , the array is not referenced.

Returns
acomplex, ndarray, shape

The first rows of the array are overwritten by the first rows of the unitary matrix .

Raises
NagValueError
(errno )

On entry, , and .

Constraint: .

(errno )

On entry, and .

Constraint: and .

(errno )

On entry, and .

Constraint: .

(errno )

On entry, .

Constraint: .

(errno )

On entry, .

Constraint: or .

Notes

No equivalent traditional C interface for this routine exists in the NAG Library.

is assumed to be given by

where

is a scalar for which , is a real scalar, is a element vector and is an element vector. must be supplied in the th row of in elements . must be supplied in the th row of in elements and , given by

must be supplied either in or in , depending upon the argument .

References

Golub, G H and Van Loan, C F, 1996, Matrix Computations, (3rd Edition), Johns Hopkins University Press, Baltimore

Wilkinson, J H, 1965, The Algebraic Eigenvalue Problem, Oxford University Press, Oxford