# cartopol~

Convert Cartesian values to polar format. Angles are in radians.

## Description

Converts a cartesian-coordinate pair consisting of real and imaginary values into a polar-coordinate pair consisting of distance and angle values.

## Arguments

### y [auto]

The y coordinate of a Cartesian pair to be converted into a polar coordinate pair consisting of distance and angle values. When used in an audio context, the value represents the imaginary part of a frequency domain value to be converted into a polar coordinate pair consisting of amplitude and phase values.

## Inlets

### x [auto]

The x coordinate of a Cartesian pair to be converted into a polar coordinate pair consisting of distance and angle values. When used in an audio context, the value represents the real part of a frequency domain value to be converted into a polar coordinate pair consisting of amplitude and phase values.

### y [auto]

The y coordinate of a Cartesian pair to be converted into a polar coordinate pair consisting of distance and angle values. When used in an audio context, the value represents the imaginary part of a frequency domain value to be converted into a polar coordinate pair consisting of amplitude and phase values.

## Outlets

### out1 [signal]

The distance portion of the polar coordinate pair. When used in an audio context, the value represents the magnitude (amplitude) of the frequency represented by the currently input.

### out2 [signal]

The angle portion of the polar coordinate pair. When used in an audio context, the value represents the phase, expressed in radians, of the frequency represented by the current input. If only the left outlet is connected, the phase computation is not performed.

## Dynamic Attributes

*
These attributes can be modified in the code during execution using the
set
object
*

### reset [bang] (default: 0)

Banging this attribute will reset the object to its default state.

### x [auto]

The x coordinate of a Cartesian pair to be converted into a polar coordinate pair consisting of distance and angle values. When used in an audio context, the value represents the real part of a frequency domain value to be converted into a polar coordinate pair consisting of amplitude and phase values.

### y [auto]

The y coordinate of a Cartesian pair to be converted into a polar coordinate pair consisting of distance and angle values. When used in an audio context, the value represents the imaginary part of a frequency domain value to be converted into a polar coordinate pair consisting of amplitude and phase values.

## See Also

Name | Description |
---|---|

cartopol~ | Convert Cartesian values to polar format. Angles are in radians. |

cartopol~ | |

fftstream~ | Fast Fourier Transform |

poltocar~ | Convert polar to cartesian coordinates |

poltocar | Convert polar to cartesian coordinates |