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

Abstract
I/O
Examples
Particulars
Required Reading
Version
Index_Entries

Abstract


   CSPICE_UNLOAD unloads a SPICE kernel file (of any type)
   from IDL.

   For important details concerning this module's function, please refer to
   the CSPICE routine unload_c.

I/O

   
   Given:
   
      file   the scalar string name or array of string names of a 
             SPICE kernel file to unload, this file or list of files  
             loaded through with cspice_furnsh
   
   the call:

      cspice_unload, file
   
   removes the file and all associated data from the kernel 
   sub-system. If file is a meta-text kernel, the sub-system
   unloads all files listed in the kernel.
   
   Note: a cspice_unload call deletes ALL kernel variables except
   those loaded into the kernel pool via a cspice_furnsh kernel 
   load  call, i.e. cspice_unload erases kernel variables placed 
   in the pool by the pool functions: cspice_pipool, cspice_pdpool, 
   and cspice_pcpool.
   

Examples


   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.

   
      ;;
      ;; A leapseconds kernel.
      ;;
      cspice_furnsh, 'naif0008.tls'

            ...
      
      cspice_unload, 'naif0008.tls'


      ;;
      ;; A planetary ephemeris SPK file de405s.bsp.
      ;;
      cspice_furnsh, 'de405s.bsp'

            ...

      cspice_unload, 'de405s.bsp'


      ;;
      ;; A meta kernel that lists leapseconds, SPK,
      ;; and PCK kernels. The calls loads/unloads all files listed
      ;; in the meta kernel.
      ;;
      cspice_furnsh, 'standard.tm'

            ...

      cspice_unload, 'standard.tm'


      ;;
      ;; Specify kernels by listing them in an array of strings.
      ;;
      kern = [ '/kernels/gen/lsk/naif0008.tls',        $
               '/kernels/gen/spk/de405_2000-2050.bsp', $
               '/kernels/gen/pck/pck00008.tpc'         ]
               
      cspice_furnsh, kern

            ...

      cspice_unload, kern

Particulars


   None.

Required Reading


   ICY.REQ
   KERNEL.REQ
   PCK.REQ

Version


   -Icy Version 1.1.0, 07-JUN-2007, EDW (JPL)

      Example section showed a cspice_furnsh call instead of the
      cspice_unload.

      Added capability to process vector 'file' input.

   -Icy Version 1.0.0, 16-JUN-2003, EDW (JPL)

Index_Entries

 
   Unload a SPICE kernel 
 



Wed Apr  5 17:58:04 2017