Index Page
cspice_bodvrd
A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X 

Abstract
I/O
Examples
Particulars
Required Reading
Version
Index_Entries

Abstract


   CSPICE_BODVRD returns from the kernel pool the double precision values  
   of an item associated with a body.

   For important details concerning this module's function, please refer to
   the CSPICE routine bodvrd_c.

I/O

   
   Given:
   
      body   the scalar string name of the body for which the data 'item'
             is requested, the string lacks case sensitivity
   
      item   the scalar string naming the property of 'body' to return,
             e.g. RADII, GM, POLE_RA
   
                 Note: 'item' *is* case-sensitive.  This attribute 
                 is inherited from the case-sensitivity of kernel 
                 variable names. 
   
      maxn   the scalar integer maximum number of values to return, this value
             must equal or exceed the size of requested kernel variable 'item'
    
    returns:
   
      values   an array of the double precision values associated with
               the variable
               
                  Note: 'values' returns a vector even when 'item' refers 
                  to a scalar, i.e. a scalar returns in 'values[0]'.
   

Examples


   Any numerical results shown for this example may differ between
   platforms as the results depend on the SPICE kernels used as input
   and the machine specific arithmetic implementation.

   
      ;;
      ;; Load a SPICE PCK file containing body data.
      ;;
      cspice_furnsh, '/kernels/gen/pck/pck00007.tpc'
   
      ;;
      ;; Retrieve the radius vector of Saturn.
      ;;
      cspice_bodvrd, 'SATURN', "RADII", 5, radii
      print, radii
   
   IDL outputs:
   
      60268.000       60268.000       54364.000
   
   The radii vector of Saturn expressed in kilometers as 
   recorded in pck00007.tpc.
   
   Note: cspice_bodvrd signals an error if the kernel pool
   lacks the necessary data. Either initiate a catch handler:
   
      catch, err
         if err eq 0 then cspice_bodvrd, 'SATURN', "RADII", 5, radii
      catch, /cancel
   
   or test for the existence of the kernel data with cspice_bodfnd
   (the NAIF ID for Saturn has the value 699):
   
      ;;
      ;; A clunky test, based on body ID.
      ;;
      found = cspice_bodfnd( 699, "RADII" )

      if (found) then begin
         cspice_bodvrd, 'SATURN', "RADII", 3, radii
      endif

Particulars


   None.

Required Reading


   ICY.REQ
   NAIF_IDS.REQ

Version


   -Icy Version 1.0.0, 16-JUN-2003, EDW (JPL)

Index_Entries

 
   fetch constants for a body from the kernel pool 
   physical constants for a body 
 



Wed Apr  5 17:57:59 2017