- Abstract
Load the variables contained in a NAIF ASCII kernel file into the
kernel pool.
- Required_Reading
kernel
- Brief_I/O
VARIABLE I/O DESCRIPTION
-------- --- --------------------------------------------------
filename I Name of the kernel file.
- Detailed_Input
filename is the name of the kernel file whose variables will be
loaded into the pool.
- Detailed_Output
None.
- Parameters
None.
- Particulars
Text kernels input to this routine need not have native line
terminators for the platform. Lower level CSPICE routines can
read and process non-native text files. This functionality does
not exist in the Fortran SPICELIB.
Only text kernel readers include the non-native read capability,
(ldpool_c and furnsh_c), the generic text file line reader, rdtext_c
requires native text files.
Please refer to kernel.req for additiional information.
- Examples
The following code fragment demonstrates how the data from
several kernel files can be loaded into a kernel pool. After the
pool is loaded, the values in the pool are written to a kernel
file.
/.
Store in an array the names of the kernel files whose
values will be loaded into the kernel pool.
./
kernel [0] = "AXES.KER";
kernel [1] = "GM.KER";
kernel [2] = "LEAP_SECONDS.KER";
/.
Clear the kernel pool. (This is optional.)
./
clpool_c();
/.
Load the variables from the three kernel files into the
the kernel pool.
./
for ( i = 0; i < 3; i++ )
{
ldpool_c ( kernel [i] );
}
- Restrictions
None.
- Exceptions
1) The error SPICE(EMPTYSTRING) is signalled if the input
string does not contain at least one character, since the
input string cannot be converted to a Fortran-style string
in this case.
2) The error SPICE(NULLPOINTER) is signalled if the input string
pointer is null.
- Files
The NAIF ASCII kernel file kernel is opened by rdknew_.
- Author_and_Institution
R.E. Thurman (JPL)
I.M. Underwood (JPL)
W.L. Taber (JPL)
E.D. Wright (JPL)
- Literature_References
kernel.req
- Version
-CSPICE 2.0.1 17-OCT-2005 (EDW)
Added text to Particulars section informing of the
non-native kernel text file reading capability.
-CSPICE Version 2.0.0, 08-FEB-1998 (NJB)
Input argument kernel was changed to type ConstSpiceChar * and
was given the new name "filename."
Re-implemented routine without dynamically allocated, temporary
strings. Made several corrections to the code example. Renamed
the argument "filename" to "kernel" for consistency with the
header comments.
-CSPICE Version 1.0.0, 25-OCT-1997 (EDW)
- Index_Entries
LOAD variables from a text kernel file into the pool
- Link to routine source