void cidfrm_c ( SpiceInt cent,
SpiceInt * frcode,
SpiceChar * frname,
SpiceBoolean * found )
Retrieve frame ID code and name to associate with a frame center.
VARIABLE I/O DESCRIPTION
-------- --- --------------------------------------------------
cent I An object to associate a frame with.
lenout I Available space in output string frname.
frcode O The ID code of the frame associated with cent.
frname O The name of the frame with ID frcode.
found O SPICETRUE if the requested information is available.
cent is the ID code for object for which there is a
preferred reference frame.
lenout is the available space in the output string frname,
including room for the terminating null character.
frcode is the frame ID code to associate with the object
specified by cent.
frname is the name of the frame that should be associated
with the object specified by cent.
found is SPICETRUE if the appropriate frame ID code and frame
name can be determined. Otherwise found is returned
with the value SPICEFALSE.
This routine allows the user to determine the frame that should
be associated with a particular object. For example, if you
need the frame to associate with the Io, you can call cidfrm_c
to determine the frame name and ID code for the bodyfixed frame
The preferred frame to use with an object is specified via one
of the kernel pool variables:
where <cent> is the decimal representation of the integer cent.
For those PCK objects that have "built-in" frame names this
routine returns the corresponding "IAU" frame and frame ID code.
Suppose that you want to determine the state of a target in the
preferred reference frame of some observer. This routine can be
used in conjunction with spkezr_c to compute the state.
#define LENOUT 32
cidfrm_c ( obs, LENOUT, &frcode, frname, &found );
if ( !found )
printf ( "The bodyfixed frame for object %d\n"
"could not be identified.\n",
spkezr_c ( targ, et, frname, abcorr, obs, state, < );
N.J. Bachman (JPL)
W.L. Taber (JPL)
-CSPICE Version 1.0.0, 22-JUL-1999 (NJB) (WLT)
Fetch reference frame attributes