Документ взят из кэша поисковой машины. Адрес
оригинального документа
: http://www.stsci.edu/~sontag/spicedocs/cspice/eklef_c.html
Дата изменения: Sat Dec 17 06:08:54 2005 Дата индексирования: Sun Apr 10 23:24:56 2016 Кодировка: Поисковые слова: п п п п п п п п п п п п п п п п п п п п п п п п п п п п п п п п п п п п п п |
Load an EK file, making it accessible to the EK readers.
EK
Variable I/O Description -------- --- -------------------------------------------------- fname I Name of EK file to load. handle O File handle of loaded EK file.
fname is the name of a binary EK file to be loaded.
handle is the handle of the EK file. The file is accessible by the EK reader routines once it has been loaded.
None.
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.
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 ); }
1) EK files containing columns having the same name but inconsistent declarations are not diagnosed. Such kernels are invalid in any case.
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.
This routine loads a binary EK into the CSPICE query system.
N.J. Bachman (JPL)
None.
-CSPICE Version 1.0.0, 26-MAR-1998 (NJB) Based on SPICELIB Version 1.0.1, 07-JUL-1996 (NJB)
load EK file load E-Kernel