cylsph_c

 Procedure Abstract Required_Reading Keywords Brief_I/O Detailed_Input Detailed_Output Parameters Exceptions Files Particulars Examples Restrictions Literature_References Author_and_Institution Version Index_Entries

#### Procedure

```   void cylsph_c ( SpiceDouble    r,
SpiceDouble    lonc,
SpiceDouble    z,
SpiceDouble *  colat,
SpiceDouble *  lon )

```

#### Abstract

```   Convert from cylindrical to spherical coordinates.
```

```   None.
```

#### Keywords

```   CONVERSION
COORDINATES

```

#### Brief_I/O

```   VARIABLE  I/O  DESCRIPTION
--------  ---  -------------------------------------------------
r          I   Distance of point from z axis.
lonc       I   Angle (radians) of point from XZ plane.
z          I   Height of point above XY plane.
radius     O   Distance of point from origin.
colat      O   Polar angle (co-latitude in radians) of point.
lon        O   Azimuthal angle (longitude) of point (radians).
```

#### Detailed_Input

```   r          Distance of the point of interest from z axis.

lonc       Cylindrical angle (radians) of the point from the
XZ plane.

z          Height of the point above XY plane.
```

#### Detailed_Output

```   radius     Distance of the point from origin.

colat      Polar angle (co-latitude in radians) of the point.
The range of `colat' is [-pi, pi].

lon        Azimuthal angle (longitude) of the point (radians).
`lon' is set equal to `lonc'.
```

#### Parameters

```   None.
```

#### Exceptions

```   Error free.
```

#### Files

```   None.
```

#### Particulars

```   This returns the spherical coordinates of a point whose position
is input through cylindrical coordinates.
```

#### Examples

```   Below are two tables:  The first is a set of input values
the second is the result of the following sequence of
calls to Spicelib routines.  Note all input and output angular
quantities are in degrees.

convrt_c ( lonc, "DEGREES", "RADIANS", lonc  );

cylsph_c ( r, lonc, z, &radius, &colat, &lon );

convrt_c ( lon,  "RADIANS", "DEGREES", lon   );
convrt_c ( lat,  "RADIANS", "DEGREES", lat   );

Inputs:                         Results:

r        lonc     z             radius   lon      colat
------   ------   ------        ------   ------   ------
1.0000     0       0            1.0000     0       90.00
1.0000    90.00    0            1.0000    90.00    90.00
1.0000   180.00    1.000        1.4142   180.00    45.00
1.0000   180.00   -1.000        1.4142   180.00   135.00
0.0000   180.00    1.000        1.0000   180.00     0.00
0.0000    33.00    0            0.0000    33.00     0.00
```

#### Restrictions

```   None.
```

#### Literature_References

```   None.
```

#### Author_and_Institution

```   E.D. Wright     (JPL)
W.L. Taber      (JPL)
```

#### Version

```   -CSPICE Version 1.0.2, 26-JUL-2016 (BVS)

```   cylindrical to spherical
`Wed Apr  5 17:54:30 2017`