CSPICE_BODVRD fetches from the kernel pool the double
precision values of an item associated with a body.
bodynm the body name for which 'item' is requested.
[1,c1] = size(bodynm); char = class(bodynm)
[1,1] = size(bodynm); cell = class(bodynm)
'bodynm' is case-insensitive, and leading
and trailing blanks in 'bodynm' are not significant.
Optionally, you may supply the integer ID code for the
object as an integer string. For example both 'MOON'
and '301' are legitimate strings that indicate the
moon is the body of interest.
item the item name to return.
[1,c2] = size(item); char = class(item)
[1,1] = size(item); cell = class(item)
Together, the NAIF ID code of the body and the item name
combine to form a kernel variable name, e.g.,
The values associated with the kernel variable having
the name constructed as shown are sought. Below
we'll take the shortcut of calling this kernel variable
the "requested kernel variable."
Note that 'item' *is* case-sensitive. This attribute
is inherited from the case-sensitivity of kernel
maxn the maximum number of kernel pool values to returns.
[1,1] = size(maxn); int32 = class(maxn)
values = cspice_bodvrd(body, item, maxn)
values an array of at most 'maxn' values associated with the
requested kernel variable.
[1,n] = size(values); double = class(values)
with n <= 'maxn'.
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 set of kernels: an SPK file, a PCK
% file and a leapseconds file. Use a meta
% kernel for convenience.
cspice_furnsh( 'standard.tm' )
% When the kernel variable
% is present in the kernel pool---normally because a PCK
% defining this variable has been loaded (as is the case
% here)---the call
values1 = cspice_bodvrd( 'EARTH', 'RADII', 3)
% returns the dimension and values associated with the
% variable "BODY399_RADII".
% The call lacks case sensitivity in the 'bodynm' variable.
values2 = cspice_bodvrd( 'earth', 'RADII', 3)
% The 'item' variable possesses case sensitivity.
% A call with improper case in 'item' will fail.
values3 = cspice_bodvrd( 'EARTH', 'radii', 3)
% Catch the error, return the error string to the user.
disp( 'Expected error signaled:' )
disp( ' ' )
disp( lasterr )
% It's always good form to unload kernels after use,
% particularly in MATLAB due to data persistence.
Expected error signaled:
SPICE(KERNELVARNOTFOUND): [bodvrd_c->BODVRD] The variable
BODY399_radii could not be found in the kernel pool.
For important details concerning this module's function, please refer to
the CSPICE routine bodvrd_c.
-Mice Version 1.0.1, 29-OCT-2014, EDW (JPL)
Edited I/O section to conform to NAIF standard for Mice documentation.
-Mice Version 1.0.0, 22-NOV-2005, EDW (JPL)
fetch constants for a body from the kernel pool
physical constants for a body