Coordinate Transformations (GNU Octave (version 10.0.90))

### 17.8 Coordinate Transformations ¶

: `[theta, r] =` cart2pol `(x, y)` ¶
: `[theta, r, z] =` cart2pol `(x, y, z)` ¶
: `[theta, r] =` cart2pol `(C)` ¶
: `[theta, r, z] =` cart2pol `(C)` ¶

  Transform Cartesian coordinates to polar or cylindrical coordinates.

  The inputs x, y (, and z) must be the same shape, or scalar. If called with a single matrix argument then each row of C represents the Cartesian coordinate pair (x, y) or triplet (x, y, z).

  The outputs theta, r (, and z) match the shape of the inputs. For a matrix input C the outputs will be column vectors with rows corresponding to the rows of the input matrix.

  theta describes the angle relative to the positive x-axis measured in the xy-plane.

  r is the distance to the z-axis (0, 0, z).

  z, if present, is unchanged by the transformation.

  The coordinate transformation is computed using:

      theta = arctan (y / x)
      r = sqrt (x^2 + y^2)
      z = z

  Note: For MATLAB compatibility, this function no longer returns a full coordinate matrix when called with a single return argument.

  See also: pol2cart, cart2sph, sph2cart.

: `[x, y] =` pol2cart `(theta, r)` ¶
: `[x, y, z] =` pol2cart `(theta, r, z)` ¶
: `[x, y] =` pol2cart `(P)` ¶
: `[x, y, z] =` pol2cart `(P)` ¶

  Transform polar or cylindrical coordinates to Cartesian coordinates.

  The inputs theta, r, (and z) must be the same shape, or scalar. If called with a single matrix argument then each row of P represents the polar coordinate pair (theta, r) or the cylindrical triplet (theta, r, z).

  The outputs x, y (, and z) match the shape of the inputs. For a matrix input P the outputs will be column vectors with rows corresponding to the rows of the input matrix.

  theta describes the angle relative to the positive x-axis measured in the xy-plane.

  r is the distance to the z-axis (0, 0, z).

  z, if present, is unchanged by the transformation.

  The coordinate transformation is computed using:

      x = r * cos (theta)
      y = r * sin (theta)
      z = z

  Note: For MATLAB compatibility, this function no longer returns a full coordinate matrix when called with a single return argument.

  See also: cart2pol, sph2cart, cart2sph.

: `[theta, phi, r] =` cart2sph `(x, y, z)` ¶
: `[theta, phi, r] =` cart2sph `(C)` ¶

  Transform Cartesian coordinates to spherical coordinates.

  The inputs x, y, and z must be the same shape, or scalar. If called with a single matrix argument then each row of C must represent a Cartesian coordinate triplet (x, y, z).

  The outputs theta, phi, r match the shape of the inputs. For a matrix input C the outputs will be column vectors with rows corresponding to the rows of the input matrix.

  theta describes the azimuth angle relative to the positive x-axis measured in the xy-plane.

  phi is the elevation angle measured relative to the xy-plane.

  r is the distance to the origin (0, 0, 0).

  The coordinate transformation is computed using:

      theta = arctan (y / x)
      phi = arctan (z / sqrt (x^2 + y^2))
      r = sqrt (x^2 + y^2 + z^2)

  Note: For MATLAB compatibility, this function no longer returns a full coordinate matrix when called with a single return argument.

  See also: sph2cart, cart2pol, pol2cart.

: `[x, y, z] =` sph2cart `(theta, phi, r)` ¶
: `[x, y, z] =` sph2cart `(S)` ¶

  Transform spherical coordinates to Cartesian coordinates.

  The inputs theta, phi, and r must be the same shape, or scalar. If called with a single matrix argument then each row of S must represent a spherical coordinate triplet (theta, phi, r).

  The outputs x, y, z match the shape of the inputs. For a matrix input S the outputs are column vectors with rows corresponding to the rows of the input matrix.

  theta describes the azimuth angle relative to the positive x-axis measured in the xy-plane.

  phi is the elevation angle measured relative to the xy-plane.

  r is the distance to the origin (0, 0, 0).

  The coordinate transformation is computed using:

      x = r * cos (phi) * cos (theta)
      y = r * cos (phi) * sin (theta)
      z = r * sin (phi)

  Note: For MATLAB compatibility, this function no longer returns a full coordinate matrix when called with a single return argument.

  See also: cart2sph, pol2cart, cart2pol.