naginterfaces.library.complex.divide

naginterfaces.library.complex.divide(xr, xi, yr, yi)

divide divides one complex number, $x=(x_r,x_i)$, by a second complex number, $y=(y_r,y_i)$, returning the result in $z=(z_r,z_i)$.

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

https://support.nag.com/numeric/nl/nagdoc_30.2/flhtml/a02/a02acf.html

Parameters

xrfloat

$x_r$, the real part of $x$.

xifloat

$x_i$, the imaginary part of $x$.

yrfloat

$y_r$, the real part of $y$.

yifloat

$y_i$, the imaginary part of $y$.

Returns

zrfloat

$z_r$, the real part of $z$.

zifloat

$z_i$, the imaginary part of $z$.

Notes

In the NAG Library the traditional C interface for this routine uses a different algorithmic base. Please contact NAG if you have any questions about compatibility.

The result $z$ is calculated using Smith’s algorithm with scaling, from Li et al. (2002), which ensures that no unnecessary overflow or underflow occurs at intermediate stages of the computation.

References

Li, X S, Demmel, J W, Bailey, D H, Henry, G, Hida, Y, Iskandar, J, Kahan, W, Kapur, A, Martin, M C, Tung, T and Yoo, D J, 2002, Design, implementation and testing of extended and mixed precision BLAS, ACM Trans. Math. Soft. (28(2)), 152–205