naginterfaces.library.blas.zrotgc

naginterfaces.library.blas.zrotgc(a, b)[source]

zrotgc generates a complex Givens plane rotation having real cosine.

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

https://www.nag.com/numeric/nl/nagdoc_28.7/flhtml/f06/f06caf.html

Parameters
acomplex

The value , the first element of the vector which determines the rotation.

bcomplex

The value , the second element of the vector which determines the rotation.

Returns
acomplex

The value .

bcomplex

The value , the tangent of the rotation.

cfloat

The value , the cosine of the rotation.

scomplex

The value , the sine of the rotation.

Notes

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

zrotgc generates a complex Givens plane rotation with parameters (real ) and (complex), such that, given complex and :

If is real, then is also real. On exit, is overwritten by , the tangent of the rotation; and can be reconstructed from the single stored value , by a subsequent call to zcsg().

If , where is the machine precision, the function sets and .

Note that is always set to , unless overflow would occur, in which case the function returns the value of the complex expression

is the float value given by .