Index Page
cspice_bodvcd
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_BODVCD returns from the kernel pool the double precision values  
   of an item associated with a body, where the body is specified by an 
   integer ID code.

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

I/O

   
   Given:
   
      body   the scalar NAIF integer ID code for a body of interest.
             For example, if the body is the earth, the code is
             399.

      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_bodvcd, 699, '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_bodvcd signals an error if the kernel pool
   lacks the necessary data. Either initiate a catch handler:
   
      catch, err
         if err eq 0 then cspice_bodvcd, 699, "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_bodvcd, 699, 'RADII', 3, radii
      endif

Particulars


   None.

Required Reading


   ICY.REQ
   NAIF_IDS.REQ

Version


   -Icy Version 1.0.0, 25-OCT-2005, 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