latcyl_c

Index Page latcyl_c
A B C D E F G H I J K L M N O P Q R S T U V W X
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 latcyl_c ( SpiceDouble    radius,
                       SpiceDouble    lon,
                       SpiceDouble    lat,
                       SpiceDouble *  r,
                       SpiceDouble *  lonc,
                       SpiceDouble *  z )
#### Abstract
       Convert from latitudinal coordinates to cylindrical coordinates.
#### Required_Reading
       None.
#### Keywords
       CONVERSION,  COORDINATES
#### Brief_I/O
       VARIABLE  I/O  DESCRIPTION
       --------  ---  --------------------------------------------------
       radius     I   Distance of a point from the origin.
       lon        I   Angle of the point from the XZ plane in radians.
       lat        I   Angle of the point from the XY plane in radians.
       r          O   Distance of the point from the z axis.
       lonc       O   Angle of the point from the XZ plane in radians.
       z          O   Height of the point above the XY plane.
#### Detailed_Input
       radius     Distance of a point from the origin.

       lon        Angle of the point from the XZ plane in radians.

       lat        Angle of the point from the XY plane in radians.
#### Detailed_Output
       r          Distance of the point from the z axis.

       lonc       Angle of the point from the XZ plane in radians.

       z          Height of the point above the XY plane.
#### Parameters
       None.
#### Exceptions
       Error free.
#### Files
       None.
#### Particulars
       This routine returns the cylindrical coordinates of a point
       whose position is input in latitudinal coordinates.

       Latitudinal coordinates are defined by a distance from a central
       reference point, an angle from a reference meridian, and an angle
       above the equator of a sphere centered at the central reference
       point.
#### Examples
       Other than the obvious conversion between coordinate systems
       this routine could be used to obtain the axial projection
       from a sphere to a cylinder about the z-axis that contains
       the equator of the sphere.  The following code fragment
       illustrates this idea.

             latcyl_c ( radius,  lon, lat, &r,  &lon, &z );
             r = radius;

       r,  lon, and z now contain the coordinates of the projected
       point. Such a projection is valuable because it preserves the
       areas between regions on the sphere and their projections to the
       cylinder.
#### Restrictions
       None.
#### Literature_References
       None.
#### Author_and_Institution
       E.D. Wright     (JPL)
       W.L. Taber      (JPL)
#### Version
       -CSPICE Version 1.0.0, 08-FEB-1998 (EDW)
#### Index_Entries
       latitudinal to cylindrical coordinates
#### Link to routine latcyl_c source file latcyl_c.c

    Thu Apr 16 08:58:28 2009