Table of contents
bodvar_c ( Return values from the kernel pool )
void bodvar_c ( SpiceInt body,
ConstSpiceChar * item,
SpiceInt * dim,
SpiceDouble * values )
Deprecated: This routine has been superseded by bodvcd_c and
bodvrd_c. This routine is supported for purposes of backward
Return the values of some item for any body in the
VARIABLE I/O DESCRIPTION
-------- --- --------------------------------------------------
body I ID code of body.
item I Item for which values are desired.
dim O Number of values returned.
values O Values.
body is the ID code of the body for which `item' is
item is the item to be returned. Together, the body and
item name combine to form a variable name, e.g.,
dim is the number of values associated with the variable.
values are the values associated with the variable.
1) If the requested item is not found, the error
SPICE(KERNELVARNOTFOUND) is signaled by a routine in the call
tree of this routine.
2) If the `item' input string pointer is null, the error
SPICE(NULLPOINTER) is signaled.
3) If the `item' input string has zero length, the error
SPICE(EMPTYSTRING) is signaled.
The numerical results shown for this example may differ across
platforms. The results depend on the SPICE kernels used as
input, the compiler and supporting libraries, and the machine
specific arithmetic implementation.
1) Retrieve the Earth's radii values from the kernel pool
Use the PCK kernel below to load the required triaxial
ellipsoidal shape model for the Earth.
Example code begins here.
int main( )
#define BODYID 399
SpiceDouble radii [ 3 ];
Load a PCK file.
furnsh_c( "pck00008.tpc" );
Test if Earth's radii values exist in the
The procedure searches for the kernel variable
found = bodfnd_c( BODYID, "RADII" );
If found, retrieve the values.
if ( found )
bodvar_c( BODYID, "RADII", &dim, radii );
printf ( "%d RADII: %10.3f %10.3f %10.3f\n",
(int)BODYID, radii, radii, radii );
printf ( "No RADII data found for object %d\n",
return ( 0 );
When this program was executed on a Mac/Intel/cc/64-bit
platform, the output was:
399 RADII: 6378.140 6378.140 6356.750
N.J. Bachman (JPL)
J. Diaz del Rio (ODC Space)
B.V. Semenov (JPL)
W.L. Taber (JPL)
I.M. Underwood (JPL)
E.D. Wright (JPL)
-CSPICE Version 2.0.5, 06-AUG-2021 (JDR)
Edited the header to comply with NAIF standard. Added complete
code example. Moved SPK required reading from -Literature_References
to -Required_Reading section.
-CSPICE Version 2.0.4, 19-MAY-2010 (BVS)
Index lines now states that this routine is deprecated.
-CSPICE Version 2.0.3, 27-OCT-2005 (NJB)
Routine is now deprecated.
-CSPICE Version 2.0.2, 08-JAN-2004 (EDW)
Trivial typo corrected.
-CSPICE Version 2.0.1, 08-FEB-1998 (EDW)
Corrected and clarified header entries.
-CSPICE Version 2.0.0, 06-JAN-1998 (NJB)
Input argument item was changed to type ConstSpiceChar *.
References to C2F_CreateStr_Sig were removed; code was
cleaned up accordingly. String checks are now done using
the macro CHKFSTR.
-CSPICE Version 1.0.0, 25-OCT-1997 (EDW) (WLT) (IMU)
DEPRECATED fetch constants for a body from the kernel pool
DEPRECATED physical constants for a body