cpolar(hx [,unwind:F or crit:val]), hx a REAL matrix representing complex data, val a REAL scalar, 0.5 < val <= 1 |

cpolar(cx) computes the polar form of the fully complex matrix cx, storing it in pseudo fully complex form, with the amplitude or absolute value as the real part and the phase as imaginary part. Thus creal(cpolar(cx)) and cimag(cpolar(cx)) return REAL matrices whose columns are the amplitudes and phases of the complex series represented by pairs of columns of cx. See topic 'complex' for information on complex matrices in MacAnova. The value of the computed phase is in radians, degrees or cycles depending on the value of option 'angles'. See subtopic 'options:"angles"'. By default the phase is "unwound" so as to minimize discontinuities arising from wrap-around. cpolar(cx,crit:Val), where .5 <= Val < 1 changes the criterion controlling "unwinding". The default is .75. See unwind() for details. cpolar(cx,unwind:F) suppresses the unwinding. See also hpolar(), crect(), hrect(). See topic 'complex' for discussion of complex matrices in MacAnova.

Gary Oehlert 2003-01-15