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

Wed Jun  9 13:05:29 2010