naginterfaces.library.blas.zutsrh¶
- naginterfaces.library.blas.zutsrh(side, k1, k2, c, s, a)[source]¶
zutsrh
transforms a complex upper triangular matrix to an upper Hessenberg matrix by applying a given sequence of plane rotations.For full information please refer to the NAG Library document for f06tv
https://support.nag.com/numeric/nl/nagdoc_30.2/flhtml/f06/f06tvf.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.
- 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 upper triangular matrix . The imaginary parts of the diagonal elements must be zero.
- Returns
- sfloat, ndarray, shape
holds , the subdiagonal element of , for .
- acomplex, ndarray, shape
The upper triangular part of the upper Hessenberg matrix .
- Raises
- NagValueError
- (errno )
On entry, error in parameter .
Constraint: or .
- (errno )
On entry, error in parameter .
Constraint: .
- Notes
No equivalent traditional C interface for this routine exists in the NAG Library.
zutsrh
transforms an complex upper triangular matrix with real diagonal elements, to an upper Hessenberg matrix , by applying a given sequence of plane rotations from either the left or the right, in planes to ; has real nonzero subdiagonal elements , for only.If , the rotations are applied from the left:
where .
If , the rotations are applied from the right:
where .
In either case, is a rotation in the plane.
The plane rotation part of has the form
with real.