Index Page
eklef_c
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
Brief_I/O
Detailed_Input
Detailed_Output
Parameters
Exceptions
Files
Particulars
Examples
Restrictions
Literature_References
Author_and_Institution
Version
Index_Entries

Procedure

   void eklef_c ( ConstSpiceChar  * fname,
                  SpiceInt        * handle ) 

Abstract

 
   Load an EK file, making it accessible to the EK readers. 
 

Required_Reading

 
   EK 
 

Keywords

 
   EK 
   FILES 
 

Brief_I/O

 
   Variable  I/O  Description 
   --------  ---  -------------------------------------------------- 
   fname      I   Name of EK file to load. 
   handle     O   File handle of loaded EK file. 
 

Detailed_Input

 
   fname          is the name of a binary EK file to be loaded. 
 

Detailed_Output

 
   handle         is the handle of the EK file.  The file is 
                  accessible by the EK reader routines once it 
                  has been loaded. 
 

Parameters

 
   None. 
 

Exceptions

 
   1)  If the EK file indicated by fname contains a column whose 
       name matches that of a column in an already loaded EK, but 
       whose declared attributes don't match those of the loaded 
       column of the same name, the error SPICE(BADATTRIBUTES) is 
       signalled.  handle is is undefined in this case. 
 
   2)  Loading an EK file that is already loaded does not cause side 
       effects.  The handle already associated with the file will be 
       returned. 
 
   3)  If a file open error occurs, the problem will be diagnosed by 
       routines called by this routine.  handle is undefined in 
       this case. 
 
   4)  If loading the input file would cause the maximum number of 
       loaded EK files to be exceeded, the error 
       SPICE(EKFILETABLEFULL) will be signalled.  handle is 
       undefined in this case.  This routine will attempt to 
       unload the file from the DAS system. 
 
   5)  If loading the input file would cause the maximum number of 
       loaded DAS files to be exceeded, the error will be diagnosed 
       by routines called by this routine.  handle is undefined in 
       this case.  This routine will attempt to unload the file 
       from the DAS system. 
 
   6)  If loading the input file would cause the maximum number of 
       segments allowed in loaded EK files to be exceeded, the error 
       SPICE(EKSEGMENTTABLEFULL) will be signalled.  handle is 
       is undefined in this case.  This routine will attempt to 
       unload the file from the DAS system. 
 
   7)  If loading the input file would cause the maximum number of 
       columns allowed in loaded EK files to be exceeded, the error 
       SPICE(EKCOLDESCTABLEFULL) will be signalled.  handle is 
       is undefined in this case.  This routine will attempt to 
       unload the file from the DAS system. 
 
   8)  If loading the input file would cause the maximum allowed 
       number of columns having distinct attributes in loaded EK 
       files to be exceeded, the error SPICE(EKCOLATTRTABLEFULL) will 
       be signalled.  handle is is undefined in this case.  This 
       routine will attempt to unload the file from the DAS system. 
 
   9)  If loading the input file would cause the maximum number of 
       instrument codes allowed in loaded EK files to be exceeded, 
       the error SPICE(EKIDTABLEFULL) will be signalled.  handle is 
       is undefined in this case.  This routine will attempt to 
       unload the file from the DAS system. 
 
   10) If the input file does not contain at least one segment, the 
       error SPICE(EKNOSEGMENTS) will be signalled. 
 

Files

 
   This routine loads a binary EK into the CSPICE query system. 
 

Particulars

 
   This routine makes EK files known to the EK system.  It is 
   necessary to load EK files using this routine in order to 
   query the files using the EK readers. 
 

Examples

 
   1)  Load three EK files.  During query execution, all files 
       will be searched. 
 
          for ( i = 0;  i < 3;  i++ )
          {
             eklef_c ( ek[i], &handle );
          }
          
          [Perform queries] 
 
 
   2)  Load 25 EK files sequentially, unloading the previous file 
       before each new file is loaded.  Unloading files prevents 
       them from being searched during query execution. 
 
          for ( i = 0;  i < 25;  i++ )
          {
             eklef_c ( ek[i], &handle );
 
             [Perform queries] 
 
             ekuef_c ( handle );
          }

 

Restrictions

 
   1)  EK files containing columns having the same name but 
       inconsistent declarations are not diagnosed.  Such kernels 
       are invalid in any case. 
 

Literature_References

 
   None. 
 

Author_and_Institution

 
   N.J. Bachman   (JPL) 
 

Version

 
   -CSPICE Version 1.0.0, 26-MAR-1998 (NJB)
   
       Based on SPICELIB Version 1.0.1, 07-JUL-1996 (NJB) 

Index_Entries

 
   load EK file 
   load E-Kernel 
 
Wed Apr  5 17:54:33 2017