Next: cprdc() Up: MacAnova Help File Previous: cosh()   Contents


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

Keywords: time series, complex arithmetic
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