Index Page
ldpool
A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X 

Procedure
Abstract
Required_Reading
Keywords
Declarations
Brief_I/O
Detailed_Input
Detailed_Output
Parameters
Exceptions
Files
Particulars
Examples
Restrictions
Literature_References
Author_and_Institution
Version

Procedure

 LDPOOL ( Load variables from a kernel file into the pool )
 
      ENTRY LDPOOL ( KERNEL )
 

Abstract

     Load the variables contained in a NAIF ASCII kernel file into the
     kernel pool.

Required_Reading

     KERNEL

Keywords

     CONSTANTS
     FILES

Declarations

     CHARACTER*(*)         KERNEL

Brief_I/O

     VARIABLE  I/O  DESCRIPTION
     --------  ---  --------------------------------------------------
     KERNEL     I   Name of the kernel file.

Detailed_Input

     KERNEL     is the name of the kernel file whose variables will be
                loaded into the pool.

Detailed_Output

     None.

Parameters

     None.

Exceptions

     1)  Any I/O errors that occur while opening or reading a text
         kernel will be diagnosed by routines in the call tree of this
         routine.

     2)  Any text kernel parsing errors will be diagnosed by routines
         in the call tree of this routine.

     3)  Any kernel pool overflow errors will be diagnosed by routines
         in the call tree of this routine.

Files

     The NAIF ASCII kernel file KERNEL is opened by RDKNEW.

Particulars

     None.

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.

     C
     C     Store in an array the names of the kernel files whose
     C     values will be loaded into the kernel pool.
     C
           KERNEL (1) = 'AXES.KER'
           KERNEL (2) = 'GM.KER'
           KERNEL (3) = 'LEAP_SECONDS.KER'

     C
     C     Clear the kernel pool. (This is optional.)
     C
           CALL CLPOOL

     C
     C     Load the variables from the three kernel files into the
     C     the kernel pool.
     C
           DO I = 1, 3
             CALL LDPOOL ( KERNEL (I) )
           END DO

     C
     C     We can examine the values associated with any d.p. variable
     C     in the kernel pool using GDPOOL.
     C
           CALL GDPOOL ( VARIABLE, START, ROOM, NVALS, VALUES, FOUND )

     C
     C     Open the new text file 'NEWKERNEL.KER'.
     C
           CALL TXTOPN ( 'NEWKERNEL.KER', UNIT )

     C
     C     Write the values in the kernel pool to the file.
     C
           CALL WRPOOL ( UNIT )

Restrictions

     1) Normally SPICE applications should load kernels via the
        FURNSH entry point of the KEEPER routine.

Literature_References

     None.

Author_and_Institution

     N.J. Bachman    (JPL)
     R.E. Thurman    (JPL)
     I.M. Underwood  (JPL)
     W.L. Taber      (JPL)
     B.V. Semenov    (JPL)

Version

    SPICELIB Version 8.2.0, 30-JUL-2013 (BVS)

        Updated to increment POOL state counter.

    SPICELIB Version 8.1.0, 19-MAR-2009 (NJB)

        Watcher update code was re-written for compatibility
        with new watcher system implementation.

        Filled out Exceptions section of header, which previously
        contained only the word "None."

        Updated code example to use TXTOPN.

    SPICELIB Version 8.0.0, 04-JUN-1999 (WLT)

        Added the entry points PCPOOL, PDPOOL and PIPOOL to allow
        direct insertion of data into the kernel pool without having
        to read an external file.

        Added the interface LMPOOL that allows SPICE
        programs to load text kernels directly from memory
        instead of requiring a text file.

        Added the entry point SZPOOL to return kernel pool definition
        parameters.

        Added the entry point DVPOOL to allow the removal of a variable
        from the kernel pool.

        Added the entry point GNPOOL to allow users to determine
        variables that are present in the kernel pool

    SPICELIB Version 7.0.0, 20-SEP-1995 (WLT)

        The implementation of the kernel pool was completely redone
        to improve performance in loading and fetching data.  In
        addition the pool was upgraded so that variables may be
        either string or numeric valued.

        In addition much greater error checking is performed on
        the input file to guarantee valid inputs.

    SPICELIB Version 6.0.0, 31-MAR-1992 (WLT)

        The entry points SWPOOL and CVPOOL were added.

    SPICELIB Version 5.0.0, 22-AUG-1990 (NJB)

        Increased value of parameter MAXVAL to 5000 to accommodate
        storage of SCLK coefficients in the kernel pool.

    SPICELIB Version 4.0.0, 12-JUN-1990 (IMU)

        All entry points except POOL and CLPOOL now initialize the
        pool if it has not been done yet.

    SPICELIB Version 3.0.0, 23-OCT-1989 (HAN)

        Added declaration of FAILED. FAILED is checked in the
        DO-loops in LDPOOL and WRPOOL to prevent infinite looping.

    SPICELIB Version 2.0.0, 18-OCT-1989 (RET)

       A FAILED test was inserted into the control of the DO-loop which
       reads in each kernel variable in LDPOOL.

    SPICELIB Version 1.2.0, 9-MAR-1989 (HAN)

        Parameters BEGDAT and BEGTXT have been moved into the
        Declarations section.

    SPICELIB Version 1.1.0, 16-FEB-1989 (IMU) (NJB)

        Parameters MAXVAR, MAXVAL, MAXLEN moved into Declarations.
        (Actually, MAXLEN was implicitly 32 characters, and has only
        now been made an explicit---and changeable---limit.)

        Declaration of unused function FAILED removed.

    SPICELIB Version 1.0.0, 8-JAN-1989 (IMU)
Wed Apr  5 17:46:50 2017