CSPICE_FRMNAM retrieves the name of a reference frame associated with a
SPICE frame ID code.
frcode value defining a SPICE reference frame ID code.
[1,n] = size(frcode); int32 = class(frcode)
frmname = cspice_frmnam( frcode )
frmnam the frame name corresponding to the 'frcode' code.
[n,m] = size(frmnam); char = class(frmnam)
If frcode is not recognized as the name of a known reference
frame, 'frname' will be returned as an empty string.
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.
% Retrieve frame information for a scalar code.
code = 13000;
% Output the frame name corresponding to 'code'.
frmname = cspice_frmnam( code )
% Retrieve frame information for a vector of codes.
codes = [1:5];
% Output the frame names corresponding to the 'codes'.
frmname = cspice_frmnam( codes )
This routine retrieves the name of a reference frame associated
with a SPICE frame ID code.
The ID codes stored locally are scanned for a match with frcode.
If a match is found, the name stored locally will be returned
as the name for the frame.
If frcode is not a member of the list of internally stored
ID codes, the kernel pool will be examined to see if the
is present (where idcode is the decimal character equivalent
of frcode). If the variable is located and it has both
character type and dimension 1, the string value of the
kernel pool variable is returned as the name of the reference
Note that because the local information is always examined
first and searches of the kernel pool are performed only
after exhausting local information, it is not possible to
override the local name for any reference frame that is
known by this routine.
For important details concerning this module's function, please refer to
the CSPICE routine frmnam_c.
-Mice Version 1.0.0, 12-MAR-2012, EDW (JPL), SCK (JPL)
frame ID code to frame name translation