# cart_to_polar (MathScript RT Module Function)

LabVIEW 2012 MathScript RT Module Help

Edition Date: June 2012

Part Number: 373123C-01

»View Product Info Download Help (Windows Only)

Owning Class: basic

Requires: MathScript RT Module

## Syntax

[a, b] = cart_to_polar(x, y)

[a, b, c] = cart_to_polar(x, y, z)

Legacy Name: `cart2pol`

## Description

Transforms 2D or 3D Cartesian coordinates into polar or cylindrical data, respectively. cart_to_polar performs an element-wise transformation for matrices.

Details

Examples

## Inputs

Name Description
x Specifies the x-coordinates. x is a matrix of double-precision, floating-point numbers.
y Specifies the y-coordinates. y is a matrix of double-precision, floating-point numbers of the same size as x.
z Specifies the z-coordinates. z is a matrix of double-precision, floating-point numbers of the same size as x.

## Outputs

Name Description
a Returns the angles of the polar or cylindrical data. a is a matrix of the same size as x.
b Returns the radii of the polar or cylindrical data. b is a matrix of the same size as x.
c Returns the heights of the cylindrical data. c is a matrix of the same size as x.

## Details

If you provide 2D coordinates, LabVIEW performs the transformation using the following equations:
a = atan2(y, x)
b = sqrt(x.^2+y.^2)

If you provide 3D coordinates, LabVIEW performs the transformation using the following equations:
a = atan2(y, x)
b = sqrt(x.^2+y.^2)
c = z

The following table lists the support characteristics of this function.

 Supported in the LabVIEW Run-Time Engine Yes Supported on RT targets Yes Suitable for bounded execution times on RT Yes

## Examples

[A, B, C] = cart_to_polar(1, 1, 1)