naginterfaces.library.blas.zutsqr

naginterfaces.library.blas.zutsqr(side, k1, k2, c, s, a)

zutsqr performs a $QR$ or $RQ$ factorization of the product of a complex upper triangular matrix and a complex matrix of plane rotations.

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

https://support.nag.com/numeric/nl/nagdoc_30.2/flhtml/f06/f06ttf.html

Parameters

sidestr, length 1

Specifies whether $P$ is applied from the left or the right in the transformation.

$side=\text{'L'}$

$P$ is applied from the left.

$side=\text{'R'}$

$P$ is applied from the right.

k1int

The value $k_1$.

k2int

The value $k_2$.

cfloat, array-like, shape $(k2-1)$

$c\left[\text{k}\right]$ must hold the cosine of the rotation $P_{\text{k}}$, for $\text{k}={\text{k}}_1,\dots ,{\text{k}}_2-1$.

scomplex, array-like, shape $(k2-1)$

$s\left[\text{k}\right]$ must hold the sine of the rotation $P_{\text{k}}$, for $\text{k}={\text{k}}_1,\dots ,{\text{k}}_2-1$.

acomplex, array-like, shape $(n,n)$

The $n\times n$ upper triangular matrix $U$.

Returns

cfloat, ndarray, shape $(k2-1)$

$c\left[\text{k}\right]$ holds the cosine of the rotation $Q_{\text{k}}$, for $\text{k}={\text{k}}_1,\dots ,{\text{k}}_2-1$.

scomplex, ndarray, shape $(k2-1)$

$s\left[\text{k}\right]$ holds the sine of the rotation $Q_{\text{k}}$, for $\text{k}={\text{k}}_1,\dots ,{\text{k}}_2-1$.

acomplex, ndarray, shape $(n,n)$

The upper triangular matrix $R$.

Raises

NagValueError

(errno $1$)

On entry, error in parameter $side$.

Constraint: $side=\text{'L'}$ or $\text{'R'}$.

(errno $2$)

On entry, error in parameter $\text{n}$.

Constraint: $n\ge 0$.

Notes

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

zutsqr performs one of the transformations

$$R\leftarrow PU{Q}^H\text{or}R\leftarrow QU{P}^H\text{,}$$

where $U$ is a given $n\times n$ complex upper triangular matrix, $P$ is a given complex unitary matrix, and $Q$ is a complex unitary matrix chosen to make $R$ upper triangular. Both $P$ and $Q$ are represented as sequences of plane rotations in planes $k_1$ to $k_2$.

If $side=\text{'L'}$,

$$R\leftarrow PU{Q}^H\text{,}$$

where $P=P_{k_2-1}\dots P_{k_1+1}{P}_{k_1}$ and $Q=Q_{k_2-1}\dots Q_{k_1+1}{Q}_{k_1}$.

If $side=\text{'R'}$,

$$R\leftarrow QU{P}^H\text{,}$$

where $P=P_{k_1}{P}_{k_1+1}\dots P_{k_2-1}$ and $Q=Q_{k_1}{Q}_{k_1+1}\dots Q_{k_2-1}$.

In either case $P_k$ and $Q_k$ are rotations in the $(k,k+1)$ plane.

The $2\times 2$ rotation part of $P_k$ or $Q_k$ has the form

$$\begin{array}{c}\left(\begin{array}{cc}{c}_k& {\overline{s}}_k\\ -s_k& c_k\end{array}\right)\end{array}$$

with $c_k$ real.