naginterfaces.library.blas.zgesrs

naginterfaces.library.blas.zgesrs(side, pivot, direct, m, k1, k2, c, s, a)[source]

zgesrs applies to a complex rectangular matrix a sequence of plane rotations having real sines and complex cosines.

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

https://www.nag.com/numeric/nl/nagdoc_29.3/flhtml/f06/f06tyf.html

Parameters
sidestr, length 1

Specifies whether is operated on from the left or the right.

is pre-multiplied from the left.

is post-multiplied from the right.

pivotstr, length 1

Specifies the plane rotated by .

(variable pivot)

rotates the plane.

(top pivot)

rotates the plane.

(bottom pivot)

rotates the plane.

directstr, length 1

Specifies the sequence direction.

(forward sequence)

.

(backward sequence)

.

mint

, the number of rows of the matrix .

k1int

The value .

k2int

The value .

ccomplex, array-like, shape

must hold , the cosine of the rotation , for .

sfloat, array-like, shape

must hold , the sine of the rotation , for .

acomplex, array-like, shape

The matrix .

Returns
acomplex, ndarray, shape

The transformed matrix .

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: or .

(errno )

On entry, error in parameter .

Constraint: .

(errno )

On entry, error in parameter .

Constraint: .

Notes

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

zgesrs performs the transformation

where is an complex matrix and is a complex unitary matrix, defined as a sequence of complex plane rotations, , with real sines, applied in planes to .

The plane rotation part of is assumed to have the form

with real.