sphlat_c

Index Page sphlat_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 sphlat_c ( SpiceDouble     r,
                       SpiceDouble     colat,
                       SpiceDouble     lons,
                       SpiceDouble   * radius,
                       SpiceDouble   * lon,
                       SpiceDouble   * lat )
#### Abstract
       Convert from spherical coordinates to latitudinal coordinates.
#### Required_Reading
       None.
#### Keywords
       CONVERSION, COORDINATES
#### Brief_I/O
       VARIABLE  I/O  DESCRIPTION
       --------  ---  --------------------------------------------------
       r          I   Distance of the point from the origin.
       colat      I   Angle of the point from positive z axis (radians).
       lons       I   Angle of the point from the XZ plane (radians).
       radius     O   Distance of a point from the origin
       lon        O   Angle of the point from the XZ plane in radians
       lat        O   Angle of the point from the XY plane in radians
#### Detailed_Input
       r          Distance of the point from the origin.

       colat      Angle between the vector from the origin to the point
                  and the positive z axis in radians.

       lons       Angle of the point from the XZ plane (radians).
#### Detailed_Output
       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
#### Parameters
       None.
#### Exceptions
       Error free.
#### Files
       None.
#### Particulars
       This routine returns the latitudinal coordinates of a point
       whose position is input in spherical 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.

       Spherical coordinates are defined by a distance from a central
       reference point, an angle from a reference meridian, and an angle
       from the z-axis.
#### Examples
       Latitude is obtained by subtracting co-latitude from HALFPI()
       Radius and longitude mean the same thing in both latitudinal
       and spherical coordinates.  The table below lists lat and
       corresponding colat in terms of degrees.

               lat            colat
              ------         ------
                0             90
               20             70
               45             45
              -30            120
               90              0
              -45            135
#### Restrictions
       None.
#### Literature_References
       None.
#### Author_and_Institution
       W.L. Taber      (JPL)
#### Version
       -CSPICE Version 1.0.0, 08-FEB-1998   (EDW)
#### Index_Entries
       spherical to latitudinal coordinates
#### Link to routine sphlat_c source file sphlat_c.c

    Thu Apr 16 08:59:09 2009